API de sub-workspaces
POST, GET, PATCH e DELETE /v1/workspaces — os sub-workspaces do modo parceiro, um por cliente do seu app, endereçados pelo seu external_id — e POST /v1/decisions/{slug}/move.
Só no modo parceiro (guia). Autentique com a sua API key. {ref} é o id do sub-workspace ou ext:<external_id>.
Criar ou atualizar
POST https://api.dcision.io/v1/workspaces| Campo | Tipo | |
|---|---|---|
external_id | string | Obrigatório. O seu id para o cliente: 1–128 caracteres [A-Za-z0-9._:-] |
name | string | Obrigatório. 1–80 caracteres |
metadata | object | Até 20 pares de strings que você guarda nele |
limits | object | max_decisions, monthly_decisions (null = o seu padrão) |
seed | object | Só na criação: { "decisions": ["slug"], "deploy": true } copia as suas decisões publicadas |
201 quando é criado, 200 quando já existia (o nome, os metadados e os limites enviados são atualizados):
{
"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": [] }
}Erros: 403 FORBIDDEN (partner_disabled — ligue o modo parceiro; key_without_author), 402 PLAN_LIMIT_REACHED (scope: "workspaces").
Listar, obter, atualizar, excluir
| Requisição | |
|---|---|
GET /v1/workspaces?limit=&cursor=&external_id= | { "data": [ … ], "next_cursor" } |
GET /v1/workspaces/{ref} | Um sub-workspace |
PATCH /v1/workspaces/{ref} | name, metadata, limits |
DELETE /v1/workspaces/{ref} | 204: exclui o sub-workspace com as decisões e execuções dele |
Um {ref} desconhecido — ou de outro workspace — responde 404 WORKSPACE_NOT_FOUND.
Mover uma decisão para um sub-workspace
POST https://api.dcision.io/v1/decisions/{slug}/moveMove uma das suas decisões (do workspace da API key) para um dos seus sub-workspaces com todo o histórico: versões, execuções, entregas de destinos e o chat do agente. O uso já cobrado continua no seu workspace. A chave precisa de um autor (as chaves criadas no app têm um), e o header Dcision-Workspace é recusado aqui (400): a decisão sempre sai do workspace da chave.
| Campo | Tipo | |
|---|---|---|
to | string | Obrigatório. O id do sub-workspace ou ext:<external_id> |
replace_empty | boolean | Padrão false. Quando o sub-workspace já tem uma decisão com esse slug que nunca rodou (sem execuções, sem entregas), exclui essa decisão e coloca a sua no lugar |
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
}A partir daí, chame a decisão com Dcision-Workspace: ext:acme — sem o header, o seu workspace responde 404 DECISION_NOT_FOUND. Atualize a sua integração antes de mover.
Erros: 400 INVALID_REQUEST (to malformado, ou um header Dcision-Workspace), 403 FORBIDDEN (partner_disabled, key_without_author), 402 PLAN_LIMIT_REACHED (scope: "workspace" — o limite de decisões do sub-workspace), 404 WORKSPACE_NOT_FOUND (não é um dos seus sub-workspaces), 404 DECISION_NOT_FOUND, 409 SLUG_TAKEN, 409 CONFLICT com reason: "inbound_webhook" (desligue antes o webhook de entrada da decisão — um webhook desligado é removido, webhook_removed: true) ou "agent_running".
No app, Proprietários e Admins usam ⋯ → Mover para um sub-workspace na página da decisão.
Listar execuções
GET /v1/executions — execuções recentes das suas decisões com respostas, ação, motivo e métricas, filtradas por decisão e status e paginadas com um cursor. Entradas nunca são devolvidas.
API de sessões de embed
POST /v1/embed/sessions — abra o editor incorporável para um dos seus usuários finais no sub-workspace dele; revogue sessões. Só no servidor.