revise_draft
Rewrite an existing post from the user's feedback, with AI. Apply the user's feedback to an EXISTING draft and save the revision onto the SAME post. Use this every time the user reacts to a draft you already produced, like 'make it shorter', 'less salesy', 'add a call to action', 'that's not what I meant'. Do NOT call draft_post again to act on feedback: that creates a second, unrelated draft and leaves the first one (with its attached images) behind. Runs the full voice engine server-side, so the revision stays in the user's voice and on-brand. Attached media and any existing schedule are preserved. Channels that carry their own tailored copy keep it: the revision changes the shared draft only. The words it replaces are kept in the post's version history, where the user can restore them in DemandBird.
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": {
"id": "<id>",
"feedback": "<feedback>"
},
"name": "revise_draft"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Post ID of the draft to revise: the post_id returned by draft_post / save_draft / list_drafts | |
| feedback | Yes | What the user wants changed, in their own words. Pass their message through; don't rewrite it into instructions. | |
| platform | No | Optional: the platform whose length limit the revision should fit. Defaults to the post's first platform. Does not change which channels the post publishes to. | |
| 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 revise with what it has instead of asking for more context. |