Lists the agent's saved system prompt versions.

GET

https://api.awork.com/api/v1/agents/:agentId/systempromptversions

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.

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. <Check title="Required Permissions" icon="key">The user must have read 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.

Response

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