# Change a plan slot

> Change one slot of this week's plan: swap its sub-topic (an approved sub-topic id), mechanism, format or time (day and localTime in the account's timezone), save its text (a post you wrote in the user's voice for it, with sourcePostId: the proven post from search_inspiration whose shape it borrows), or skip it. Changing the idea clears text that no longer fits, resets where the idea came from, and takes the slot out of the week's test when it no longer fits it. Text is checked against the user's own rules; a draft that breaks one or has a detail Xholic can't back is marked needs_look. It schedules nothing. Approved slots can't change here (edit the queued post instead).

`plan.update_slot` · write

- **MCP tool:** `update_plan_slot`. Loaded by default in MCP clients.
- **REST:** `POST /v1/plan/update-slot`
- **CLI:** `xholic plan update-slot`
- **Scope:** `write`
- **Plan:** Every plan, including the trial
- **Cost:** Free.
- **Rate limit bucket:** `write`

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `slotId` | string ≤ 40 chars | Yes | The slot's id from get_week_plan (e.g. s-20261124-0930). |
| `subtopicId` | string ≤ 100 chars | No | An approved sub-topic id. |
| `mechanism` | "confession_question" \\| "forced_choice" \\| "fresh_finding" \\| "sharp_distinction" \\| "honest_moment" \\| "before_after" \\| "open_question" \\| "practical_list" \\| "bold_claim" \\| "relatable_humor" | No | Why people would respond: confession_question, forced_choice, fresh_finding, sharp_distinction, honest_moment, before_after, open_question, practical_list, bold_claim or relatable_humor. |
| `format` | "relatable_scene" \\| "one_liner" \\| "contrast_pair" \\| "hot_take" \\| "contrarian_reframe" \\| "personal_story" \\| "proof_numbers" \\| "build_update" \\| "list_playbook" \\| "framework" \\| "question" \\| "observation" \\| "trend_reaction" \\| "ironic_humor" \\| "advice" \\| "motivation" | No | The post's shape, such as question, personal_story or list_playbook. |
| `day` | string | No | New local date, YYYY-MM-DD. |
| `localTime` | string | No | New local time, HH:MM. |
| `text` | string ≤ 25000 chars | No | The post's text, in the user's voice. |
| `sourcePostId` | string | No | The proven post (an X post id from search_inspiration) whose shape the text borrows. Its words are never copied. |
| `skip` | boolean | No | Skip this slot this week (false brings it back). |
| `account` | string ≤ 64 chars | No | X account to act on, as @handle. Leave it out to use the connection's default account. |
| `note` | string ≤ 20000 chars | No | Optional, on any tool: one or two sentences for Xholic's shared memory about what the user just decided, asked for or said about themselves or their plans (e.g. "Dropping threads for now; focusing on replies to founders"). Every AI the user connects reads it, so they never repeat themselves. In your words, never other people's posts. Leave it out when nothing new was said. |
| `dryRun` | boolean | No | Return exactly what would happen without doing it. |
| `idempotencyKey` | string ≤ 200 chars | No | A unique key for this write. Repeating a call with the same key returns the first result instead of acting twice. |
