# Update a note

> Change a note's text, due date or trigger, or mark it DONE or DROPPED when the user says it is finished or no longer wanted.

`notes.update` · write

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

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `noteId` | string (uuid) | Yes | The note id from add_note or find_notes. |
| `title` | string ≤ 140 chars | No |  |
| `body` | string ≤ 4000 chars | No |  |
| `due` | string ≤ 40 chars or null | No | When to act: a date such as 2026-10-30, a local date and time such as 2026-10-30T09:00 (then pass timezone), or an ISO time with offset. |
| `timezone` | string ≤ 80 chars | No | IANA timezone for due, such as Asia/Kolkata. |
| `trigger` | object or null | No | Fire on an event instead of a date: OWN_SPIKE (the account's next follower spike or breakout post; for posts that need a real number), MILESTONE (followers or posts crossing a number; the next round follower count when left out), TRACKED_POSTS (one of these accounts posts, optionally about a topic), TOPIC_HEATS (the topic shows up in the account's trends). |
| `status` | "OPEN" \\| "DONE" \\| "DROPPED" | No |  |
| `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. |
