<!--
  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/list_agent_runs

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


# list_agent_runs

**Sweep history**

The sweeps this organisation's agent has reported, newest first. Use it to answer "when did my agent last run", "how many files did it review last month", or to find a runId to drill into. Returns counts and coverage per run. decisions[] is omitted here for size, so use get_agent_run for one run or list_agent_decisions to query across runs. Read-only.

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

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `workspace` | string | no | Workspace id |
| `mode` | `interactive` \| `unattended` | no | Only sweeps of this kind |
| `objective` | string | no | Only sweeps that served this objective |
| `protectedOnly` | boolean | no | true excludes sweeps that protected nothing |
| `from` | string | no | ISO 8601, on the sweep finish time |
| `to` | string | no | ISO 8601, on the sweep finish time |
| `page` | number | no | Page number (default 1) |
| `limit` | number | no | Page size, max 100 (default 20) |

## Tool contract

```json
{
  "name": "list_agent_runs",
  "title": "Sweep history",
  "description": "The sweeps this organisation's agent has reported, newest first. Use it to answer \"when did my agent last run\", \"how many files did it review last month\", or to find a runId to drill into. Returns counts and coverage per run. decisions[] is omitted here for size, so use get_agent_run for one run or list_agent_decisions to query across runs. Read-only.",
  "access": "read",
  "destructive": false,
  "hostedOnProduction": true,
  "restEndpoint": "/api/v1/agent/runs",
  "arguments": {
    "workspace": {
      "type": "string",
      "required": false,
      "description": "Workspace id"
    },
    "mode": {
      "type": "enum",
      "required": false,
      "description": "Only sweeps of this kind",
      "values": [
        "interactive",
        "unattended"
      ]
    },
    "objective": {
      "type": "string",
      "required": false,
      "description": "Only sweeps that served this objective"
    },
    "protectedOnly": {
      "type": "boolean",
      "required": false,
      "description": "true excludes sweeps that protected nothing"
    },
    "from": {
      "type": "string",
      "required": false,
      "description": "ISO 8601, on the sweep finish time"
    },
    "to": {
      "type": "string",
      "required": false,
      "description": "ISO 8601, on the sweep finish time"
    },
    "page": {
      "type": "number",
      "required": false,
      "description": "Page number (default 1)"
    },
    "limit": {
      "type": "number",
      "required": false,
      "description": "Page size, max 100 (default 20)"
    }
  }
}
```