# Upload link for the user

> A page where the user drops a photo or video themselves, for files you can't send: a file attached in this chat (claude.ai, ChatGPT and other chat apps let you see it, not send its bytes). Give the user the link (it works for 30 minutes and takes up to 4 files), wait until they say it's done, then call media.upload_link_status for the mediaIds and attach them to the post (schedule_post or edit_queued_post media). Pass postId when the file is for a post already in the queue, so the page shows which one.

`media.upload_link` · write

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

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `postId` | string ≤ 120 chars | No | The queued post the file is for, to show on the page. |
| `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. |
