Skip to main content
GET
Leer el contenido de una version
Returns the content of a specific version, in the same shape as reading the current content. Two reasons to use it: checking what a restore would bring back, and reading the version an assistant is actually pinned to when that is not the current one.

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

The block does not exist in the token’s company and project, or error.code is BLOCK_VERSION_NOT_FOUND because the version does not exist or belongs to a different block.

502 Bad Gateway

The assistant service is unreachable.

Operational notes

  • The version must belong to the block in the path. A valid version id from another block of the same company is a 404, not a redirect — the nesting is enforced, not decorative.
  • edit_mode decides the field, same as the current-content endpoint: free gives you content as text, assisted gives you payload as an object.
  • Historical versions of catalogue blocks are readable. The write restriction applies to saving, not to reading, so you can inspect the history of a product_info block even though you cannot edit it here.
  • Versions never expire and are never pruned. Any id you have seen stays readable.

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
versionId
string
required

Response

200 - application/json
content
object
required