Agent
The sweep history for this organisation
GET
https://backend.immut.io/api/v1/agent/runsRequired scope: documents:read
Filterable by mode, objective, protectedOnly, from/to. Omits decisions[] for size; use the single-run route for those.
Parameters
| Name | In | Required | Description |
|---|---|---|---|
workspace | query | no | workspace id |
mode | query | no | interactive | unattended (any other value is ignored) |
objective | query | no | the objective the sweep served |
protectedOnly | query | no | true excludes sweeps that protected nothing |
from | query | no | ISO 8601, filters on finishedAt |
to | query | no | ISO 8601, filters on finishedAt |
page | query | no | default 1 |
limit | query | no | default 20, max 100 |
Responses
| Status | Meaning |
|---|---|
200 | Success Returns: the full run MINUS decisions[]: runId, startedAt, finishedAt, mode, objective, trigger, counts, coverage, connectorsReached, connectorsUnreachable, unreadableGroups, network, noOp, decisionsReported, decisionsTruncated. decisions[] is omitted here for size; use GET /agent/runs/{id} for one run, or GET /agent/decisions to query across runs. meta carries page, limit, total, totalPages. |
400 | BadRequest |
401 | Unauthorized |
403 | Forbidden |
429 | RateLimited |
Example
curl -X GET "https://backend.immut.io/api/v1/agent/runs" \
-H "Authorization: Bearer $IMMUT_API_KEY"
Generated from the immut API contract, version 1.14.0. Machine-readable: this page as markdown · everything in one file · OpenAPI