update_scheduled_post
Edit a not-yet-published post — caption, hashtags, schedule time, draft<->scheduled status, reel settings, automation link, or first comment.
Every parameter here is "leave alone unless set" — omit anything you don't want to change. caption="" and hashtags=[] are real values (clear it to blank/empty), not "unset"; there's no way through this tool to explicitly clear automation_id or first_comment back to none (only to a new value or leaving them alone) — cancel_scheduled_post and re-schedule if that's what you need.
share_to_feed/allow_comments/allow_remixing edit individual fields on the post's reel settings — passing one merges it onto the post's current reel settings rather than replacing the whole thing, so setting only share_to_feed doesn't reset allow_comments/allow_remixing back to their defaults.
status only accepts "draft" or "scheduled" — publishing/published/failed are written by the publish pipeline, not settable here. Moving draft -> scheduled charges the same reel-schedule quota schedule_reel does; a published or actively-publishing post can't be moved at all. Setting scheduled_at on an already-scheduled post moves it to that new time — the way to reschedule a story, which takes no caption or hashtags.
trial_reel turns a scheduled reel into a trial reel (non-followers first) or back into an ordinary one; trial_graduation ("MANUAL" or "SS_PERFORMANCE") changes how a trial is shared to followers. See schedule_reel. Turning a scheduled reel into a trial uses the plan's trial-reel allowance. Reels only.
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": {
"workspace_id": "<workspace_id>",
"post_id": "<post_id>"
},
"name": "update_scheduled_post"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | ||
| caption | No | ||
| post_id | Yes | ||
| hashtags | No | ||
| trial_reel | No | ||
| scheduled_at | No | ||
| workspace_id | Yes | ||
| automation_id | No | ||
| first_comment | No | ||
| share_to_feed | No | ||
| allow_comments | No | ||
| allow_remixing | No | ||
| trial_graduation | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| mode | Yes | ||
| status | Yes | ||
| caption | Yes | ||
| is_trial | No | ||
| ig_media_id | No | ||
| scheduled_at | No | ||
| ig_account_id | Yes | ||
| publish_error | No |