Sign in

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
      }
    }
  ]
}

Changes

Changed in 2 of the 68 revisions of this API.23

  • d2b230555b7f22See the full diff
    • ▲

      response property data/items/session_id list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • ▲

      response property next_page list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • ○

      removed from the // response property allOf list for the response status

      response-property-all-of-removed

    • ○

      added subschema #2 to the // response property anyOf list for the response status

      response-property-any-of-added

  • 2336fecb081b1See the full diff
    • ○

      endpoint added

      endpoint-added