Listar e obter decisões
GET /v1/decisions e GET /v1/decisions/{slug} — as decisões do workspace de uma API key e o contrato da versão ativa de cada uma — mais a delegação de uma decisão para o GPT-Live e o endpoint das respostas.
GET https://api.dcision.io/v1/decisions
GET https://api.dcision.io/v1/decisions/{slug}Dois endpoints de leitura informam a uma integração — ou a um agente, pelo servidor MCP — quais decisões existem e o que cada uma aceita e responde, sem abrir o app. Eles mostram só o que a versão ativa expõe: um rascunho que nunca foi publicado aparece na lista, mas o schema dele fica privado até você publicá-lo.
Os dois usam as mesmas API keys das decisões, compartilham a janela de rate limit de leitura com GET /v1/me e GET /v1/executions, e não são cobrados.
Outros dois endpoints ligam uma decisão publicada a uma sessão de voz em tempo real da OpenAI — veja Delegação do GPT-Live.
Listar decisões
curl https://api.dcision.io/v1/decisions \
-H "Authorization: Bearer $DCISION_API_KEY"{
"data": [
{
"slug": "lead-qualification",
"name": "Lead Qualification",
"description": "Qualify inbound leads and route them to the right team.",
"status": "deployed",
"version": 3,
"updated_at": "2026-10-05T13:41:09.204Z"
},
{
"slug": "chat-triage",
"name": "Chat triage",
"description": null,
"status": "draft",
"version": null,
"updated_at": "2026-10-04T18:02:55.731Z"
}
]
}| Campo | Tipo | Descrição |
|---|---|---|
data | array | As decisões do workspace, das atualizadas mais recentemente para as mais antigas. |
data[].slug | string | O slug da decisão — o seu endpoint, POST /v1/decisions/{slug}. |
data[].name | string | O nome da decisão. |
data[].description | string ou null | A descrição da decisão. |
data[].status | string | draft (nunca publicada), deployed ou disabled (endpoint desligado). |
data[].version | integer ou null | A versão ativa; null para um rascunho. |
data[].updated_at | string | Quando a decisão mudou pela última vez, em ISO 8601. |
Só decisões deployed podem rodar: as outras respondem 409 DECISION_NOT_DEPLOYED ou 409 DECISION_DISABLED.
Obter uma decisão
curl https://api.dcision.io/v1/decisions/lead-qualification \
-H "Authorization: Bearer $DCISION_API_KEY"{
"slug": "lead-qualification",
"name": "Lead Qualification",
"description": "Qualify inbound leads and route them to the right team.",
"status": "deployed",
"version": 3,
"state_schema": {
"type": "object",
"required": ["message"],
"properties": {
"message": { "type": "string", "description": "Inbound lead message" },
"company_size": { "type": "number", "description": "Employee count" },
"source": { "type": "string", "description": "website, referral, ads" }
}
},
"questions": [
{
"id": "purchase_intent",
"type": "probability",
"prompt": "Does this lead have real intent to buy in the next 30 days?",
"options": ["yes", "no"]
},
{
"id": "priority",
"type": "score",
"prompt": "How urgent is it to answer this lead?",
"options": ["low", "medium", "high", "critical"]
},
{
"id": "route",
"type": "choice",
"prompt": "Which team should receive this lead?",
"options": ["sales", "sdr", "nurture", "spam", "other"]
}
],
"composites": [
{ "id": "lead_score", "description": "0–1 ranking: intent counts double, priority adds, spam-like routes don't count" }
],
"actions": ["continue", "block", "escalate", "fallback"],
"fallback_action": "escalate",
"example_state": { "message": "<message>", "company_size": 1.5, "source": "<source>" }
}| Campo | Tipo | Descrição |
|---|---|---|
slug | string | O slug da decisão. |
name | string | O nome da decisão. |
description | string ou null | A descrição da decisão. |
status | string | draft, deployed ou disabled. |
version | integer ou null | A versão ativa; null para um rascunho. |
state_schema | object ou null | O estado que a versão ativa aceita, como JSON Schema — o contrato de API do editor: { "type": "object", "required", "properties" }, { "type": "string" } para um estado de texto ou { "type": "array", "items" } para um estado de lista. null para um rascunho. |
questions | array | As perguntas, em ordem. Vazio para um rascunho. |
questions[].id | string | A chave da pergunta — a chave da resposta dela em result e confidence. |
questions[].type | string | choice, score ou probability. |
questions[].prompt | string, object ou array | As instruções da pergunta, como escritas no schema. |
questions[].options | array | O que a resposta pode ser: as opções de uma pergunta de escolha, other incluída; os rótulos dos níveis de uma pergunta de nota, do mais baixo para o mais alto; ["yes", "no"] para uma pergunta de probabilidade, cujo result é a probabilidade de sim. |
questions[].min_confidence | number | Só quando a pergunta tem um minConfidence: abaixo dele, vale a ação de fallback. |
composites | array | Só para decisões com composites: o id e a description de cada um. |
actions | array | As ações que uma resposta pode trazer: continue, block, escalate e fallback. Vazio para um rascunho. |
fallback_action | string | A ação para uma resposta other ou baixa confiança — veja Políticas e ações. Ausente para um rascunho. |
example_state | any | Um estado de exemplo com o formato certo — strings como <field>, números como 1.5, inteiros como 1 — para servir de ponto de partida. Substitua os valores antes de executar. null para um rascunho. |
Um rascunho responde 200 com version, state_schema e example_state iguais a null e questions e actions vazios. Políticas, destinos, configurações e o context da decisão nunca são devolvidos.
Erros
| Status | Código | Quando |
|---|---|---|
| 401 | INVALID_API_KEY | A chave está ausente, malformada, é desconhecida ou foi revogada. |
| 404 | DECISION_NOT_FOUND | Nenhuma decisão com este slug no workspace da chave, ou um slug malformado. |
| 429 | RATE_LIMITED | Requisições de leitura demais no minuto atual. |
Uma chave só vê as decisões do seu próprio workspace.
Delegação do GPT-Live
GET https://api.dcision.io/v1/decisions/{slug}/openai-live
POST https://api.dcision.io/v1/decisions/{slug}/openai-live/answersUma sessão do GPT-Live (a voz em tempo real da OpenAI) pode fazer perguntas tipadas à OpenAI Decisions enquanto o usuário fala. Esses dois endpoints fazem a sessão perguntar as perguntas da sua decisão publicada e rodam as políticas, os destinos e o log de execuções da decisão sobre as respostas. O guia do GPT-Live mostra o fluxo completo.
Exporte a delegação
GET /v1/decisions/{slug}/openai-live devolve as perguntas da versão ativa no formato da OpenAI Decisions, prontas para entrar na requisição da sessão como delegation. Usa a janela de rate limit de leitura e não é cobrado.
curl https://api.dcision.io/v1/decisions/lead-qualification/openai-live \
-H "Authorization: Bearer $DCISION_API_KEY"{
"decision": "lead-qualification",
"version": 3,
"delegation": {
"type": "decisions",
"model": "gpt-6-luna",
"questions": [
{
"type": "predicate",
"name": "purchase_intent",
"instructions": "Does this lead have real intent to buy in the next 30 days?\n\nTrue when: asks for pricing, a demo, a quote or a start date\nFalse when: just browsing, student, vendor or spam"
},
{
"type": "score",
"name": "priority",
"instructions": "How urgent is it to answer this lead?",
"levels": [{ "label": "low" }, { "label": "medium" }, { "label": "high" }, { "label": "critical" }]
},
{
"type": "choice",
"name": "route",
"instructions": "Which team should receive this lead?",
"choices": [
{ "value": "sales", "description": "high intent, ready to talk to sales" },
{ "value": "sdr", "description": "some intent, needs qualification" },
{ "value": "nurture", "description": "early stage, send content" },
{ "value": "spam", "description": "spam, vendor pitch or irrelevant" },
{ "value": "other", "description": "none of the options above" }
]
}
]
},
"answers_url": "/v1/decisions/lead-qualification/openai-live/answers"
}| Campo | Tipo | Descrição |
|---|---|---|
decision | string | O slug da decisão. |
version | integer | A versão ativa de onde vêm as perguntas. |
delegation.type | string | Sempre decisions. |
delegation.model | string | O modelo da OpenAI Decisions, gpt-6-luna. |
delegation.questions | array | As perguntas, em ordem, traduzidas como para o engine OpenAI Decisions: predicate (probability), choice com choices (value, description) e score com levels (label, description). Cada uma tem um name — a chave da pergunta — e instructions. |
answers_url | string | Para onde enviar as respostas: o path de POST /v1/decisions/{slug}/openai-live/answers. |
Só as perguntas são exportadas: o context, as políticas e os destinos da decisão ficam na Dcision. Exporte a delegação de novo depois de cada deploy, para que a sessão faça as perguntas da nova versão.
Envie as respostas
POST /v1/decisions/{slug}/openai-live/answers recebe as answers de um evento decision.completed da sessão e devolve a mesma resposta de POST /v1/decisions/{slug}. Nenhum engine é chamado.
curl -X POST https://api.dcision.io/v1/decisions/lead-qualification/openai-live/answers \
-H "Authorization: Bearer $DCISION_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "model": "gpt-6-luna", "answers": [
{ "type": "predicate", "name": "purchase_intent", "probability": 0.92 },
{ "type": "score", "name": "priority", "score": 2.03, "probabilities": [
{ "value": 0, "label": "low", "probability": 0.02 }, { "value": 1, "label": "medium", "probability": 0.1 },
{ "value": 2, "label": "high", "probability": 0.71 }, { "value": 3, "label": "critical", "probability": 0.17 } ] },
{ "type": "choice", "name": "route", "choice": "sales", "probabilities": [
{ "value": "sales", "probability": 0.9 }, { "value": "sdr", "probability": 0.07 }, { "value": "other", "probability": 0.03 } ] }
] }'| Campo | Tipo | Descrição |
|---|---|---|
answers | array | Obrigatório, de 1 a 200 itens: as answers do evento decision.completed, como a OpenAI as enviou — predicate, choice, score ou refusal, cada uma com o name da pergunta. |
model | string | Opcional. O modelo que respondeu; gpt-6-luna quando ausente. Registrado como metrics.model. |
usage | object | Opcional. input_tokens e output_tokens da decisão da sessão, registrados com a execução. |
state | any | Opcional. Contexto para os destinos e o log de execuções — por exemplo, o estado do app durante a chamada. Validado contra o state schema da decisão quando enviado. |
?include=probabilities acrescenta as distribuições completas, como em Executar uma decisão.
{
"decision_id": "dec_3fKq9ZtW1mXcV7bN2pLa",
"execution_id": "exec_Lv7Qm2Xc9Tn4Rb8Wk1Pz",
"schema": "lead-qualification",
"version": 3,
"result": { "purchase_intent": 0.92, "priority": "high", "route": "sales" },
"confidence": { "purchase_intent": 0.84, "priority": 0.69, "route": 0.875 },
"scores": { "priority": 3.03 },
"composites": { "lead_score": 0.8542 },
"action": "continue",
"action_reason": { "type": "default" },
"metrics": {
"latency_ms": 38,
"engine": "openai",
"model": "gpt-6-luna",
"estimated_cost_usd": 0,
"input_tokens": 0,
"output_tokens": 0
}
}- Mesmas regras de uma execução. Políticas, as checagens de recusa,
othereminConfidence, os composites e os destinos rodam sobre as respostas;actioneaction_reasonsignificam o mesmo que em qualquer lugar. - Cobrado como uma execução. Cada chamada conta para as decisões incluídas no plano e depois usa créditos.
metrics.estimated_cost_usdé0: a OpenAI já cobrou a sessão Live. - Registrado como execução com origem API, engine
openaie credencial live — aparece em Execuções, na Visão geral da decisão e emGET /v1/executions. - Usa a janela de rate limit de decisões.
Idempotency-Keynão é suportado: uma chamada repetida roda — e é cobrada — de novo.
Erros dos endpoints do GPT-Live
| Status | Código | Quando |
|---|---|---|
| 400 | INVALID_REQUEST | Sem answers, mais de 200, ou respostas que não batem com as perguntas publicadas — uma pergunta faltando, uma choice que não é uma opção, um tipo de resposta errado. |
| 401 | INVALID_API_KEY | A chave está ausente, malformada, é desconhecida ou foi revogada. |
| 402 | CREDITS_EXHAUSTED, SPEND_CAP_REACHED, QUOTA_EXCEEDED | Só nas respostas, como em Executar uma decisão. |
| 404 | DECISION_NOT_FOUND | Nenhuma decisão com este slug no workspace da chave. |
| 409 | DECISION_NOT_DEPLOYED | A decisão nunca foi publicada. As respostas também devolvem DECISION_DISABLED para um endpoint desativado. |
| 422 | INVALID_STATE | Só nas respostas: o state opcional não bate com o state schema. |
| 429 | RATE_LIMITED | Requisições demais no minuto atual. |
Executar uma decisão
POST /v1/decisions/{slug} — path, query, headers, corpo da requisição, todos os campos da resposta e os erros, com exemplos em cURL, JavaScript e Python.
Obter conta e uso
GET /v1/me — o workspace, a API key e o plano por trás de uma chave, mais o uso deste período de cobrança. Verifique uma chave no CI e acompanhe a sua cota pelo código.