<!--
  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_decisions

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


# list_agent_decisions

**What the agent decided NOT to protect**

Query, across every sweep, the files the agent decided not to protect, with the reason it gave, the doc type it judged, and when the sweep ran. Use it for "what did my agent leave alone last month and why". ⚠️ Read meta.consent before reporting an empty list: decisions are consent-gated, so never_consented means the customer never opted in to sending them, which is NOT the same as nothing being excluded. Read-only.

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

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `decision` | string | no | One of the 11 decision codes; an unknown code is rejected |
| `docType` | string | no | Filter by doc type |
| `docState` | string | no | Filter by doc state |
| `workspace` | string | no | Workspace id |
| `objective` | string | no | The objective the sweep served |
| `from` | string | no | ISO 8601, on the sweep finish time |
| `to` | string | no | ISO 8601, on the sweep finish time |
| `search` | string | no | Matches the file path and the reason |
| `page` | number | no | Page number (default 1) |
| `limit` | number | no | Page size, max 100 (default 50) |

## Tool contract

```json
{
  "name": "list_agent_decisions",
  "title": "What the agent decided NOT to protect",
  "description": "Query, across every sweep, the files the agent decided not to protect, with the reason it gave, the doc type it judged, and when the sweep ran. Use it for \"what did my agent leave alone last month and why\". ⚠️ Read meta.consent before reporting an empty list: decisions are consent-gated, so never_consented means the customer never opted in to sending them, which is NOT the same as nothing being excluded. Read-only.",
  "access": "read",
  "destructive": false,
  "hostedOnProduction": true,
  "restEndpoint": "/api/v1/agent/decisions",
  "arguments": {
    "decision": {
      "type": "string",
      "required": false,
      "description": "One of the 11 decision codes; an unknown code is rejected"
    },
    "docType": {
      "type": "string",
      "required": false,
      "description": "Filter by doc type"
    },
    "docState": {
      "type": "string",
      "required": false,
      "description": "Filter by doc state"
    },
    "workspace": {
      "type": "string",
      "required": false,
      "description": "Workspace id"
    },
    "objective": {
      "type": "string",
      "required": false,
      "description": "The objective the sweep served"
    },
    "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"
    },
    "search": {
      "type": "string",
      "required": false,
      "description": "Matches the file path and the reason"
    },
    "page": {
      "type": "number",
      "required": false,
      "description": "Page number (default 1)"
    },
    "limit": {
      "type": "number",
      "required": false,
      "description": "Page size, max 100 (default 50)"
    }
  }
}
```