Agent
Decisions the human made in immut that this agent must apply
GET
https://backend.immut.io/api/v1/agent/instructionsRequired scope: documents:read
CALL THIS AT THE START OF EVERY SWEEP. Defaults to status=pending and excludes expired rows. protect means upload that path on this sweep; reject means leave it and record decision declined_by_human. Mark each one applied with PATCH once you have actually acted.
Parameters
| Name | In | Required | Description |
|---|---|---|---|
status | query | no | pending | applied | cancelled (default pending, which also excludes expired rows) |
Responses
| Status | Meaning |
|---|---|
200 | Success Returns: per row: path, action, status, requestedAt, appliedAt, expiresAt, workspace. Newest first, capped at 500. meta carries count and status. |
400 | BadRequest |
401 | Unauthorized |
403 | Forbidden |
429 | RateLimited |
Example
curl -X GET "https://backend.immut.io/api/v1/agent/instructions" \
-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