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.
Solo en modo partner (guía). Llámala desde tu servidor con tu clave de API.
POST https://api.dcision.io/v1/embed/sessions| Campo | Tipo | |
|---|---|---|
workspace | string u objeto | ext:<external_id> / el id del sub-workspace, o { "external_id", "name", … } para crearlo sobre la marcha (mismos campos que POST /v1/workspaces) |
user | objeto | Obligatorio. { "id", "name"?, "email"? } — tu usuario final |
permissions | string[] | Predeterminado: todos. decisions:read, decisions:write, decisions:deploy, decisions:delete, executions:read, agent |
start_path | string | /decisions (predeterminado), /decisions/new o /decisions/{id}[/editor|builder|playground|deploy|executions] |
origins | string[] | Un subconjunto de tus orígenes permitidos (predeterminado: todos). Las sesiones de claves de prueba también pueden usar un origen de desarrollo local |
locale | string | en, pt, es, ru o zh |
theme | string | light, dark o system |
ttl_seconds | integer | 300–43 200 (predeterminado 3 600) |
{
"id": "emb_7Hq2Lm9Xc4Rv1Tz8Wn3B",
"url": "https://app.dcision.io/embed/launch?ticket=emt_…",
"launch_expires_at": "2026-10-09T12:01:00.000Z",
"expires_at": "2026-10-09T13:00:00.000Z",
"permissions": ["decisions:read", "decisions:write", "decisions:deploy", "decisions:delete", "executions:read", "agent"],
"origins": ["https://app.example.com"],
"workspace": { "id": "…", "external_id": "acme", "name": "Acme Inc", "created": false, "…": "…" }
}Carga url en un iframe en menos de 60 segundos (funciona una sola vez) — @dcision/embed lo hace por ti.
Errores: 400 INVALID_REQUEST (un origen fuera de tu lista de permitidos, un start_path o un permiso inválidos), 403 FORBIDDEN (partner_disabled, key_without_author), 404 WORKSPACE_NOT_FOUND.
Revocar
| Solicitud | |
|---|---|
DELETE /v1/embed/sessions/{id} | 204: cierra una sesión |
POST /v1/embed/sessions/revoke | { "workspace"?, "user_id"? } → { "revoked": 3 }: cierra las sesiones activas de un sub-workspace y/o de uno de tus usuarios |
Una sesión cerrada o expirada muestra en el iframe un aviso para abrirla de nuevo desde tu app; @dcision/embed abre una nueva a través de tu backend.
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.
Webhook de entrada
POST /v1/hooks/{token} — ejecuta una decisión desplegada desde una URL secreta sin clave de API, desde formularios, CRM, Zapier, n8n, Make o cualquier backend, con firma opcional mediante un secreto whsec_.