schedule_story
Schedule a photo or video to post to Instagram Stories at a future time.
media_url is one publicly fetchable image or video link, the same rule
publish_story follows; whether it's a photo or a video story is detected
when it's downloaded. scheduled_at is a future, timezone-aware ISO
datetime — never guess one: get real slots from get_posting_slots, or use
the exact time the user gave you in their own timezone.
One story per call. For several, call this once per file — each is its own story, and several can share one time. They appear in list_scheduled_posts (filter mode="story"); a story has no caption, so identify it by its time. Move one with update_scheduled_post(scheduled_at=...) or remove it with cancel_scheduled_post, both before it goes out.
Stories take media and nothing else — Instagram rejects a caption, hashtags, share-to-feed and comment settings on a story, so this tool doesn't accept them. If the user asks for a captioned story, tell them the text has to be burned into the image or video itself.
automation_id attaches a story-reply automation: once the story is live,
replies to it trigger the automation. To post right now, use publish_story.
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>",
"ig_account_id": "<ig_account_id>",
"media_url": "<media_url>",
"scheduled_at": "<scheduled_at>"
},
"name": "schedule_story"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| media_url | Yes | ||
| client_token | No | ||
| scheduled_at | Yes | ||
| workspace_id | Yes | ||
| automation_id | No | ||
| ig_account_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | ||
| status | Yes | ||
| post_id | Yes | ||
| scheduled_at | No |