Historial de una seccion
GET /v1/agents/{id}/prompts/{section}/versions
The history of one section, newest first.
GET
Historial de una seccion
Every text that section has held. A version is written on each save that changes the text, so saving without editing does not pad the history, and the newest version is what the agent is reading right now.
Endpoint
Required scope
agents:read
Path parameters
Query parameters
Example request
Response
200 OK
404 Not Found
No agent with that id in the token’s company and project.Operational notes
- The first item is the current text. There is no
is_currentflag because there is nothing to disagree with: the highestversion_numberis what the agent reads. version_numberis per section, not per agent. Two sections both have a version 1.created_byis who saved it — a portal user’s email, the PAT owner’s email when it came through this API, ornullfor versions written before the field existed.restored_fromnames the version this one copied, when it was born from a restore. It is how you tell an edit from a rollback.- An agent created before section history existed starts at version 1 with whatever text it had at that moment, not with its real past.
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 >= 0