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

Sökningen laddas först när du använder den. Bläddra bland alla kategorier nedan.

MCP-verktyg

Hämta schemalagt inlägg

sosoapi_get_scheduled_post

Läs ett schemalagt inlägg via id: innehåll, status, leveransstatus och resultat. Dess version behövs som expected_version för update, publish, retry och cancel.

Läs som Markdown

Profiler och transporter

Profiler: core, full · Transporter: stdio, http

Välj core eller full för att styra vilka verktyg klienten ser; detta ändrar inte dess behörigheter. Lokal filuppladdning kräver stdio och är inte tillgänglig via HTTP. Ange SOSOAPI_OUTPUT_SCHEMAS=1 för att inkludera utdatascheman vid identifiering. Verktygen returnerar strukturerade resultat med eller utan inställningen.

Behörigheter och sidoeffekter

Annoteringar hjälper klienter att beskriva ett verktyg. Varje anrop kontrollerar fortfarande användarens autentisering, roll, resursåtkomst och tilldelade funktionsbehörigheter.

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

Indatafält

Obligatoriskt betyder obligatoriskt inom sitt överordnade objekt och vald gren. Ett obligatoriskt underfält gör inte ett valfritt överordnat objekt obligatoriskt. Regler och fältnamn nedan kopieras från kontraktet.

Indatafält
Fält / grenTyp / obligatorisktBegränsningar
$objectObligatoriskt i överordnat objekt
  • additionalProperties: false
idstringObligatoriskt i överordnat objekt
  • 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}$"
Fullständigt 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
}

Strukturerat resultat

Detta schema beskriver structuredContent i ett lyckat verktygsresultat. MCP-svaret innehåller även content och kan ange isError när ett anrop misslyckas. För publicering ska du läsa inläggets slutresultat i stället för att tolka en accepterad begäran eller ett textsvar som bekräftelse. Den länkade API-åtgärden förklarar behörigheter och regler för nya försök.

Obligatoriskt betyder obligatoriskt inom sitt överordnade objekt och vald gren. Ett obligatoriskt underfält gör inte ett valfritt överordnat objekt obligatoriskt. Regler och fältnamn nedan kopieras från kontraktet.

Strukturerat resultat
Fält / grenTyp / obligatorisktBegränsningar
$objectObligatoriskt i överordnat objekt
  • additionalProperties: false
postobjectObligatoriskt i överordnat objekt
  • additionalProperties: false
post.idstringObligatoriskt i överordnat objekt
  • 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_idstringObligatoriskt i överordnat objekt
  • format: "uuid"
post.social_account_idstring | nullObligatoriskt i överordnat objekt—
post.social_account_idanyOf 1stringObligatoriskt i överordnat objekt
  • format: "uuid"
post.social_account_idanyOf 2nullObligatoriskt i överordnat objekt—
post.platformstringObligatoriskt i överordnat objekt
  • enum: ["instagram","threads","facebook","youtube","x"]
post.destinationobjectObligatoriskt i överordnat objekt
  • additionalProperties: false
post.destination.social_account_idstring | nullObligatoriskt i överordnat objekt—
post.destination.social_account_idanyOf 1stringObligatoriskt i överordnat objekt
  • format: "uuid"
post.destination.social_account_idanyOf 2nullObligatoriskt i överordnat objekt—
post.destination.platformstringObligatoriskt i överordnat objekt
  • enum: ["instagram","threads","facebook","youtube","x"]
post.destination.platform_user_idstring | nullObligatoriskt i överordnat objekt—
post.destination.platform_user_idanyOf 1stringObligatoriskt i överordnat objekt—
post.destination.platform_user_idanyOf 2nullObligatoriskt i överordnat objekt—
post.destination.account_labelstring | nullObligatoriskt i överordnat objekt—
post.destination.account_labelanyOf 1stringObligatoriskt i överordnat objekt—
post.destination.account_labelanyOf 2nullObligatoriskt i överordnat objekt—
post.captionstring | nullObligatoriskt i överordnat objekt—
post.captionanyOf 1stringObligatoriskt i överordnat objekt—
post.captionanyOf 2nullObligatoriskt i överordnat objekt—
post.hashtagsarrayObligatoriskt i överordnat objekt—
post.hashtags[]stringValfritt / objekt—
post.mediaarrayObligatoriskt i överordnat objekt—
post.media[]objectValfritt / objekt
  • additionalProperties: false
post.media[].kindstringObligatoriskt i överordnat objekt
  • enum: ["image","video"]
post.media[].urlstringObligatoriskt i överordnat objekt
  • format: "uri"
post.media[].cover_urlstring | nullValfritt / objekt—
post.media[].cover_urlanyOf 1stringValfritt / objekt
  • format: "uri"
post.media[].cover_urlanyOf 2nullValfritt / objekt—
post.media[].cover_asset_idinteger | nullValfritt / objekt—
post.media[].cover_asset_idanyOf 1integerValfritt / objekt
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.media[].cover_asset_idanyOf 2nullValfritt / objekt—
post.media[].asset_idinteger | nullValfritt / objekt—
post.media[].asset_idanyOf 1integerValfritt / objekt
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.media[].asset_idanyOf 2nullValfritt / objekt—
post.media[].mime_typestring | nullValfritt / objekt—
post.media[].mime_typeanyOf 1stringValfritt / objekt
  • minLength: 1
  • maxLength: 160
post.media[].mime_typeanyOf 2nullValfritt / objekt—
post.media[].preview_urlstring | nullValfritt / objekt

Tillfällig behörig läs-URL; behåll url som beständig medieidentitet för Scheduled Post.

—
post.media[].preview_urlanyOf 1stringValfritt / objekt
  • format: "uri"
post.media[].preview_urlanyOf 2nullValfritt / objekt—
post.media[].cover_preview_urlstring | nullValfritt / objekt

Tillfällig behörig läs-URL för omslag; behåll cover_url som beständig medieidentitet.

—
post.media[].cover_preview_urlanyOf 1stringValfritt / objekt
  • format: "uri"
post.media[].cover_preview_urlanyOf 2nullValfritt / objekt—
post.media[].preview_expires_atstring | nullValfritt / objekt—
post.media[].preview_expires_atanyOf 1stringValfritt / objekt
  • 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 2nullValfritt / objekt—
post.link_urlstring | nullValfritt / objekt—
post.link_urlanyOf 1stringValfritt / objekt
  • format: "uri"
post.link_urlanyOf 2nullValfritt / objekt—
post.publish_optionsobjectObligatoriskt i överordnat objekt
  • additionalProperties: false
post.publish_options.post_typestringValfritt / objekt
  • enum: ["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]
post.publish_options.location_idstringValfritt / objekt
  • minLength: 1
post.publish_options.share_to_feedbooleanValfritt / objekt—
post.publish_options.collaboratorsarrayValfritt / objekt
  • maxItems: 3
post.publish_options.collaborators[]stringValfritt / objekt
  • minLength: 1
post.publish_options.first_commentstringValfritt / objekt
  • minLength: 1
  • maxLength: 2200
post.publish_options.topic_tagstringValfritt / objekt
  • minLength: 1
post.publish_options.thumb_offset_msintegerValfritt / objekt
  • minimum: 0
  • maximum: 9007199254740991
post.publish_options.titlestringValfritt / objekt
  • maxLength: 255
post.publish_options.youtube_privacy_statusstringValfritt / objekt
  • enum: ["private","unlisted","public"]
post.publish_options.youtube_category_idstringValfritt / objekt
  • pattern: "^\\d+$"
post.publish_options.youtube_contains_synthetic_mediabooleanValfritt / objekt—
post.publish_options.descriptionstringValfritt / objekt
  • maxLength: 5000
post.publish_options.category_idstringValfritt / objekt
  • pattern: "^\\d+$"
post.publish_options.privacy_statusstringValfritt / objekt
  • enum: ["private","unlisted","public"]
post.publish_options.cancellation_modestringValfritt / objekt
  • enum: ["DELETE","UNSCHEDULE_KEEP_PRIVATE"]
post.publish_options.tagsarrayValfritt / objekt—
post.publish_options.tags[]stringValfritt / objekt—
post.publish_options.default_languagestringValfritt / objekt—
post.publish_options.localizationsobjectValfritt / objekt
  • additionalProperties: {}
post.publish_options.localizations.*any JSON valueValfritt / objekt—
post.publish_options.licensestringValfritt / objekt
  • enum: ["youtube","creativeCommon"]
post.publish_options.embeddablebooleanValfritt / objekt—
post.publish_options.public_stats_viewablebooleanValfritt / objekt—
post.publish_options.self_declared_made_for_kidsbooleanValfritt / objekt—
post.publish_options.contains_synthetic_mediabooleanValfritt / objekt—
post.publish_options.has_paid_product_placementbooleanValfritt / objekt—
post.publish_options.recording_datestringValfritt / objekt—
post.publish_options.notify_subscribersbooleanValfritt / objekt—
post.publish_options.thumbnail_asset_idintegerValfritt / objekt
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.publish_options.surface_expectationstringValfritt / objekt
  • const: "SHORT"
post.publish_options.brand_partnerobjectValfritt / objekt
  • additionalProperties: {}
post.publish_options.brand_partner.*any JSON valueValfritt / objekt—
post.publish_options.cover_asset_idintegerValfritt / objekt
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.publish_options.audio_namestringValfritt / objekt—
post.publish_options.trial_paramsobjectValfritt / objekt
  • additionalProperties: {}
post.publish_options.trial_params.*any JSON valueValfritt / objekt—
post.publish_options.is_ai_generatedbooleanValfritt / objekt—
post.publish_options.branded_content_sponsor_idsarrayValfritt / objekt—
post.publish_options.branded_content_sponsor_ids[]stringValfritt / objekt—
post.publish_options.is_paid_partnershipbooleanValfritt / objekt—
post.publish_options.media_optionsarrayValfritt / objekt—
post.publish_options.media_options[]objectValfritt / objekt
  • additionalProperties: {}
post.publish_options.media_options[].*any JSON valueValfritt / objekt—
post.publish_options.reply_to_idstringValfritt / objekt—
post.publish_options.quote_post_idstringValfritt / objekt—
post.publish_options.repost_target_idstringValfritt / objekt—
post.publish_options.reply_controlstringValfritt / objekt—
post.publish_options.enable_reply_approvalsbooleanValfritt / objekt—
post.publish_options.link_attachmentstringValfritt / objekt
  • format: "uri"
post.publish_options.poll_attachmentobjectValfritt / objekt
  • additionalProperties: {}
post.publish_options.poll_attachment.*any JSON valueValfritt / objekt—
post.publish_options.gif_attachmentobjectValfritt / objekt
  • additionalProperties: {}
post.publish_options.gif_attachment.*any JSON valueValfritt / objekt—
post.publish_options.text_attachmentobjectValfritt / objekt
  • additionalProperties: {}
post.publish_options.text_attachment.*any JSON valueValfritt / objekt—
post.publish_options.text_entitiesarrayValfritt / objekt—
post.publish_options.text_entities[]objectValfritt / objekt
  • additionalProperties: {}
post.publish_options.text_entities[].*any JSON valueValfritt / objekt—
post.publish_options.is_spoiler_mediabooleanValfritt / objekt—
post.publish_options.is_ghost_postbooleanValfritt / objekt—
post.publish_options.allowlisted_country_codesarrayValfritt / objekt—
post.publish_options.allowlisted_country_codes[]stringValfritt / objekt—
post.publish_options.crossreshare_to_igbooleanValfritt / objekt—
post.publish_options.crossreshare_to_ig_dark_modebooleanValfritt / objekt—
post.publish_options.auto_publish_textbooleanValfritt / objekt—
post.publish_options.publication_modestringValfritt / objekt
  • enum: ["PUBLISH","DRAFT"]
post.publish_options.backdated_timenumberValfritt / objekt—
post.publish_options.backdated_time_granularitystringValfritt / objekt
  • enum: ["year","month","day","hour","minute"]
post.publish_options.placestringValfritt / objekt—
post.publish_options.feed_targetingobjectValfritt / objekt
  • additionalProperties: {}
post.publish_options.feed_targeting.*any JSON valueValfritt / objekt—
post.publish_options.targetingobjectValfritt / objekt
  • additionalProperties: {}
post.publish_options.targeting.*any JSON valueValfritt / objekt—
post.publish_options.child_attachmentsarrayValfritt / objekt—
post.publish_options.child_attachments[]objectValfritt / objekt
  • additionalProperties: {}
post.publish_options.child_attachments[].*any JSON valueValfritt / objekt—
post.publish_options.multi_share_end_cardbooleanValfritt / objekt—
post.publish_options.multi_share_optimizedbooleanValfritt / objekt—
post.publish_options.unpublished_content_typestringValfritt / objekt—
post.publish_options.no_storybooleanValfritt / objekt—
post.publish_options.crossposted_video_idstringValfritt / objekt—
post.publish_options.sphericalbooleanValfritt / objekt—
post.scheduled_atstringObligatoriskt i överordnat objekt—
post.display_timezonestringObligatoriskt i överordnat objekt
  • minLength: 1
  • maxLength: 80
post.local_scheduled_atstring | nullValfritt / objekt—
post.local_scheduled_atanyOf 1stringValfritt / objekt
  • pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
post.local_scheduled_atanyOf 2nullValfritt / objekt—
post.schedule_timezonestring | nullValfritt / objekt—
post.schedule_timezoneanyOf 1stringValfritt / objekt
  • minLength: 1
  • maxLength: 80
post.schedule_timezoneanyOf 2nullValfritt / objekt—
post.schedule_dst_disambiguationstring | nullValfritt / objekt—
post.schedule_dst_disambiguationanyOf 1stringValfritt / objekt
  • enum: ["exact","earlier","later"]
post.schedule_dst_disambiguationanyOf 2nullValfritt / objekt—
post.schedule_intent_statestringValfritt / objekt
  • enum: ["verified","legacy_unverified"]
post.expires_atstring | nullObligatoriskt i överordnat objekt—
post.expires_atanyOf 1stringObligatoriskt i överordnat objekt—
post.expires_atanyOf 2nullObligatoriskt i överordnat objekt—
post.statusstringObligatoriskt i överordnat objekt
  • enum: ["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]
post.versionintegerObligatoriskt i överordnat objekt
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.automatic_retry_enabledbooleanObligatoriskt i överordnat objekt—
post.delete_requested_atstring | nullObligatoriskt i överordnat objekt—
post.delete_requested_atanyOf 1stringObligatoriskt i överordnat objekt—
post.delete_requested_atanyOf 2nullObligatoriskt i överordnat objekt—
post.published_atstring | nullObligatoriskt i överordnat objekt—
post.published_atanyOf 1stringObligatoriskt i överordnat objekt—
post.published_atanyOf 2nullObligatoriskt i överordnat objekt—
post.deleted_atstring | nullObligatoriskt i överordnat objekt—
post.deleted_atanyOf 1stringObligatoriskt i överordnat objekt—
post.deleted_atanyOf 2nullObligatoriskt i överordnat objekt—
post.provider_post_idstring | nullObligatoriskt i överordnat objekt—
post.provider_post_idanyOf 1stringObligatoriskt i överordnat objekt—
post.provider_post_idanyOf 2nullObligatoriskt i överordnat objekt—
post.permalinkstring | nullObligatoriskt i överordnat objekt—
post.permalinkanyOf 1stringObligatoriskt i överordnat objekt
  • format: "uri"
post.permalinkanyOf 2nullObligatoriskt i överordnat objekt—
post.created_atstringObligatoriskt i överordnat objekt—
post.updated_atstringObligatoriskt i överordnat objekt—
deliveryobjectObligatoriskt i överordnat objekt
  • additionalProperties: false
delivery.stagestringObligatoriskt i överordnat objekt
  • enum: ["scheduled","preparing","delivering","reconciling","cancelling","terminal"]
delivery.messagestringObligatoriskt i överordnat objekt
  • minLength: 1
  • maxLength: 500
actionsarrayObligatoriskt i överordnat objekt
  • minItems: 5
  • maxItems: 5
actions[]objectValfritt / objekt
  • additionalProperties: false
actions[].actionstringObligatoriskt i överordnat objekt
  • enum: ["edit","publish_now","retry","cancel","delete"]
actions[].allowedbooleanObligatoriskt i överordnat objekt—
actions[].reason_codestringObligatoriskt i överordnat objekt
  • 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[].messagestringObligatoriskt i överordnat objekt
  • minLength: 1
  • maxLength: 500
attemptsarrayObligatoriskt i överordnat objekt
  • maxItems: 200
attempts[]objectValfritt / objekt
  • additionalProperties: false
attempts[].idstringObligatoriskt i överordnat objekt
  • format: "uuid"
attempts[].operationstringObligatoriskt i överordnat objekt
  • enum: ["publish","delete"]
attempts[].attempt_numberintegerObligatoriskt i överordnat objekt
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
attempts[].dispatched_atstringObligatoriskt i överordnat objekt—
outcomesarrayObligatoriskt i överordnat objekt
  • maxItems: 200
outcomes[]objectValfritt / objekt
  • additionalProperties: false
outcomes[].idstringObligatoriskt i överordnat objekt
  • format: "uuid"
outcomes[].publication_attempt_idstring | nullObligatoriskt i överordnat objekt—
outcomes[].publication_attempt_idanyOf 1stringObligatoriskt i överordnat objekt
  • format: "uuid"
outcomes[].publication_attempt_idanyOf 2nullObligatoriskt i överordnat objekt—
outcomes[].operationstringObligatoriskt i överordnat objekt
  • enum: ["publish","delete"]
outcomes[].statusstringObligatoriskt i överordnat objekt
  • enum: ["published","failed","deleted"]
outcomes[].provider_post_idstring | nullObligatoriskt i överordnat objekt—
outcomes[].provider_post_idanyOf 1stringObligatoriskt i överordnat objekt—
outcomes[].provider_post_idanyOf 2nullObligatoriskt i överordnat objekt—
outcomes[].permalinkstring | nullObligatoriskt i överordnat objekt—
outcomes[].permalinkanyOf 1stringObligatoriskt i överordnat objekt
  • format: "uri"
outcomes[].permalinkanyOf 2nullObligatoriskt i överordnat objekt—
outcomes[].messagestringObligatoriskt i överordnat objekt
  • minLength: 1
  • maxLength: 500
outcomes[].observed_atstringObligatoriskt i överordnat objekt—
outcomes[].terminal_suboperationobjectValfritt / objekt
  • additionalProperties: false
outcomes[].terminal_suboperation.kindstringObligatoriskt i överordnat objekt
  • const: "instagram_first_comment"
outcomes[].terminal_suboperation.statusstringObligatoriskt i överordnat objekt
  • enum: ["succeeded","failed","attention"]
outcomes[].terminal_suboperation.external_idstring | nullObligatoriskt i överordnat objekt—
outcomes[].terminal_suboperation.external_idanyOf 1stringObligatoriskt i överordnat objekt
  • minLength: 1
  • maxLength: 500
outcomes[].terminal_suboperation.external_idanyOf 2nullObligatoriskt i överordnat objekt—
Fullständigt 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
}

Exempel på verktygsanrop

Exemplen använder fiktiva värden som kontrollerats mot schemana. Ersätt ID:n med sådana du får använda, medier med färdiga mediefiler och datum med din bekräftade publiceringstid. Kontrollera kontots behörighet före en skrivning. Denna sida skickar inga API-anrop.

{
  "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": []
}
Installera eller anslut MCP