Agent
Protect a staged file: writes its ledger record NOW and moves it into the document library
POST
https://backend.immut.io/api/v1/agent/review/{id}/approveRequired scope: documents:write
The proof therefore carries the approval date, not the date the agent uploaded it. If the record cannot be confirmed the file stays in the queue and this returns 502, because releasing it without a record would present an unprotected file as protected.
Parameters
| Name | In | Required | Description |
|---|---|---|---|
id | path | yes | id of the target record |
Request body
Content type: application/json
| Field | Type | Required | Description |
|---|---|---|---|
_ | string | no | No body. The file and its classification are already on immut; approving needs only the id in the path. |
Responses
| Status | Meaning |
|---|---|
200 | Success |
400 | BadRequest |
401 | Unauthorized |
403 | Forbidden |
429 | RateLimited |
Example
curl -X POST "https://backend.immut.io/api/v1/agent/review/<id>/approve" \
-H "Authorization: Bearer $IMMUT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"_":"<_>"}'
Generated from the immut API contract, version 1.9.0. Machine-readable: this page as markdown · everything in one file · OpenAPI