Listar bloques del proyecto
Block catalogue
GET /v1/blocks
List every block in the project, attached to an assistant or not, with metadata and no content.
GET
Listar bloques del proyecto
The project’s whole block catalogue. Blocks are not owned by an assistant: they live here and any number of assistants can reference them, so this is where you look for something to reuse.
Metadata only, no content — for that, read one block’s content.
Endpoint
Required scope
assistants:read
Headers
Query parameters
Example request
Response
200 OK
401 Unauthorized
Missing, invalid, revoked, or expired token.403 Forbidden
The token does not have theassistants:read scope.
502 Bad Gateway
The assistant service is unreachable.Operational notes
- There is no
total, and that is deliberate. The upstream store exposes no count for blocks, so rather than return the length of the current page as if it were the size of the set — which would make a client stop paginating early — the response carrieshas_more. Page until it isfalse. - Archived blocks are hidden by default but still active.
include_archived=falseonly affects this listing: an archived block that is still attached to an assistant keeps rendering into its prompt. To take it out of an assistant, detach it. content_writable: falsemarks the five catalogue types —product_info,store_info,reservation_info,tables_info,tags. You can read, rename and archive them here; saving their content returns409.- Scoped to the token’s project. A block created under another project of the same company does not appear and cannot be read by id.
- A block with
current_version_id: nullhas never been saved. Reading its content returns404 BLOCK_CONTENT_NOT_FOUND.
Authorizations
Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.
Query Parameters
Required range:
1 <= x <= 200Required range:
x >= 0Available options:
personification, objective, response_format, steps, cases_possible, do_not, product_info, store_info, reservation_info, tables_info, tags, response_policy Available options:
identity, instructions, information Incluye los bloques archivados. Un bloque archivado sigue rindiendo en el prompt de los asistentes que lo tienen adjunto.