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_id | string | Обязательно. Ваш id клиента: 1–128 символов [A-Za-z0-9._:-] |
name | string | Обязательно. 1–80 символов |
metadata | object | До 20 строковых пар, которые вы храните на нём |
limits | object | max_decisions, monthly_decisions (null = ваше значение по умолчанию) |
seed | object | Только при создании: { "decisions": ["slug"], "deploy": true } копирует ваши опубликованные решения |
201 при создании, 200, если оно уже существовало (переданные имя, метаданные и лимиты обновляются):
{
"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): решение всегда уходит из рабочего пространства ключа.
| Поле | Тип | |
|---|---|---|
to | string | Обязательно. id подпространства или ext:<external_id> |
replace_empty | boolean | По умолчанию 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 }'{
"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".
В приложении владельцы и администраторы используют ⋯ → Перенести в подпространство на странице решения.
Список выполнений
GET /v1/executions — последние запуски ваших решений с ответами, действием, причиной и метриками, с фильтрами по решению и статусу и пагинацией через курсор. Входные данные не возвращаются.
API сессий встраивания
POST /v1/embed/sessions — открывает встраиваемый редактор для одного из ваших конечных пользователей в его подпространстве; отзыв сессий. Только на стороне сервера.