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

Lista 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âmetroDescrição
limitExecuções por página, de 1 a 100. Padrão 20.
decisionSó as execuções da decisão com este slug.
statussuccess ou error.
cursorO 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

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"
}
CampoTipoDescrição
dataarrayAs execuções desta página, das mais recentes para as mais antigas.
data[].execution_idstringO ID da execução — o execution_id que a sua resposta devolveu.
data[].decisionstringO slug da decisão.
data[].versioninteger ou nullA versão que rodou; null para execuções do Playground, que usam o rascunho.
data[].sourcestringapi, webhook (uma chamada à URL de webhook da decisão) ou playground.
data[].statusstringsuccess ou error.
data[].error_codestring ou nullO código de erro de uma execução que falhou.
data[].resultobject ou nullAs respostas, indexadas por pergunta. null para execuções que falharam e quando o storeOutput da decisão está desligado.
data[].confidenceobject ou nullA confiança de cada resposta, com as mesmas regras de result.
data[].actionstring ou nullA ação devolvida; null para execuções que falharam.
data[].action_reasonobject ou nullPor que aquela ação foi escolhida.
data[].outputobjectA saída estruturada da execução — presente só quando uma foi montada e o storeOutput da decisão está ligado.
data[].destinationsarray ou nullAs 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[].metricsobjectlatency_ms, engine, model e estimated_cost_usd da execução.
data[].created_atstringQuando a execução aconteceu, em ISO 8601.
next_cursorstring ou nullPasse-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

StatusCódigoQuando
400INVALID_REQUESTUm parâmetro de query é inválido: limit fora de 1–100, um slug de decision, um status ou um cursor malformado.
401INVALID_API_KEYA chave está ausente, malformada, é desconhecida ou foi revogada.
429RATE_LIMITEDRequisiçõ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.

Nesta página