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"
200 OK
{
  "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"
    }
  ]
}
CampoTipoDescrição
dataarrayAs decisões do workspace, das atualizadas mais recentemente para as mais antigas.
data[].slugstringO slug da decisão — o seu endpoint, POST /v1/decisions/{slug}.
data[].namestringO nome da decisão.
data[].descriptionstring ou nullA descrição da decisão.
data[].statusstringdraft (nunca publicada), deployed ou disabled (endpoint desligado).
data[].versioninteger ou nullA versão ativa; null para um rascunho.
data[].updated_atstringQuando 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"
200 OK
{
  "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>" }
}
CampoTipoDescrição
slugstringO slug da decisão.
namestringO nome da decisão.
descriptionstring ou nullA descrição da decisão.
statusstringdraft, deployed ou disabled.
versioninteger ou nullA versão ativa; null para um rascunho.
state_schemaobject ou nullO 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.
questionsarrayAs perguntas, em ordem. Vazio para um rascunho.
questions[].idstringA chave da pergunta — a chave da resposta dela em result e confidence.
questions[].typestringchoice, score ou probability.
questions[].promptstring, object ou arrayAs instruções da pergunta, como escritas no schema.
questions[].optionsarrayO 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_confidencenumberSó quando a pergunta tem um minConfidence: abaixo dele, vale a ação de fallback.
compositesarraySó para decisões com composites: o id e a description de cada um.
actionsarrayAs ações que uma resposta pode trazer: continue, block, escalate e fallback. Vazio para um rascunho.
fallback_actionstringA ação para uma resposta other ou baixa confiança — veja Políticas e ações. Ausente para um rascunho.
example_stateanyUm 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

StatusCódigoQuando
401INVALID_API_KEYA chave está ausente, malformada, é desconhecida ou foi revogada.
404DECISION_NOT_FOUNDNenhuma decisão com este slug no workspace da chave, ou um slug malformado.
429RATE_LIMITEDRequisiçõ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/answers

Uma 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"
200 OK
{
  "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"
}
CampoTipoDescrição
decisionstringO slug da decisão.
versionintegerA versão ativa de onde vêm as perguntas.
delegation.typestringSempre decisions.
delegation.modelstringO modelo da OpenAI Decisions, gpt-6-luna.
delegation.questionsarrayAs 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_urlstringPara 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 } ] }
      ] }'
CampoTipoDescrição
answersarrayObrigató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.
modelstringOpcional. O modelo que respondeu; gpt-6-luna quando ausente. Registrado como metrics.model.
usageobjectOpcional. input_tokens e output_tokens da decisão da sessão, registrados com a execução.
stateanyOpcional. 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.

200 OK
{
  "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, other e minConfidence, os composites e os destinos rodam sobre as respostas; action e action_reason significam 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 openai e credencial live — aparece em Execuções, na Visão geral da decisão e em GET /v1/executions.
  • Usa a janela de rate limit de decisões. Idempotency-Key não é suportado: uma chamada repetida roda — e é cobrada — de novo.

Erros dos endpoints do GPT-Live

StatusCódigoQuando
400INVALID_REQUESTSem 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.
401INVALID_API_KEYA chave está ausente, malformada, é desconhecida ou foi revogada.
402CREDITS_EXHAUSTED, SPEND_CAP_REACHED, QUOTA_EXCEEDEDSó nas respostas, como em Executar uma decisão.
404DECISION_NOT_FOUNDNenhuma decisão com este slug no workspace da chave.
409DECISION_NOT_DEPLOYEDA decisão nunca foi publicada. As respostas também devolvem DECISION_DISABLED para um endpoint desativado.
422INVALID_STATESó nas respostas: o state opcional não bate com o state schema.
429RATE_LIMITEDRequisições demais no minuto atual.

Nesta página