子工作区 API

POST、GET、PATCH 和 DELETE /v1/workspaces——合作伙伴模式的子工作区,你的应用的每位客户一个,通过你的 external_id 寻址——以及 POST /v1/decisions/{slug}/move。

仅限合作伙伴模式(指南)。使用你的 API 密钥进行身份验证。{ref} 是子工作区的 id 或 ext:<external_id>。

创建或更新

POST https://api.dcision.io/v1/workspaces
字段类型
external_idstring必填。你为该客户设定的 id:1–128 个字符 [A-Za-z0-9._:-]
namestring必填。1–80 个字符
metadataobject最多 20 个由你保存在其上的字符串键值对
limitsobjectmax_decisions、monthly_decisions(null = 你的默认值)
seedobject仅在创建时:{ "decisions": ["slug"], "deploy": true } 会复制你已部署的决策

创建时返回 201,已存在时返回 200(会更新所发送的名称、元数据和限额):

201 Created
{
  "id": "0b0c1d2e-6a1f-4c55-9b0e-3f6d7a8c9e01",
  "external_id": "acme",
  "name": "Acme Inc",
  "metadata": {},
  "limits": { "max_decisions": 10, "monthly_decisions": null },
  "usage": { "decisions": 1, "period_used": 0, "period_start": "2026-10-01T00:00:00.000Z", "period_end": "2026-11-01T00:00:00.000Z" },
  "created_at": "2026-10-09T12:00:00.000Z",
  "seed": { "created": [{ "slug": "lead-qualification", "id": "dec_…", "deployed": true }], "skipped": [] }
}

错误:403 FORBIDDEN(partner_disabled——请开启合作伙伴模式;key_without_author),402 PLAN_LIMIT_REACHED(scope: "workspaces")。

列出、获取、更新、删除

请求
GET /v1/workspaces?limit=&cursor=&external_id={ "data": [ … ], "next_cursor" }
GET /v1/workspaces/{ref}单个子工作区
PATCH /v1/workspaces/{ref}name、metadata、limits
DELETE /v1/workspaces/{ref}204:删除子工作区及其决策和执行记录

未知的 {ref}——或属于其他工作区的——会返回 404 WORKSPACE_NOT_FOUND。

把决策移动到子工作区

POST https://api.dcision.io/v1/decisions/{slug}/move

把你的某个决策(API 密钥所属工作区中的)连同其全部历史移动到你的某个子工作区:版本、执行记录、目的地投递和智能体对话。已计费的用量保留在你的工作区。该密钥需要有作者(在应用中创建的密钥都有),并且此处会拒绝 Dcision-Workspace 请求头(400):决策总是从密钥所属的工作区移出。

字段类型
tostring必填。子工作区的 id 或 ext:<external_id>
replace_emptyboolean默认 false。如果子工作区中已有使用此 slug 且从未运行过(没有执行记录、没有投递)的决策,则删除它并把你的决策移到它的位置
curl -X POST https://api.dcision.io/v1/decisions/lead-qualification/move \
  -H "Authorization: Bearer $DCISION_API_KEY" -H "Content-Type: application/json" \
  -d '{ "to": "ext:acme", "replace_empty": true }'
200 OK
{
  "decision": { "id": "dec_8kQ2mZ7xV1pLr4Tn9WcY", "slug": "lead-qualification", "name": "Lead qualification", "status": "deployed", "version": 4, "updated_at": "2026-10-09T12:00:00.000Z" },
  "from_workspace": { "id": "5d1e6f20-1b2c-4d3e-8f90-a1b2c3d4e5f6" },
  "workspace": { "id": "0b0c1d2e-6a1f-4c55-9b0e-3f6d7a8c9e01", "external_id": "acme", "name": "Acme Inc" },
  "moved": { "executions": 1234, "deliveries": 56, "chat_messages": 12, "agent_turns": 3, "versions": 4 },
  "replaced": { "id": "dec_3hT7nW2qK9mXv5Lp8RcZ" },
  "webhook_removed": false
}

从此以后,请使用 Dcision-Workspace: ext:acme 调用该决策——不带此请求头时,你的工作区会返回 404 DECISION_NOT_FOUND。请在移动之前更新你的集成。

错误:400 INVALID_REQUEST(to 格式错误,或携带了 Dcision-Workspace 请求头),403 FORBIDDEN(partner_disabled、key_without_author),402 PLAN_LIMIT_REACHED(scope: "workspace"——子工作区的决策数量上限),404 WORKSPACE_NOT_FOUND(不是你的子工作区之一),404 DECISION_NOT_FOUND,409 SLUG_TAKEN,409 CONFLICT 且 reason: "inbound_webhook"(请先关闭该决策的入站 webhook——已关闭的 webhook 会被删除,webhook_removed: true)或 "agent_running"。

在应用中,Owner 和 Admin 可以在决策页面使用 ⋯ → 移动到子工作区。

本页内容