Fetch blocks by ID, in request order, with image references resolved.
Fetch blocks by ID for a website, with image references resolved to URLs. Blocks are returned in the same order as the requested ids; unknown IDs are silently skipped.
Auth: API key (x-api-key header or api_key query param).
| Param | Type | Required | Notes |
|---|---|---|---|
websiteId | uuid | no | Target website; falls back to Host header / config. |
ids | string | no | Comma-separated block UUIDs. Empty or missing → []. |
api_key | string | no | Alternative to the x-api-key header. |
A JSON array of blocks:
[
{
"id": "...",
"website_id": "...",
"schema_id": "...",
"draft_content": {},
"published_content": {},
"state": "published",
"version": 3,
"schema_name": "hero-block",
"layout": {},
"cloned_from_id": null,
"created_at": "2026-06-23T18:34:16Z",
"updated_at": "2026-06-23T20:36:55Z"
}
]
curl '{CMS_API_URL}/blocks?websiteId=<uuid>&ids=<id1>,<id2>' \
-H 'x-api-key: <key>'
400 — invalid UUID in ids, or unresolvable website401 — invalid API key