列出部署

通过 OMA API 列出部署。

GET /v1/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": "每日订单报告",
      "description": "每个工作日早晨将前一天的订单汇总为报告。",
      "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": "将昨天的订单汇总到 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="
}

每个请求都必须发送 ?beta=true、anthropic-version: 2023-06-01 与 anthropic-beta: managed-agents-2026-04-01。

授权

omaApiKeyomaBearer

X-Api-Key · string · header · 默认值: sk-ant-local-default · 必填

OMA 工作区 API 密钥。

请求头

anthropic-version · string · 必填

anthropic-beta · string · 必填

查询参数

beta · enum<boolean> · 必填

为此接口启用 Beta API 合同，必须为 true。

可用选项: true

limit · integer<int32>

每页最大结果数。默认 20，上限 100。

page · string

不透明的分页游标。

agent_id · string

按智能体 ID 筛选。

status · enum<string>

按状态过滤：active 或 paused。省略时返回两者。如需包含已归档的部署，请改用 include_archived；两者不能同时使用。 部署的生命周期状态。

可用选项: active, paused

created_at[gte] · string<date-time>

返回在此时间或之后创建的部署（含该时间点）。 RFC 3339 格式的时间戳

created_at[lte] · string<date-time>

返回在此时间或之前创建的部署（含该时间点）。 RFC 3339 格式的时间戳

include_archived · boolean

为 true 时包含已归档的部署。默认值：false（不包含已归档的部署）。

响应

200

application/json

请求成功。

部署的分页列表。

data · object[] · 必填

部署列表。

Show child attributes

示例:

[
  {
    "type": "deployment",
    "id": "depl_011CZkZcDH3vPqd7xnEfwTai",
    "name": "每日订单报告",
    "description": "每个工作日早晨将前一天的订单汇总为报告。",
    "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": "将昨天的订单汇总到 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

下一页的不透明游标。没有更多结果时为 null。

示例:

"page_MjAyNS0wNS0xNFQwMDowMDowMFo="