Skip to main content
GET
/
agents
/
{namespace_slug}
/
{agent_name}
/
versions
List Versions for Agent
curl --request GET \
  --url https://api.example.com/agents/{namespace_slug}/{agent_name}/versions
{
  "total": 123,
  "versions": [
    {
      "author_email": "<string>",
      "author_name": "<string>",
      "branch_id": "<string>",
      "deployed_at": "2023-11-07T05:31:56Z",
      "git_branch": "<string>",
      "git_hash": "<string>",
      "id": "<string>",
      "image_url": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "failure_diagnostics": {},
      "failure_reason": "<string>",
      "git_message": "",
      "image_expires_at": "2023-11-07T05:31:56Z",
      "is_dirty": false,
      "last_rollback_at": "2023-11-07T05:31:56Z",
      "replicas": 0,
      "retired_at": "2023-11-07T05:31:56Z",
      "rollback_count": 0,
      "rolled_back_at": "2023-11-07T05:31:56Z",
      "source_filesystem_id": "<string>",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "branch_id": "<string>"
}

Path Parameters

​
namespace_slug
string
required
​
agent_name
string
required

Query Parameters

​
branch
string | null

Filter by branch name (e.g., 'main', 'feature/login'). If not provided, returns versions across all branches.

​
status
enum<string> | null

Filter by version status Status of a version in its lifecycle.

Available options:
DEPLOYING,
ACTIVE,
FAILED,
UNHEALTHY,
DRAINING,
RETIRED,
ROLLED_BACK
​
limit
integer
default:20

Maximum versions to return

Required range: 1 <= x <= 100

Response

Successful Response

Response for listing versions of a branch.

​
total
integer
required

Total count

​
versions
VersionResponse · object[]
required

List of versions

​
branch_id
string | null

Branch ID