MCP tool

建立排程帖文

sosoapi_create_scheduled_post

用 provider_payload 為一個帳戶排程到 scheduled_at。媒體要 ready asset_id 同正式 URL；單張來源圖片可用 sosoapi_post_image_url。local_scheduled_at 同 schedule_dst_disambiguation 一齊提供或一齊省略。需要 publish 能力、editor 角色及 idempotency_key；scheduled 唔等於 published，要讀結果。

閱讀 Markdown

Profiles 及連接方式

Profiles: core, full · Transports: stdio, http

Profile 只影響工具可見性，唔會授權。HTTP 冇本機檔案上傳。SOSOAPI_OUTPUT_SCHEMAS=1 會宣告輸出 schema；兩種模式都會回傳 structured results。

權限及改動

MCP annotations 只係發現提示，唔係存取控制保證；仍然有實際登入、角色、資源及能力檢查。

{
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}

/studio-api/scheduled-posts/create: agent:publish · terminal publication outcome

輸入欄位

必填表示喺所屬物件及所選分支內必須提供；子欄位必填唔代表可選父物件變成必填。以下欄位名稱及規則直接來自 contract。

輸入欄位
欄位／分支	類型／必填	限制
`$`	`object`父物件內必填	`additionalProperties: false`
`workspace_id`	`string`父物件內必填	`format: "uuid"`
`project_id`	`string \| null`可選／陣列項目	—
`project_id`anyOf 1	`string`可選／陣列項目	`format: "uuid"`
`project_id`anyOf 2	`null`可選／陣列項目	—
`social_account_id`	`string`父物件內必填	`format: "uuid"`
`caption`	`string \| null`可選／陣列項目	—
`caption`anyOf 1	`string`可選／陣列項目	`maxLength: 5000`
`caption`anyOf 2	`null`可選／陣列項目	—
`hashtags`	`array`可選／陣列項目	`maxItems: 100`
`hashtags[]`	`string`可選／陣列項目	`maxLength: 100`
`media`	`array`可選／陣列項目	`maxItems: 20`
`media[]`	`object`可選／陣列項目	`additionalProperties: false`
`media[].kind`	`string`父物件內必填	`enum: ["image","video"]`
`media[].url`	`string`父物件內必填	`format: "uri"`
`media[].cover_url`	`string \| null`可選／陣列項目	—
`media[].cover_url`anyOf 1	`string`可選／陣列項目	`format: "uri"`
`media[].cover_url`anyOf 2	`null`可選／陣列項目	—
`media[].cover_asset_id`	`integer \| null`可選／陣列項目	—
`media[].cover_asset_id`anyOf 1	`integer`可選／陣列項目	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`media[].cover_asset_id`anyOf 2	`null`可選／陣列項目	—
`media[].asset_id`	`integer \| null`可選／陣列項目	—
`media[].asset_id`anyOf 1	`integer`可選／陣列項目	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`media[].asset_id`anyOf 2	`null`可選／陣列項目	—
`media[].mime_type`	`string \| null`可選／陣列項目	—
`media[].mime_type`anyOf 1	`string`可選／陣列項目	`minLength: 1` `maxLength: 160`
`media[].mime_type`anyOf 2	`null`可選／陣列項目	—
`link_url`	`string \| null`可選／陣列項目	—
`link_url`anyOf 1	`string`可選／陣列項目	`format: "uri"`
`link_url`anyOf 2	`null`可選／陣列項目	—
`provider_payload`	`object`父物件內必填	—
`provider_payload`anyOf 1	`object`父物件內必填	`additionalProperties: false`
`provider_payload.platform`anyOf 1	`string`父物件內必填	`enum: ["x"]`
`provider_payload.publish_options`anyOf 1	`object`父物件內必填	`additionalProperties: false`
`provider_payload.publish_options.post_type`anyOf 1	`string`父物件內必填	`enum: ["TEXT"]`
`provider_payload`anyOf 2	`object`父物件內必填	`additionalProperties: false`
`provider_payload.platform`anyOf 2	`string`父物件內必填	`enum: ["instagram"]`
`provider_payload.publish_options`anyOf 2	`object`父物件內必填	`additionalProperties: false`
`provider_payload.publish_options.post_type`anyOf 2	`string`父物件內必填	`enum: ["IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO"]`
`provider_payload.publish_options.location_id`anyOf 2	`string`可選／陣列項目	`minLength: 1` `maxLength: 256`
`provider_payload.publish_options.share_to_feed`anyOf 2	`boolean`可選／陣列項目	—
`provider_payload.publish_options.collaborators`anyOf 2	`array`可選／陣列項目	`maxItems: 3`
`provider_payload.publish_options.collaborators[]`anyOf 2	`string`可選／陣列項目	`minLength: 1` `maxLength: 30`
`provider_payload.publish_options.first_comment`anyOf 2	`string`可選／陣列項目	`minLength: 1` `maxLength: 2200`
`provider_payload.publish_options.cover_asset_id`anyOf 2	`integer`可選／陣列項目	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`provider_payload.publish_options.thumb_offset_ms`anyOf 2	`integer`可選／陣列項目	`minimum: 0` `maximum: 9007199254740991`
`provider_payload.publish_options.audio_name`anyOf 2	`string`可選／陣列項目	`minLength: 1` `maxLength: 100`
`provider_payload.publish_options.trial_params`anyOf 2	`object`可選／陣列項目	`additionalProperties: false`
`provider_payload.publish_options.trial_params.graduation_strategy`anyOf 2	`string`父物件內必填	`enum: ["MANUAL","SS_PERFORMANCE"]`
`provider_payload.publish_options.is_ai_generated`anyOf 2	`boolean`可選／陣列項目	—
`provider_payload.publish_options.branded_content_sponsor_ids`anyOf 2	`array`可選／陣列項目	`maxItems: 2`
`provider_payload.publish_options.branded_content_sponsor_ids[]`anyOf 2	`string`可選／陣列項目	`minLength: 1` `maxLength: 256`
`provider_payload.publish_options.is_paid_partnership`anyOf 2	`boolean`可選／陣列項目	—
`provider_payload.publish_options.media_options`anyOf 2	`array`可選／陣列項目	`maxItems: 10`
`provider_payload.publish_options.media_options[]`anyOf 2	`object`可選／陣列項目	`additionalProperties: false`
`provider_payload.publish_options.media_options[].asset_id`anyOf 2	`integer`父物件內必填	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`provider_payload.publish_options.media_options[].alt_text`anyOf 2	`string`可選／陣列項目	`minLength: 1` `maxLength: 1000`
`provider_payload.publish_options.media_options[].user_tags`anyOf 2	`array`可選／陣列項目	`maxItems: 20`
`provider_payload.publish_options.media_options[].user_tags[]`anyOf 2	`object`可選／陣列項目	`additionalProperties: false`
`provider_payload.publish_options.media_options[].user_tags[].username`anyOf 2	`string`父物件內必填	`minLength: 1` `maxLength: 30`
`provider_payload.publish_options.media_options[].user_tags[].x`anyOf 2	`number`可選／陣列項目	`minimum: 0` `maximum: 1`
`provider_payload.publish_options.media_options[].user_tags[].y`anyOf 2	`number`可選／陣列項目	`minimum: 0` `maximum: 1`
`provider_payload.publish_options.media_options[].product_tags`anyOf 2	`array`可選／陣列項目	`maxItems: 5`
`provider_payload.publish_options.media_options[].product_tags[]`anyOf 2	`object`可選／陣列項目	`additionalProperties: false`
`provider_payload.publish_options.media_options[].product_tags[].product_id`anyOf 2	`string`父物件內必填	`minLength: 1` `maxLength: 256`
`provider_payload.publish_options.media_options[].product_tags[].x`anyOf 2	`number`可選／陣列項目	`minimum: 0` `maximum: 1`
`provider_payload.publish_options.media_options[].product_tags[].y`anyOf 2	`number`可選／陣列項目	`minimum: 0` `maximum: 1`
`provider_payload.publish_options.media_options[].thumb_offset_ms`anyOf 2	`integer`可選／陣列項目	`minimum: 0` `maximum: 9007199254740991`
`provider_payload`anyOf 3	`object`父物件內必填	`additionalProperties: false`
`provider_payload.platform`anyOf 3	`string`父物件內必填	`enum: ["facebook"]`
`provider_payload.publish_options`anyOf 3	`object`父物件內必填	`additionalProperties: false`
`provider_payload.publish_options.post_type`anyOf 3	`string`父物件內必填	`enum: ["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","REELS","STORY_IMAGE","STORY_VIDEO"]`
`provider_payload.publish_options.title`anyOf 3	`string`可選／陣列項目	`maxLength: 255`
`provider_payload.publish_options.description`anyOf 3	`string`可選／陣列項目	`maxLength: 5000`
`provider_payload.publish_options.publication_mode`anyOf 3	`string`可選／陣列項目	`enum: ["PUBLISH","DRAFT"]`
`provider_payload.publish_options.backdated_time`anyOf 3	`number`可選／陣列項目	—
`provider_payload.publish_options.backdated_time_granularity`anyOf 3	`string`可選／陣列項目	`enum: ["year","month","day","hour","minute"]`
`provider_payload.publish_options.place`anyOf 3	`string`可選／陣列項目	`minLength: 1` `maxLength: 256`
`provider_payload.publish_options.tags`anyOf 3	`array`可選／陣列項目	`maxItems: 50`
`provider_payload.publish_options.tags[]`anyOf 3	`string`可選／陣列項目	`minLength: 1` `maxLength: 256`
`provider_payload.publish_options.feed_targeting`anyOf 3	`object`可選／陣列項目	`additionalProperties: false`
`provider_payload.publish_options.feed_targeting.age_min`anyOf 3	`integer`可選／陣列項目	`minimum: 13` `maximum: 65`
`provider_payload.publish_options.feed_targeting.age_max`anyOf 3	`integer`可選／陣列項目	`minimum: 13` `maximum: 65`
`provider_payload.publish_options.feed_targeting.college_years`anyOf 3	`array`可選／陣列項目	`maxItems: 100`
`provider_payload.publish_options.feed_targeting.college_years[]`anyOf 3	`integer`可選／陣列項目	`minimum: 1900` `maximum: 2200`
`provider_payload.publish_options.feed_targeting.education_statuses`anyOf 3	`array`可選／陣列項目	`maxItems: 3`
`provider_payload.publish_options.feed_targeting.education_statuses[]`anyOf 3	`number`可選／陣列項目	—
`provider_payload.publish_options.feed_targeting.education_statuses[]`anyOf 3 / anyOf 1	`number`可選／陣列項目	`enum: [1]`
`provider_payload.publish_options.feed_targeting.education_statuses[]`anyOf 3 / anyOf 2	`number`可選／陣列項目	`enum: [2]`
`provider_payload.publish_options.feed_targeting.education_statuses[]`anyOf 3 / anyOf 3	`number`可選／陣列項目	`enum: [3]`
`provider_payload.publish_options.feed_targeting.genders`anyOf 3	`array`可選／陣列項目	`maxItems: 2`
`provider_payload.publish_options.feed_targeting.genders[]`anyOf 3	`number`可選／陣列項目	—
`provider_payload.publish_options.feed_targeting.genders[]`anyOf 3 / anyOf 1	`number`可選／陣列項目	`enum: [1]`
`provider_payload.publish_options.feed_targeting.genders[]`anyOf 3 / anyOf 2	`number`可選／陣列項目	`enum: [2]`
`provider_payload.publish_options.feed_targeting.geo_locations`anyOf 3	`object`可選／陣列項目	`additionalProperties: false`
`provider_payload.publish_options.feed_targeting.geo_locations.countries`anyOf 3	`array`可選／陣列項目	`minItems: 1` `maxItems: 25`
`provider_payload.publish_options.feed_targeting.geo_locations.countries[]`anyOf 3	`string`可選／陣列項目	`pattern: "^[A-Z]{2}$"`
`provider_payload.publish_options.feed_targeting.geo_locations.regions`anyOf 3	`array`可選／陣列項目	`minItems: 1` `maxItems: 250`
`provider_payload.publish_options.feed_targeting.geo_locations.regions[]`anyOf 3	`object`可選／陣列項目	`additionalProperties: false`
`provider_payload.publish_options.feed_targeting.geo_locations.regions[].key`anyOf 3	`string \| integer`父物件內必填	—
`provider_payload.publish_options.feed_targeting.geo_locations.regions[].key`anyOf 3 / anyOf 1	`string`父物件內必填	`minLength: 1` `maxLength: 256`
`provider_payload.publish_options.feed_targeting.geo_locations.regions[].key`anyOf 3 / anyOf 2	`integer`父物件內必填	`minimum: 0` `maximum: 9007199254740991`
`provider_payload.publish_options.feed_targeting.geo_locations.cities`anyOf 3	`array`可選／陣列項目	`minItems: 1` `maxItems: 250`
`provider_payload.publish_options.feed_targeting.geo_locations.cities[]`anyOf 3	`object`可選／陣列項目	`additionalProperties: false`
`provider_payload.publish_options.feed_targeting.geo_locations.cities[].key`anyOf 3	`string \| integer`父物件內必填	—
`provider_payload.publish_options.feed_targeting.geo_locations.cities[].key`anyOf 3 / anyOf 1	`string`父物件內必填	`minLength: 1` `maxLength: 256`
`provider_payload.publish_options.feed_targeting.geo_locations.cities[].key`anyOf 3 / anyOf 2	`integer`父物件內必填	`minimum: 0` `maximum: 9007199254740991`
`provider_payload.publish_options.feed_targeting.geo_locations.cities[].radius`anyOf 3	`number`可選／陣列項目	`maximum: 1000` `exclusiveMinimum: 0`
`provider_payload.publish_options.feed_targeting.geo_locations.cities[].distance_unit`anyOf 3	`string`可選／陣列項目	`enum: ["mile","kilometer"]`
`provider_payload.publish_options.feed_targeting.geo_locations.zips`anyOf 3	`array`可選／陣列項目	`minItems: 1` `maxItems: 250`
`provider_payload.publish_options.feed_targeting.geo_locations.zips[]`anyOf 3	`object`可選／陣列項目	`additionalProperties: false`
`provider_payload.publish_options.feed_targeting.geo_locations.zips[].key`anyOf 3	`string \| integer`父物件內必填	—
`provider_payload.publish_options.feed_targeting.geo_locations.zips[].key`anyOf 3 / anyOf 1	`string`父物件內必填	`minLength: 1` `maxLength: 256`
`provider_payload.publish_options.feed_targeting.geo_locations.zips[].key`anyOf 3 / anyOf 2	`integer`父物件內必填	`minimum: 0` `maximum: 9007199254740991`
`provider_payload.publish_options.feed_targeting.geo_locations.location_types`anyOf 3	`array`可選／陣列項目	`minItems: 1` `maxItems: 2`
`provider_payload.publish_options.feed_targeting.geo_locations.location_types[]`anyOf 3	`string`可選／陣列項目	`enum: ["home","recent"]`
`provider_payload.publish_options.feed_targeting.interests`anyOf 3	`array`可選／陣列項目	`maxItems: 250`
`provider_payload.publish_options.feed_targeting.interests[]`anyOf 3	`string \| integer`可選／陣列項目	—
`provider_payload.publish_options.feed_targeting.interests[]`anyOf 3 / anyOf 1	`string`可選／陣列項目	`minLength: 1` `maxLength: 256`
`provider_payload.publish_options.feed_targeting.interests[]`anyOf 3 / anyOf 2	`integer`可選／陣列項目	`minimum: 0` `maximum: 9007199254740991`
`provider_payload.publish_options.feed_targeting.locales`anyOf 3	`array`可選／陣列項目	`maxItems: 250`
`provider_payload.publish_options.feed_targeting.locales[]`anyOf 3	`integer`可選／陣列項目	`minimum: 0` `maximum: 9007199254740991`
`provider_payload.publish_options.feed_targeting.relationship_statuses`anyOf 3	`array`可選／陣列項目	`maxItems: 4`
`provider_payload.publish_options.feed_targeting.relationship_statuses[]`anyOf 3	`number`可選／陣列項目	—
`provider_payload.publish_options.feed_targeting.relationship_statuses[]`anyOf 3 / anyOf 1	`number`可選／陣列項目	`enum: [1]`
`provider_payload.publish_options.feed_targeting.relationship_statuses[]`anyOf 3 / anyOf 2	`number`可選／陣列項目	`enum: [2]`
`provider_payload.publish_options.feed_targeting.relationship_statuses[]`anyOf 3 / anyOf 3	`number`可選／陣列項目	`enum: [3]`
`provider_payload.publish_options.feed_targeting.relationship_statuses[]`anyOf 3 / anyOf 4	`number`可選／陣列項目	`enum: [4]`
`provider_payload.publish_options.targeting`anyOf 3	`object`可選／陣列項目	`additionalProperties: false`
`provider_payload.publish_options.targeting.age_min`anyOf 3	`number`可選／陣列項目	—
`provider_payload.publish_options.targeting.age_min`anyOf 3 / anyOf 1	`number`可選／陣列項目	`enum: [13]`
`provider_payload.publish_options.targeting.age_min`anyOf 3 / anyOf 2	`number`可選／陣列項目	`enum: [15]`
`provider_payload.publish_options.targeting.age_min`anyOf 3 / anyOf 3	`number`可選／陣列項目	`enum: [18]`
`provider_payload.publish_options.targeting.age_min`anyOf 3 / anyOf 4	`number`可選／陣列項目	`enum: [21]`
`provider_payload.publish_options.targeting.age_min`anyOf 3 / anyOf 5	`number`可選／陣列項目	`enum: [25]`
`provider_payload.publish_options.targeting.geo_locations`anyOf 3	`object`可選／陣列項目	`additionalProperties: false`
`provider_payload.publish_options.targeting.geo_locations.countries`anyOf 3	`array`可選／陣列項目	`minItems: 1` `maxItems: 25`
`provider_payload.publish_options.targeting.geo_locations.countries[]`anyOf 3	`string`可選／陣列項目	`pattern: "^[A-Z]{2}$"`
`provider_payload.publish_options.targeting.geo_locations.regions`anyOf 3	`array`可選／陣列項目	`minItems: 1` `maxItems: 250`
`provider_payload.publish_options.targeting.geo_locations.regions[]`anyOf 3	`object`可選／陣列項目	`additionalProperties: false`
`provider_payload.publish_options.targeting.geo_locations.regions[].key`anyOf 3	`string \| integer`父物件內必填	—
`provider_payload.publish_options.targeting.geo_locations.regions[].key`anyOf 3 / anyOf 1	`string`父物件內必填	`minLength: 1` `maxLength: 256`
`provider_payload.publish_options.targeting.geo_locations.regions[].key`anyOf 3 / anyOf 2	`integer`父物件內必填	`minimum: 0` `maximum: 9007199254740991`
`provider_payload.publish_options.targeting.geo_locations.cities`anyOf 3	`array`可選／陣列項目	`minItems: 1` `maxItems: 250`
`provider_payload.publish_options.targeting.geo_locations.cities[]`anyOf 3	`object`可選／陣列項目	`additionalProperties: false`
`provider_payload.publish_options.targeting.geo_locations.cities[].key`anyOf 3	`string \| integer`父物件內必填	—
`provider_payload.publish_options.targeting.geo_locations.cities[].key`anyOf 3 / anyOf 1	`string`父物件內必填	`minLength: 1` `maxLength: 256`
`provider_payload.publish_options.targeting.geo_locations.cities[].key`anyOf 3 / anyOf 2	`integer`父物件內必填	`minimum: 0` `maximum: 9007199254740991`
`provider_payload.publish_options.targeting.geo_locations.cities[].radius`anyOf 3	`number`可選／陣列項目	`maximum: 1000` `exclusiveMinimum: 0`
`provider_payload.publish_options.targeting.geo_locations.cities[].distance_unit`anyOf 3	`string`可選／陣列項目	`enum: ["mile","kilometer"]`
`provider_payload.publish_options.targeting.geo_locations.zips`anyOf 3	`array`可選／陣列項目	`minItems: 1` `maxItems: 250`
`provider_payload.publish_options.targeting.geo_locations.zips[]`anyOf 3	`object`可選／陣列項目	`additionalProperties: false`
`provider_payload.publish_options.targeting.geo_locations.zips[].key`anyOf 3	`string \| integer`父物件內必填	—
`provider_payload.publish_options.targeting.geo_locations.zips[].key`anyOf 3 / anyOf 1	`string`父物件內必填	`minLength: 1` `maxLength: 256`
`provider_payload.publish_options.targeting.geo_locations.zips[].key`anyOf 3 / anyOf 2	`integer`父物件內必填	`minimum: 0` `maximum: 9007199254740991`
`provider_payload.publish_options.targeting.geo_locations.location_types`anyOf 3	`array`可選／陣列項目	`minItems: 1` `maxItems: 2`
`provider_payload.publish_options.targeting.geo_locations.location_types[]`anyOf 3	`string`可選／陣列項目	`enum: ["home","recent"]`
`provider_payload.publish_options.child_attachments`anyOf 3	`array`可選／陣列項目	`minItems: 2` `maxItems: 10`
`provider_payload.publish_options.child_attachments[]`anyOf 3	`object`可選／陣列項目	`additionalProperties: false`
`provider_payload.publish_options.child_attachments[].link`anyOf 3	`string`父物件內必填	`format: "uri"`
`provider_payload.publish_options.child_attachments[].name`anyOf 3	`string`可選／陣列項目	`maxLength: 255`
`provider_payload.publish_options.child_attachments[].description`anyOf 3	`string`可選／陣列項目	`maxLength: 1000`
`provider_payload.publish_options.child_attachments[].picture`anyOf 3	`string`父物件內必填	`format: "uri"`
`provider_payload.publish_options.multi_share_end_card`anyOf 3	`boolean`可選／陣列項目	—
`provider_payload.publish_options.multi_share_optimized`anyOf 3	`boolean`可選／陣列項目	—
`provider_payload.publish_options.unpublished_content_type`anyOf 3	`string`可選／陣列項目	`enum: ["SCHEDULED","SCHEDULED_RECURRING","DRAFT","PUBLISH_PENDING","ADS_POST","INLINE_CREATED","PUBLISHED","REVIEWABLE_BRANDED_CONTENT"]`
`provider_payload.publish_options.no_story`anyOf 3	`boolean`可選／陣列項目	—
`provider_payload.publish_options.crossposted_video_id`anyOf 3	`string`可選／陣列項目	`minLength: 1` `maxLength: 256`
`provider_payload.publish_options.spherical`anyOf 3	`boolean`可選／陣列項目	—
`provider_payload.publish_options.media_options`anyOf 3	`array`可選／陣列項目	`maxItems: 20`
`provider_payload.publish_options.media_options[]`anyOf 3	`object`可選／陣列項目	`additionalProperties: false`
`provider_payload.publish_options.media_options[].asset_id`anyOf 3	`integer`父物件內必填	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`provider_payload.publish_options.media_options[].alt_text_custom`anyOf 3	`string`可選／陣列項目	`minLength: 1` `maxLength: 1000`
`provider_payload`anyOf 4	`object`父物件內必填	`additionalProperties: false`
`provider_payload.platform`anyOf 4	`string`父物件內必填	`enum: ["threads"]`
`provider_payload.publish_options`anyOf 4	`object`父物件內必填	`additionalProperties: false`
`provider_payload.publish_options.post_type`anyOf 4	`string`父物件內必填	`enum: ["TEXT","IMAGE","VIDEO","CAROUSEL","REPOST"]`
`provider_payload.publish_options.reply_to_id`anyOf 4	`string`可選／陣列項目	`minLength: 1` `maxLength: 256`
`provider_payload.publish_options.quote_post_id`anyOf 4	`string`可選／陣列項目	`minLength: 1` `maxLength: 256`
`provider_payload.publish_options.repost_target_id`anyOf 4	`string`可選／陣列項目	`minLength: 1` `maxLength: 256`
`provider_payload.publish_options.reply_control`anyOf 4	`string`可選／陣列項目	`enum: ["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only"]`
`provider_payload.publish_options.enable_reply_approvals`anyOf 4	`boolean`可選／陣列項目	—
`provider_payload.publish_options.link_attachment`anyOf 4	`string`可選／陣列項目	`format: "uri"`
`provider_payload.publish_options.poll_attachment`anyOf 4	`object`可選／陣列項目	`additionalProperties: false`
`provider_payload.publish_options.poll_attachment.option_a`anyOf 4	`string`父物件內必填	`minLength: 1` `maxLength: 25`
`provider_payload.publish_options.poll_attachment.option_b`anyOf 4	`string`父物件內必填	`minLength: 1` `maxLength: 25`
`provider_payload.publish_options.poll_attachment.option_c`anyOf 4	`string`可選／陣列項目	`minLength: 1` `maxLength: 25`
`provider_payload.publish_options.poll_attachment.option_d`anyOf 4	`string`可選／陣列項目	`minLength: 1` `maxLength: 25`
`provider_payload.publish_options.gif_attachment`anyOf 4	`object`可選／陣列項目	`additionalProperties: false`
`provider_payload.publish_options.gif_attachment.gif_id`anyOf 4	`string`父物件內必填	`minLength: 1` `maxLength: 256`
`provider_payload.publish_options.gif_attachment.provider`anyOf 4	`string`父物件內必填	`enum: ["GIPHY"]`
`provider_payload.publish_options.text_attachment`anyOf 4	`object`可選／陣列項目	`additionalProperties: false`
`provider_payload.publish_options.text_attachment.plaintext`anyOf 4	`string`父物件內必填	`minLength: 1` `maxLength: 10000`
`provider_payload.publish_options.text_attachment.link_attachment_url`anyOf 4	`string`可選／陣列項目	`format: "uri"`
`provider_payload.publish_options.text_attachment.text_with_styling_info`anyOf 4	`array`可選／陣列項目	`maxItems: 100`
`provider_payload.publish_options.text_attachment.text_with_styling_info[]`anyOf 4	`object`可選／陣列項目	`additionalProperties: false`
`provider_payload.publish_options.text_attachment.text_with_styling_info[].offset`anyOf 4	`integer`父物件內必填	`minimum: 0` `maximum: 9007199254740991`
`provider_payload.publish_options.text_attachment.text_with_styling_info[].length`anyOf 4	`integer`父物件內必填	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`provider_payload.publish_options.text_attachment.text_with_styling_info[].styling_info`anyOf 4	`array`父物件內必填	`minItems: 1`
`provider_payload.publish_options.text_attachment.text_with_styling_info[].styling_info[]`anyOf 4	`string`可選／陣列項目	`enum: ["bold","italic","highlight","underline","strikethrough"]`
`provider_payload.publish_options.topic_tag`anyOf 4	`string`可選／陣列項目	`minLength: 1` `maxLength: 50`
`provider_payload.publish_options.text_entities`anyOf 4	`array`可選／陣列項目	`maxItems: 10`
`provider_payload.publish_options.text_entities[]`anyOf 4	`object`可選／陣列項目	`additionalProperties: false`
`provider_payload.publish_options.text_entities[].entity_type`anyOf 4	`string`父物件內必填	`enum: ["SPOILER","spoiler"]`
`provider_payload.publish_options.text_entities[].offset`anyOf 4	`integer`父物件內必填	`minimum: 0` `maximum: 9007199254740991`
`provider_payload.publish_options.text_entities[].length`anyOf 4	`integer`父物件內必填	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`provider_payload.publish_options.is_spoiler_media`anyOf 4	`boolean`可選／陣列項目	—
`provider_payload.publish_options.is_ghost_post`anyOf 4	`boolean`可選／陣列項目	—
`provider_payload.publish_options.location_id`anyOf 4	`string`可選／陣列項目	`minLength: 1` `maxLength: 256`
`provider_payload.publish_options.allowlisted_country_codes`anyOf 4	`array`可選／陣列項目	`minItems: 1` `maxItems: 249`
`provider_payload.publish_options.allowlisted_country_codes[]`anyOf 4	`string`可選／陣列項目	`pattern: "^[A-Z]{2}$"`
`provider_payload.publish_options.crossreshare_to_ig`anyOf 4	`boolean`可選／陣列項目	—
`provider_payload.publish_options.crossreshare_to_ig_dark_mode`anyOf 4	`boolean`可選／陣列項目	—
`provider_payload.publish_options.auto_publish_text`anyOf 4	`boolean`可選／陣列項目	—
`provider_payload.publish_options.media_options`anyOf 4	`array`可選／陣列項目	`maxItems: 20`
`provider_payload.publish_options.media_options[]`anyOf 4	`object`可選／陣列項目	`additionalProperties: false`
`provider_payload.publish_options.media_options[].asset_id`anyOf 4	`integer`父物件內必填	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`provider_payload.publish_options.media_options[].alt_text`anyOf 4	`string`可選／陣列項目	`minLength: 1` `maxLength: 1000`
`provider_payload.publish_options.media_options[].is_spoiler_media`anyOf 4	`boolean`可選／陣列項目	—
`provider_payload`anyOf 5	`object`父物件內必填	`additionalProperties: false`
`provider_payload.platform`anyOf 5	`string`父物件內必填	`enum: ["youtube"]`
`provider_payload.publish_options`anyOf 5	`object`父物件內必填	`additionalProperties: false`
`provider_payload.publish_options.post_type`anyOf 5	`string`父物件內必填	`enum: ["VIDEO"]`
`provider_payload.publish_options.title`anyOf 5	`string`父物件內必填	`minLength: 1` `maxLength: 100`
`provider_payload.publish_options.description`anyOf 5	`string`可選／陣列項目	`maxLength: 5000`
`provider_payload.publish_options.tags`anyOf 5	`array`可選／陣列項目	`maxItems: 100`
`provider_payload.publish_options.tags[]`anyOf 5	`string`可選／陣列項目	`minLength: 1` `maxLength: 500`
`provider_payload.publish_options.category_id`anyOf 5	`string`可選／陣列項目	—
`provider_payload.publish_options.category_id`anyOf 5 / anyOf 1	`string`可選／陣列項目	`minLength: 0` `maxLength: 0`
`provider_payload.publish_options.category_id`anyOf 5 / anyOf 2	`string`可選／陣列項目	`pattern: "^\\d+$"`
`provider_payload.publish_options.default_language`anyOf 5	`string`可選／陣列項目	`minLength: 2` `maxLength: 35`
`provider_payload.publish_options.localizations`anyOf 5	`object`可選／陣列項目	`additionalProperties: {"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","maxLength":5000}},"required":["title","description"],"additionalProperties":false}`
`provider_payload.publish_options.localizations.*`anyOf 5	`object`可選／陣列項目	`additionalProperties: false`
`provider_payload.publish_options.localizations.*.title`anyOf 5	`string`父物件內必填	`minLength: 1` `maxLength: 100`
`provider_payload.publish_options.localizations.*.description`anyOf 5	`string`父物件內必填	`maxLength: 5000`
`provider_payload.publish_options.privacy_status`anyOf 5	`string`父物件內必填	`enum: ["private","unlisted","public"]`
`provider_payload.publish_options.cancellation_mode`anyOf 5	`string`父物件內必填	`enum: ["DELETE","UNSCHEDULE_KEEP_PRIVATE"]`
`provider_payload.publish_options.license`anyOf 5	`string`可選／陣列項目	`enum: ["youtube","creativeCommon"]`
`provider_payload.publish_options.embeddable`anyOf 5	`boolean`可選／陣列項目	—
`provider_payload.publish_options.public_stats_viewable`anyOf 5	`boolean`可選／陣列項目	—
`provider_payload.publish_options.self_declared_made_for_kids`anyOf 5	`boolean`可選／陣列項目	—
`provider_payload.publish_options.contains_synthetic_media`anyOf 5	`boolean`可選／陣列項目	—
`provider_payload.publish_options.has_paid_product_placement`anyOf 5	`boolean`可選／陣列項目	—
`provider_payload.publish_options.recording_date`anyOf 5	`string`可選／陣列項目	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`provider_payload.publish_options.notify_subscribers`anyOf 5	`boolean`可選／陣列項目	—
`provider_payload.publish_options.thumbnail_asset_id`anyOf 5	`integer`可選／陣列項目	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`provider_payload.publish_options.surface_expectation`anyOf 5	`string`可選／陣列項目	`enum: ["SHORT"]`
`provider_payload.publish_options.brand_partner`anyOf 5	`object`可選／陣列項目	`additionalProperties: false`
`provider_payload.publish_options.brand_partner.channel_id`anyOf 5	`string`可選／陣列項目	`pattern: "^UC[A-Za-z0-9_-]+$"`
`provider_payload.publish_options.brand_partner.channel_handle`anyOf 5	`string`可選／陣列項目	`pattern: "^@[A-Za-z0-9._-]+$"`
`scheduled_at`	`string`父物件內必填	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`display_timezone`	`string`可選／陣列項目	`minLength: 1` `maxLength: 80`
`local_scheduled_at`	`string`可選／陣列項目	`pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"`
`schedule_dst_disambiguation`	`string`可選／陣列項目	`enum: ["exact","earlier","later"]`
`expires_at`	`string \| null`可選／陣列項目	—
`expires_at`anyOf 1	`string`可選／陣列項目	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`expires_at`anyOf 2	`null`可選／陣列項目	—
`source_ref`	`object \| null`可選／陣列項目	—
`source_ref`anyOf 1	`object`可選／陣列項目	`additionalProperties: {}`
`source_ref.*`anyOf 1	`any JSON value`可選／陣列項目	—
`source_ref`anyOf 2	`null`可選／陣列項目	—
`automatic_retry_enabled`	`boolean`可選／陣列項目	—
`idempotency_key`	`string`父物件內必填	`minLength: 8` `maxLength: 160`

完整 JSON Schema

{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "project_id": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid"
        },
        {
          "type": "null"
        }
      ]
    },
    "social_account_id": {
      "type": "string",
      "format": "uuid"
    },
    "caption": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 5000
        },
        {
          "type": "null"
        }
      ]
    },
    "hashtags": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 100
      }
    },
    "media": {
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "image",
              "video"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "cover_url": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ]
          },
          "cover_asset_id": {
            "anyOf": [
              {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "asset_id": {
            "anyOf": [
              {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "mime_type": {
            "anyOf": [
              {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "kind",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "link_url": {
      "anyOf": [
        {
          "type": "string",
          "format": "uri"
        },
        {
          "type": "null"
        }
      ]
    },
    "provider_payload": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "platform": {
              "type": "string",
              "enum": [
                "x"
              ]
            },
            "publish_options": {
              "type": "object",
              "properties": {
                "post_type": {
                  "type": "string",
                  "enum": [
                    "TEXT"
                  ]
                }
              },
              "required": [
                "post_type"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "platform",
            "publish_options"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "platform": {
              "type": "string",
              "enum": [
                "instagram"
              ]
            },
            "publish_options": {
              "type": "object",
              "properties": {
                "post_type": {
                  "type": "string",
                  "enum": [
                    "IMAGE",
                    "VIDEO",
                    "CAROUSEL",
                    "REELS",
                    "STORY_IMAGE",
                    "STORY_VIDEO"
                  ]
                },
                "location_id": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256
                },
                "share_to_feed": {
                  "type": "boolean"
                },
                "collaborators": {
                  "maxItems": 3,
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 30
                  }
                },
                "first_comment": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 2200
                },
                "cover_asset_id": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 9007199254740991
                },
                "thumb_offset_ms": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991
                },
                "audio_name": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100
                },
                "trial_params": {
                  "type": "object",
                  "properties": {
                    "graduation_strategy": {
                      "type": "string",
                      "enum": [
                        "MANUAL",
                        "SS_PERFORMANCE"
                      ]
                    }
                  },
                  "required": [
                    "graduation_strategy"
                  ],
                  "additionalProperties": false
                },
                "is_ai_generated": {
                  "type": "boolean"
                },
                "branded_content_sponsor_ids": {
                  "maxItems": 2,
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 256
                  }
                },
                "is_paid_partnership": {
                  "type": "boolean"
                },
                "media_options": {
                  "maxItems": 10,
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "asset_id": {
                        "type": "integer",
                        "exclusiveMinimum": 0,
                        "maximum": 9007199254740991
                      },
                      "alt_text": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1000
                      },
                      "user_tags": {
                        "maxItems": 20,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "username": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 30
                            },
                            "x": {
                              "type": "number",
                              "minimum": 0,
                              "maximum": 1
                            },
                            "y": {
                              "type": "number",
                              "minimum": 0,
                              "maximum": 1
                            }
                          },
                          "required": [
                            "username"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "product_tags": {
                        "maxItems": 5,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "product_id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 256
                            },
                            "x": {
                              "type": "number",
                              "minimum": 0,
                              "maximum": 1
                            },
                            "y": {
                              "type": "number",
                              "minimum": 0,
                              "maximum": 1
                            }
                          },
                          "required": [
                            "product_id"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "thumb_offset_ms": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      }
                    },
                    "required": [
                      "asset_id"
                    ],
                    "additionalProperties": false
                  }
                }
              },
              "required": [
                "post_type"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "platform",
            "publish_options"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "platform": {
              "type": "string",
              "enum": [
                "facebook"
              ]
            },
            "publish_options": {
              "type": "object",
              "properties": {
                "post_type": {
                  "type": "string",
                  "enum": [
                    "TEXT",
                    "LINK",
                    "IMAGE",
                    "MULTI_IMAGE",
                    "VIDEO",
                    "REELS",
                    "STORY_IMAGE",
                    "STORY_VIDEO"
                  ]
                },
                "title": {
                  "type": "string",
                  "maxLength": 255
                },
                "description": {
                  "type": "string",
                  "maxLength": 5000
                },
                "publication_mode": {
                  "type": "string",
                  "enum": [
                    "PUBLISH",
                    "DRAFT"
                  ]
                },
                "backdated_time": {
                  "type": "number"
                },
                "backdated_time_granularity": {
                  "type": "string",
                  "enum": [
                    "year",
                    "month",
                    "day",
                    "hour",
                    "minute"
                  ]
                },
                "place": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256
                },
                "tags": {
                  "maxItems": 50,
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 256
                  }
                },
                "feed_targeting": {
                  "type": "object",
                  "properties": {
                    "age_min": {
                      "type": "integer",
                      "minimum": 13,
                      "maximum": 65
                    },
                    "age_max": {
                      "type": "integer",
                      "minimum": 13,
                      "maximum": 65
                    },
                    "college_years": {
                      "maxItems": 100,
                      "type": "array",
                      "items": {
                        "type": "integer",
                        "minimum": 1900,
                        "maximum": 2200
                      }
                    },
                    "education_statuses": {
                      "maxItems": 3,
                      "type": "array",
                      "items": {
                        "anyOf": [
                          {
                            "type": "number",
                            "enum": [
                              1
                            ]
                          },
                          {
                            "type": "number",
                            "enum": [
                              2
                            ]
                          },
                          {
                            "type": "number",
                            "enum": [
                              3
                            ]
                          }
                        ]
                      }
                    },
                    "genders": {
                      "maxItems": 2,
                      "type": "array",
                      "items": {
                        "anyOf": [
                          {
                            "type": "number",
                            "enum": [
                              1
                            ]
                          },
                          {
                            "type": "number",
                            "enum": [
                              2
                            ]
                          }
                        ]
                      }
                    },
                    "geo_locations": {
                      "type": "object",
                      "properties": {
                        "countries": {
                          "minItems": 1,
                          "maxItems": 25,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Z]{2}$"
                          }
                        },
                        "regions": {
                          "minItems": 1,
                          "maxItems": 250,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "key": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 256
                                  },
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  }
                                ]
                              }
                            },
                            "required": [
                              "key"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "cities": {
                          "minItems": 1,
                          "maxItems": 250,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "key": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 256
                                  },
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  }
                                ]
                              },
                              "radius": {
                                "type": "number",
                                "exclusiveMinimum": 0,
                                "maximum": 1000
                              },
                              "distance_unit": {
                                "type": "string",
                                "enum": [
                                  "mile",
                                  "kilometer"
                                ]
                              }
                            },
                            "required": [
                              "key"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "zips": {
                          "minItems": 1,
                          "maxItems": 250,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "key": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 256
                                  },
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  }
                                ]
                              }
                            },
                            "required": [
                              "key"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "location_types": {
                          "minItems": 1,
                          "maxItems": 2,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "home",
                              "recent"
                            ]
                          }
                        }
                      },
                      "additionalProperties": false
                    },
                    "interests": {
                      "maxItems": 250,
                      "type": "array",
                      "items": {
                        "anyOf": [
                          {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 256
                          },
                          {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          }
                        ]
                      }
                    },
                    "locales": {
                      "maxItems": 250,
                      "type": "array",
                      "items": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      }
                    },
                    "relationship_statuses": {
                      "maxItems": 4,
                      "type": "array",
                      "items": {
                        "anyOf": [
                          {
                            "type": "number",
                            "enum": [
                              1
                            ]
                          },
                          {
                            "type": "number",
                            "enum": [
                              2
                            ]
                          },
                          {
                            "type": "number",
                            "enum": [
                              3
                            ]
                          },
                          {
                            "type": "number",
                            "enum": [
                              4
                            ]
                          }
                        ]
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "targeting": {
                  "type": "object",
                  "properties": {
                    "age_min": {
                      "anyOf": [
                        {
                          "type": "number",
                          "enum": [
                            13
                          ]
                        },
                        {
                          "type": "number",
                          "enum": [
                            15
                          ]
                        },
                        {
                          "type": "number",
                          "enum": [
                            18
                          ]
                        },
                        {
                          "type": "number",
                          "enum": [
                            21
                          ]
                        },
                        {
                          "type": "number",
                          "enum": [
                            25
                          ]
                        }
                      ]
                    },
                    "geo_locations": {
                      "type": "object",
                      "properties": {
                        "countries": {
                          "minItems": 1,
                          "maxItems": 25,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Z]{2}$"
                          }
                        },
                        "regions": {
                          "minItems": 1,
                          "maxItems": 250,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "key": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 256
                                  },
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  }
                                ]
                              }
                            },
                            "required": [
                              "key"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "cities": {
                          "minItems": 1,
                          "maxItems": 250,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "key": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 256
                                  },
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  }
                                ]
                              },
                              "radius": {
                                "type": "number",
                                "exclusiveMinimum": 0,
                                "maximum": 1000
                              },
                              "distance_unit": {
                                "type": "string",
                                "enum": [
                                  "mile",
                                  "kilometer"
                                ]
                              }
                            },
                            "required": [
                              "key"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "zips": {
                          "minItems": 1,
                          "maxItems": 250,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "key": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 256
                                  },
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  }
                                ]
                              }
                            },
                            "required": [
                              "key"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "location_types": {
                          "minItems": 1,
                          "maxItems": 2,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "home",
                              "recent"
                            ]
                          }
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                },
                "child_attachments": {
                  "minItems": 2,
                  "maxItems": 10,
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "link": {
                        "type": "string",
                        "format": "uri"
                      },
                      "name": {
                        "type": "string",
                        "maxLength": 255
                      },
                      "description": {
                        "type": "string",
                        "maxLength": 1000
                      },
                      "picture": {
                        "type": "string",
                        "format": "uri"
                      }
                    },
                    "required": [
                      "link",
                      "picture"
                    ],
                    "additionalProperties": false
                  }
                },
                "multi_share_end_card": {
                  "type": "boolean"
                },
                "multi_share_optimized": {
                  "type": "boolean"
                },
                "unpublished_content_type": {
                  "type": "string",
                  "enum": [
                    "SCHEDULED",
                    "SCHEDULED_RECURRING",
                    "DRAFT",
                    "PUBLISH_PENDING",
                    "ADS_POST",
                    "INLINE_CREATED",
                    "PUBLISHED",
                    "REVIEWABLE_BRANDED_CONTENT"
                  ]
                },
                "no_story": {
                  "type": "boolean"
                },
                "crossposted_video_id": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256
                },
                "spherical": {
                  "type": "boolean"
                },
                "media_options": {
                  "maxItems": 20,
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "asset_id": {
                        "type": "integer",
                        "exclusiveMinimum": 0,
                        "maximum": 9007199254740991
                      },
                      "alt_text_custom": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1000
                      }
                    },
                    "required": [
                      "asset_id"
                    ],
                    "additionalProperties": false
                  }
                }
              },
              "required": [
                "post_type"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "platform",
            "publish_options"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "platform": {
              "type": "string",
              "enum": [
                "threads"
              ]
            },
            "publish_options": {
              "type": "object",
              "properties": {
                "post_type": {
                  "type": "string",
                  "enum": [
                    "TEXT",
                    "IMAGE",
                    "VIDEO",
                    "CAROUSEL",
                    "REPOST"
                  ]
                },
                "reply_to_id": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256
                },
                "quote_post_id": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256
                },
                "repost_target_id": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256
                },
                "reply_control": {
                  "type": "string",
                  "enum": [
                    "everyone",
                    "accounts_you_follow",
                    "mentioned_only",
                    "parent_post_author_only",
                    "followers_only"
                  ]
                },
                "enable_reply_approvals": {
                  "type": "boolean"
                },
                "link_attachment": {
                  "type": "string",
                  "format": "uri"
                },
                "poll_attachment": {
                  "type": "object",
                  "properties": {
                    "option_a": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 25
                    },
                    "option_b": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 25
                    },
                    "option_c": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 25
                    },
                    "option_d": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 25
                    }
                  },
                  "required": [
                    "option_a",
                    "option_b"
                  ],
                  "additionalProperties": false
                },
                "gif_attachment": {
                  "type": "object",
                  "properties": {
                    "gif_id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 256
                    },
                    "provider": {
                      "type": "string",
                      "enum": [
                        "GIPHY"
                      ]
                    }
                  },
                  "required": [
                    "gif_id",
                    "provider"
                  ],
                  "additionalProperties": false
                },
                "text_attachment": {
                  "type": "object",
                  "properties": {
                    "plaintext": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 10000
                    },
                    "link_attachment_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "text_with_styling_info": {
                      "maxItems": 100,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "offset": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          "length": {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991
                          },
                          "styling_info": {
                            "minItems": 1,
                            "type": "array",
                            "items": {
                              "type": "string",
                              "enum": [
                                "bold",
                                "italic",
                                "highlight",
                                "underline",
                                "strikethrough"
                              ]
                            }
                          }
                        },
                        "required": [
                          "offset",
                          "length",
                          "styling_info"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "plaintext"
                  ],
                  "additionalProperties": false
                },
                "topic_tag": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50
                },
                "text_entities": {
                  "maxItems": 10,
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "entity_type": {
                        "type": "string",
                        "enum": [
                          "SPOILER",
                          "spoiler"
                        ]
                      },
                      "offset": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      "length": {
                        "type": "integer",
                        "exclusiveMinimum": 0,
                        "maximum": 9007199254740991
                      }
                    },
                    "required": [
                      "entity_type",
                      "offset",
                      "length"
                    ],
                    "additionalProperties": false
                  }
                },
                "is_spoiler_media": {
                  "type": "boolean"
                },
                "is_ghost_post": {
                  "type": "boolean"
                },
                "location_id": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256
                },
                "allowlisted_country_codes": {
                  "minItems": 1,
                  "maxItems": 249,
                  "type": "array",
                  "items": {
                    "type": "string",
                    "pattern": "^[A-Z]{2}$"
                  }
                },
                "crossreshare_to_ig": {
                  "type": "boolean"
                },
                "crossreshare_to_ig_dark_mode": {
                  "type": "boolean"
                },
                "auto_publish_text": {
                  "type": "boolean"
                },
                "media_options": {
                  "maxItems": 20,
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "asset_id": {
                        "type": "integer",
                        "exclusiveMinimum": 0,
                        "maximum": 9007199254740991
                      },
                      "alt_text": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1000
                      },
                      "is_spoiler_media": {
                        "type": "boolean"
                      }
                    },
                    "required": [
                      "asset_id"
                    ],
                    "additionalProperties": false
                  }
                }
              },
              "required": [
                "post_type"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "platform",
            "publish_options"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "platform": {
              "type": "string",
              "enum": [
                "youtube"
              ]
            },
            "publish_options": {
              "type": "object",
              "properties": {
                "post_type": {
                  "type": "string",
                  "enum": [
                    "VIDEO"
                  ]
                },
                "title": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100
                },
                "description": {
                  "type": "string",
                  "maxLength": 5000
                },
                "tags": {
                  "maxItems": 100,
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 500
                  }
                },
                "category_id": {
                  "anyOf": [
                    {
                      "type": "string",
                      "minLength": 0,
                      "maxLength": 0
                    },
                    {
                      "type": "string",
                      "pattern": "^\\d+$"
                    }
                  ]
                },
                "default_language": {
                  "type": "string",
                  "minLength": 2,
                  "maxLength": 35
                },
                "localizations": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "object",
                    "properties": {
                      "title": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "description": {
                        "type": "string",
                        "maxLength": 5000
                      }
                    },
                    "required": [
                      "title",
                      "description"
                    ],
                    "additionalProperties": false
                  }
                },
                "privacy_status": {
                  "type": "string",
                  "enum": [
                    "private",
                    "unlisted",
                    "public"
                  ]
                },
                "cancellation_mode": {
                  "type": "string",
                  "enum": [
                    "DELETE",
                    "UNSCHEDULE_KEEP_PRIVATE"
                  ]
                },
                "license": {
                  "type": "string",
                  "enum": [
                    "youtube",
                    "creativeCommon"
                  ]
                },
                "embeddable": {
                  "type": "boolean"
                },
                "public_stats_viewable": {
                  "type": "boolean"
                },
                "self_declared_made_for_kids": {
                  "type": "boolean"
                },
                "contains_synthetic_media": {
                  "type": "boolean"
                },
                "has_paid_product_placement": {
                  "type": "boolean"
                },
                "recording_date": {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                },
                "notify_subscribers": {
                  "type": "boolean"
                },
                "thumbnail_asset_id": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 9007199254740991
                },
                "surface_expectation": {
                  "type": "string",
                  "enum": [
                    "SHORT"
                  ]
                },
                "brand_partner": {
                  "type": "object",
                  "properties": {
                    "channel_id": {
                      "type": "string",
                      "pattern": "^UC[A-Za-z0-9_-]+$"
                    },
                    "channel_handle": {
                      "type": "string",
                      "pattern": "^@[A-Za-z0-9._-]+$"
                    }
                  },
                  "additionalProperties": false
                }
              },
              "required": [
                "post_type",
                "title",
                "privacy_status",
                "cancellation_mode"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "platform",
            "publish_options"
          ],
          "additionalProperties": false
        }
      ]
    },
    "scheduled_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
    },
    "display_timezone": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "local_scheduled_at": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
    },
    "schedule_dst_disambiguation": {
      "type": "string",
      "enum": [
        "exact",
        "earlier",
        "later"
      ]
    },
    "expires_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
        },
        {
          "type": "null"
        }
      ]
    },
    "source_ref": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ]
    },
    "automatic_retry_enabled": {
      "type": "boolean"
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 8,
      "maxLength": 160
    }
  },
  "required": [
    "workspace_id",
    "social_account_id",
    "provider_payload",
    "scheduled_at",
    "idempotency_key"
  ],
  "additionalProperties": false
}

結構化輸出

此 schema 描述成功工具結果嘅 structuredContent。MCP envelope 亦包括 content，失敗可能設定 isError；唔好將文字收據或接受請求當成平台終態。權限及重試規則見對應 API 操作。

必填表示喺所屬物件及所選分支內必須提供；子欄位必填唔代表可選父物件變成必填。以下欄位名稱及規則直接來自 contract。

結構化輸出
欄位／分支	類型／必填	限制
`$`	`object`父物件內必填	`additionalProperties: false`
`post`	`object`父物件內必填	`additionalProperties: false`
`post.id`	`string`父物件內必填	`pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"`
`post.workspace_id`	`string`父物件內必填	`format: "uuid"`
`post.social_account_id`	`string \| null`父物件內必填	—
`post.social_account_id`anyOf 1	`string`父物件內必填	`format: "uuid"`
`post.social_account_id`anyOf 2	`null`父物件內必填	—
`post.platform`	`string`父物件內必填	`enum: ["instagram","threads","facebook","youtube","x"]`
`post.destination`	`object`父物件內必填	`additionalProperties: false`
`post.destination.social_account_id`	`string \| null`父物件內必填	—
`post.destination.social_account_id`anyOf 1	`string`父物件內必填	`format: "uuid"`
`post.destination.social_account_id`anyOf 2	`null`父物件內必填	—
`post.destination.platform`	`string`父物件內必填	`enum: ["instagram","threads","facebook","youtube","x"]`
`post.destination.platform_user_id`	`string \| null`父物件內必填	—
`post.destination.platform_user_id`anyOf 1	`string`父物件內必填	—
`post.destination.platform_user_id`anyOf 2	`null`父物件內必填	—
`post.destination.account_label`	`string \| null`父物件內必填	—
`post.destination.account_label`anyOf 1	`string`父物件內必填	—
`post.destination.account_label`anyOf 2	`null`父物件內必填	—
`post.caption`	`string \| null`父物件內必填	—
`post.caption`anyOf 1	`string`父物件內必填	—
`post.caption`anyOf 2	`null`父物件內必填	—
`post.hashtags`	`array`父物件內必填	—
`post.hashtags[]`	`string`可選／陣列項目	—
`post.media`	`array`父物件內必填	—
`post.media[]`	`object`可選／陣列項目	`additionalProperties: false`
`post.media[].kind`	`string`父物件內必填	`enum: ["image","video"]`
`post.media[].url`	`string`父物件內必填	`format: "uri"`
`post.media[].cover_url`	`string \| null`可選／陣列項目	—
`post.media[].cover_url`anyOf 1	`string`可選／陣列項目	`format: "uri"`
`post.media[].cover_url`anyOf 2	`null`可選／陣列項目	—
`post.media[].cover_asset_id`	`integer \| null`可選／陣列項目	—
`post.media[].cover_asset_id`anyOf 1	`integer`可選／陣列項目	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`post.media[].cover_asset_id`anyOf 2	`null`可選／陣列項目	—
`post.media[].asset_id`	`integer \| null`可選／陣列項目	—
`post.media[].asset_id`anyOf 1	`integer`可選／陣列項目	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`post.media[].asset_id`anyOf 2	`null`可選／陣列項目	—
`post.media[].mime_type`	`string \| null`可選／陣列項目	—
`post.media[].mime_type`anyOf 1	`string`可選／陣列項目	`minLength: 1` `maxLength: 160`
`post.media[].mime_type`anyOf 2	`null`可選／陣列項目	—
`post.media[].preview_url`	`string \| null`可選／陣列項目	Temporary authorized read URL; keep url as persisted Scheduled Post media identity. —
`post.media[].preview_url`anyOf 1	`string`可選／陣列項目	`format: "uri"`
`post.media[].preview_url`anyOf 2	`null`可選／陣列項目	—
`post.media[].cover_preview_url`	`string \| null`可選／陣列項目	Temporary authorized cover read URL; keep cover_url as persisted media identity. —
`post.media[].cover_preview_url`anyOf 1	`string`可選／陣列項目	`format: "uri"`
`post.media[].cover_preview_url`anyOf 2	`null`可選／陣列項目	—
`post.media[].preview_expires_at`	`string \| null`可選／陣列項目	—
`post.media[].preview_expires_at`anyOf 1	`string`可選／陣列項目	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"`
`post.media[].preview_expires_at`anyOf 2	`null`可選／陣列項目	—
`post.link_url`	`string \| null`可選／陣列項目	—
`post.link_url`anyOf 1	`string`可選／陣列項目	`format: "uri"`
`post.link_url`anyOf 2	`null`可選／陣列項目	—
`post.publish_options`	`object`父物件內必填	`additionalProperties: false`
`post.publish_options.post_type`	`string`可選／陣列項目	`enum: ["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]`
`post.publish_options.location_id`	`string`可選／陣列項目	`minLength: 1`
`post.publish_options.share_to_feed`	`boolean`可選／陣列項目	—
`post.publish_options.collaborators`	`array`可選／陣列項目	`maxItems: 3`
`post.publish_options.collaborators[]`	`string`可選／陣列項目	`minLength: 1`
`post.publish_options.first_comment`	`string`可選／陣列項目	`minLength: 1` `maxLength: 2200`
`post.publish_options.topic_tag`	`string`可選／陣列項目	`minLength: 1`
`post.publish_options.thumb_offset_ms`	`integer`可選／陣列項目	`minimum: 0` `maximum: 9007199254740991`
`post.publish_options.title`	`string`可選／陣列項目	`maxLength: 255`
`post.publish_options.youtube_privacy_status`	`string`可選／陣列項目	`enum: ["private","unlisted","public"]`
`post.publish_options.youtube_category_id`	`string`可選／陣列項目	`pattern: "^\\d+$"`
`post.publish_options.youtube_contains_synthetic_media`	`boolean`可選／陣列項目	—
`post.publish_options.description`	`string`可選／陣列項目	`maxLength: 5000`
`post.publish_options.category_id`	`string`可選／陣列項目	`pattern: "^\\d+$"`
`post.publish_options.privacy_status`	`string`可選／陣列項目	`enum: ["private","unlisted","public"]`
`post.publish_options.cancellation_mode`	`string`可選／陣列項目	`enum: ["DELETE","UNSCHEDULE_KEEP_PRIVATE"]`
`post.publish_options.tags`	`array`可選／陣列項目	—
`post.publish_options.tags[]`	`string`可選／陣列項目	—
`post.publish_options.default_language`	`string`可選／陣列項目	—
`post.publish_options.localizations`	`object`可選／陣列項目	`additionalProperties: {}`
`post.publish_options.localizations.*`	`any JSON value`可選／陣列項目	—
`post.publish_options.license`	`string`可選／陣列項目	`enum: ["youtube","creativeCommon"]`
`post.publish_options.embeddable`	`boolean`可選／陣列項目	—
`post.publish_options.public_stats_viewable`	`boolean`可選／陣列項目	—
`post.publish_options.self_declared_made_for_kids`	`boolean`可選／陣列項目	—
`post.publish_options.contains_synthetic_media`	`boolean`可選／陣列項目	—
`post.publish_options.has_paid_product_placement`	`boolean`可選／陣列項目	—
`post.publish_options.recording_date`	`string`可選／陣列項目	—
`post.publish_options.notify_subscribers`	`boolean`可選／陣列項目	—
`post.publish_options.thumbnail_asset_id`	`integer`可選／陣列項目	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`post.publish_options.surface_expectation`	`string`可選／陣列項目	`const: "SHORT"`
`post.publish_options.brand_partner`	`object`可選／陣列項目	`additionalProperties: {}`
`post.publish_options.brand_partner.*`	`any JSON value`可選／陣列項目	—
`post.publish_options.cover_asset_id`	`integer`可選／陣列項目	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`post.publish_options.audio_name`	`string`可選／陣列項目	—
`post.publish_options.trial_params`	`object`可選／陣列項目	`additionalProperties: {}`
`post.publish_options.trial_params.*`	`any JSON value`可選／陣列項目	—
`post.publish_options.is_ai_generated`	`boolean`可選／陣列項目	—
`post.publish_options.branded_content_sponsor_ids`	`array`可選／陣列項目	—
`post.publish_options.branded_content_sponsor_ids[]`	`string`可選／陣列項目	—
`post.publish_options.is_paid_partnership`	`boolean`可選／陣列項目	—
`post.publish_options.media_options`	`array`可選／陣列項目	—
`post.publish_options.media_options[]`	`object`可選／陣列項目	`additionalProperties: {}`
`post.publish_options.media_options[].*`	`any JSON value`可選／陣列項目	—
`post.publish_options.reply_to_id`	`string`可選／陣列項目	—
`post.publish_options.quote_post_id`	`string`可選／陣列項目	—
`post.publish_options.repost_target_id`	`string`可選／陣列項目	—
`post.publish_options.reply_control`	`string`可選／陣列項目	—
`post.publish_options.enable_reply_approvals`	`boolean`可選／陣列項目	—
`post.publish_options.link_attachment`	`string`可選／陣列項目	`format: "uri"`
`post.publish_options.poll_attachment`	`object`可選／陣列項目	`additionalProperties: {}`
`post.publish_options.poll_attachment.*`	`any JSON value`可選／陣列項目	—
`post.publish_options.gif_attachment`	`object`可選／陣列項目	`additionalProperties: {}`
`post.publish_options.gif_attachment.*`	`any JSON value`可選／陣列項目	—
`post.publish_options.text_attachment`	`object`可選／陣列項目	`additionalProperties: {}`
`post.publish_options.text_attachment.*`	`any JSON value`可選／陣列項目	—
`post.publish_options.text_entities`	`array`可選／陣列項目	—
`post.publish_options.text_entities[]`	`object`可選／陣列項目	`additionalProperties: {}`
`post.publish_options.text_entities[].*`	`any JSON value`可選／陣列項目	—
`post.publish_options.is_spoiler_media`	`boolean`可選／陣列項目	—
`post.publish_options.is_ghost_post`	`boolean`可選／陣列項目	—
`post.publish_options.allowlisted_country_codes`	`array`可選／陣列項目	—
`post.publish_options.allowlisted_country_codes[]`	`string`可選／陣列項目	—
`post.publish_options.crossreshare_to_ig`	`boolean`可選／陣列項目	—
`post.publish_options.crossreshare_to_ig_dark_mode`	`boolean`可選／陣列項目	—
`post.publish_options.auto_publish_text`	`boolean`可選／陣列項目	—
`post.publish_options.publication_mode`	`string`可選／陣列項目	`enum: ["PUBLISH","DRAFT"]`
`post.publish_options.backdated_time`	`number`可選／陣列項目	—
`post.publish_options.backdated_time_granularity`	`string`可選／陣列項目	`enum: ["year","month","day","hour","minute"]`
`post.publish_options.place`	`string`可選／陣列項目	—
`post.publish_options.feed_targeting`	`object`可選／陣列項目	`additionalProperties: {}`
`post.publish_options.feed_targeting.*`	`any JSON value`可選／陣列項目	—
`post.publish_options.targeting`	`object`可選／陣列項目	`additionalProperties: {}`
`post.publish_options.targeting.*`	`any JSON value`可選／陣列項目	—
`post.publish_options.child_attachments`	`array`可選／陣列項目	—
`post.publish_options.child_attachments[]`	`object`可選／陣列項目	`additionalProperties: {}`
`post.publish_options.child_attachments[].*`	`any JSON value`可選／陣列項目	—
`post.publish_options.multi_share_end_card`	`boolean`可選／陣列項目	—
`post.publish_options.multi_share_optimized`	`boolean`可選／陣列項目	—
`post.publish_options.unpublished_content_type`	`string`可選／陣列項目	—
`post.publish_options.no_story`	`boolean`可選／陣列項目	—
`post.publish_options.crossposted_video_id`	`string`可選／陣列項目	—
`post.publish_options.spherical`	`boolean`可選／陣列項目	—
`post.scheduled_at`	`string`父物件內必填	—
`post.display_timezone`	`string`父物件內必填	`minLength: 1` `maxLength: 80`
`post.local_scheduled_at`	`string \| null`可選／陣列項目	—
`post.local_scheduled_at`anyOf 1	`string`可選／陣列項目	`pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"`
`post.local_scheduled_at`anyOf 2	`null`可選／陣列項目	—
`post.schedule_timezone`	`string \| null`可選／陣列項目	—
`post.schedule_timezone`anyOf 1	`string`可選／陣列項目	`minLength: 1` `maxLength: 80`
`post.schedule_timezone`anyOf 2	`null`可選／陣列項目	—
`post.schedule_dst_disambiguation`	`string \| null`可選／陣列項目	—
`post.schedule_dst_disambiguation`anyOf 1	`string`可選／陣列項目	`enum: ["exact","earlier","later"]`
`post.schedule_dst_disambiguation`anyOf 2	`null`可選／陣列項目	—
`post.schedule_intent_state`	`string`可選／陣列項目	`enum: ["verified","legacy_unverified"]`
`post.expires_at`	`string \| null`父物件內必填	—
`post.expires_at`anyOf 1	`string`父物件內必填	—
`post.expires_at`anyOf 2	`null`父物件內必填	—
`post.status`	`string`父物件內必填	`enum: ["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]`
`post.version`	`integer`父物件內必填	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`post.automatic_retry_enabled`	`boolean`父物件內必填	—
`post.delete_requested_at`	`string \| null`父物件內必填	—
`post.delete_requested_at`anyOf 1	`string`父物件內必填	—
`post.delete_requested_at`anyOf 2	`null`父物件內必填	—
`post.published_at`	`string \| null`父物件內必填	—
`post.published_at`anyOf 1	`string`父物件內必填	—
`post.published_at`anyOf 2	`null`父物件內必填	—
`post.deleted_at`	`string \| null`父物件內必填	—
`post.deleted_at`anyOf 1	`string`父物件內必填	—
`post.deleted_at`anyOf 2	`null`父物件內必填	—
`post.provider_post_id`	`string \| null`父物件內必填	—
`post.provider_post_id`anyOf 1	`string`父物件內必填	—
`post.provider_post_id`anyOf 2	`null`父物件內必填	—
`post.permalink`	`string \| null`父物件內必填	—
`post.permalink`anyOf 1	`string`父物件內必填	`format: "uri"`
`post.permalink`anyOf 2	`null`父物件內必填	—
`post.created_at`	`string`父物件內必填	—
`post.updated_at`	`string`父物件內必填	—
`post.project_id`	`string \| null`父物件內必填	—
`post.project_id`anyOf 1	`string`父物件內必填	`format: "uuid"`
`post.project_id`anyOf 2	`null`父物件內必填	—
`post.batch_id`	`string \| null`父物件內必填	—
`post.batch_id`anyOf 1	`string`父物件內必填	`format: "uuid"`
`post.batch_id`anyOf 2	`null`父物件內必填	—
`post.source_ref`	`object \| null`父物件內必填	—
`post.source_ref`anyOf 1	`object`父物件內必填	`additionalProperties: {}`
`post.source_ref.*`anyOf 1	`any JSON value`可選／陣列項目	—
`post.source_ref`anyOf 2	`null`父物件內必填	—
`deduped`	`boolean`父物件內必填	—

完整 JSON Schema

{
  "type": "object",
  "properties": {
    "post": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
        },
        "workspace_id": {
          "type": "string",
          "format": "uuid"
        },
        "social_account_id": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid"
            },
            {
              "type": "null"
            }
          ]
        },
        "platform": {
          "type": "string",
          "enum": [
            "instagram",
            "threads",
            "facebook",
            "youtube",
            "x"
          ]
        },
        "destination": {
          "type": "object",
          "properties": {
            "social_account_id": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "uuid"
                },
                {
                  "type": "null"
                }
              ]
            },
            "platform": {
              "type": "string",
              "enum": [
                "instagram",
                "threads",
                "facebook",
                "youtube",
                "x"
              ]
            },
            "platform_user_id": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "account_label": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "social_account_id",
            "platform",
            "platform_user_id",
            "account_label"
          ],
          "additionalProperties": false
        },
        "caption": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "hashtags": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "media": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "enum": [
                  "image",
                  "video"
                ]
              },
              "url": {
                "type": "string",
                "format": "uri"
              },
              "cover_url": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "uri"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "cover_asset_id": {
                "anyOf": [
                  {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "asset_id": {
                "anyOf": [
                  {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "mime_type": {
                "anyOf": [
                  {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 160
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "preview_url": {
                "description": "Temporary authorized read URL; keep url as persisted Scheduled Post media identity.",
                "anyOf": [
                  {
                    "type": "string",
                    "format": "uri"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "cover_preview_url": {
                "description": "Temporary authorized cover read URL; keep cover_url as persisted media identity.",
                "anyOf": [
                  {
                    "type": "string",
                    "format": "uri"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "preview_expires_at": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "kind",
              "url"
            ],
            "additionalProperties": false
          }
        },
        "link_url": {
          "anyOf": [
            {
              "type": "string",
              "format": "uri"
            },
            {
              "type": "null"
            }
          ]
        },
        "publish_options": {
          "type": "object",
          "properties": {
            "post_type": {
              "type": "string",
              "enum": [
                "TEXT",
                "LINK",
                "IMAGE",
                "MULTI_IMAGE",
                "VIDEO",
                "CAROUSEL",
                "REELS",
                "STORY_IMAGE",
                "STORY_VIDEO",
                "REPOST",
                "SHORT"
              ]
            },
            "location_id": {
              "type": "string",
              "minLength": 1
            },
            "share_to_feed": {
              "type": "boolean"
            },
            "collaborators": {
              "maxItems": 3,
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1
              }
            },
            "first_comment": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2200
            },
            "topic_tag": {
              "type": "string",
              "minLength": 1
            },
            "thumb_offset_ms": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "title": {
              "type": "string",
              "maxLength": 255
            },
            "youtube_privacy_status": {
              "type": "string",
              "enum": [
                "private",
                "unlisted",
                "public"
              ]
            },
            "youtube_category_id": {
              "type": "string",
              "pattern": "^\\d+$"
            },
            "youtube_contains_synthetic_media": {
              "type": "boolean"
            },
            "description": {
              "type": "string",
              "maxLength": 5000
            },
            "category_id": {
              "type": "string",
              "pattern": "^\\d+$"
            },
            "privacy_status": {
              "type": "string",
              "enum": [
                "private",
                "unlisted",
                "public"
              ]
            },
            "cancellation_mode": {
              "type": "string",
              "enum": [
                "DELETE",
                "UNSCHEDULE_KEEP_PRIVATE"
              ]
            },
            "tags": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "default_language": {
              "type": "string"
            },
            "localizations": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "license": {
              "type": "string",
              "enum": [
                "youtube",
                "creativeCommon"
              ]
            },
            "embeddable": {
              "type": "boolean"
            },
            "public_stats_viewable": {
              "type": "boolean"
            },
            "self_declared_made_for_kids": {
              "type": "boolean"
            },
            "contains_synthetic_media": {
              "type": "boolean"
            },
            "has_paid_product_placement": {
              "type": "boolean"
            },
            "recording_date": {
              "type": "string"
            },
            "notify_subscribers": {
              "type": "boolean"
            },
            "thumbnail_asset_id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            },
            "surface_expectation": {
              "type": "string",
              "const": "SHORT"
            },
            "brand_partner": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "cover_asset_id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            },
            "audio_name": {
              "type": "string"
            },
            "trial_params": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "is_ai_generated": {
              "type": "boolean"
            },
            "branded_content_sponsor_ids": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "is_paid_partnership": {
              "type": "boolean"
            },
            "media_options": {
              "type": "array",
              "items": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              }
            },
            "reply_to_id": {
              "type": "string"
            },
            "quote_post_id": {
              "type": "string"
            },
            "repost_target_id": {
              "type": "string"
            },
            "reply_control": {
              "type": "string"
            },
            "enable_reply_approvals": {
              "type": "boolean"
            },
            "link_attachment": {
              "type": "string",
              "format": "uri"
            },
            "poll_attachment": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "gif_attachment": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "text_attachment": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "text_entities": {
              "type": "array",
              "items": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              }
            },
            "is_spoiler_media": {
              "type": "boolean"
            },
            "is_ghost_post": {
              "type": "boolean"
            },
            "allowlisted_country_codes": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "crossreshare_to_ig": {
              "type": "boolean"
            },
            "crossreshare_to_ig_dark_mode": {
              "type": "boolean"
            },
            "auto_publish_text": {
              "type": "boolean"
            },
            "publication_mode": {
              "type": "string",
              "enum": [
                "PUBLISH",
                "DRAFT"
              ]
            },
            "backdated_time": {
              "type": "number"
            },
            "backdated_time_granularity": {
              "type": "string",
              "enum": [
                "year",
                "month",
                "day",
                "hour",
                "minute"
              ]
            },
            "place": {
              "type": "string"
            },
            "feed_targeting": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "targeting": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "child_attachments": {
              "type": "array",
              "items": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              }
            },
            "multi_share_end_card": {
              "type": "boolean"
            },
            "multi_share_optimized": {
              "type": "boolean"
            },
            "unpublished_content_type": {
              "type": "string"
            },
            "no_story": {
              "type": "boolean"
            },
            "crossposted_video_id": {
              "type": "string"
            },
            "spherical": {
              "type": "boolean"
            }
          },
          "additionalProperties": false
        },
        "scheduled_at": {
          "type": "string"
        },
        "display_timezone": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80
        },
        "local_scheduled_at": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
            },
            {
              "type": "null"
            }
          ]
        },
        "schedule_timezone": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1,
              "maxLength": 80
            },
            {
              "type": "null"
            }
          ]
        },
        "schedule_dst_disambiguation": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "exact",
                "earlier",
                "later"
              ]
            },
            {
              "type": "null"
            }
          ]
        },
        "schedule_intent_state": {
          "type": "string",
          "enum": [
            "verified",
            "legacy_unverified"
          ]
        },
        "expires_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "status": {
          "type": "string",
          "enum": [
            "scheduled",
            "publishing",
            "published",
            "failed",
            "expired",
            "needs_reschedule",
            "cancelled",
            "deleted"
          ]
        },
        "version": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        "automatic_retry_enabled": {
          "type": "boolean"
        },
        "delete_requested_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "published_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "deleted_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "provider_post_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "permalink": {
          "anyOf": [
            {
              "type": "string",
              "format": "uri"
            },
            {
              "type": "null"
            }
          ]
        },
        "created_at": {
          "type": "string"
        },
        "updated_at": {
          "type": "string"
        },
        "project_id": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid"
            },
            {
              "type": "null"
            }
          ]
        },
        "batch_id": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid"
            },
            {
              "type": "null"
            }
          ]
        },
        "source_ref": {
          "anyOf": [
            {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "id",
        "workspace_id",
        "social_account_id",
        "platform",
        "destination",
        "caption",
        "hashtags",
        "media",
        "publish_options",
        "scheduled_at",
        "display_timezone",
        "expires_at",
        "status",
        "version",
        "automatic_retry_enabled",
        "delete_requested_at",
        "published_at",
        "deleted_at",
        "provider_post_id",
        "permalink",
        "created_at",
        "updated_at",
        "project_id",
        "batch_id",
        "source_ref"
      ],
      "additionalProperties": false
    },
    "deduped": {
      "type": "boolean"
    }
  },
  "required": [
    "post",
    "deduped"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

工具呼叫範例

以下虛構值已按 contract 驗證，唔係真實帳戶 ID、憑證或發佈紀錄。請用已授權範圍回傳嘅 ID、已準備好嘅素材及已審核排程取代，寫入前核對平台資格。此頁唔會呼叫 API。

{
  "name": "sosoapi_create_scheduled_post",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "social_account_id": "11111111-1111-4111-8111-111111111111",
    "provider_payload": {
      "platform": "x",
      "publish_options": {
        "post_type": "TEXT"
      }
    },
    "scheduled_at": "2099-01-15T09:00:00Z",
    "idempotency_key": "example-intent-0001"
  }
}

structuredContent

{
  "post": {
    "id": "11111111-1111-4111-8111-111111111111",
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "social_account_id": null,
    "platform": "instagram",
    "destination": {
      "social_account_id": null,
      "platform": "instagram",
      "platform_user_id": null,
      "account_label": null
    },
    "caption": null,
    "hashtags": [],
    "media": [],
    "publish_options": {},
    "scheduled_at": "example",
    "display_timezone": "UTC",
    "expires_at": null,
    "status": "scheduled",
    "version": 1,
    "automatic_retry_enabled": false,
    "delete_requested_at": null,
    "published_at": null,
    "deleted_at": null,
    "provider_post_id": null,
    "permalink": null,
    "created_at": "example",
    "updated_at": "example",
    "project_id": null,
    "batch_id": null,
    "source_ref": null
  },
  "deduped": false
}

/studio-api/scheduled-posts/create

安裝或連接 MCP