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/executions

Lista 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ámetroDescripción
limitEjecuciones por página, de 1 a 100. Por defecto 20.
decisionSolo las ejecuciones de la decisión con este slug.
statussuccess o error.
cursorEl 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

200 OK
{
  "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"
}
CampoTipoDescripción
dataarrayLas ejecuciones de esta página, las más recientes primero.
data[].execution_idstringEl ID de la ejecución: el execution_id que devolvió su respuesta.
data[].decisionstringEl slug de la decisión.
data[].versioninteger o nullLa versión que se ejecutó; null para las ejecuciones del Playground, que usan el borrador.
data[].sourcestringapi, webhook (una llamada a la URL de webhook de la decisión) o playground.
data[].statusstringsuccess o error.
data[].error_codestring o nullEl código de error de una ejecución fallida.
data[].resultobject o nullLas respuestas, indexadas por pregunta. null en ejecuciones fallidas y cuando storeOutput de la decisión está desactivado.
data[].confidenceobject o nullLa confianza de cada respuesta, con las mismas reglas que result.
data[].actionstring o nullLa acción devuelta; null en ejecuciones fallidas.
data[].action_reasonobject o nullPor qué se eligió esa acción.
data[].outputobjectLa salida estructurada de la ejecución; presente solo cuando se generó una y storeOutput de la decisión está activado.
data[].destinationsarray o nullLas 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[].metricsobjectlatency_ms, engine, model y estimated_cost_usd de la ejecución.
data[].created_atstringCuándo ocurrió la ejecución, en ISO 8601.
next_cursorstring o nullPá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

EstadoCódigoCuándo
400INVALID_REQUESTUn parámetro de consulta no es válido: limit fuera de 1–100, un slug de decision, un status o un cursor mal formado.
401INVALID_API_KEYLa clave falta, está mal formada, es desconocida o fue revocada.
429RATE_LIMITEDDemasiadas 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.

En esta página