API v1 ReferenceCustom Agents

Restores a previous system prompt version.

Restores a saved system prompt version as the agent's current prompt. The restore records a new history version and returns that version. Use the system prompt versions endpoint to find a version id. <Check title="Required Permissions" icon="key">The user must have manage access to the agent.</Check>

Authentication

AuthorizationBearer

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

Path parameters

agentIdstringRequiredformat: "uuid"
The agent id.
systemPromptVersionIdstringRequiredformat: "uuid"
The prompt version 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