API de subespacios
POST, GET, PATCH y DELETE /v1/workspaces — subespacios del modo socio, uno por cliente de tu app, identificados por tu external_id — y POST /v1/decisions/{slug}/move.
Solo en modo socio (guía). Autentícate con tu clave de API. {ref} es el id del subespacio o ext:<external_id>.
Crear o actualizar
POST https://api.dcision.io/v1/workspaces| Campo | Tipo | |
|---|---|---|
external_id | string | Obligatorio. Tu id para el cliente: de 1 a 128 caracteres [A-Za-z0-9._:-] |
name | string | Obligatorio. De 1 a 80 caracteres |
metadata | object | Hasta 20 pares de strings que guardas en él |
limits | object | max_decisions, monthly_decisions (null = tu valor predeterminado) |
seed | object | Solo al crearlo: { "decisions": ["slug"], "deploy": true } copia tus decisiones desplegadas |
201 cuando se crea, 200 cuando ya existía (se actualizan el nombre, los metadatos y los límites enviados):
{
"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": [] }
}Errores: 403 FORBIDDEN (partner_disabled — activa el modo socio; key_without_author), 402 PLAN_LIMIT_REACHED (scope: "workspaces").
Listar, obtener, actualizar, eliminar
| Solicitud | |
|---|---|
GET /v1/workspaces?limit=&cursor=&external_id= | { "data": [ … ], "next_cursor" } |
GET /v1/workspaces/{ref} | Un subespacio |
PATCH /v1/workspaces/{ref} | name, metadata, limits |
DELETE /v1/workspaces/{ref} | 204: lo elimina junto con sus decisiones y ejecuciones |
Un {ref} desconocido — o de otro workspace — responde 404 WORKSPACE_NOT_FOUND.
Mover una decisión a un subespacio
POST https://api.dcision.io/v1/decisions/{slug}/moveMueve una de tus decisiones (del workspace de la clave de API) a uno de tus subespacios con todo su historial: versiones, ejecuciones, entregas de destinos y el chat del agente. El uso ya facturado se queda en tu workspace. La clave necesita un autor (las claves creadas en la app lo tienen), y aquí se rechaza el header Dcision-Workspace (400): la decisión siempre sale del workspace de la clave.
| Campo | Tipo | |
|---|---|---|
to | string | Obligatorio. El id del subespacio o ext:<external_id> |
replace_empty | boolean | Predeterminado false. Cuando el subespacio ya tiene una decisión con este slug que nunca se ejecutó (sin ejecuciones ni entregas), la elimina y mueve la tuya en su 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 de ahí, llama a la decisión con Dcision-Workspace: ext:acme — sin el header, tu workspace responde 404 DECISION_NOT_FOUND. Actualiza tu integración antes de mover.
Errores: 400 INVALID_REQUEST (to mal formado, o un header Dcision-Workspace), 403 FORBIDDEN (partner_disabled, key_without_author), 402 PLAN_LIMIT_REACHED (scope: "workspace" — el límite de decisiones del subespacio), 404 WORKSPACE_NOT_FOUND (no es uno de tus subespacios), 404 DECISION_NOT_FOUND, 409 SLUG_TAKEN, 409 CONFLICT con reason: "inbound_webhook" (primero desactiva el webhook de entrada de la decisión — un webhook desactivado se elimina, webhook_removed: true) o "agent_running".
En la app, los Propietarios y Administradores usan ⋯ → Mover a un subespacio en la página de la decisión.
Listar ejecuciones
GET /v1/executions — ejecuciones recientes de tus decisiones con respuestas, acción, motivo y métricas, filtradas por decisión y estado y paginadas con un cursor. Las entradas nunca se devuelven.
API de sesiones embebidas
POST /v1/embed/sessions — abre el editor embebible para uno de tus usuarios finales en su sub-workspace; revoca sesiones. Solo desde el servidor.