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

Schemaläggning och publicering

Återkalla raderingsbegäran

Återkalla en stoppad raderingsbegäran för Instagram Login och behåll det publicerade inlägget. Kräver expected_version.

POST /studio-api/scheduled-posts/withdraw-delete

Kontrakt granskat: · sha256:563d2d581da0ad29

Översikt

Återkalla en stoppad raderingsbegäran för Instagram Login och behåll det publicerade inlägget. Kräver expected_version.

Ett lyckat HTTP-svar kan betyda att en begäran accepterats snarare än slutförts. Spara returnerat ID för bakgrundsarbete och kontrollera samma åtgärd tills den är klar. Ett schemalagt eller accepterat inlägg är publicerat först när plattformen bekräftar det; en klienttimeout fastställer inte resultatet.

Autentisering och behörigheter

Godtagna typer av autentiseringsuppgifter
user_session, delegated_oauth, personal_access_token
Delegerad funktion
agent:publish
Lägsta arbetsyteroll
editor
Åtkomstomfång
Resurser som denna användare har behörighet att komma åt
Samtycke för alla arbetsytor krävs
Nej
Ändrar tillstånd
Ja
När åtgärden är klar
audited withdrawal; provider content retained

En token får endast använda ägarens rättigheter. Varje anrop kontrollerar arbetsytemedlemskap, resursägarskap, valda arbetsytor och beviljade funktioner. Profilerna core och full ändrar vilka verktyg som visas; de ger ingen åtkomst.

Anropsfä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.

Anropsfä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}$"
expected_versionintegerObligatoriskt i överordnat objekt
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
Fullständigt 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
}

Svar och slutförande

HTTP-status vid framgång: 200. När åtgärden är klar: audited withdrawal; provider content retained.

Ett lyckat HTTP-svar kan betyda att en begäran accepterats snarare än slutförts. Spara returnerat ID för bakgrundsarbete och kontrollera samma åtgärd tills den är klar. Ett schemalagt eller accepterat inlägg är publicerat först när plattformen bekräftar det; en klienttimeout fastställer inte resultatet.

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.

Svar och slutförande
Fält / grenTyp / obligatorisktBegränsningar
$objectObligatoriskt i överordnat objekt—
postobjectObligatoriskt i överordnat objekt—
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"
  • 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 | nullObligatoriskt i överordnat objekt—
post.social_account_idanyOf 1stringObligatoriskt i överordnat objekt
  • 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 2nullObligatoriskt i överordnat objekt—
post.platformstringObligatoriskt i överordnat objekt
  • enum: ["instagram","threads","facebook","youtube","x"]
post.destinationobjectObligatoriskt i överordnat objekt—
post.destination.social_account_idstring | nullObligatoriskt i överordnat objekt—
post.destination.social_account_idanyOf 1stringObligatoriskt i överordnat objekt
  • 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 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—
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—
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—
post.project_idstring | nullObligatoriskt i överordnat objekt—
post.project_idanyOf 1stringObligatoriskt i överordnat objekt
  • 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 2nullObligatoriskt i överordnat objekt—
post.batch_idstring | nullObligatoriskt i överordnat objekt—
post.batch_idanyOf 1stringObligatoriskt i överordnat objekt
  • 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 2nullObligatoriskt i överordnat objekt—
post.source_refobject | nullObligatoriskt i överordnat objekt—
post.source_refanyOf 1objectObligatoriskt i överordnat objekt
  • additionalProperties: {}
post.source_ref.*anyOf 1any JSON valueValfritt / objekt—
post.source_refanyOf 2nullObligatoriskt i överordnat objekt—
Fullständigt 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"
  ]
}

Fel och säkra nya försök

Kontrollera HTTP-status och svarskropp. Ett valideringsfel med 400 kan innehålla ZodError; hanterarfel använder fälten error, message och code. Spara request_id eller x-request-id för felsökning, utan inloggningsuppgifter. Åtgärda åtkomstfel med 401/403 innan du försöker igen och följ Retry-After vid 429. Om en skrivning är osäker eller returnerar 5xx, läs först det befintliga resultatet. Återanvänd en idempotensnyckel endast där det stöds; försöksbeteendet varierar mellan åtgärder och garanterar inte leverans exakt en gång.

Felsökningsguide

Exempel

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.

Sätt SOSOAPI_ACCESS_TOKEN på servern till en autentiseringsuppgift som åtgärden godtar och håll den borta från webbläsarkod. För en agent använder du sosoapi auth login för att logga in via webbläsaren och låter CLI förnya sina uppgifter.

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/withdraw-delete" \
  -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/withdraw-delete", {
  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/withdraw-delete < request.json

Syntetiskt svarsexempel

{
  "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_withdraw_scheduled_post_delete