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

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


# ack_agent_instruction

**Report that you carried out an instruction**

Tell immut you have ACTED on one instruction from get_agent_instructions. Call it only after the action is really done — a human clicking a button is not evidence the file was handled, which is why this is a separate call from creating the instruction. Pass the runId of the sweep that applied it so the two records line up. Use cancelled if you could not act and will not retry (for example the file no longer exists).

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

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `instructionId` | string | **yes** | Id from get_agent_instructions |
| `status` | `applied` \| `cancelled` | **yes** | applied = you did it; cancelled = you will not, and will not retry |
| `runId` | string | no | runId of the sweep that applied it (recommended) |

## Tool contract

```json
{
  "name": "ack_agent_instruction",
  "title": "Report that you carried out an instruction",
  "description": "Tell immut you have ACTED on one instruction from get_agent_instructions. Call it only after the action is really done — a human clicking a button is not evidence the file was handled, which is why this is a separate call from creating the instruction. Pass the runId of the sweep that applied it so the two records line up. Use cancelled if you could not act and will not retry (for example the file no longer exists).",
  "access": "write",
  "destructive": false,
  "hostedOnProduction": true,
  "restEndpoint": "/api/v1/agent/instructions/",
  "arguments": {
    "instructionId": {
      "type": "string",
      "required": true,
      "description": "Id from get_agent_instructions"
    },
    "status": {
      "type": "enum",
      "required": true,
      "description": "applied = you did it; cancelled = you will not, and will not retry",
      "values": [
        "applied",
        "cancelled"
      ]
    },
    "runId": {
      "type": "string",
      "required": false,
      "description": "runId of the sweep that applied it (recommended)"
    }
  }
}
```