Listar las secciones del prompt de un agente
GET /v1/agents/{id}/prompts
The sections of one agent’s prompt, with their text.
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 theagents: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
totalis the count of real sections, not of section types. labelis optional. When it isnullthe 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.