List Deployments

List Deployments through the OMA API.

GET /v1/deployments

List Deployments

cURL

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

200

{
  "data": [
    {
      "type": "deployment",
      "id": "depl_011CZkZcDH3vPqd7xnEfwTai",
      "name": "Daily order report",
      "description": "Compiles yesterday's orders into a report every weekday morning.",
      "agent": {
        "type": "agent",
        "id": "agent_011CZkYpogX7uDKUyvBTophP",
        "version": 1
      },
      "environment_id": "env_011CZkZ9X2dpNyB7HsEFoRfW",
      "vault_ids": [
        "vlt_011CZkZDLs7fYzm1hXNPeRjv"
      ],
      "initial_events": [
        {
          "type": "user.message",
          "content": [
            {
              "type": "text",
              "text": "Compile yesterday's orders into report.md."
            }
          ]
        }
      ],
      "resources": [],
      "metadata": {},
      "schedule": {
        "type": "cron",
        "expression": "0 9 * * 1-5",
        "timezone": "America/Los_Angeles",
        "last_run_at": "2026-03-16T16:00:09Z",
        "upcoming_runs_at": [
          "2026-03-17T16:00:00Z",
          "2026-03-18T16:00:00Z"
        ]
      },
      "status": "active",
      "paused_reason": null,
      "created_at": "2026-03-15T10:00:00Z",
      "updated_at": "2026-03-15T10:00:00Z",
      "archived_at": null
    }
  ],
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}

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 100.

page · string

Opaque pagination cursor.

agent_id · string

Filter by agent ID.

status · enum<string>

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

Available options: active, paused

created_at[gte] · string<date-time>

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

created_at[lte] · string<date-time>

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

include_archived · boolean

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

Response

200

application/json

Successful response (OK)

Paginated list of deployments.

data · object[] · required

List of deployments.

Show child attributes

Example:

[
  {
    "type": "deployment",
    "id": "depl_011CZkZcDH3vPqd7xnEfwTai",
    "name": "Daily order report",
    "description": "Compiles yesterday's orders into a report every weekday morning.",
    "agent": {
      "type": "agent",
      "id": "agent_011CZkYpogX7uDKUyvBTophP",
      "version": 1
    },
    "environment_id": "env_011CZkZ9X2dpNyB7HsEFoRfW",
    "vault_ids": ["vlt_011CZkZDLs7fYzm1hXNPeRjv"],
    "initial_events": [
      {
        "type": "user.message",
        "content": [
          {
            "type": "text",
            "text": "Compile yesterday's orders into report.md."
          }
        ]
      }
    ],
    "resources": [],
    "metadata": {},
    "schedule": {
      "type": "cron",
      "expression": "0 9 * * 1-5",
      "timezone": "America/Los_Angeles",
      "last_run_at": "2026-03-16T16:00:09Z",
      "upcoming_runs_at": [
        "2026-03-17T16:00:00Z",
        "2026-03-18T16:00:00Z"
      ]
    },
    "status": "active",
    "paused_reason": null,
    "created_at": "2026-03-15T10:00:00Z",
    "updated_at": "2026-03-15T10:00:00Z",
    "archived_at": null
  }
]

next_page · string | null

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

Example:

"page_MjAyNS0wNS0xNFQwMDowMDowMFo="