Skip to main content
GET
Leer el contenido de un bloque
The last step of the drill-down: assistantstheir blocksthis block’s content. Returns the content of whichever version the block currently points at, together with that version’s id and number.

Endpoint

Required scope

assistants:read

Headers

Path parameters

Example request

Response

200 OK

A free block, which is anything written through this API:
A catalogue block, configured in the portal:

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, or error.code is BLOCK_CONTENT_NOT_FOUND because the block has never been saved and has no current version.

502 Bad Gateway

The assistant service is unreachable.

Operational notes

  • edit_mode tells you which field to read. free gives you content as text and no payload; assisted gives you payload as an object and no content. Every block written through this API is free.
  • The payload of an assisted block is an opaque object whose shape depends on the block type. It is returned as stored so you can inspect it, but it is not writable here — saving those types returns 409.
  • Rich formatting authored in the portal flattens to text. Bold, italics, colours and inline function chips do not survive the round trip: you get the words, not the styling. If a block was carefully styled in the portal, prefer editing it there.
  • This reads the block’s current version, which is not necessarily what a given assistant sees. An assistant with a pinned_version_id renders that version instead; read it with GET /v1/blocks/{id}/versions/{versionId}.
  • created_by is never returned. It is an internal user id.

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
content
object
required