List Deployments

get/v1/deployments?beta=true

Query parameters

limitinteger

Maximum results per page. Default 20, maximum 100.

pagestring

Opaque pagination cursor.

agent_idstring

Filter by agent ID.

status'active' | 'paused'

Lifecycle status of a deployment.

Filter by status: active or paused. Omit for both. To include archived deployments, use include_archived instead; the two cannot be combined.

created_at[gte]string date-time

A timestamp in RFC 3339 format

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

created_at[lte]string date-time

A timestamp in RFC 3339 format

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

include_archivedboolean

When true, includes archived deployments. Default: false (exclude archived).

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
      },
      "initial_events": [
        {
          "content": [
            {
              "type": "text",
              "text": "Where is my order #1234?"
            }
          ]
        }
      ],
      "resources": [
        {
          "checkout": {
            "type": "branch",
            "name": "main"
          }
        }
      ]
    }
  ]
}

Changes