v27

latestOpenAPI 3.1.0Proprietaryraw.githubusercontent.com2026-06-0872127230.6 KB

Shorts

Publish short video to YouTube Shorts, Instagram Reels, and/or TikTok

post/api/agent/shorts/publish

Request body

video_urlstring uri required

HTTPS URL of the video. Must be hosted on download.citedy.com (path must start with /agent/shorts/ or /agent/reels/) or Supabase storage. The R2 prefix restriction ensures Meta's facebookexternalhit crawler can fetch the video via our /media/shorts/... proxy on www.citedy.com — direct R2 URLs are blocked by the bucket's default Disallow: / robots.txt and cause Instagram Reel publish to fail.

speech_textstring required

Spoken text from the video for metadata generation

privacy_status'public' | 'unlisted' | 'private'

Publish privacy. YouTube supports public/unlisted/private. TikTok uses tiktok_privacy_level from the account's current creator_info options; privacy_status=private remains a compatibility fallback for SELF_ONLY. Instagram Reels ignores this field.

tiktok_privacy_level'PUBLIC_TO_EVERYONE' | 'FOLLOWER_OF_CREATOR' | 'MUTUAL_FOLLOW_FRIENDS' | 'SELF_ONLY'

TikTok-only visibility level selected from the account's current TikTok creator_info options.

tiktok_titlestring

TikTok-only reviewed post title/caption.

tiktok_disable_commentboolean

TikTok-only flag to disable comments for the post.

tiktok_disable_duetboolean

TikTok-only flag to disable duets for the post.

tiktok_disable_stitchboolean

TikTok-only flag to disable stitches for the post.

tiktok_brand_content_toggleboolean

TikTok-only commercial disclosure flag for third-party branded content. Branded content cannot use SELF_ONLY visibility.

tiktok_brand_organic_toggleboolean

TikTok-only commercial disclosure flag for content promoting the creator's own brand.

tiktok_is_aigcboolean

TikTok-only flag indicating AI-generated content.

Response

Publish completed (check per-platform results)

metadata_providerstring

LLM provider used for metadata generation

metadata_degradedboolean

True if AI metadata generation failed and static fallback was used

credits_chargednumber