---
title: "Agent Trace"
method: GET
path: "/api/v1/agent/{run_id}/trace"
---

# Agent Trace

`GET /api/v1/agent/{run_id}/trace`

## Request

- Base URL: `https://api.mesharc.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mesharc.dev/api/v1/agent/{run_id}/trace`
- Auth: none declared

What the run did, step by step: model calls, searches, pages read
(with rung and credits), maps, waits. Only the steps after `after`, so
a poll reads what is new.

## Path parameters

- `run_id` string, required

## Query parameters

- `after` integer
- `limit` integer

## Headers

- `authorization` string, nullable
- `x-mesharc-tenant` string, nullable

## Response `200`

Successful Response

- AgentTrace
  - `data` AgentEvent[], required
    - `seq` integer, required
    - `t` string, nullable
    - `kind` string, required
    - `text` string
  - `last` integer, required

## Other responses

- `422`: Validation Error

---

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