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.
Só no modo parceiro (guia). Chame do seu servidor com a sua API key.
POST https://api.dcision.io/v1/embed/sessions| Campo | Tipo | |
|---|---|---|
workspace | string ou object | ext:<external_id> / o id do sub-workspace, ou { "external_id", "name", … } para criá-lo na hora (mesmos campos de POST /v1/workspaces) |
user | object | Obrigatório. { "id", "name"?, "email"? } — o seu usuário final |
permissions | string[] | Padrão: todas. decisions:read, decisions:write, decisions:deploy, decisions:delete, executions:read, agent |
start_path | string | /decisions (padrão), /decisions/new ou /decisions/{id}[/editor|builder|playground|deploy|executions] |
origins | string[] | Um subconjunto das suas origens permitidas (padrão: todas). Sessões de chaves de teste também podem usar uma origem local de desenvolvimento |
locale | string | en, pt, es, ru ou zh |
theme | string | light, dark ou system |
ttl_seconds | integer | 300–43 200 (padrão 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, "…": "…" }
}Carregue url num iframe em até 60 segundos (funciona uma única vez) — o @dcision/embed faz isso por você.
Erros: 400 INVALID_REQUEST (uma origem fora da sua lista de permitidas, um start_path ou permissão inválidos), 403 FORBIDDEN (partner_disabled, key_without_author), 404 WORKSPACE_NOT_FOUND.
Revogar
| Requisição | |
|---|---|
DELETE /v1/embed/sessions/{id} | 204: encerra uma sessão |
POST /v1/embed/sessions/revoke | { "workspace"?, "user_id"? } → { "revoked": 3 }: encerra as sessões ativas de um sub-workspace e/ou de um dos seus usuários |
Uma sessão encerrada ou expirada mostra "reopen from your app" no iframe; o @dcision/embed abre uma nova pelo seu backend.
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.
Webhook de entrada
POST /v1/hooks/{token} — rode uma decisão publicada a partir de uma URL secreta, sem API key, de formulários, CRMs, Zapier, n8n, Make ou qualquer backend, opcionalmente assinada com um segredo whsec_.