# move_scheduled

> Move planned posts with Wavegrain's MCP server: the move_scheduled tool needs the write permission. Inputs, outputs and an example call.

> Index of these docs: https://wavegrain.com/developers/llms.txt

**Move planned posts.** Permission: `write`. Changes or removes saved work.

Move every planned post in a window (at most 31 days, 30 posts) by some days, keeping each local time. The first call lists the moves with a confirmToken; only after the user says yes, call again with confirm: true and the token. A move withdraws an approval. Moving by the opposite days undoes it; withdrawn approvals stay withdrawn.

## Inputs

| Input | Type | Required | Notes |
| --- | --- | --- | --- |
| `from` | string | yes | Start of the window of planned posts to move. |
| `to` | string | yes | End of the window, at most 31 days after from. |
| `days` | integer | yes | Days to move each post: 7 is a week later, -1 a day earlier. -60 to 60 |
| `brandId` | string | no | Only this brand's posts. Default: every brand. up to 200 characters |
| `confirm` | boolean | no | Only after the user said yes to the list from the first call. |
| `confirmToken` | string | no | The confirmToken of the first call's answer, sent with confirm. up to 4000 characters |

The fields inside an object or a list are in the JSON Schema at [/developers/mcp-tools.json](/developers/mcp-tools.json).

## Returns

| Field | Type | Notes |
| --- | --- | --- |
| `moves` | object[] | The posts in the window and where each one goes. |
| `confirmToken` | string \| null | Send it back with confirm after the user agrees; null once moved. |
| `moved` | string[] | The slideshows moved, on the confirming call. |
| `failed` | object[] | Posts that could not be moved, on the confirming call. |
| `note` | string | What to tell the user. |

## Example call

Send it to `POST https://wavegrain.com/api/mcp` with an access key that has the `write` permission; [Authentication](/developers/authentication) shows how to make one.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "move_scheduled",
    "arguments": {
      "from": "<from>",
      "to": "<to>",
      "days": 1
    }
  }
}
```

The call shows only the required inputs, with placeholder values: put your own in.

## Related tools

- [`schedule_slideshows`](/developers/mcp-tools/schedule_slideshows): Schedule slideshows
- [`unschedule_slideshow`](/developers/mcp-tools/unschedule_slideshow): Unschedule a slideshow
- [`edit_slides`](/developers/mcp-tools/edit_slides): Edit slides
- [`save_images`](/developers/mcp-tools/save_images): Save images to the library
- [`open_upload`](/developers/mcp-tools/open_upload): Open a drop zone for photos
- [`import_image`](/developers/mcp-tools/import_image): Import an image from a URL
- [All 79 tools](/developers/mcp-tools)
