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

Zoeken wordt pas geladen wanneer je het gebruikt. Bekijk hieronder alle categorieën.

MCP-tool

Ingepland bericht ophalen

sosoapi_get_scheduled_post

Lees één ingepland bericht op id: inhoud, status, afleverstatus en resultaten. De versie ervan is nodig als expected_version voor bijwerken, publiceren, opnieuw proberen en annuleren.

Lezen als Markdown

Profielen en transporten

Profielen: core, full · Transporten: stdio, http

Kies core of full om te bepalen welke tools je client ziet; dit verandert geen machtigingen. Lokale bestandsupload vereist stdio en is niet beschikbaar via HTTP. Stel SOSOAPI_OUTPUT_SCHEMAS=1 in om uitvoerschema's bij detectie op te nemen. Tools geven met en zonder die instelling gestructureerde resultaten terug.

Machtigingen en neveneffecten

Annotaties helpen clients een tool te beschrijven. Elke aanroep controleert nog steeds gebruikersauthenticatie, rol, resourcetoegang en verleende bevoegdheden.

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

Invoervelden

Verplicht betekent verplicht binnen het bovenliggende object en de gekozen variant. Een verplicht onderliggend veld maakt een optioneel bovenliggend object niet verplicht. Onderstaande regels en veldnamen zijn uit het contract gekopieerd.

Invoervelden
Veld / variantType / verplichtBeperkingen
$objectVerplicht in bovenliggend object
  • additionalProperties: false
idstringVerplicht in bovenliggend object
  • 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}$"
Volledig 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
}

Gestructureerde uitvoer

Dit schema beschrijft structuredContent in een geslaagd toolresultaat. Het MCP-antwoord bevat ook content en kan isError instellen wanneer een aanroep mislukt. Lees bij publiceren het definitieve berichtresultaat; beschouw een geaccepteerd verzoek of tekstantwoord niet als bevestiging. De gekoppelde API-bewerking beschrijft machtigingen en regels voor opnieuw proberen.

Verplicht betekent verplicht binnen het bovenliggende object en de gekozen variant. Een verplicht onderliggend veld maakt een optioneel bovenliggend object niet verplicht. Onderstaande regels en veldnamen zijn uit het contract gekopieerd.

Gestructureerde uitvoer
Veld / variantType / verplichtBeperkingen
$objectVerplicht in bovenliggend object
  • additionalProperties: false
postobjectVerplicht in bovenliggend object
  • additionalProperties: false
post.idstringVerplicht in bovenliggend object
  • 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_idstringVerplicht in bovenliggend object
  • format: "uuid"
post.social_account_idstring | nullVerplicht in bovenliggend object—
post.social_account_idanyOf 1stringVerplicht in bovenliggend object
  • format: "uuid"
post.social_account_idanyOf 2nullVerplicht in bovenliggend object—
post.platformstringVerplicht in bovenliggend object
  • enum: ["instagram","threads","facebook","youtube","x"]
post.destinationobjectVerplicht in bovenliggend object
  • additionalProperties: false
post.destination.social_account_idstring | nullVerplicht in bovenliggend object—
post.destination.social_account_idanyOf 1stringVerplicht in bovenliggend object
  • format: "uuid"
post.destination.social_account_idanyOf 2nullVerplicht in bovenliggend object—
post.destination.platformstringVerplicht in bovenliggend object
  • enum: ["instagram","threads","facebook","youtube","x"]
post.destination.platform_user_idstring | nullVerplicht in bovenliggend object—
post.destination.platform_user_idanyOf 1stringVerplicht in bovenliggend object—
post.destination.platform_user_idanyOf 2nullVerplicht in bovenliggend object—
post.destination.account_labelstring | nullVerplicht in bovenliggend object—
post.destination.account_labelanyOf 1stringVerplicht in bovenliggend object—
post.destination.account_labelanyOf 2nullVerplicht in bovenliggend object—
post.captionstring | nullVerplicht in bovenliggend object—
post.captionanyOf 1stringVerplicht in bovenliggend object—
post.captionanyOf 2nullVerplicht in bovenliggend object—
post.hashtagsarrayVerplicht in bovenliggend object—
post.hashtags[]stringOptioneel / item—
post.mediaarrayVerplicht in bovenliggend object—
post.media[]objectOptioneel / item
  • additionalProperties: false
post.media[].kindstringVerplicht in bovenliggend object
  • enum: ["image","video"]
post.media[].urlstringVerplicht in bovenliggend object
  • format: "uri"
post.media[].cover_urlstring | nullOptioneel / item—
post.media[].cover_urlanyOf 1stringOptioneel / item
  • format: "uri"
post.media[].cover_urlanyOf 2nullOptioneel / item—
post.media[].cover_asset_idinteger | nullOptioneel / item—
post.media[].cover_asset_idanyOf 1integerOptioneel / item
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.media[].cover_asset_idanyOf 2nullOptioneel / item—
post.media[].asset_idinteger | nullOptioneel / item—
post.media[].asset_idanyOf 1integerOptioneel / item
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.media[].asset_idanyOf 2nullOptioneel / item—
post.media[].mime_typestring | nullOptioneel / item—
post.media[].mime_typeanyOf 1stringOptioneel / item
  • minLength: 1
  • maxLength: 160
post.media[].mime_typeanyOf 2nullOptioneel / item—
post.media[].preview_urlstring | nullOptioneel / item

Tijdelijke toegestane lees-URL; behoud url als blijvende media-identiteit van de Scheduled Post.

—
post.media[].preview_urlanyOf 1stringOptioneel / item
  • format: "uri"
post.media[].preview_urlanyOf 2nullOptioneel / item—
post.media[].cover_preview_urlstring | nullOptioneel / item

Tijdelijke toegestane lees-URL voor omslag; behoud cover_url als blijvende media-identiteit.

—
post.media[].cover_preview_urlanyOf 1stringOptioneel / item
  • format: "uri"
post.media[].cover_preview_urlanyOf 2nullOptioneel / item—
post.media[].preview_expires_atstring | nullOptioneel / item—
post.media[].preview_expires_atanyOf 1stringOptioneel / item
  • 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 2nullOptioneel / item—
post.link_urlstring | nullOptioneel / item—
post.link_urlanyOf 1stringOptioneel / item
  • format: "uri"
post.link_urlanyOf 2nullOptioneel / item—
post.publish_optionsobjectVerplicht in bovenliggend object
  • additionalProperties: false
post.publish_options.post_typestringOptioneel / item
  • enum: ["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]
post.publish_options.location_idstringOptioneel / item
  • minLength: 1
post.publish_options.share_to_feedbooleanOptioneel / item—
post.publish_options.collaboratorsarrayOptioneel / item
  • maxItems: 3
post.publish_options.collaborators[]stringOptioneel / item
  • minLength: 1
post.publish_options.first_commentstringOptioneel / item
  • minLength: 1
  • maxLength: 2200
post.publish_options.topic_tagstringOptioneel / item
  • minLength: 1
post.publish_options.thumb_offset_msintegerOptioneel / item
  • minimum: 0
  • maximum: 9007199254740991
post.publish_options.titlestringOptioneel / item
  • maxLength: 255
post.publish_options.youtube_privacy_statusstringOptioneel / item
  • enum: ["private","unlisted","public"]
post.publish_options.youtube_category_idstringOptioneel / item
  • pattern: "^\\d+$"
post.publish_options.youtube_contains_synthetic_mediabooleanOptioneel / item—
post.publish_options.descriptionstringOptioneel / item
  • maxLength: 5000
post.publish_options.category_idstringOptioneel / item
  • pattern: "^\\d+$"
post.publish_options.privacy_statusstringOptioneel / item
  • enum: ["private","unlisted","public"]
post.publish_options.cancellation_modestringOptioneel / item
  • enum: ["DELETE","UNSCHEDULE_KEEP_PRIVATE"]
post.publish_options.tagsarrayOptioneel / item—
post.publish_options.tags[]stringOptioneel / item—
post.publish_options.default_languagestringOptioneel / item—
post.publish_options.localizationsobjectOptioneel / item
  • additionalProperties: {}
post.publish_options.localizations.*any JSON valueOptioneel / item—
post.publish_options.licensestringOptioneel / item
  • enum: ["youtube","creativeCommon"]
post.publish_options.embeddablebooleanOptioneel / item—
post.publish_options.public_stats_viewablebooleanOptioneel / item—
post.publish_options.self_declared_made_for_kidsbooleanOptioneel / item—
post.publish_options.contains_synthetic_mediabooleanOptioneel / item—
post.publish_options.has_paid_product_placementbooleanOptioneel / item—
post.publish_options.recording_datestringOptioneel / item—
post.publish_options.notify_subscribersbooleanOptioneel / item—
post.publish_options.thumbnail_asset_idintegerOptioneel / item
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.publish_options.surface_expectationstringOptioneel / item
  • const: "SHORT"
post.publish_options.brand_partnerobjectOptioneel / item
  • additionalProperties: {}
post.publish_options.brand_partner.*any JSON valueOptioneel / item—
post.publish_options.cover_asset_idintegerOptioneel / item
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.publish_options.audio_namestringOptioneel / item—
post.publish_options.trial_paramsobjectOptioneel / item
  • additionalProperties: {}
post.publish_options.trial_params.*any JSON valueOptioneel / item—
post.publish_options.is_ai_generatedbooleanOptioneel / item—
post.publish_options.branded_content_sponsor_idsarrayOptioneel / item—
post.publish_options.branded_content_sponsor_ids[]stringOptioneel / item—
post.publish_options.is_paid_partnershipbooleanOptioneel / item—
post.publish_options.media_optionsarrayOptioneel / item—
post.publish_options.media_options[]objectOptioneel / item
  • additionalProperties: {}
post.publish_options.media_options[].*any JSON valueOptioneel / item—
post.publish_options.reply_to_idstringOptioneel / item—
post.publish_options.quote_post_idstringOptioneel / item—
post.publish_options.repost_target_idstringOptioneel / item—
post.publish_options.reply_controlstringOptioneel / item—
post.publish_options.enable_reply_approvalsbooleanOptioneel / item—
post.publish_options.link_attachmentstringOptioneel / item
  • format: "uri"
post.publish_options.poll_attachmentobjectOptioneel / item
  • additionalProperties: {}
post.publish_options.poll_attachment.*any JSON valueOptioneel / item—
post.publish_options.gif_attachmentobjectOptioneel / item
  • additionalProperties: {}
post.publish_options.gif_attachment.*any JSON valueOptioneel / item—
post.publish_options.text_attachmentobjectOptioneel / item
  • additionalProperties: {}
post.publish_options.text_attachment.*any JSON valueOptioneel / item—
post.publish_options.text_entitiesarrayOptioneel / item—
post.publish_options.text_entities[]objectOptioneel / item
  • additionalProperties: {}
post.publish_options.text_entities[].*any JSON valueOptioneel / item—
post.publish_options.is_spoiler_mediabooleanOptioneel / item—
post.publish_options.is_ghost_postbooleanOptioneel / item—
post.publish_options.allowlisted_country_codesarrayOptioneel / item—
post.publish_options.allowlisted_country_codes[]stringOptioneel / item—
post.publish_options.crossreshare_to_igbooleanOptioneel / item—
post.publish_options.crossreshare_to_ig_dark_modebooleanOptioneel / item—
post.publish_options.auto_publish_textbooleanOptioneel / item—
post.publish_options.publication_modestringOptioneel / item
  • enum: ["PUBLISH","DRAFT"]
post.publish_options.backdated_timenumberOptioneel / item—
post.publish_options.backdated_time_granularitystringOptioneel / item
  • enum: ["year","month","day","hour","minute"]
post.publish_options.placestringOptioneel / item—
post.publish_options.feed_targetingobjectOptioneel / item
  • additionalProperties: {}
post.publish_options.feed_targeting.*any JSON valueOptioneel / item—
post.publish_options.targetingobjectOptioneel / item
  • additionalProperties: {}
post.publish_options.targeting.*any JSON valueOptioneel / item—
post.publish_options.child_attachmentsarrayOptioneel / item—
post.publish_options.child_attachments[]objectOptioneel / item
  • additionalProperties: {}
post.publish_options.child_attachments[].*any JSON valueOptioneel / item—
post.publish_options.multi_share_end_cardbooleanOptioneel / item—
post.publish_options.multi_share_optimizedbooleanOptioneel / item—
post.publish_options.unpublished_content_typestringOptioneel / item—
post.publish_options.no_storybooleanOptioneel / item—
post.publish_options.crossposted_video_idstringOptioneel / item—
post.publish_options.sphericalbooleanOptioneel / item—
post.scheduled_atstringVerplicht in bovenliggend object—
post.display_timezonestringVerplicht in bovenliggend object
  • minLength: 1
  • maxLength: 80
post.local_scheduled_atstring | nullOptioneel / item—
post.local_scheduled_atanyOf 1stringOptioneel / item
  • pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
post.local_scheduled_atanyOf 2nullOptioneel / item—
post.schedule_timezonestring | nullOptioneel / item—
post.schedule_timezoneanyOf 1stringOptioneel / item
  • minLength: 1
  • maxLength: 80
post.schedule_timezoneanyOf 2nullOptioneel / item—
post.schedule_dst_disambiguationstring | nullOptioneel / item—
post.schedule_dst_disambiguationanyOf 1stringOptioneel / item
  • enum: ["exact","earlier","later"]
post.schedule_dst_disambiguationanyOf 2nullOptioneel / item—
post.schedule_intent_statestringOptioneel / item
  • enum: ["verified","legacy_unverified"]
post.expires_atstring | nullVerplicht in bovenliggend object—
post.expires_atanyOf 1stringVerplicht in bovenliggend object—
post.expires_atanyOf 2nullVerplicht in bovenliggend object—
post.statusstringVerplicht in bovenliggend object
  • enum: ["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]
post.versionintegerVerplicht in bovenliggend object
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.automatic_retry_enabledbooleanVerplicht in bovenliggend object—
post.delete_requested_atstring | nullVerplicht in bovenliggend object—
post.delete_requested_atanyOf 1stringVerplicht in bovenliggend object—
post.delete_requested_atanyOf 2nullVerplicht in bovenliggend object—
post.published_atstring | nullVerplicht in bovenliggend object—
post.published_atanyOf 1stringVerplicht in bovenliggend object—
post.published_atanyOf 2nullVerplicht in bovenliggend object—
post.deleted_atstring | nullVerplicht in bovenliggend object—
post.deleted_atanyOf 1stringVerplicht in bovenliggend object—
post.deleted_atanyOf 2nullVerplicht in bovenliggend object—
post.provider_post_idstring | nullVerplicht in bovenliggend object—
post.provider_post_idanyOf 1stringVerplicht in bovenliggend object—
post.provider_post_idanyOf 2nullVerplicht in bovenliggend object—
post.permalinkstring | nullVerplicht in bovenliggend object—
post.permalinkanyOf 1stringVerplicht in bovenliggend object
  • format: "uri"
post.permalinkanyOf 2nullVerplicht in bovenliggend object—
post.created_atstringVerplicht in bovenliggend object—
post.updated_atstringVerplicht in bovenliggend object—
deliveryobjectVerplicht in bovenliggend object
  • additionalProperties: false
delivery.stagestringVerplicht in bovenliggend object
  • enum: ["scheduled","preparing","delivering","reconciling","cancelling","terminal"]
delivery.messagestringVerplicht in bovenliggend object
  • minLength: 1
  • maxLength: 500
actionsarrayVerplicht in bovenliggend object
  • minItems: 5
  • maxItems: 5
actions[]objectOptioneel / item
  • additionalProperties: false
actions[].actionstringVerplicht in bovenliggend object
  • enum: ["edit","publish_now","retry","cancel","delete"]
actions[].allowedbooleanVerplicht in bovenliggend object—
actions[].reason_codestringVerplicht in bovenliggend object
  • 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[].messagestringVerplicht in bovenliggend object
  • minLength: 1
  • maxLength: 500
attemptsarrayVerplicht in bovenliggend object
  • maxItems: 200
attempts[]objectOptioneel / item
  • additionalProperties: false
attempts[].idstringVerplicht in bovenliggend object
  • format: "uuid"
attempts[].operationstringVerplicht in bovenliggend object
  • enum: ["publish","delete"]
attempts[].attempt_numberintegerVerplicht in bovenliggend object
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
attempts[].dispatched_atstringVerplicht in bovenliggend object—
outcomesarrayVerplicht in bovenliggend object
  • maxItems: 200
outcomes[]objectOptioneel / item
  • additionalProperties: false
outcomes[].idstringVerplicht in bovenliggend object
  • format: "uuid"
outcomes[].publication_attempt_idstring | nullVerplicht in bovenliggend object—
outcomes[].publication_attempt_idanyOf 1stringVerplicht in bovenliggend object
  • format: "uuid"
outcomes[].publication_attempt_idanyOf 2nullVerplicht in bovenliggend object—
outcomes[].operationstringVerplicht in bovenliggend object
  • enum: ["publish","delete"]
outcomes[].statusstringVerplicht in bovenliggend object
  • enum: ["published","failed","deleted"]
outcomes[].provider_post_idstring | nullVerplicht in bovenliggend object—
outcomes[].provider_post_idanyOf 1stringVerplicht in bovenliggend object—
outcomes[].provider_post_idanyOf 2nullVerplicht in bovenliggend object—
outcomes[].permalinkstring | nullVerplicht in bovenliggend object—
outcomes[].permalinkanyOf 1stringVerplicht in bovenliggend object
  • format: "uri"
outcomes[].permalinkanyOf 2nullVerplicht in bovenliggend object—
outcomes[].messagestringVerplicht in bovenliggend object
  • minLength: 1
  • maxLength: 500
outcomes[].observed_atstringVerplicht in bovenliggend object—
outcomes[].terminal_suboperationobjectOptioneel / item
  • additionalProperties: false
outcomes[].terminal_suboperation.kindstringVerplicht in bovenliggend object
  • const: "instagram_first_comment"
outcomes[].terminal_suboperation.statusstringVerplicht in bovenliggend object
  • enum: ["succeeded","failed","attention"]
outcomes[].terminal_suboperation.external_idstring | nullVerplicht in bovenliggend object—
outcomes[].terminal_suboperation.external_idanyOf 1stringVerplicht in bovenliggend object
  • minLength: 1
  • maxLength: 500
outcomes[].terminal_suboperation.external_idanyOf 2nullVerplicht in bovenliggend object—
Volledig 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
}

Voorbeeld van een toolaanroep

Deze voorbeelden gebruiken fictieve waarden die tegen de schema's zijn gecontroleerd. Vervang IDs door toegestane IDs, media door gereedstaande bestanden en datums door je bevestigde publicatietijd. Controleer accountgeschiktheid vóór een schrijfhandeling. Deze pagina verstuurt geen API-verzoeken.

{
  "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": []
}
Installeer of verbind MCP