SosoAPI
繁中
EN繁中繁體中文（台灣）简体中文日本語한국어DeutschFrançaisEspañolPortuguês (Brasil)العربيةעבריתNederlandsहिन्दीBahasa IndonesiaNorsk bokmålSvenskaMagyar
登入

使用時先載入搜尋資料。亦可直接瀏覽下方分類。

MCP tool

讀取排程帖文

sosoapi_get_scheduled_post

按 id 讀取內容、狀態、delivery state 及 outcomes。回傳 version 係 update、publish、retry、cancel 所需 expected_version。

閱讀 Markdown

Profiles 及連接方式

Profiles: core, full · Transports: stdio, http

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

權限及改動

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

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

輸入欄位

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

輸入欄位
欄位／分支類型／必填限制
$object父物件內必填
  • additionalProperties: false
idstring父物件內必填
  • 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}$"
完整 JSON Schema
{
  "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}$"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

結構化輸出

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

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

結構化輸出
欄位／分支類型／必填限制
$object父物件內必填
  • additionalProperties: false
postobject父物件內必填
  • additionalProperties: false
post.idstring父物件內必填
  • 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_idstring父物件內必填
  • format: "uuid"
post.social_account_idstring | null父物件內必填—
post.social_account_idanyOf 1string父物件內必填
  • format: "uuid"
post.social_account_idanyOf 2null父物件內必填—
post.platformstring父物件內必填
  • enum: ["instagram","threads","facebook","youtube","x"]
post.destinationobject父物件內必填
  • additionalProperties: false
post.destination.social_account_idstring | null父物件內必填—
post.destination.social_account_idanyOf 1string父物件內必填
  • format: "uuid"
post.destination.social_account_idanyOf 2null父物件內必填—
post.destination.platformstring父物件內必填
  • enum: ["instagram","threads","facebook","youtube","x"]
post.destination.platform_user_idstring | null父物件內必填—
post.destination.platform_user_idanyOf 1string父物件內必填—
post.destination.platform_user_idanyOf 2null父物件內必填—
post.destination.account_labelstring | null父物件內必填—
post.destination.account_labelanyOf 1string父物件內必填—
post.destination.account_labelanyOf 2null父物件內必填—
post.captionstring | null父物件內必填—
post.captionanyOf 1string父物件內必填—
post.captionanyOf 2null父物件內必填—
post.hashtagsarray父物件內必填—
post.hashtags[]string可選／陣列項目—
post.mediaarray父物件內必填—
post.media[]object可選／陣列項目
  • additionalProperties: false
post.media[].kindstring父物件內必填
  • enum: ["image","video"]
post.media[].urlstring父物件內必填
  • format: "uri"
post.media[].cover_urlstring | null可選／陣列項目—
post.media[].cover_urlanyOf 1string可選／陣列項目
  • format: "uri"
post.media[].cover_urlanyOf 2null可選／陣列項目—
post.media[].cover_asset_idinteger | null可選／陣列項目—
post.media[].cover_asset_idanyOf 1integer可選／陣列項目
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.media[].cover_asset_idanyOf 2null可選／陣列項目—
post.media[].asset_idinteger | null可選／陣列項目—
post.media[].asset_idanyOf 1integer可選／陣列項目
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.media[].asset_idanyOf 2null可選／陣列項目—
post.media[].mime_typestring | null可選／陣列項目—
post.media[].mime_typeanyOf 1string可選／陣列項目
  • minLength: 1
  • maxLength: 160
post.media[].mime_typeanyOf 2null可選／陣列項目—
post.media[].preview_urlstring | null可選／陣列項目

Temporary authorized read URL; keep url as persisted Scheduled Post media identity.

—
post.media[].preview_urlanyOf 1string可選／陣列項目
  • format: "uri"
post.media[].preview_urlanyOf 2null可選／陣列項目—
post.media[].cover_preview_urlstring | null可選／陣列項目

Temporary authorized cover read URL; keep cover_url as persisted media identity.

—
post.media[].cover_preview_urlanyOf 1string可選／陣列項目
  • format: "uri"
post.media[].cover_preview_urlanyOf 2null可選／陣列項目—
post.media[].preview_expires_atstring | null可選／陣列項目—
post.media[].preview_expires_atanyOf 1string可選／陣列項目
  • 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_atanyOf 2null可選／陣列項目—
post.link_urlstring | null可選／陣列項目—
post.link_urlanyOf 1string可選／陣列項目
  • format: "uri"
post.link_urlanyOf 2null可選／陣列項目—
post.publish_optionsobject父物件內必填
  • additionalProperties: false
post.publish_options.post_typestring可選／陣列項目
  • enum: ["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]
post.publish_options.location_idstring可選／陣列項目
  • minLength: 1
post.publish_options.share_to_feedboolean可選／陣列項目—
post.publish_options.collaboratorsarray可選／陣列項目
  • maxItems: 3
post.publish_options.collaborators[]string可選／陣列項目
  • minLength: 1
post.publish_options.first_commentstring可選／陣列項目
  • minLength: 1
  • maxLength: 2200
post.publish_options.topic_tagstring可選／陣列項目
  • minLength: 1
post.publish_options.thumb_offset_msinteger可選／陣列項目
  • minimum: 0
  • maximum: 9007199254740991
post.publish_options.titlestring可選／陣列項目
  • maxLength: 255
post.publish_options.youtube_privacy_statusstring可選／陣列項目
  • enum: ["private","unlisted","public"]
post.publish_options.youtube_category_idstring可選／陣列項目
  • pattern: "^\\d+$"
post.publish_options.youtube_contains_synthetic_mediaboolean可選／陣列項目—
post.publish_options.descriptionstring可選／陣列項目
  • maxLength: 5000
post.publish_options.category_idstring可選／陣列項目
  • pattern: "^\\d+$"
post.publish_options.privacy_statusstring可選／陣列項目
  • enum: ["private","unlisted","public"]
post.publish_options.cancellation_modestring可選／陣列項目
  • enum: ["DELETE","UNSCHEDULE_KEEP_PRIVATE"]
post.publish_options.tagsarray可選／陣列項目—
post.publish_options.tags[]string可選／陣列項目—
post.publish_options.default_languagestring可選／陣列項目—
post.publish_options.localizationsobject可選／陣列項目
  • additionalProperties: {}
post.publish_options.localizations.*any JSON value可選／陣列項目—
post.publish_options.licensestring可選／陣列項目
  • enum: ["youtube","creativeCommon"]
post.publish_options.embeddableboolean可選／陣列項目—
post.publish_options.public_stats_viewableboolean可選／陣列項目—
post.publish_options.self_declared_made_for_kidsboolean可選／陣列項目—
post.publish_options.contains_synthetic_mediaboolean可選／陣列項目—
post.publish_options.has_paid_product_placementboolean可選／陣列項目—
post.publish_options.recording_datestring可選／陣列項目—
post.publish_options.notify_subscribersboolean可選／陣列項目—
post.publish_options.thumbnail_asset_idinteger可選／陣列項目
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.publish_options.surface_expectationstring可選／陣列項目
  • const: "SHORT"
post.publish_options.brand_partnerobject可選／陣列項目
  • additionalProperties: {}
post.publish_options.brand_partner.*any JSON value可選／陣列項目—
post.publish_options.cover_asset_idinteger可選／陣列項目
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.publish_options.audio_namestring可選／陣列項目—
post.publish_options.trial_paramsobject可選／陣列項目
  • additionalProperties: {}
post.publish_options.trial_params.*any JSON value可選／陣列項目—
post.publish_options.is_ai_generatedboolean可選／陣列項目—
post.publish_options.branded_content_sponsor_idsarray可選／陣列項目—
post.publish_options.branded_content_sponsor_ids[]string可選／陣列項目—
post.publish_options.is_paid_partnershipboolean可選／陣列項目—
post.publish_options.media_optionsarray可選／陣列項目—
post.publish_options.media_options[]object可選／陣列項目
  • additionalProperties: {}
post.publish_options.media_options[].*any JSON value可選／陣列項目—
post.publish_options.reply_to_idstring可選／陣列項目—
post.publish_options.quote_post_idstring可選／陣列項目—
post.publish_options.repost_target_idstring可選／陣列項目—
post.publish_options.reply_controlstring可選／陣列項目—
post.publish_options.enable_reply_approvalsboolean可選／陣列項目—
post.publish_options.link_attachmentstring可選／陣列項目
  • format: "uri"
post.publish_options.poll_attachmentobject可選／陣列項目
  • additionalProperties: {}
post.publish_options.poll_attachment.*any JSON value可選／陣列項目—
post.publish_options.gif_attachmentobject可選／陣列項目
  • additionalProperties: {}
post.publish_options.gif_attachment.*any JSON value可選／陣列項目—
post.publish_options.text_attachmentobject可選／陣列項目
  • additionalProperties: {}
post.publish_options.text_attachment.*any JSON value可選／陣列項目—
post.publish_options.text_entitiesarray可選／陣列項目—
post.publish_options.text_entities[]object可選／陣列項目
  • additionalProperties: {}
post.publish_options.text_entities[].*any JSON value可選／陣列項目—
post.publish_options.is_spoiler_mediaboolean可選／陣列項目—
post.publish_options.is_ghost_postboolean可選／陣列項目—
post.publish_options.allowlisted_country_codesarray可選／陣列項目—
post.publish_options.allowlisted_country_codes[]string可選／陣列項目—
post.publish_options.crossreshare_to_igboolean可選／陣列項目—
post.publish_options.crossreshare_to_ig_dark_modeboolean可選／陣列項目—
post.publish_options.auto_publish_textboolean可選／陣列項目—
post.publish_options.publication_modestring可選／陣列項目
  • enum: ["PUBLISH","DRAFT"]
post.publish_options.backdated_timenumber可選／陣列項目—
post.publish_options.backdated_time_granularitystring可選／陣列項目
  • enum: ["year","month","day","hour","minute"]
post.publish_options.placestring可選／陣列項目—
post.publish_options.feed_targetingobject可選／陣列項目
  • additionalProperties: {}
post.publish_options.feed_targeting.*any JSON value可選／陣列項目—
post.publish_options.targetingobject可選／陣列項目
  • additionalProperties: {}
post.publish_options.targeting.*any JSON value可選／陣列項目—
post.publish_options.child_attachmentsarray可選／陣列項目—
post.publish_options.child_attachments[]object可選／陣列項目
  • additionalProperties: {}
post.publish_options.child_attachments[].*any JSON value可選／陣列項目—
post.publish_options.multi_share_end_cardboolean可選／陣列項目—
post.publish_options.multi_share_optimizedboolean可選／陣列項目—
post.publish_options.unpublished_content_typestring可選／陣列項目—
post.publish_options.no_storyboolean可選／陣列項目—
post.publish_options.crossposted_video_idstring可選／陣列項目—
post.publish_options.sphericalboolean可選／陣列項目—
post.scheduled_atstring父物件內必填—
post.display_timezonestring父物件內必填
  • minLength: 1
  • maxLength: 80
post.local_scheduled_atstring | null可選／陣列項目—
post.local_scheduled_atanyOf 1string可選／陣列項目
  • pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
post.local_scheduled_atanyOf 2null可選／陣列項目—
post.schedule_timezonestring | null可選／陣列項目—
post.schedule_timezoneanyOf 1string可選／陣列項目
  • minLength: 1
  • maxLength: 80
post.schedule_timezoneanyOf 2null可選／陣列項目—
post.schedule_dst_disambiguationstring | null可選／陣列項目—
post.schedule_dst_disambiguationanyOf 1string可選／陣列項目
  • enum: ["exact","earlier","later"]
post.schedule_dst_disambiguationanyOf 2null可選／陣列項目—
post.schedule_intent_statestring可選／陣列項目
  • enum: ["verified","legacy_unverified"]
post.expires_atstring | null父物件內必填—
post.expires_atanyOf 1string父物件內必填—
post.expires_atanyOf 2null父物件內必填—
post.statusstring父物件內必填
  • enum: ["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]
post.versioninteger父物件內必填
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.automatic_retry_enabledboolean父物件內必填—
post.delete_requested_atstring | null父物件內必填—
post.delete_requested_atanyOf 1string父物件內必填—
post.delete_requested_atanyOf 2null父物件內必填—
post.published_atstring | null父物件內必填—
post.published_atanyOf 1string父物件內必填—
post.published_atanyOf 2null父物件內必填—
post.deleted_atstring | null父物件內必填—
post.deleted_atanyOf 1string父物件內必填—
post.deleted_atanyOf 2null父物件內必填—
post.provider_post_idstring | null父物件內必填—
post.provider_post_idanyOf 1string父物件內必填—
post.provider_post_idanyOf 2null父物件內必填—
post.permalinkstring | null父物件內必填—
post.permalinkanyOf 1string父物件內必填
  • format: "uri"
post.permalinkanyOf 2null父物件內必填—
post.created_atstring父物件內必填—
post.updated_atstring父物件內必填—
deliveryobject父物件內必填
  • additionalProperties: false
delivery.stagestring父物件內必填
  • enum: ["scheduled","preparing","delivering","reconciling","cancelling","terminal"]
delivery.messagestring父物件內必填
  • minLength: 1
  • maxLength: 500
actionsarray父物件內必填
  • minItems: 5
  • maxItems: 5
actions[]object可選／陣列項目
  • additionalProperties: false
actions[].actionstring父物件內必填
  • enum: ["edit","publish_now","retry","cancel","delete"]
actions[].allowedboolean父物件內必填—
actions[].reason_codestring父物件內必填
  • enum: ["allowed","terminal_state","provider_preparation_started","delivery_started","not_scheduled","not_failed","retry_evidence_missing","destination_disconnected","expiry_passed","cancellation_in_progress","delete_in_progress","not_published"]
actions[].messagestring父物件內必填
  • minLength: 1
  • maxLength: 500
attemptsarray父物件內必填
  • maxItems: 200
attempts[]object可選／陣列項目
  • additionalProperties: false
attempts[].idstring父物件內必填
  • format: "uuid"
attempts[].operationstring父物件內必填
  • enum: ["publish","delete"]
attempts[].attempt_numberinteger父物件內必填
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
attempts[].dispatched_atstring父物件內必填—
outcomesarray父物件內必填
  • maxItems: 200
outcomes[]object可選／陣列項目
  • additionalProperties: false
outcomes[].idstring父物件內必填
  • format: "uuid"
outcomes[].publication_attempt_idstring | null父物件內必填—
outcomes[].publication_attempt_idanyOf 1string父物件內必填
  • format: "uuid"
outcomes[].publication_attempt_idanyOf 2null父物件內必填—
outcomes[].operationstring父物件內必填
  • enum: ["publish","delete"]
outcomes[].statusstring父物件內必填
  • enum: ["published","failed","deleted"]
outcomes[].provider_post_idstring | null父物件內必填—
outcomes[].provider_post_idanyOf 1string父物件內必填—
outcomes[].provider_post_idanyOf 2null父物件內必填—
outcomes[].permalinkstring | null父物件內必填—
outcomes[].permalinkanyOf 1string父物件內必填
  • format: "uri"
outcomes[].permalinkanyOf 2null父物件內必填—
outcomes[].messagestring父物件內必填
  • minLength: 1
  • maxLength: 500
outcomes[].observed_atstring父物件內必填—
outcomes[].terminal_suboperationobject可選／陣列項目
  • additionalProperties: false
outcomes[].terminal_suboperation.kindstring父物件內必填
  • const: "instagram_first_comment"
outcomes[].terminal_suboperation.statusstring父物件內必填
  • enum: ["succeeded","failed","attention"]
outcomes[].terminal_suboperation.external_idstring | null父物件內必填—
outcomes[].terminal_suboperation.external_idanyOf 1string父物件內必填
  • minLength: 1
  • maxLength: 500
outcomes[].terminal_suboperation.external_idanyOf 2null父物件內必填—
完整 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"
        }
      },
      "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"
      ],
      "additionalProperties": false
    },
    "delivery": {
      "type": "object",
      "properties": {
        "stage": {
          "type": "string",
          "enum": [
            "scheduled",
            "preparing",
            "delivering",
            "reconciling",
            "cancelling",
            "terminal"
          ]
        },
        "message": {
          "type": "string",
          "minLength": 1,
          "maxLength": 500
        }
      },
      "required": [
        "stage",
        "message"
      ],
      "additionalProperties": false
    },
    "actions": {
      "minItems": 5,
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "edit",
              "publish_now",
              "retry",
              "cancel",
              "delete"
            ]
          },
          "allowed": {
            "type": "boolean"
          },
          "reason_code": {
            "type": "string",
            "enum": [
              "allowed",
              "terminal_state",
              "provider_preparation_started",
              "delivery_started",
              "not_scheduled",
              "not_failed",
              "retry_evidence_missing",
              "destination_disconnected",
              "expiry_passed",
              "cancellation_in_progress",
              "delete_in_progress",
              "not_published"
            ]
          },
          "message": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          }
        },
        "required": [
          "action",
          "allowed",
          "reason_code",
          "message"
        ],
        "additionalProperties": false
      }
    },
    "attempts": {
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "operation": {
            "type": "string",
            "enum": [
              "publish",
              "delete"
            ]
          },
          "attempt_number": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          },
          "dispatched_at": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "operation",
          "attempt_number",
          "dispatched_at"
        ],
        "additionalProperties": false
      }
    },
    "outcomes": {
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "publication_attempt_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ]
          },
          "operation": {
            "type": "string",
            "enum": [
              "publish",
              "delete"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "published",
              "failed",
              "deleted"
            ]
          },
          "provider_post_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "permalink": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ]
          },
          "message": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          },
          "observed_at": {
            "type": "string"
          },
          "terminal_suboperation": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "instagram_first_comment"
              },
              "status": {
                "type": "string",
                "enum": [
                  "succeeded",
                  "failed",
                  "attention"
                ]
              },
              "external_id": {
                "anyOf": [
                  {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 500
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "kind",
              "status",
              "external_id"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "id",
          "publication_attempt_id",
          "operation",
          "status",
          "provider_post_id",
          "permalink",
          "message",
          "observed_at"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "post",
    "delivery",
    "actions",
    "attempts",
    "outcomes"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

工具呼叫範例

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

{
  "name": "sosoapi_get_scheduled_post",
  "arguments": {
    "id": "11111111-1111-4111-8111-111111111111"
  }
}

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"
  },
  "delivery": {
    "stage": "scheduled",
    "message": "example"
  },
  "actions": [
    {
      "action": "edit",
      "allowed": true,
      "reason_code": "allowed",
      "message": "Allowed in this example state."
    },
    {
      "action": "publish_now",
      "allowed": true,
      "reason_code": "allowed",
      "message": "Allowed in this example state."
    },
    {
      "action": "retry",
      "allowed": false,
      "reason_code": "not_failed",
      "message": "This example post has not failed."
    },
    {
      "action": "cancel",
      "allowed": true,
      "reason_code": "allowed",
      "message": "Allowed in this example state."
    },
    {
      "action": "delete",
      "allowed": true,
      "reason_code": "allowed",
      "message": "Allowed in this example state."
    }
  ],
  "attempts": [],
  "outcomes": []
}
安裝或連接 MCP