List Deployment Runs

List Deployment Runs through the OMA API.

GET /v1/deployment_runs

List Deployment Runs

cURL

curl --request GET \
  --url http://localhost:38080/v1/deployment_runs \
  --header 'X-Api-Key: <api-key>' \
  --header 'anthropic-beta: <anthropic-beta>' \
  --header 'anthropic-version: <anthropic-version>'

200

{
  "data": [
    {
      "type": "deployment_run",
      "id": "<string>",
      "deployment_id": "<string>",
      "trigger_context": {
        "type": "schedule",
        "scheduled_at": "2023-11-07T05:31:56Z"
      },
      "session_id": "<string>",
      "error": {
        "type": "environment_archived_error",
        "message": "<string>"
      },
      "agent": {
        "type": "agent",
        "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
        "version": 1
      },
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "next_page": "<string>"
}

Every request requires ?beta=true, anthropic-version: 2023-06-01, and anthropic-beta: managed-agents-2026-04-01.

Authorizations

omaApiKeyomaBearer

X-Api-Key · string · header · default: sk-ant-local-default · required

OMA workspace API key.

Headers

anthropic-version · string · required

anthropic-beta · string · required

Query Parameters

beta · enum<boolean> · required

Selects the beta API contract for this endpoint. Must be true.

Available options: true

limit · integer<int32>

Maximum results per page. Default 20, maximum 1000.

page · string

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

deployment_id · string

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 · enum<string>

Filter runs by what triggered them. Omit to return all runs. What triggered a deployment run.

Available options: schedule, manual

has_error · boolean

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>

Return runs created at or after this time (inclusive). A timestamp in RFC 3339 format

created_at[lte] · string<date-time>

Return runs created at or before this time (inclusive). A timestamp in RFC 3339 format

created_at[gt] · string<date-time>

Return runs created strictly after this time (exclusive). A timestamp in RFC 3339 format

created_at[lt] · string<date-time>

Return runs created strictly before this time (exclusive). A timestamp in RFC 3339 format

Response

200

application/json

Successful response (OK)

Paginated list of deployment runs. Sorted by created_at descending (most recent first).

data · object[] · required

List of deployment runs.

Show child attributes

next_page · string | null

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