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"{
"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 | Descripción |
|---|---|---|
data | array | Las decisiones del workspace, de la actualizada más recientemente a la más antigua. |
data[].slug | string | El slug de la decisión: su endpoint, POST /v1/decisions/{slug}. |
data[].name | string | El nombre de la decisión. |
data[].description | string o null | La descripción de la decisión. |
data[].status | string | draft (nunca desplegada), deployed o disabled (endpoint desactivado). |
data[].version | integer o null | La versión activa; null para un borrador. |
data[].updated_at | string | Cuá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"{
"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 | Descripción |
|---|---|---|
slug | string | El slug de la decisión. |
name | string | El nombre de la decisión. |
description | string o null | La descripción de la decisión. |
status | string | draft, deployed o disabled. |
version | integer o null | La versión activa; null para un borrador. |
state_schema | object o null | El 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. |
questions | array | Las preguntas, en orden. Vacío para un borrador. |
questions[].id | string | La clave de la pregunta: la clave de su respuesta en result y confidence. |
questions[].type | string | choice, score o probability. |
questions[].prompt | string, object o array | Las instrucciones de la pregunta, tal como están escritas en el schema. |
questions[].options | array | Lo 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_confidence | number | Solo cuando la pregunta tiene un minConfidence: por debajo de él, se aplica la acción de fallback. |
composites | array | Solo para decisiones con compuestos: el id y la description de cada uno. |
actions | array | Las acciones que puede llevar una respuesta: continue, block, escalate y fallback. Vacío para un borrador. |
fallback_action | string | La acción para una respuesta other o una confianza baja; consulta Políticas y acciones. Ausente para un borrador. |
example_state | any | Un 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
| Estado | Código | Cuándo |
|---|---|---|
| 401 | INVALID_API_KEY | La clave falta, está mal formada, es desconocida o fue revocada. |
| 404 | DECISION_NOT_FOUND | No hay ninguna decisión con este slug en el workspace de la clave, o el slug está mal formado. |
| 429 | RATE_LIMITED | Demasiadas 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/answersUna 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"{
"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 | Descripción |
|---|---|---|
decision | string | El slug de la decisión. |
version | integer | La versión activa de la que vienen las preguntas. |
delegation.type | string | Siempre decisions. |
delegation.model | string | El modelo de OpenAI Decisions, gpt-6-luna. |
delegation.questions | array | Las 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_url | string | Adó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 } ] }
] }'| Campo | Tipo | Descripción |
|---|---|---|
answers | array | Obligatorio, 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. |
model | string | Opcional. El modelo que respondió; gpt-6-luna si falta. Se registra como metrics.model. |
usage | object | Opcional. input_tokens y output_tokens de la decisión de la sesión, registrados con la ejecución. |
state | any | Opcional. 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.
{
"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,
otheryminConfidence, los compuestos y los destinos se ejecutan sobre las respuestas;actionyaction_reasonsignifican 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_usdes0: OpenAI ya facturó la sesión Live. - Se registra como ejecución con origen API, motor
openaiy credencial live — aparece en Ejecuciones, en el Resumen de la decisión y enGET /v1/executions. - Usa la ventana de rate limit de decisiones.
Idempotency-Keyno está soportado: una llamada reintentada se ejecuta — y se factura — de nuevo.
Errores de los endpoints de GPT-Live
| Estado | Código | Cuándo |
|---|---|---|
| 400 | INVALID_REQUEST | Sin 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. |
| 401 | INVALID_API_KEY | La clave falta, está mal formada, es desconocida o fue revocada. |
| 402 | CREDITS_EXHAUSTED, SPEND_CAP_REACHED, QUOTA_EXCEEDED | Solo en las respuestas, como en Ejecutar una decisión. |
| 404 | DECISION_NOT_FOUND | No hay ninguna decisión con este slug en el workspace de la clave. |
| 409 | DECISION_NOT_DEPLOYED | La decisión nunca se desplegó. Las respuestas también devuelven DECISION_DISABLED para un endpoint desactivado. |
| 422 | INVALID_STATE | Solo en las respuestas: el state opcional no coincide con el esquema del estado. |
| 429 | RATE_LIMITED | Demasiadas solicitudes en el minuto actual. |
Ejecutar una decisión
POST /v1/decisions/{slug} — ruta, query, encabezados, cuerpo de la solicitud, cada campo de la respuesta y los errores, con ejemplos en cURL, JavaScript y Python.
Obtener cuenta y uso
GET /v1/me — el workspace, la clave de API y el plan detrás de una clave, más el uso de este período de facturación. Verifica una clave en CI y vigila tu cuota desde el código.