Approve, revise, plan, restore, or discard a draft
revise_content_draftAct on one draft in the user's queue. stage = the user approved it (mark ready to publish; publishing itself happens in the web tool). discard drops it. revise rewrites it in the brand voice per a one-click preset — shorter, longer, punchier, deeper, simpler, more_specific, less_salesy, more_casual, more_formal — and/or a typed instruction (2 credits). fix makes the surgical change the reviewer's notes asked for (2). humanize strips the AI feel and keeps everything else (2). review scores it against the brand voice (2). edit replaces the text with what you or the user wrote (free) — when you can write the better version yourself, prefer edit over revise. plan puts it on the calendar for planned_at (YYYY-MM-DD or ISO time; null unplans; free; a plan, not a schedule). restore brings back an earlier version by version_id from get_content_draft (free; its old score returns when the filing is unchanged). Every text change saves the previous text as a version, so any step can be undone with restore. Any text change clears the old score. A scheduled or live draft cannot be changed (error draft_locked) — tell the user to change it in their scheduler. Stage and discard are the USER's decisions — act on their say-so, never on your own judgment. If the user's reaction should apply to every future draft (not just this one), use teach_content_voice instead.
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": {
"space_id": "<space_id>",
"draft_id": "<draft_id>",
"action": "<action>"
},
"name": "revise_content_draft"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | No | edit: the replacement text. | |
| action | Yes | ||
| preset | No | revise: the calibration chip the user clicked. | |
| draft_id | Yes | From get_content_queue or a write_content_candidates result. | |
| space_id | Yes | ||
| planned_at | No | plan: the day (YYYY-MM-DD) or ISO time to plan it for; null removes it from the calendar. | |
| version_id | No | restore: a version_id from get_content_draft. | |
| instruction | No | revise / fix / humanize: the user's note in their words. |