v1

latestOpenAPI 3.1.02026-08-04151221521.2 KB

Branches

Versions

Get Version

Get version details by ID.

get/versions/{version_id}

Path parameters

version_idstring required

Response

Successful Response

acp_type'sync' | 'async' required

Type of ACP server.

author_emailstring required

Commit author email

author_namestring required

Commit author name

branch_idstring required

Parent branch ID

created_atstring date-time nullable

Creation timestamp

deployed_atstring date-time required

When this version was deployed

failure_diagnosticsobject nullable

User-facing failure diagnostics with 'title', 'description', and 'action' fields

failure_reasonstring nullable

Classified failure reason when status is FAILED (e.g., 'image_pull_failed', 'crash_loop', 'scheduling_failed')

git_branchstring required

Git branch name

git_hashstring required

Git commit hash

git_messagestring

Git commit message

idstring required

Version ID

image_expires_atstring date-time nullable

When image expires (for rollback window)

image_urlstring required

Container image URL

is_dirtyboolean

Whether the commit had uncommitted changes

last_rollback_atstring date-time nullable

Timestamp when this version was last rolled back TO

replicasinteger

Current pod count for this version

retired_atstring date-time nullable

When version was retired

rollback_countinteger

Number of rollbacks to this version

rolled_back_atstring date-time nullable

Timestamp when this version was rolled back FROM

sdk_type'claude_agent_sdk' | 'codex_agent_sdk' required

SDK type for agent runtime.

source_filesystem_idstring nullable

Filesystem snapshot that can reopen this version in Agent Builder

Status of a version in its lifecycle.

updated_atstring date-time nullable

Last update timestamp