Sub-workspaces
Um sub-workspace por cliente do seu app, pelo seu próprio id — crie, copie suas decisões para ele, rode-as com Dcision-Workspace, limite e acompanhe o uso.
Um sub-workspace guarda as decisões de um cliente. Você o identifica pelo seu id do cliente (external_id, por exemplo o id do workspace ou da conta no seu sistema), então nunca precisa guardar ids da Dcision.
Criar um
POST /v1/workspaces cria o sub-workspace para um external_id, ou o atualiza quando ele já existe — chame-o toda vez que um cliente ligar o recurso.
curl https://api.dcision.io/v1/workspaces \
-H "Authorization: Bearer $DCISION_API_KEY" -H "Content-Type: application/json" \
-d '{
"external_id": "acme",
"name": "Acme Inc",
"seed": { "decisions": ["lead-qualification"], "deploy": true }
}'seed copia a versão publicada das suas próprias decisões para o novo sub-workspace, com os mesmos slugs — assim cada cliente começa da sua decisão que já funciona e depois pode alterá-la. Ele só roda quando o sub-workspace é criado; a resposta lista o que foi copiado e o que foi pulado.
Rodar a decisão de um cliente
Envie a sua API key com o header Dcision-Workspace: ext:<external_id> (ou o id do sub-workspace):
curl https://api.dcision.io/v1/decisions/lead-qualification \
-H "Authorization: Bearer $DCISION_API_KEY" \
-H "Dcision-Workspace: ext:acme" \
-H "Content-Type: application/json" \
-d '{ "state": { "message": "Can you send pricing for 500 seats?" } }'O mesmo header funciona em GET /v1/decisions, GET /v1/me, GET /v1/executions e no servidor MCP. Um sub-workspace que não é seu responde 404 WORKSPACE_NOT_FOUND. Os SDKs o recebem como opção:
const acme = dcision.withWorkspace("ext:acme");
await acme.decide("lead-qualification", { message: "Pricing?" });A idempotência é por sub-workspace: o mesmo Idempotency-Key enviado para dois clientes é um conflito (409), nunca a resposta guardada de outro cliente.
Cobrança e limites
- Toda execução cobrável de um sub-workspace conta no uso, no plano e na carteira do seu workspace; os rate limits também são os do seu workspace.
- Limites por cliente (em Configurações → Parceiro, ou
limitsno sub-workspace):max_decisions(402 PLAN_LIMIT_REACHEDcomscope: "workspace") emonthly_decisionspor ciclo de cobrança (402 QUOTA_EXCEEDEDcomscope: "workspace"). GET /v1/mecom o header acrescentaworkspace_usage— as execuções do cliente no ciclo e o limite dele.- Sub-workspaces rodam nas suas configurações e chaves de engine. Os destinos LLM e JSON deles usam as suas chaves de LLM só se você permitir; segredos do workspace nunca são compartilhados.
Mover uma das suas decisões para ele
Uma decisão que você construiu no seu próprio workspace pode ir para o sub-workspace de um cliente com o histórico (versões, execuções, entregas, chat com o agente) — POST /v1/decisions/{slug}/move com { "to": "ext:acme" }, ou ⋯ → Mover para um sub-workspace no app (Proprietários e Admins). Se o sub-workspace tiver uma cópia intocada com o mesmo slug (vinda de seed), replace_empty: true a substitui. Depois, chame a decisão com Dcision-Workspace.
Ver as decisões de um cliente no app
Configurações → Parceiro → Abrir mostra as decisões de um sub-workspace dentro do app da Dcision — as mesmas telas que os seus clientes veem no seu. Membros do seu workspace as editam; Leitores só leem.
Excluir
DELETE /v1/workspaces/ext:acme remove o sub-workspace com todas as decisões e execuções dele. O uso já cobrado fica no seu workspace.
Parceiros
Ofereça a Dcision dentro do seu próprio app — um sub-workspace por cliente, um editor incorporável para os seus usuários finais e o uso cobrado no seu workspace.
Incorporar o editor
Deixe os seus clientes criarem, editarem, testarem e publicarem as decisões deles dentro do seu app — sessões de embed pelo seu backend, o script @dcision/embed, permissões e eventos.