Skip to navigation
API v1 ReferenceCustom Agents

Lists the agent's saved system prompt versions.

Lists the saved system prompt versions for the specified custom agent. Use a returned version id with the system prompt restore endpoint to restore an earlier prompt.

Required Permissions
The user must have read access to the agent.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

agentIdstringRequiredformat: "uuid"
The agent id.

Response

OK
idstringOptionalformat: "uuid"
The prompt version id.
agentIdstringOptionalformat: "uuid"
The agent id.
versionNumberintegerOptional
The version number, assigned in order of creation.
isCurrentbooleanOptional
Whether this is the agent's current system prompt.
systemPromptstring or nullOptional
The system prompt.
createdOnstring or nullOptionalformat: "date-time"
The creation time of the system prompt version.
createdBystring or nullOptionalformat: "uuid"
The user who created the system prompt version.

Errors

401
Unauthorized Error
404
Not Found Error