---
title: get_mutation_status
description: Find out how a change on Meta ended, after a write tool started it.
---

Ask whether a change on Meta is done. Each write tool gives back a change id before the change reaches Meta, and this tool tells how that change ended.

> Did the budget change on Spring Prospecting go through?

The agent calls `get_mutation_status` with the id of that change, and it asks again while the change runs. When the change waits for you, it reports `awaiting_confirmation`, and the agent gives you the link to the change in the AdCrunch console. Confirm or reject it there. Then you see whether Meta applied the change, or why the change did not apply. For a change of an object that exists, it also gives the value that the change replaced, so the agent can put it back. For a copy, it gives the id of the copy and the budget that the copy carries. [Change what runs on Meta](/mcp/tools/change-what-runs-on-meta) lists each outcome.

## Reference

Check whether a mutation started by a write tool (e.g. meta_update_status) has finished. Pass the `mutationId` that tool returned. Returns `running`, `awaiting_confirmation` (a person must confirm the change in the AdCrunch console: give `consoleUrl` to the user), `complete` (with the result), or `errored`. For a change to an object that exists, it also returns `priorValue`: the values that the change replaced. To undo the change, call the same tool again with them.

### Input

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `mutationId` | string | yes | The `mutationId` returned by a write tool. |

### Output

A successful call returns this object in `structuredContent`.

| Field | Type | Always present | Description |
| --- | --- | --- | --- |
| `consoleUrl` | string | yes | The page of this change in the AdCrunch console. When `get_mutation_status` reports `awaiting_confirmation`, give this URL to the user: a person must confirm the change there before it reaches Meta. You cannot confirm it. |
| `priorValue` | map of any | no | The values that the change replaced, read from Meta just before the change. It uses the field names and units of the arguments that you sent: `{ "dailyBudget": 800 }` for a budget, `{ "status": "ACTIVE" }` for a status, `{ "bidStrategy": "COST_CAP", "costCap": 4 }` for a bid, `{ "startTime": "2026-10-01T00:00:00+0200", "endTime": null }` for a schedule with no end, `{ "name": "Spring sale" }` for a name. To undo the change, call the same tool again with these values. A bid change on a campaign also gives the amount of each ad set in `adsets`: undo it on each ad set. It is present for a change to an object that exists, in each status. A create and a copy have none. |
| `result` | object | no | How the change ended. It is present when `status` is `complete`. `ok` tells whether Meta applied the change. When `ok` is false, `error` holds the code of the refusal. |
| `result.ok` | `true` or `false` | yes | `true`: Meta applied the change. `false`: The change did not apply. |
| `result.result` | object | yes | Only when `ok` is `true`. What Meta gave back. A create gives `id`. A copy gives `id` and `budget`. A change of an object that exists gives `success`. |
| `result.result.budget` | object or `campaign` or `adset` | yes | Only in form 1 of 3. The budget that the copy carries, read from its source: what the copy can spend after you activate it. Change it with `meta_update_budget` on the paused copy. |
| `result.result.budget.dailyBudget` | number | yes | Only in form 1 of 2. The daily budget, in whole units of the account currency. |
| `result.result.budget.lifetimeBudget` | number | yes | Only in form 2 of 2. The lifetime budget, in whole units of the account currency. |
| `result.result.id` | string | yes | Only in form 1 of 3. The Meta id of the copy. |
| `result.result.id` | string | yes | Only in form 2 of 3. The Meta id of the object that a create made. |
| `result.result.deliveryStartsAgain` | `true` | no | Only in form 3 of 3. Present on a schedule change that gave an ACTIVE ad set that had ended a new end time, or no end. The ad set delivers again, and it spends again. |
| `result.result.success` | boolean | yes | Only in form 3 of 3. Whether Meta accepted a change of an object. |
| `result.error` | one of `budget_cap_exceeded`, `expired`, `invalid_request`, `missing_write_access`, `not_found`, `provider_error`, `provider_not_connected`, `rejected`, `wrong_level` | yes | Only when `ok` is `false`. Why the change did not apply, as a stable code. |
| `result.message` | string | yes | Only when `ok` is `false`. Why the change did not apply, in one sentence for a person. For `provider_error`, the sentence holds the words of Meta. `rejected`: a person rejected the change in the console. `expired`: nobody confirmed it within 24 hours. After either, nothing changed at Meta. |
| `status` | one of `running`, `awaiting_confirmation`, `complete`, `errored` | yes | `running`: the change has not ended. Call again. `awaiting_confirmation`: a person must confirm the change in the AdCrunch console before it reaches Meta. Give `consoleUrl` to the user, and do not call again in a loop: the change waits up to 24 hours. `complete`: the change ended. `result` tells how. A refused change is also `complete`. `errored`: the run itself stopped. AdCrunch cannot tell whether Meta applied the change. Read the object at Meta before you send the change again. |

### Failure codes

A failed call has `isError` set, and `structuredContent.error` holds one of these codes. [Errors](/mcp/errors) describes the shape of a failed call.

- `not_found`
- `organization_unentitled`
- `forbidden`
- `invalid_request`
- `internal_error`

### Scope

The token must hold `mutation:write`. [Auth & scopes](/mcp/auth) lists each scope.

### Annotations

A client reads these hints. A hint that the tool does not declare has the default value of the MCP specification.

- **Read-only.** The tool changes nothing.
- **Open world.** The tool reaches a system outside AdCrunch, such as an ad platform.

### Example

The arguments:

```json
{
  "mutationId": "mut_k3x9q2v7m4n8p1r5t6w0y2z4"
}
```

The result, in `structuredContent`:

```json
{
  "consoleUrl": "https://console.adcrunch.dev/activity/mut_k3x9q2v7m4n8p1r5t6w0y2z4",
  "result": {
    "ok": true,
    "result": {
      "id": "120215678901234567"
    }
  },
  "status": "complete"
}
```