---
title: "List Versions"
method: GET
path: "/branches/{branch_id}/versions"
tags: ["Branches"]
---

# List Versions

`GET /branches/{branch_id}/versions`

List all versions for a branch.

    Versions are ordered by deployed_at descending (most recent first).
    Each version represents a git commit that was deployed.

## Path parameters

- `branch_id` string, required

## Query parameters

- `limit` integer — Maximum versions to return

## Response `200`

Successful Response

- VersionListResponse — Response for listing versions of a branch.
  - `branch_id` string, nullable — Branch ID
  - `total` integer, required — Total count
  - `versions` VersionResponse[], required — List of versions
    - `acp_type` 'sync' | 'async', required — Type of ACP server.
    - `author_email` string, required — Commit author email
    - `author_name` string, required — Commit author name
    - `branch_id` string, required — Parent branch ID
    - `created_at` string, date-time, nullable — Creation timestamp
    - `deployed_at` string, date-time, required — When this version was deployed
    - `failure_diagnostics` object, nullable — User-facing failure diagnostics with 'title', 'description', and 'action' fields
    - `failure_reason` string, nullable — Classified failure reason when status is FAILED (e.g., 'image_pull_failed', 'crash_loop', 'scheduling_failed')
    - `git_branch` string, required — Git branch name
    - `git_hash` string, required — Git commit hash
    - `git_message` string — Git commit message
    - `id` string, required — Version ID
    - `image_expires_at` string, date-time, nullable — When image expires (for rollback window)
    - `image_url` string, required — Container image URL
    - `is_dirty` boolean — Whether the commit had uncommitted changes
    - `last_rollback_at` string, date-time, nullable — Timestamp when this version was last rolled back TO
    - `replicas` integer — Current pod count for this version
    - `retired_at` string, date-time, nullable — When version was retired
    - `rollback_count` integer — Number of rollbacks to this version
    - `rolled_back_at` string, 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_id` string, nullable — Filesystem snapshot that can reopen this version in Agent Builder
    - `status` 'DEPLOYING' | 'ACTIVE' | 'FAILED' | 'UNHEALTHY' | 'DRAINING' | 'RETIRED' | 'ROLLED_BACK', required — Status of a version in its lifecycle.
    - `updated_at` string, date-time, nullable — Last update timestamp

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/terminaluse/apis/sb0-api.md) · [All operations](https://skmtc.net/terminaluse/apis/sb0-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/terminaluse/sb0-api/versions/f24a474dc415/schema)