Skip to content

List saved agent versions

GET
/v1/agents/{agent_id}/versions
agent_id
required
string

Agent ID (prefixed) or name

Saved agent versions

Array<object>

Immutable snapshot of an Agent’s authored and resolved runtime config.

object
agent_id
required
string
Example
agent_01933b5a000070008000000000000001
authored_config
required
object
change_kind
required

Reason a version was created. Stored as lower_snake_case text.

string
Allowed values: manual patch minor major import rollback fork
config_hash
required
string
created_at
required
string format: date-time
created_by_principal_id
string | null
id
required
string
Example
agentver_01933b5a000070008000000000000001
parent_version_id
string | null
resolved_config
required
object
semver_major
required
integer format: int32
semver_minor
required
integer format: int32
semver_patch
required
integer format: int32
source_version_id
string | null
summary
string | null
version
required
string
version_number
required
integer format: int32

Agent not found or agent_versions disabled

Standard error response for API endpoints.

object
error
required

Error message describing what went wrong.

string