publish_story
Publish a photo or video to Instagram Stories, immediately.
media_url is one publicly fetchable image or video link; whether it's
treated as a photo or a video story is detected when it's downloaded.
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.
This goes out now. For a story the user wants at a later time, use schedule_story — don't schedule a reel instead.
automation_id attaches a story-reply automation, so replies to this
story trigger it. Stories expire after ~24 hours: list_live_stories shows
the ones still up, and get_story_analytics how recent ones did.
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>"
},
"name": "publish_story"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| media_url | Yes | ||
| client_token | No | ||
| 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 |