Skip to main content
GET
Listar las secciones del prompt de un agente
Everything the business wrote into this agent: who it is, what it does not do, when it hands over to a person, its example conversations. One call, text included — unlike the block model this replaced, the text lives inside the agent. What each section is for, and what belongs in it, comes from the catalogue.

Endpoint

Required scope

agents:read

Path parameters

Example request

Response

200 OK

401 Unauthorized

Missing, invalid, revoked, or expired token.

403 Forbidden

The token does not have the agents:read scope.

404 Not Found

No agent with that id in the token’s company and project.

502 Bad Gateway

The agent service is unreachable.

Operational notes

  • A section that was never written is simply absent. There is no empty placeholder row: the list holds what the business actually wrote, so total is the count of real sections, not of section types.
  • label is optional. When it is null the portal shows the catalogue’s own label.
  • This is not paginated. An agent holds a handful of sections and the catalogue caps how many types exist.
  • Order follows the catalogue, which is the order the sections take in the assembled prompt.

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
data
object[]
required
total
number
required