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
CampoTipo
external_idstringObligatorio. Tu id para el cliente: de 1 a 128 caracteres [A-Za-z0-9._:-]
namestringObligatorio. De 1 a 80 caracteres
metadataobjectHasta 20 pares de strings que guardas en él
limitsobjectmax_decisions, monthly_decisions (null = tu valor predeterminado)
seedobjectSolo 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):

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": [] }
}

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}/move

Mueve 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.

CampoTipo
tostringObligatorio. El id del subespacio o ext:<external_id>
replace_emptybooleanPredeterminado 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 }'
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
}

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.

En esta página