Listar ejecuciones
GET /v1/executions — ejecuciones recientes de tus decisiones con respuestas, acción, motivo y métricas, filtradas por decisión y estado y paginadas con un cursor. Las entradas nunca se devuelven.
GET https://api.dcision.io/v1/executionsLista las ejecuciones del workspace de la clave de API, las más recientes primero: las respuestas, la acción y el motivo de cada ejecución, los destinos, el estado y el código de error, y las métricas. Úsalo para monitorear un deploy, exportar resultados a tu data warehouse o calibrar umbrales con lo que realmente pasó.
Las entradas nunca se devuelven
El estado de una ejecución puede contener datos personales, por eso este endpoint nunca lo devuelve. Los miembros del workspace pueden ver las entradas guardadas en la pantalla Ejecuciones de la app.
Solicitud
Parámetros de consulta
| Parámetro | Descripción |
|---|---|
limit | Ejecuciones por página, de 1 a 100. Por defecto 20. |
decision | Solo las ejecuciones de la decisión con este slug. |
status | success o error. |
cursor | El next_cursor de la página anterior, para leer la siguiente. |
Un valor no válido falla con 400 INVALID_REQUEST; por ejemplo, limit=1000 o un cursor mal formado.
curl "https://api.dcision.io/v1/executions?decision=lead-qualification&status=error&limit=50" \
-H "Authorization: Bearer $DCISION_API_KEY"Respuesta
{
"data": [
{
"execution_id": "exec_8HsT2kQw9ZyR4vMn1cXe",
"decision": "lead-qualification",
"version": 1,
"source": "api",
"status": "success",
"error_code": null,
"result": { "purchase_intent": 0.9412, "priority": "high", "route": "sales" },
"confidence": { "purchase_intent": 0.8824, "priority": 0.69, "route": 0.85 },
"action": "continue",
"action_reason": { "type": "default" },
"destinations": [
{ "key": "sales_crm", "type": "workflow", "status": "queued", "delivery_id": "dlv_8kJx2mQp4LzN7vR1tY6w" }
],
"metrics": { "latency_ms": 412, "engine": "jev", "model": "jev-1.13.0", "estimated_cost_usd": 0.00001575 },
"created_at": "2026-10-05T14:03:27.512Z"
},
{
"execution_id": "exec_2Lm7Qw4Xz9Tk1Rb6Vn3C",
"decision": "lead-qualification",
"version": 1,
"source": "api",
"status": "error",
"error_code": "INVALID_STATE",
"result": null,
"confidence": null,
"action": null,
"action_reason": null,
"destinations": null,
"metrics": { "latency_ms": 2, "engine": "jev", "model": null, "estimated_cost_usd": 0 },
"created_at": "2026-10-05T14:01:09.880Z"
}
],
"next_cursor": "exec_2Lm7Qw4Xz9Tk1Rb6Vn3C"
}| Campo | Tipo | Descripción |
|---|---|---|
data | array | Las ejecuciones de esta página, las más recientes primero. |
data[].execution_id | string | El ID de la ejecución: el execution_id que devolvió su respuesta. |
data[].decision | string | El slug de la decisión. |
data[].version | integer o null | La versión que se ejecutó; null para las ejecuciones del Playground, que usan el borrador. |
data[].source | string | api, webhook (una llamada a la URL de webhook de la decisión) o playground. |
data[].status | string | success o error. |
data[].error_code | string o null | El código de error de una ejecución fallida. |
data[].result | object o null | Las respuestas, indexadas por pregunta. null en ejecuciones fallidas y cuando storeOutput de la decisión está desactivado. |
data[].confidence | object o null | La confianza de cada respuesta, con las mismas reglas que result. |
data[].action | string o null | La acción devuelta; null en ejecuciones fallidas. |
data[].action_reason | object o null | Por qué se eligió esa acción. |
data[].output | object | La salida estructurada de la ejecución; presente solo cuando se generó una y storeOutput de la decisión está activado. |
data[].destinations | array o null | Las entradas de destinos que devolvió la ejecución: respuestas, respuestas de LLM y de agentes, funciones, entregas encoladas con su delivery_id, destinos omitidos. null cuando ninguno se disparó. Una entrada encolada conserva el estado que tenía cuando la ejecución respondió: el progreso de la entrega está en la app. |
data[].metrics | object | latency_ms, engine, model y estimated_cost_usd de la ejecución. |
data[].created_at | string | Cuándo ocurrió la ejecución, en ISO 8601. |
next_cursor | string o null | Pásalo como cursor para leer la página siguiente; null en la última página. |
Las ejecuciones fallidas también se listan —estados no válidos, errores del motor— para que veas lo que envía tu integración. Una ejecución respondida con el fallback por error del motor aparece con estado error y el código de error del motor, aunque la llamada en sí haya devuelto 200.
Solo se listan las ejecuciones que siguen dentro de tu retención de logs.
Las entradas de destinos pueden contener datos personales
El estado en sí nunca se devuelve, pero destinations se conserva tal como lo devolvió la ejecución, sean cuales sean los ajustes storeInput y storeOutput de la decisión: incluidos los params de funciones mapeados desde el estado, las respuestas fijas, los textos de LLM y las respuestas de agentes. Las salidas estructuradas son la excepción: con storeOutput desactivado, su objeto se vacía. Mapea en los params solo los valores que tu código necesita.
Paginar
async function* executions(params = {}) {
let cursor;
do {
const query = new URLSearchParams({ limit: "100", ...params, ...(cursor ? { cursor } : {}) });
const page = await fetch(`https://api.dcision.io/v1/executions?${query}`, {
headers: { Authorization: `Bearer ${process.env.DCISION_API_KEY}` },
}).then((response) => response.json());
yield* page.data;
cursor = page.next_cursor;
} while (cursor);
}
for await (const run of executions({ decision: "voice-banking", status: "success" })) {
console.log(run.created_at, run.result?.intent, run.confidence?.intent, run.action);
}Errores
| Estado | Código | Cuándo |
|---|---|---|
| 400 | INVALID_REQUEST | Un parámetro de consulta no es válido: limit fuera de 1–100, un slug de decision, un status o un cursor mal formado. |
| 401 | INVALID_API_KEY | La clave falta, está mal formada, es desconocida o fue revocada. |
| 429 | RATE_LIMITED | Demasiadas solicitudes de lectura en el minuto actual. |
GET /v1/executions comparte la ventana de rate limit de lectura con GET /v1/me, separada de la de las decisiones. Una clave solo ve las ejecuciones de su propio workspace.
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.
API de subespacios
POST, GET, PATCH y DELETE /v1/workspaces — subespacios del modo socio, uno por cliente de tu app, identificados por tu external_id — y POST /v1/decisions/{slug}/move.