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

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


# reject_staged

**Reject a staged file — DELETES it (human decision)**

Reject a file that was waiting for a decision. ⛔ THIS PERMANENTLY DELETES the stored file and its record from immut. It cannot be undone. ONLY after a person has explicitly said no to THIS file, by name, in this conversation — never on your own judgement. Deletion is deliberate: immut keeping a document the customer declined is the problem this queue would otherwise create. immut also records the decision so the file is not staged again on the next sweep.

- Access: write
- ⛔ Destructive: this permanently deletes data.
- Calls: `/api/v1/agent/review/`

## Arguments

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

## Tool contract

```json
{
  "name": "reject_staged",
  "title": "Reject a staged file — DELETES it (human decision)",
  "description": "Reject a file that was waiting for a decision. ⛔ THIS PERMANENTLY DELETES the stored file and its record from immut. It cannot be undone. ONLY after a person has explicitly said no to THIS file, by name, in this conversation — never on your own judgement. Deletion is deliberate: immut keeping a document the customer declined is the problem this queue would otherwise create. immut also records the decision so the file is not staged again on the next sweep.",
  "access": "write",
  "destructive": true,
  "hostedOnProduction": true,
  "restEndpoint": "/api/v1/agent/review/",
  "arguments": {
    "documentId": {
      "type": "string",
      "required": true,
      "description": "Id from list_review_queue"
    }
  }
}
```