draft_post
Write a NEW post with AI. If you are about to write post copy, call this instead: it writes from this person's real posts, voice and the client's brand (positioning / audience / pillars). That includes 'write a post about X', 'draft something about Y' and 'turn this into a LinkedIn post': pass the topic, notes or angle as prompt rather than writing the post yourself. Use save_draft only for words the user wrote or pasted. Returns the new draft's post_id and its full text. Nothing is scheduled or published. If the idea is too thin to write from, it saves nothing and asks a question instead; call again with the answer, or with draft_anyway: true. To change the draft afterwards, use revise_draft with that post_id, not draft_post again.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"prompt": "<prompt>"
},
"name": "draft_post"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| images | No | Images, a video, or one PDF to attach. For ANY image beyond a thumbnail, call upload_image FIRST to get a presigned S3 URL, upload via the returned curl command, then pass the s3_key here. Inline `data` is only for tiny images (≤50 KB); `file_path` is dev-only. A PDF posts as a LinkedIn document (a swipeable carousel): LinkedIn only, one per post, never alongside images or video. | |
| prompt | Yes | Topic or instructions for what to write | |
| youtube | No | YouTube-specific options. Required platform inputs: a video must be attached via `images` (the upload tool accepts video MIME types). If `title` is omitted, it is derived from the first line of content (truncated to 100 chars). | |
| platform | No | Target platform. Influences tone and length. Instagram needs an image or video on the post: upload one with `upload_image` (or make one with `generate_image`) and pass its s3_key in `images`. | |
| workspace | No | Optional: the workspace (client) to answer from for this call only, by name (e.g. 'Acme') or numeric id, as returned by list_workspaces. Leave it out to use the current workspace. It does not change the current workspace; use select_workspace for that. | |
| draft_anyway | No | Set true to make the writer draft with what it has instead of asking for more context. Use when a previous draft_post call came back with 'Need more to draft this' and the user would rather you just write it. |