---
title: "Listar execuções dos assistentes"
method: GET
path: "/api/management/steps/{step}/assistants/execution-logs"
tags: ["step-assistants", "Execução"]
---

# Listar execuções dos assistentes

`GET /api/management/steps/{step}/assistants/execution-logs`

Histórico de execuções de todos os assistentes de uma etapa, do mais recente para o mais antigo.

Cada registro traz o assistente, o projeto, a execução do agente de IA (com o texto devolvido e o modelo usado) e o desfecho de cada destino separadamente: a gravação como conteúdo do projeto e a gravação em campo de formulário têm campos próprios de status e de erro, porque uma pode dar certo e a outra falhar.

Aceita filtros e paginação por query params, consulte:

- [Filtro básico](https://docs.olie.ai/api-reference/general/basic-filters)
- [Paginação](https://docs.olie.ai/api-reference/general/pagination)

Os campos de paginação (`current_page`, `per_page`, `total`, ...) vêm na raiz da resposta, ao lado de `data`, e não dentro de `meta` como no restante da API.

## Query parameters

- `page` string
- `perPage` string
- `filter[status]` string
- `filter[step_assistant_id]` string

## Response `200`

Sucesso

- object — Resposta paginada. Diferente do restante da API, os campos de paginação vêm na raiz, e não dentro de `meta`.
  - `current_page` integer, required — Página retornada.
  - `data` object[], required — Execuções encontradas na página atual, da mais recente para a mais antiga.
    - `id` string, uuid — ID (UUID) do registro de execução.
    - `step_assistant_id` string, uuid — ID (UUID) do assistente executado.
    - `project_id` string, uuid — ID (UUID) do projeto sobre o qual o assistente rodou.
    - `agent_execution_id` string, uuid, nullable — ID (UUID) da execução do agente de IA correspondente.
    - `status` 'pending' | 'success' | 'error' — Situação da execução: `pending` em andamento, `success` concluída e `error` falhou.
    - `result` string, nullable — Texto devolvido pelo agente de IA.
    - `media_result_status` boolean, nullable — Resultado da gravação como conteúdo do projeto: `true` gravou, `false` falhou, `null` não se aplica.
    - `media_result_error` string, nullable — Motivo da falha ao gravar como conteúdo do projeto.
    - `dynamic_form_result_status` boolean, nullable — Resultado da gravação no campo de formulário: `true` gravou, `false` falhou, `null` não se aplica.
    - `dynamic_form_result_error` string, nullable — Motivo da falha ao gravar no campo de formulário.
    - `execution_time` string, date-time, nullable — Momento em que a execução foi encerrada.
    - `created_at` string, date-time — Momento em que a execução foi enfileirada.
    - `updated_at` string, date-time — Data da última alteração do registro.
    - `step_assistant` object — Assistente que gerou o registro.
      - `id` string, uuid — ID (UUID) do assistente.
      - `name` string — Nome do assistente.
      - `ai_agent_id` string, uuid — ID (UUID) do agente de IA usado.
    - `project` object — Projeto sobre o qual o assistente rodou.
      - `id` string, uuid — ID (UUID) do projeto.
      - `name` string — Nome do projeto.
      - `code` string — Código do projeto.
    - `agent_execution` object, nullable — Execução do agente de IA correspondente.
      - `id` string, uuid — ID (UUID) da execução.
      - `status` 'pending' | 'completed' | 'failed' — Situação da chamada ao modelo: `pending`, `completed` ou `failed`.
      - `response` string, nullable — Texto devolvido pelo modelo.
      - `model` string, nullable — Modelo de IA usado na execução.
  - `first_page_url` string — Endereço da primeira página.
  - `from` integer, nullable — Posição do primeiro item da página no total.
  - `last_page` integer — Número da última página.
  - `last_page_url` string — Endereço da última página.
  - `links` object[] — Links de navegação prontos para uma barra de paginação.
    - `url` string, nullable — Endereço da página, ou `null` quando não há para onde ir.
    - `label` string — Rótulo do link, já traduzido.
    - `page` integer, nullable — Número da página do link.
    - `active` boolean — Indica se o link aponta para a página atual.
  - `next_page_url` string, nullable — Endereço da próxima página, ou `null` na última.
  - `path` string — Endereço base usado para montar os links.
  - `per_page` integer, required — Itens por página.
  - `prev_page_url` string, nullable — Endereço da página anterior, ou `null` na primeira.
  - `to` integer, nullable — Posição do último item da página no total.
  - `total` integer, required — Total de itens encontrados.

## Changes

- **2026-08-24** `3c590152d5b5` — 19 breaking, 6 warning, 4 info
  - the response property `data/items/agent_execution` became nullable for the status `200`
  - the response property `data/items/agent_execution/model` became nullable for the status `200`
  - the response property `data/items/agent_execution/response` became nullable for the status `200`
  - the response property `data/items/agent_execution_id` became nullable for the status `200`
  - …25 more
- **2026-08-19** `063de6e2e93c` — 2 info
  - api tag `Execução` added
  - api tag `execution-logs` removed
- **2026-08-19** `69f9300dc045` — 1 info
  - added the media type `application/json` for the response with the status `200`
- **2026-08-19** `3227b85304ca` — 4 info
  - added the new optional `query` request parameter `filter[status]`
  - added the new optional `query` request parameter `filter[step_assistant_id]`
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `perPage`

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/steps/:step/assistants/execution-logs/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-service-production.skmtc.workers.dev/v1/apis/olie-ai/olie-api/revisions/8c9bac94e5ad/schema)