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.

Inplannen en publiceren

Ingepland bericht annuleren

Annuleer een nog niet gepubliceerd ingepland bericht zodat het niet wordt verzonden. Een gepubliceerd bericht wordt geweigerd; een agent kan gepubliceerde inhoud ook niet verwijderen: dat doet de gebruiker in de webapp. Vereist expected_version.

POST /studio-api/scheduled-posts/cancel

Contract beoordeeld: · sha256:563d2d581da0ad29

Lezen als MarkdownDownload openbaar contractDownload OpenAPI

Overzicht

Annuleer een nog niet gepubliceerd ingepland bericht zodat het niet wordt verzonden. Een gepubliceerd bericht wordt geweigerd; een agent kan gepubliceerde inhoud ook niet verwijderen: dat doet de gebruiker in de webapp. Vereist expected_version.

Een geslaagd HTTP-antwoord kan acceptatie betekenen in plaats van voltooiing. Bewaar bij achtergrondwerk de teruggegeven ID en controleer dezelfde bewerking totdat die klaar is. Een ingepland of geaccepteerd bericht is pas gepubliceerd na platformbevestiging; een client-time-out bepaalt het resultaat niet.

Authenticatie en machtigingen

Toegestane soorten inloggegevens
user_session, delegated_oauth, personal_access_token
Gedelegeerde bevoegdheid
agent:publish
Minimale werkruimterol
editor
Toegangsbereik
Resources waartoe deze gebruiker toegang heeft
Toestemming voor alle werkruimten vereist
Nee
Wijzigt status
Ja
Wanneer de bewerking voltooid is
terminal publication outcome

Een token kan alleen rechten van de eigenaar gebruiken. Elk verzoek controleert werkruimtelidmaatschap, resource-eigendom, geselecteerde werkruimten en verleende bevoegdheden. De profielen core en full bepalen welke tools zichtbaar zijn; ze verlenen geen toegang.

Verzoekvelden

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.

Verzoekvelden
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}$"
expected_versionintegerVerplicht in bovenliggend object
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
Volledig JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/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}$"
    },
    "expected_version": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "id",
    "expected_version"
  ],
  "additionalProperties": false
}

Antwoord en voltooiing

HTTP-statuscodes bij succes: 200. Wanneer de bewerking voltooid is: terminal publication outcome.

Een geslaagd HTTP-antwoord kan acceptatie betekenen in plaats van voltooiing. Bewaar bij achtergrondwerk de teruggegeven ID en controleer dezelfde bewerking totdat die klaar is. Een ingepland of geaccepteerd bericht is pas gepubliceerd na platformbevestiging; een client-time-out bepaalt het resultaat niet.

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.

Antwoord en voltooiing
Veld / variantType / verplichtBeperkingen
$objectVerplicht in bovenliggend object—
postobjectVerplicht in bovenliggend object—
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"
  • pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
post.social_account_idstring | nullVerplicht in bovenliggend object—
post.social_account_idanyOf 1stringVerplicht in bovenliggend object
  • format: "uuid"
  • pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
post.social_account_idanyOf 2nullVerplicht in bovenliggend object—
post.platformstringVerplicht in bovenliggend object
  • enum: ["instagram","threads","facebook","youtube","x"]
post.destinationobjectVerplicht in bovenliggend object—
post.destination.social_account_idstring | nullVerplicht in bovenliggend object—
post.destination.social_account_idanyOf 1stringVerplicht in bovenliggend object
  • format: "uuid"
  • pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
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—
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—
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—
post.project_idstring | nullVerplicht in bovenliggend object—
post.project_idanyOf 1stringVerplicht in bovenliggend object
  • format: "uuid"
  • pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
post.project_idanyOf 2nullVerplicht in bovenliggend object—
post.batch_idstring | nullVerplicht in bovenliggend object—
post.batch_idanyOf 1stringVerplicht in bovenliggend object
  • format: "uuid"
  • pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
post.batch_idanyOf 2nullVerplicht in bovenliggend object—
post.source_refobject | nullVerplicht in bovenliggend object—
post.source_refanyOf 1objectVerplicht in bovenliggend object
  • additionalProperties: {}
post.source_ref.*anyOf 1any JSON valueOptioneel / item—
post.source_refanyOf 2nullVerplicht in bovenliggend object—
Volledig JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/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",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        "social_account_id": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            {
              "type": "null"
            }
          ]
        },
        "platform": {
          "type": "string",
          "enum": [
            "instagram",
            "threads",
            "facebook",
            "youtube",
            "x"
          ]
        },
        "destination": {
          "type": "object",
          "properties": {
            "social_account_id": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "uuid",
                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                },
                {
                  "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"
          ]
        },
        "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"
            ]
          }
        },
        "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"
            }
          }
        },
        "scheduled_at": {
          "type": "string"
        },
        "display_timezone": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80
        },
        "local_scheduled_at": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
            },
            {
              "type": "null"
            }
          ]
        },
        "schedule_timezone": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1,
              "maxLength": 80
            },
            {
              "type": "null"
            }
          ]
        },
        "schedule_dst_disambiguation": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "exact",
                "earlier",
                "later"
              ]
            },
            {
              "type": "null"
            }
          ]
        },
        "schedule_intent_state": {
          "type": "string",
          "enum": [
            "verified",
            "legacy_unverified"
          ]
        },
        "expires_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "status": {
          "type": "string",
          "enum": [
            "scheduled",
            "publishing",
            "published",
            "failed",
            "expired",
            "needs_reschedule",
            "cancelled",
            "deleted"
          ]
        },
        "version": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        "automatic_retry_enabled": {
          "type": "boolean"
        },
        "delete_requested_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "published_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "deleted_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "provider_post_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "permalink": {
          "anyOf": [
            {
              "type": "string",
              "format": "uri"
            },
            {
              "type": "null"
            }
          ]
        },
        "created_at": {
          "type": "string"
        },
        "updated_at": {
          "type": "string"
        },
        "project_id": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            {
              "type": "null"
            }
          ]
        },
        "batch_id": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            {
              "type": "null"
            }
          ]
        },
        "source_ref": {
          "anyOf": [
            {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "id",
        "workspace_id",
        "social_account_id",
        "platform",
        "destination",
        "caption",
        "hashtags",
        "media",
        "publish_options",
        "scheduled_at",
        "display_timezone",
        "expires_at",
        "status",
        "version",
        "automatic_retry_enabled",
        "delete_requested_at",
        "published_at",
        "deleted_at",
        "provider_post_id",
        "permalink",
        "created_at",
        "updated_at",
        "project_id",
        "batch_id",
        "source_ref"
      ]
    }
  },
  "required": [
    "post"
  ]
}

Fouten en veilig opnieuw proberen

Controleer de HTTP-status en antwoordinhoud. Een 400-validatiefout kan een ZodError bevatten; afhandelingsfouten gebruiken de velden error, message en code. Bewaar request_id of x-request-id voor diagnose, zonder inloggegevens. Los 401/403-toegangsfouten op voordat je opnieuw probeert en volg Retry-After bij 429. Lees bij een onzekere schrijfhandeling of 5xx eerst het bestaande resultaat. Hergebruik een idempotentiesleutel alleen waar dit wordt ondersteund; het gedrag bij opnieuw proberen verschilt per bewerking en garandeert geen precies eenmalige aflevering.

Handleiding voor probleemoplossing

Voorbeelden

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.

Stel SOSOAPI_ACCESS_TOKEN op je server in op inloggegevens die deze bewerking accepteert en houd deze uit browsercode. Gebruik voor een agent sosoapi auth login om via de browser aan te melden en laat de CLI de inloggegevens vernieuwen.

request.json

{
  "id": "11111111-1111-4111-8111-111111111111",
  "expected_version": 1
}

cURL

curl --request POST \
  "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/scheduled-posts/cancel" \
  -H "Authorization: Bearer $SOSOAPI_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @request.json

JavaScript

// Server-side JavaScript. Do not print tokens or credential-bearing responses.
const token = process.env.SOSOAPI_ACCESS_TOKEN;
if (!token) throw new Error("Set an accepted credential for this operation");
const response = await fetch("https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/scheduled-posts/cancel", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: "Bearer " + token },
  body: JSON.stringify({
  "id": "11111111-1111-4111-8111-111111111111",
  "expected_version": 1
})
});
const result = await response.json();
// Check response.ok, the operation-specific body and completion state before continuing.

CLI

npx sosoapi api post /studio-api/scheduled-posts/cancel < request.json

Voorbeeld van een synthetisch antwoord

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

MCP: sosoapi_cancel_scheduled_post

Alle API-bewerkingenAuthenticatie en machtigingen