<!--
  immut documentation, machine-readable.

  Everything in one file:  https://www.immut.io/llms-full.txt
    What immut is, which integration path to choose, authentication and scopes, and the COMPLETE
    API reference: every endpoint with parameters, responses and a runnable curl. Fetch this first
    if you intend to call the API.

  Index of all pages:      https://www.immut.io/llms.txt
  OpenAPI contract:        https://www.immut.io/docs/openapi.json
  This page as HTML:       https://www.immut.io/docs/mcp/get_agent_run

  Any page on this site is available as raw markdown by appending .md to its URL.
-->


# get_agent_run

**One sweep in full**

One sweep and the documents it protected. This is the ONLY tool that returns decisions[] in full for a run: the per-file record of what the agent chose NOT to protect and why. Also returns unreadableGroups[], the metadata-only summary of files it could not open. decisions[] is consent-gated, so an absent array means the customer never opted in to sending it, NOT that nothing was excluded. Read-only.

- Access: read-only
- Calls: `/api/v1/agent/runs/`

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `runId` | string | **yes** | The immut id of the run, from list_agent_runs |
| `docPage` | number | no | Page of the joined document list |
| `docLimit` | number | no | Page size, max 100 (default 50) |

## Tool contract

```json
{
  "name": "get_agent_run",
  "title": "One sweep in full",
  "description": "One sweep and the documents it protected. This is the ONLY tool that returns decisions[] in full for a run: the per-file record of what the agent chose NOT to protect and why. Also returns unreadableGroups[], the metadata-only summary of files it could not open. decisions[] is consent-gated, so an absent array means the customer never opted in to sending it, NOT that nothing was excluded. Read-only.",
  "access": "read",
  "destructive": false,
  "hostedOnProduction": true,
  "restEndpoint": "/api/v1/agent/runs/",
  "arguments": {
    "runId": {
      "type": "string",
      "required": true,
      "description": "The immut id of the run, from list_agent_runs"
    },
    "docPage": {
      "type": "number",
      "required": false,
      "description": "Page of the joined document list"
    },
    "docLimit": {
      "type": "number",
      "required": false,
      "description": "Page size, max 100 (default 50)"
    }
  }
}
```