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} — или {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_removed: true) или "agent_running".

В приложении владельцы и администраторы используют ⋯ → Перенести в подпространство на странице решения.

На этой странице