v49

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-261319281.7 MB

List Deployment Runs

get/v1/deployment_runs?beta=true

Query parameters

limitinteger

Maximum results per page. Default 20, maximum 1000.

pagestring

Opaque pagination cursor. Pass next_page from the previous response. Invalid or expired cursors return 400.

deployment_idstring

Filter to a specific deployment. Omit to list across all deployments in the workspace. Filtering by a non-existent deployment_id returns 200 with empty data.

trigger_type'schedule' | 'manual'

What triggered a deployment run.

Filter runs by what triggered them. Omit to return all runs.

has_errorboolean

Filter: true for runs with non-null error, false for runs with non-null session_id. Omit for all.

created_at[gte]string date-time

A timestamp in RFC 3339 format

Return runs created at or after this time (inclusive).

created_at[lte]string date-time

A timestamp in RFC 3339 format

Return runs created at or before this time (inclusive).

created_at[gt]string date-time

A timestamp in RFC 3339 format

Return runs created strictly after this time (exclusive).

created_at[lt]string date-time

A timestamp in RFC 3339 format

Return runs created strictly before this time (exclusive).

Headers

x-api-keystring

anthropic-versionstring

anthropic-betastring

Response

Successful response (OK)

next_pagestring nullable

Opaque cursor for the next page. Null when no more results.

Example response

{
  "data": [
    {
      "agent": {
        "type": "agent",
        "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
        "version": 1
      }
    }
  ]
}