Obtener la metadata de un bloque
Block catalogue
GET /v1/blocks/{id}
Get one block’s metadata: type, family, name, and which version is current.
GET
Obtener la metadata de un bloque
Returns one block’s metadata. No content: a block document holds none. The text lives in its versions, which is why reading it is a separate call.
Use this when you have a
block_id from an assistant’s blocks array and want to know what it is before deciding whether to read or edit it.
Endpoint
Required scope
assistants:read
Headers
Path parameters
Example request
Response
200 OK
401 Unauthorized
Missing, invalid, revoked, or expired token.403 Forbidden
The token does not have theassistants:read scope.
404 Not Found
No block with that id in the token’s company and project.502 Bad Gateway
The assistant service is unreachable.Operational notes
familyis derived fromtypeand is read-only. It decides which section of the composed prompt the block lands in — identity first, then instructions, then information — and is never accepted on a write.current_version_idis the pointer to follow for the content.nullmeans the block has never been saved.- This endpoint returns archived blocks.
is_archived: trueonly means it is hidden from the catalogue listing; it can still be attached and still renders. - A block from another project of the same company is a
404. Project is part of a block’s identity, so cross-project reads are indistinguishable from a missing id. companyandprojectare never returned. Both are implied by the token.