<!--
  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/approve_staged

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


# approve_staged

**Protect a staged file (human decision)**

Protect a file that was waiting for a decision. ⛔ ONLY after a person has explicitly said yes to THIS file, by name, in this conversation. You may never call this on your own judgement — the file is in the queue because judgement was not enough. Writes the ledger record NOW, so the proof carries today's date, not the date it was staged. Read the network in the result and tell the person: only a mainnet proof is permanent.

- Access: write
- Calls: `/api/v1/agent/review/`

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `documentId` | string | **yes** | Id from list_review_queue |

## Tool contract

```json
{
  "name": "approve_staged",
  "title": "Protect a staged file (human decision)",
  "description": "Protect a file that was waiting for a decision. ⛔ ONLY after a person has explicitly said yes to THIS file, by name, in this conversation. You may never call this on your own judgement — the file is in the queue because judgement was not enough. Writes the ledger record NOW, so the proof carries today's date, not the date it was staged. Read the network in the result and tell the person: only a mainnet proof is permanent.",
  "access": "write",
  "destructive": false,
  "hostedOnProduction": true,
  "restEndpoint": "/api/v1/agent/review/",
  "arguments": {
    "documentId": {
      "type": "string",
      "required": true,
      "description": "Id from list_review_queue"
    }
  }
}
```