Skip to main content
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 the assistants: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

  • family is derived from type and 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_id is the pointer to follow for the content. null means the block has never been saved.
  • This endpoint returns archived blocks. is_archived: true only 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.
  • company and project are never returned. Both are implied by the token.

Authorizations

Authorization
string
header
required

Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.

Path Parameters

id
string
required

Response

200 - application/json
block
object
required