# GET /agent-ops/runs/:run_id

**Resource:** [Agent Ops](./agent-ops.md)  
**MCP tool:** `get_agent_run`  
**Scopes:** `agent-ops:read`  
**Write operation:** no

Fetch one agent run with its full per-step execution trace (each step's role, model, status, tokens, tool calls, output) from the workflow-agent ledger. Accepts the run id returned by dispatch_agent_run, or an agent_run_log row id.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `run_id` | path | string | yes | Run id from dispatch_agent_run, or an agent_run_log row id. |

## Request example

```bash
curl   "https://api.trustpager.com/functions/v1/api/v1/agent-ops/runs/:run_id"   -H "Authorization: Bearer YOUR_API_KEY"
```

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`