Publish a video
publish_videoPublish one of the user's COMPLETED videos. YOUTUBE: uploads to the connected channel with your title/description and privacy (public, unlisted, private); the "altered or synthetic content" disclosure is always set; madeForKids is the user's COPPA answer (ask them for a kids audience); nothing is appended to the description unless addAttribution is true (default false — only when the user asked for "Made with StoryShort"). TIKTOK: sends the video to the creator's TikTok Drafts (inbox) — they add the caption, switch on the AI-generated label and post in the app; pass userConsent: true only after the user agreed. Idempotent per (videoId, platform): a repeat returns the first result and never posts twice (a video already posted from the website counts). Respects platform caps (YouTube ≈5 uploads/day; TikTok's pending-drafts limit). Not connected → NOT_CONNECTED with a connectUrl. Requires the "video:create" scope. Free.
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": {
"videoId": "<videoId>",
"platform": "<platform>"
},
"name": "publish_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | YouTube title (cleaned and cut to 60 characters on a word). Defaults to the video title. | |
| privacy | No | YouTube visibility (default public). | |
| videoId | Yes | ||
| platform | Yes | ||
| description | No | YouTube description. #Shorts is added if missing. | |
| madeForKids | No | YouTube COPPA declaration. Omit to use the series answer, or the niche default. | |
| userConsent | No | TikTok only: the user agreed to send this video to their TikTok drafts. | |
| addAttribution | No | YouTube only. Append "Made with StoryShort", a link and #StoryShort to the description. Default false: set true ONLY if the user explicitly asked for it. |