Listar execuções
GET /v1/executions — execuções recentes das suas decisões com respostas, ação, motivo e métricas, filtradas por decisão e status e paginadas com um cursor. Entradas nunca são devolvidas.
GET https://api.dcision.io/v1/executionsLista as execuções do workspace da API key, das mais recentes para as mais antigas: as respostas, a ação e o motivo de cada execução, os destinos, o status e o código de erro, e as métricas. Use-o para monitorar um deploy, exportar resultados para o seu data warehouse ou calibrar limiares em relação ao que realmente aconteceu.
Entradas nunca são devolvidas
O estado de uma execução pode conter dados pessoais, então este endpoint nunca o devolve. Membros do workspace podem ver as entradas guardadas na tela Execuções do app.
Requisição
Parâmetros de query
| Parâmetro | Descrição |
|---|---|
limit | Execuções por página, de 1 a 100. Padrão 20. |
decision | Só as execuções da decisão com este slug. |
status | success ou error. |
cursor | O next_cursor da página anterior, para ler a próxima. |
Um valor inválido falha com 400 INVALID_REQUEST — por exemplo limit=1000 ou um cursor malformado.
curl "https://api.dcision.io/v1/executions?decision=lead-qualification&status=error&limit=50" \
-H "Authorization: Bearer $DCISION_API_KEY"Resposta
{
"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 | Descrição |
|---|---|---|
data | array | As execuções desta página, das mais recentes para as mais antigas. |
data[].execution_id | string | O ID da execução — o execution_id que a sua resposta devolveu. |
data[].decision | string | O slug da decisão. |
data[].version | integer ou null | A versão que rodou; null para execuções do Playground, que usam o rascunho. |
data[].source | string | api, webhook (uma chamada à URL de webhook da decisão) ou playground. |
data[].status | string | success ou error. |
data[].error_code | string ou null | O código de erro de uma execução que falhou. |
data[].result | object ou null | As respostas, indexadas por pergunta. null para execuções que falharam e quando o storeOutput da decisão está desligado. |
data[].confidence | object ou null | A confiança de cada resposta, com as mesmas regras de result. |
data[].action | string ou null | A ação devolvida; null para execuções que falharam. |
data[].action_reason | object ou null | Por que aquela ação foi escolhida. |
data[].output | object | A saída estruturada da execução — presente só quando uma foi montada e o storeOutput da decisão está ligado. |
data[].destinations | array ou null | As entradas de destino que a execução devolveu — respostas fixas, respostas de LLM e de agentes, funções, entregas na fila com o seu delivery_id, destinos pulados. null quando nenhum disparou. Uma entrada na fila mantém o status que tinha quando a execução respondeu: o andamento da entrega fica no app. |
data[].metrics | object | latency_ms, engine, model e estimated_cost_usd da execução. |
data[].created_at | string | Quando a execução aconteceu, em ISO 8601. |
next_cursor | string ou null | Passe-o como cursor para ler a próxima página; null na última página. |
Execuções que falharam também são listadas — estados inválidos, erros do engine —, para que você veja o que a sua integração envia. Uma execução respondida com o fallback de erro do engine aparece com status error e o código de erro do engine, mesmo que a própria chamada tenha devolvido 200.
Só são listadas as execuções que ainda estão dentro da sua retenção de logs.
Entradas de destino podem conter dados pessoais
O estado em si nunca é devolvido, mas destinations é mantido como a execução o devolveu — quaisquer que sejam as configurações storeInput e storeOutput da decisão: params de função mapeados a partir do estado, respostas fixas, textos de LLM e respostas de agentes incluídos. Saídas estruturadas são a exceção: com storeOutput desligado, o objeto delas é esvaziado. Mapeie para params só os valores de que o seu código precisa.
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);
}Erros
| Status | Código | Quando |
|---|---|---|
| 400 | INVALID_REQUEST | Um parâmetro de query é inválido: limit fora de 1–100, um slug de decision, um status ou um cursor malformado. |
| 401 | INVALID_API_KEY | A chave está ausente, malformada, é desconhecida ou foi revogada. |
| 429 | RATE_LIMITED | Requisições de leitura demais no minuto atual. |
GET /v1/executions compartilha a janela de rate limit de leitura com GET /v1/me, separada da das decisões. Uma chave só vê as execuções do seu próprio workspace.
Obter conta e uso
GET /v1/me — o workspace, a API key e o plano por trás de uma chave, mais o uso deste período de cobrança. Verifique uma chave no CI e acompanhe a sua cota pelo código.
API de sub-workspaces
POST, GET, PATCH e DELETE /v1/workspaces — os sub-workspaces do modo parceiro, um por cliente do seu app, endereçados pelo seu external_id — e POST /v1/decisions/{slug}/move.