---
title: "Obter execução de agente específica"
method: GET
path: "/api/management/ai/agents/executions/{execution}"
tags: ["ai-agents", "agents", "executions"]
---

# Obter execução de agente específica

`GET /api/management/ai/agents/executions/{execution}`

Retorna o detalhe de uma execução de agente: o prompt enviado, a resposta gerada, o erro quando houve falha e o consumo em créditos. Traz também `steps`, o histórico de idas e voltas ao modelo, com as ferramentas chamadas, os tokens e o custo de cada passo.

## Response `200`

Sucesso

- object — Detalhe completo da execução.
  - `data` object — Execução do agente.
    - `id` string, uuid — ID (UUID) da execução.
    - `agent_id` string, uuid, nullable — ID (UUID) do agente executado.
    - `model` string, nullable — Modelo de IA usado na execução.
    - `provider` 'openrouter' | 'google' | 'openai' | 'anthropic' | 'null', nullable — Provedor de IA usado na execução.
    - `response` string, nullable — Texto final produzido pelo agente; nulo enquanto a execução não termina.
    - `prompt` string, nullable — Instrução enviada ao agente, já com o template renderizado.
    - `status` 'pending' | 'completed' | 'failed' — Situação da execução.
    - `error` string, nullable — Mensagem do erro que interrompeu a execução; nulo quando não houve falha.
    - `latency` integer — Tempo total da execução, em milissegundos.
    - `invoice_id` string, uuid, nullable — ID (UUID) da fatura em que a execução foi cobrada, no modelo de cobrança anterior à carteira de créditos.
    - `bill_computed` boolean — Indica se a execução já foi contabilizada no faturamento anterior à carteira de créditos.
    - `tokens_used` integer — Total de tokens consumidos pela execução.
    - `credits_debited` string, nullable — Créditos debitados da carteira da empresa, com nove casas decimais; nulo quando nada foi debitado.
    - `credit_transaction_id` string, uuid, nullable — ID (UUID) do lançamento na carteira de créditos gerado por esta execução.
    - `created_at` string, date-time — Data e hora em que a execução foi enfileirada.
    - `updated_at` string, date-time — Data e hora da última alteração da execução.
    - `steps` object[] — Idas e voltas ao modelo, na ordem em que aconteceram; vazio quando a execução ainda não rodou.
      - `index` integer — Posição do passo dentro da execução, a partir de zero.
      - `provider` string, nullable — Provedor de IA usado no passo.
      - `model` string, nullable — Modelo de IA usado no passo.
      - `text` string, nullable — Texto produzido pelo modelo no passo; nulo quando o passo só chamou ferramentas.
      - `tool_calls` object[], nullable — Ferramentas chamadas pelo modelo no passo.
        - `id` string — Identificador da chamada, usado para casar com o resultado correspondente.
        - `name` string — Nome da ferramenta chamada.
        - `arguments` object — Argumentos com que a ferramenta foi chamada.
        - `result_id` string, nullable — Identificador do resultado correspondente, quando o provedor o informa.
        - `reasoning_id` string, nullable — Identificador do raciocínio associado à chamada, quando o provedor o informa.
        - `reasoning_summary` string[], nullable — Resumo do raciocínio associado à chamada, quando o provedor o informa.
      - `tool_results` object[], nullable — Resultados das ferramentas devolvidos ao modelo no passo.
        - `id` string — Identificador da chamada que originou o resultado.
        - `name` string — Nome da ferramenta executada.
        - `arguments` object — Argumentos com que a ferramenta foi chamada.
        - `result` union — Conteúdo devolvido pela ferramenta ao modelo.
          - string
          - object
          - unknown[]
            - unknown
          - number
          - boolean
        - `result_id` string, nullable — Identificador do resultado informado pelo provedor, quando existe.
      - `finish_reason` string, nullable — Motivo pelo qual o modelo encerrou o passo, conforme informado pelo provedor.
      - `prompt_tokens` integer — Tokens de entrada consumidos no passo.
      - `completion_tokens` integer — Tokens de saída gerados no passo.
      - `cached_tokens` integer — Tokens de entrada lidos do cache do provedor.
      - `cache_write_tokens` integer — Tokens de entrada gravados no cache do provedor.
      - `reasoning_tokens` integer — Tokens gastos com raciocínio interno do modelo.
      - `cost` string, nullable — Custo do passo cobrado pelo provedor, em dólares e com nove casas decimais.
      - `created_at` string, date-time — Data e hora em que o passo foi registrado.
  - `response` boolean — Indicador de sucesso da requisição; sempre verdadeiro nesta resposta.

## Other responses

- `404` — Execução não encontrada

## Changes

- **2026-09-22** `d71b18b1685d` — 15 breaking, 10 warning, 7 info
  - the response property `data/agent_id` became nullable for the status `200`
  - the response property `data/credit_transaction_id` became nullable for the status `200`
  - the response property `data/credits_debited` became nullable for the status `200`
  - the response property `data/model` became nullable for the status `200`
  - …28 more
- **2026-09-22** `b43a04f35145` — 7 warning
  - removed the optional property `data/error` from the response with the `200` status
  - removed the optional property `data/invoice_id` from the response with the `200` status
  - removed the optional property `data/steps/items/text` from the response with the `200` status
  - removed the optional property `data/steps/items/tool_calls/items/reasoning_id` from the response with the `200` status
  - …3 more
- **2026-09-18** `468063611950` — 2 info
  - added the media type `application/json` for the response with the status `200`
  - added the non-success response with the status `404`

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/ai/agents/executions/:execution/get.md)

---

[API](https://skmtc.dev/olie-ai/apis/olie-api.md) · [All operations](https://skmtc.dev/olie-ai/apis/olie-api/llms.txt) · [OpenAPI document](https://skmtc.dev/olie-ai/apis/olie-api/revisions/d71b18b1685d?raw)