Listar y obtener decisiones

GET /v1/decisions y GET /v1/decisions/{slug} — las decisiones del workspace de una clave de API y el contrato de la versión activa de cada una — más la delegación de GPT-Live de una decisión y su endpoint de respuestas.

GET https://api.dcision.io/v1/decisions
GET https://api.dcision.io/v1/decisions/{slug}

Dos endpoints de lectura le dicen a una integración —o a un agente a través del servidor MCP— qué decisiones existen y qué acepta y responde cada una, sin abrir la app. Solo muestran lo que expone la versión activa: un borrador que nunca se desplegó aparece en la lista, pero su schema sigue siendo privado hasta que lo despliegues.

Ambos usan las mismas claves de API que las decisiones, comparten la ventana de rate limit de lectura con GET /v1/me y GET /v1/executions, y no se facturan.

Otros dos endpoints conectan una decisión desplegada con una sesión de voz en tiempo real de OpenAI — consulta Delegación de GPT-Live.

Listar decisiones

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"
    }
  ]
}
CampoTipoDescripción
dataarrayLas decisiones del workspace, de la actualizada más recientemente a la más antigua.
data[].slugstringEl slug de la decisión: su endpoint, POST /v1/decisions/{slug}.
data[].namestringEl nombre de la decisión.
data[].descriptionstring o nullLa descripción de la decisión.
data[].statusstringdraft (nunca desplegada), deployed o disabled (endpoint desactivado).
data[].versioninteger o nullLa versión activa; null para un borrador.
data[].updated_atstringCuándo cambió la decisión por última vez, en ISO 8601.

Solo las decisiones deployed pueden ejecutarse: las demás responden 409 DECISION_NOT_DEPLOYED o 409 DECISION_DISABLED.

Obtener una decisión

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>" }
}
CampoTipoDescripción
slugstringEl slug de la decisión.
namestringEl nombre de la decisión.
descriptionstring o nullLa descripción de la decisión.
statusstringdraft, deployed o disabled.
versioninteger o nullLa versión activa; null para un borrador.
state_schemaobject o nullEl estado que acepta la versión activa, como JSON Schema: el contrato de la API del editor: { "type": "object", "required", "properties" }, { "type": "string" } para un estado de texto o { "type": "array", "items" } para un estado de lista. null para un borrador.
questionsarrayLas preguntas, en orden. Vacío para un borrador.
questions[].idstringLa clave de la pregunta: la clave de su respuesta en result y confidence.
questions[].typestringchoice, score o probability.
questions[].promptstring, object o arrayLas instrucciones de la pregunta, tal como están escritas en el schema.
questions[].optionsarrayLo que puede ser la respuesta: las opciones de una pregunta de elección, incluida other; las etiquetas de nivel de una pregunta de puntaje, de menor a mayor; ["yes", "no"] para una pregunta de probabilidad, cuyo result es la probabilidad de yes.
questions[].min_confidencenumberSolo cuando la pregunta tiene un minConfidence: por debajo de él, se aplica la acción de fallback.
compositesarraySolo para decisiones con compuestos: el id y la description de cada uno.
actionsarrayLas acciones que puede llevar una respuesta: continue, block, escalate y fallback. Vacío para un borrador.
fallback_actionstringLa acción para una respuesta other o una confianza baja; consulta Políticas y acciones. Ausente para un borrador.
example_stateanyUn estado de ejemplo con la forma correcta —strings como <field>, numbers como 1.5, integers como 1— para empezar. Reemplaza los valores antes de ejecutar. null para un borrador.

Un borrador responde 200 con version, state_schema y example_state en null y questions y actions vacíos. Las políticas, los destinos, la configuración y el context de la decisión nunca se devuelven.

Errores

EstadoCódigoCuándo
401INVALID_API_KEYLa clave falta, está mal formada, es desconocida o fue revocada.
404DECISION_NOT_FOUNDNo hay ninguna decisión con este slug en el workspace de la clave, o el slug está mal formado.
429RATE_LIMITEDDemasiadas solicitudes de lectura en el minuto actual.

Una clave solo ve las decisiones de su propio workspace.

Delegación de GPT-Live

GET  https://api.dcision.io/v1/decisions/{slug}/openai-live
POST https://api.dcision.io/v1/decisions/{slug}/openai-live/answers

Una sesión de GPT-Live (la voz en tiempo real de OpenAI) puede hacerle preguntas tipadas a OpenAI Decisions mientras el usuario habla. Estos dos endpoints hacen que pregunte las preguntas de tu decisión desplegada y ejecutan las políticas, los destinos y el log de ejecuciones de la decisión sobre las respuestas. La guía de GPT-Live muestra el flujo completo.

Exportar la delegación

GET /v1/decisions/{slug}/openai-live devuelve las preguntas de la versión activa en el formato de OpenAI Decisions, listas para ponerlas en la solicitud de la sesión como delegation. Usa la ventana de rate limit de lectura y no se factura.

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"
}
CampoTipoDescripción
decisionstringEl slug de la decisión.
versionintegerLa versión activa de la que vienen las preguntas.
delegation.typestringSiempre decisions.
delegation.modelstringEl modelo de OpenAI Decisions, gpt-6-luna.
delegation.questionsarrayLas preguntas, en orden, traducidas como para el motor OpenAI Decisions: predicate (probability), choice con choices (value, description) y score con levels (label, description). Cada una tiene un name — la clave de la pregunta — e instructions.
answers_urlstringAdónde enviar las respuestas: la ruta de POST /v1/decisions/{slug}/openai-live/answers.

Solo se exportan las preguntas: el context, las políticas y los destinos de la decisión se quedan en Dcision. Vuelve a exportar la delegación después de cada despliegue para que la sesión haga las preguntas de la nueva versión.

Enviar las respuestas

POST /v1/decisions/{slug}/openai-live/answers recibe las answers de un evento decision.completed de la sesión y devuelve la misma respuesta que POST /v1/decisions/{slug}. No se llama a ningún motor.

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 } ] }
      ] }'
CampoTipoDescripción
answersarrayObligatorio, de 1 a 200 elementos: las answers del evento decision.completed, tal como las envió OpenAI — predicate, choice, score o refusal, cada una con el name de la pregunta.
modelstringOpcional. El modelo que respondió; gpt-6-luna si falta. Se registra como metrics.model.
usageobjectOpcional. input_tokens y output_tokens de la decisión de la sesión, registrados con la ejecución.
stateanyOpcional. Contexto para los destinos y el log de ejecuciones — por ejemplo, el estado de la app durante la llamada. Se valida contra el esquema del estado de la decisión cuando se envía.

?include=probabilities añade las distribuciones completas, como en Ejecutar una decisión.

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
  }
}
  • Mismas reglas que una ejecución. Las políticas, las comprobaciones de rechazo, other y minConfidence, los compuestos y los destinos se ejecutan sobre las respuestas; action y action_reason significan lo mismo que en todas partes.
  • Se factura como una ejecución. Cada llamada cuenta para las decisiones incluidas en el plan y luego usa créditos. metrics.estimated_cost_usd es 0: OpenAI ya facturó la sesión Live.
  • Se registra como ejecución con origen API, motor openai y credencial live — aparece en Ejecuciones, en el Resumen de la decisión y en GET /v1/executions.
  • Usa la ventana de rate limit de decisiones. Idempotency-Key no está soportado: una llamada reintentada se ejecuta — y se factura — de nuevo.

Errores de los endpoints de GPT-Live

EstadoCódigoCuándo
400INVALID_REQUESTSin answers, más de 200, o respuestas que no coinciden con las preguntas desplegadas — falta una pregunta, una choice que no es una opción, un tipo de respuesta incorrecto.
401INVALID_API_KEYLa clave falta, está mal formada, es desconocida o fue revocada.
402CREDITS_EXHAUSTED, SPEND_CAP_REACHED, QUOTA_EXCEEDEDSolo en las respuestas, como en Ejecutar una decisión.
404DECISION_NOT_FOUNDNo hay ninguna decisión con este slug en el workspace de la clave.
409DECISION_NOT_DEPLOYEDLa decisión nunca se desplegó. Las respuestas también devuelven DECISION_DISABLED para un endpoint desactivado.
422INVALID_STATESolo en las respuestas: el state opcional no coincide con el esquema del estado.
429RATE_LIMITEDDemasiadas solicitudes en el minuto actual.

En esta página