save_draft
Save words the user wrote or pasted as a new draft, word for word, with no AI. If you are about to write the copy yourself, call draft_post instead: it writes from this person's real posts, voice and the client's brand, and nothing on this path does. If you still write it yourself, call get_brand_voice first and match it. When the saved copy doesn't sound like the author, the reply ends with a note saying what is off; offer revise_draft to rewrite it in their voice. IMPORTANT: This tool ONLY saves. Do NOT call queue_post or schedule_post unless explicitly asked. For YouTube, the post must have a video attached (via images with a video MIME type) before it can be scheduled or published. When saving a post that belongs to someone else on the workspace (for example moving a teammate's posts in), pass their name as author so it is filed under them. Pass tags to label the post the way it was labelled in the tool it came from. When the workspace has more than one account on a platform (two LinkedIn profiles, a profile and a company page), pass platform_account_ids so the draft publishes from the right one; it is kept on the draft and used when it is scheduled, queued or published. Pass first_comment to have a comment posted under the post once it is live (LinkedIn, Facebook, Instagram), or first_comments for several, each from its own profile. To give one channel different text (an X version of a LinkedIn post), pass channel_copies on the same post; don't save a second post. To tag a person or company page on LinkedIn ("tag Jane", "mention Acme"): call find_linkedin_mention first to get their exact name and urn, write "@" in the post text where the tag goes, and pass {name, urn} in linkedin_tags. A bare "@Name" in the text is never tagged by itself. Tags work in the LinkedIn post only, not in first comments. Pass penciled_at to pencil it in at a date and time. Drafts never post. A penciled time only holds the slot.
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": {
"content": "<content>"
},
"name": "save_draft"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Tag names for the post, as they appear on the Content page (e.g. ["Launch", "Case study"]). Matched to the workspace's existing tags ignoring case; a name that doesn't exist yet is created if the user may manage tags, otherwise nothing is saved and the reply lists the tags that exist. | |
| author | No | Optional: whose post this is. A teammate's name, or 'me'. Omit to save it as yours. Only people who can see everyone's posts may save as someone else. | |
| 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. | |
| content | Yes | The post content to save | |
| 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). | |
| platforms | No | Target platforms. 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. | |
| penciled_at | No | Optional: pencil the draft in at a date and time, ISO 8601 (e.g. '2026-10-20T09:00'; no offset means the workspace's posting zone). Drafts never post. A penciled time only holds the slot. It stays a draft: nothing is scheduled or queued, and the queue skips that slot. A date with no time is refused. schedule_post with no `scheduled_at` books it at that time. | |
| first_comment | No | Optional: a comment DemandBird posts under the post, from the same profile, once the post is live (often a link or a call to action kept out of the post itself). LinkedIn, Facebook and Instagram only here. Stored verbatim. Pass {"text": ""} to remove it. Omit to leave it as it is. | |
| linkedin_tags | No | Optional: real LinkedIn tags (people or company pages) in the LinkedIn post. Each is the {name, urn} `find_linkedin_mention` returned, or {url} with a LinkedIn profile or company page URL. Every tag's "@<name>" must be in the LinkedIn text, spelled exactly as returned. A tag that can't be resolved saves nothing. Tags already on the post stay while their "@Name" is still in the text. LinkedIn only; not in first comments. | |
| channel_copies | No | Optional: a channel's own text, keyed by platform, e.g. {"twitter": "..."} for an X version of a LinkedIn post. That text publishes on that channel instead of the shared `content`; every other channel keeps what it had. Stored verbatim. A channel named here is added to the post's platforms. Pass "" for a channel to remove its copy (it then publishes the shared content). Use this, never a second post, to give one channel different text. | |
| first_comments | No | Optional: up to 5 comments DemandBird posts under the post once it is live, in order, each on its own delay and, if `comment_as` is set, from its own profile or page (a teammate adding their thoughts). Replaces every first comment on the platforms it covers; [] removes them all. Stored verbatim. Use this or `first_comment`, not both. Omit to leave the comments as they are. | |
| platform_account_ids | No | Optional map of platform => connected_account_id (numeric id from `list_connected_accounts`): which account each platform publishes from. Example: {"linkedin": 42}. A platform named here is added to `platforms`. Each id must be a channel of this workspace and match the platform, or nothing is saved. |