Agent
What the agent decided NOT to protect, across every sweep
GET
https://backend.immut.io/api/v1/agent/decisionsRequired scope: documents:read
decisions[] otherwise lives inside a single run, so this is the route for "what did my agent leave alone last month, and why". Consent-gated: read meta.consent before reporting an empty list as a clean sweep.
Read decisions. Requires scope documents:read.
Parameters
| Name | In | Required | Description |
|---|---|---|---|
decision | query | no | one of the 11 decision codes; an unknown code returns 400 rather than an empty list |
docType | query | no | filter by doc type |
docState | query | no | filter by doc state |
workspace | query | no | workspace id |
objective | query | no | the objective the sweep served |
from | query | no | ISO 8601, filters on the sweep finish time |
to | query | no | ISO 8601, filters on the sweep finish time |
search | query | no | matches the file path and the reason |
page | query | no | default 1 |
limit | query | no | default 50, max 100 |
Responses
| Status | Meaning |
|---|---|
200 | Success Returns: per row: path, decision, reason, docType, docState, servesObjective, confidence, folderConfidence, plus runId and sweptAt (when that sweep finished). meta.consent is reported |
400 | BadRequest |
401 | Unauthorized |
403 | Forbidden |
429 | RateLimited |
Example
curl -X GET "https://backend.immut.io/api/v1/agent/decisions" \
-H "Authorization: Bearer $IMMUT_API_KEY"
Generated from the immut API contract, version 1.10.0. Machine-readable: this page as markdown · everything in one file · OpenAPI