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

Die Suche lädt erst bei Nutzung. Durchsuche unten alle Kategorien.

Planung und Veröffentlichung

Geplanten Beitrag abrufen

Lies einen geplanten Beitrag anhand seiner id: Inhalt, Status, Zustellungszustand und Ergebnisse. Seine version wird für update, publish, retry und cancel als expected_version benötigt.

POST /studio-api/scheduled-posts/get

Vertrag geprüft: · sha256:563d2d581da0ad29

Als Markdown lesenÖffentlichen Vertrag herunterladenOpenAPI herunterladen

Überblick

Lies einen geplanten Beitrag anhand seiner id: Inhalt, Status, Zustellungszustand und Ergebnisse. Seine version wird für update, publish, retry und cancel als expected_version benötigt.

Eine erfolgreiche HTTP-Antwort kann Annahme statt Abschluss bedeuten. Speichere bei Hintergrundarbeit die ID und prüfe dieselbe Operation bis zum Abschluss. Geplante oder angenommene Beiträge gelten erst nach Plattformbestätigung als veröffentlicht; ein Client-Timeout klärt das Ergebnis nicht.

Authentifizierung und Berechtigungen

Akzeptierte Zugangsdatenklassen
user_session, delegated_oauth, personal_access_token
Delegierte Funktion
agent:operate
Minimale Workspace-Rolle
viewer
Zugriffsumfang
Ressourcen, auf die dieser Nutzer zugreifen darf
Zustimmung für alle Workspaces erforderlich
Nein
Ändert Zustand
Nein
Nach Abschluss der Operation
synchronous_http_response

Ein Token nutzt nur Eigentümerrechte. Jede Anfrage prüft Workspace-Mitgliedschaft, Ressourceneigentum, gewählte Workspaces und Funktionen. core und full ändern sichtbare Tools; sie erteilen keinen Zugriff.

Anfragefelder

Erforderlich bedeutet innerhalb des übergeordneten Objekts und gewählten Zweigs erforderlich. Ein erforderliches Kind macht kein optionales Elternobjekt erforderlich. Regeln und Feldnamen unten stammen aus dem Vertrag.

Anfragefelder
Feld / VarianteTyp / erforderlichEinschränkungen
$objectIm Elternobjekt erforderlich
  • additionalProperties: false
idstringIm Elternobjekt erforderlich
  • 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}$"
Vollständiges 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}$"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Antwort und Abschluss

HTTP-Erfolgsstatus: 200. Wenn die Operation abgeschlossen ist: synchronous_http_response.

Eine erfolgreiche HTTP-Antwort kann Annahme statt Abschluss bedeuten. Speichere bei Hintergrundarbeit die ID und prüfe dieselbe Operation bis zum Abschluss. Geplante oder angenommene Beiträge gelten erst nach Plattformbestätigung als veröffentlicht; ein Client-Timeout klärt das Ergebnis nicht.

Erforderlich bedeutet innerhalb des übergeordneten Objekts und gewählten Zweigs erforderlich. Ein erforderliches Kind macht kein optionales Elternobjekt erforderlich. Regeln und Feldnamen unten stammen aus dem Vertrag.

Antwort und Abschluss
Feld / VarianteTyp / erforderlichEinschränkungen
$objectIm Elternobjekt erforderlich—
postobjectIm Elternobjekt erforderlich—
post.idstringIm Elternobjekt erforderlich
  • 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_idstringIm Elternobjekt erforderlich
  • 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 | nullIm Elternobjekt erforderlich—
post.social_account_idanyOf 1stringIm Elternobjekt erforderlich
  • 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 2nullIm Elternobjekt erforderlich—
post.platformstringIm Elternobjekt erforderlich
  • enum: ["instagram","threads","facebook","youtube","x"]
post.destinationobjectIm Elternobjekt erforderlich—
post.destination.social_account_idstring | nullIm Elternobjekt erforderlich—
post.destination.social_account_idanyOf 1stringIm Elternobjekt erforderlich
  • 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 2nullIm Elternobjekt erforderlich—
post.destination.platformstringIm Elternobjekt erforderlich
  • enum: ["instagram","threads","facebook","youtube","x"]
post.destination.platform_user_idstring | nullIm Elternobjekt erforderlich—
post.destination.platform_user_idanyOf 1stringIm Elternobjekt erforderlich—
post.destination.platform_user_idanyOf 2nullIm Elternobjekt erforderlich—
post.destination.account_labelstring | nullIm Elternobjekt erforderlich—
post.destination.account_labelanyOf 1stringIm Elternobjekt erforderlich—
post.destination.account_labelanyOf 2nullIm Elternobjekt erforderlich—
post.captionstring | nullIm Elternobjekt erforderlich—
post.captionanyOf 1stringIm Elternobjekt erforderlich—
post.captionanyOf 2nullIm Elternobjekt erforderlich—
post.hashtagsarrayIm Elternobjekt erforderlich—
post.hashtags[]stringOptional / Element—
post.mediaarrayIm Elternobjekt erforderlich—
post.media[]objectOptional / Element—
post.media[].kindstringIm Elternobjekt erforderlich
  • enum: ["image","video"]
post.media[].urlstringIm Elternobjekt erforderlich
  • format: "uri"
post.media[].cover_urlstring | nullOptional / Element—
post.media[].cover_urlanyOf 1stringOptional / Element
  • format: "uri"
post.media[].cover_urlanyOf 2nullOptional / Element—
post.media[].cover_asset_idinteger | nullOptional / Element—
post.media[].cover_asset_idanyOf 1integerOptional / Element
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.media[].cover_asset_idanyOf 2nullOptional / Element—
post.media[].asset_idinteger | nullOptional / Element—
post.media[].asset_idanyOf 1integerOptional / Element
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.media[].asset_idanyOf 2nullOptional / Element—
post.media[].mime_typestring | nullOptional / Element—
post.media[].mime_typeanyOf 1stringOptional / Element
  • minLength: 1
  • maxLength: 160
post.media[].mime_typeanyOf 2nullOptional / Element—
post.media[].preview_urlstring | nullOptional / Element

Temporäre autorisierte Lese-URL; url als dauerhafte Scheduled-Post-Medienidentität behalten.

—
post.media[].preview_urlanyOf 1stringOptional / Element
  • format: "uri"
post.media[].preview_urlanyOf 2nullOptional / Element—
post.media[].cover_preview_urlstring | nullOptional / Element

Temporäre autorisierte Cover-Lese-URL; cover_url als dauerhafte Medienidentität behalten.

—
post.media[].cover_preview_urlanyOf 1stringOptional / Element
  • format: "uri"
post.media[].cover_preview_urlanyOf 2nullOptional / Element—
post.media[].preview_expires_atstring | nullOptional / Element—
post.media[].preview_expires_atanyOf 1stringOptional / Element
  • 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 2nullOptional / Element—
post.link_urlstring | nullOptional / Element—
post.link_urlanyOf 1stringOptional / Element
  • format: "uri"
post.link_urlanyOf 2nullOptional / Element—
post.publish_optionsobjectIm Elternobjekt erforderlich—
post.publish_options.post_typestringOptional / Element
  • enum: ["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]
post.publish_options.location_idstringOptional / Element
  • minLength: 1
post.publish_options.share_to_feedbooleanOptional / Element—
post.publish_options.collaboratorsarrayOptional / Element
  • maxItems: 3
post.publish_options.collaborators[]stringOptional / Element
  • minLength: 1
post.publish_options.first_commentstringOptional / Element
  • minLength: 1
  • maxLength: 2200
post.publish_options.topic_tagstringOptional / Element
  • minLength: 1
post.publish_options.thumb_offset_msintegerOptional / Element
  • minimum: 0
  • maximum: 9007199254740991
post.publish_options.titlestringOptional / Element
  • maxLength: 255
post.publish_options.youtube_privacy_statusstringOptional / Element
  • enum: ["private","unlisted","public"]
post.publish_options.youtube_category_idstringOptional / Element
  • pattern: "^\\d+$"
post.publish_options.youtube_contains_synthetic_mediabooleanOptional / Element—
post.publish_options.descriptionstringOptional / Element
  • maxLength: 5000
post.publish_options.category_idstringOptional / Element
  • pattern: "^\\d+$"
post.publish_options.privacy_statusstringOptional / Element
  • enum: ["private","unlisted","public"]
post.publish_options.cancellation_modestringOptional / Element
  • enum: ["DELETE","UNSCHEDULE_KEEP_PRIVATE"]
post.publish_options.tagsarrayOptional / Element—
post.publish_options.tags[]stringOptional / Element—
post.publish_options.default_languagestringOptional / Element—
post.publish_options.localizationsobjectOptional / Element
  • additionalProperties: {}
post.publish_options.localizations.*any JSON valueOptional / Element—
post.publish_options.licensestringOptional / Element
  • enum: ["youtube","creativeCommon"]
post.publish_options.embeddablebooleanOptional / Element—
post.publish_options.public_stats_viewablebooleanOptional / Element—
post.publish_options.self_declared_made_for_kidsbooleanOptional / Element—
post.publish_options.contains_synthetic_mediabooleanOptional / Element—
post.publish_options.has_paid_product_placementbooleanOptional / Element—
post.publish_options.recording_datestringOptional / Element—
post.publish_options.notify_subscribersbooleanOptional / Element—
post.publish_options.thumbnail_asset_idintegerOptional / Element
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.publish_options.surface_expectationstringOptional / Element
  • const: "SHORT"
post.publish_options.brand_partnerobjectOptional / Element
  • additionalProperties: {}
post.publish_options.brand_partner.*any JSON valueOptional / Element—
post.publish_options.cover_asset_idintegerOptional / Element
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.publish_options.audio_namestringOptional / Element—
post.publish_options.trial_paramsobjectOptional / Element
  • additionalProperties: {}
post.publish_options.trial_params.*any JSON valueOptional / Element—
post.publish_options.is_ai_generatedbooleanOptional / Element—
post.publish_options.branded_content_sponsor_idsarrayOptional / Element—
post.publish_options.branded_content_sponsor_ids[]stringOptional / Element—
post.publish_options.is_paid_partnershipbooleanOptional / Element—
post.publish_options.media_optionsarrayOptional / Element—
post.publish_options.media_options[]objectOptional / Element
  • additionalProperties: {}
post.publish_options.media_options[].*any JSON valueOptional / Element—
post.publish_options.reply_to_idstringOptional / Element—
post.publish_options.quote_post_idstringOptional / Element—
post.publish_options.repost_target_idstringOptional / Element—
post.publish_options.reply_controlstringOptional / Element—
post.publish_options.enable_reply_approvalsbooleanOptional / Element—
post.publish_options.link_attachmentstringOptional / Element
  • format: "uri"
post.publish_options.poll_attachmentobjectOptional / Element
  • additionalProperties: {}
post.publish_options.poll_attachment.*any JSON valueOptional / Element—
post.publish_options.gif_attachmentobjectOptional / Element
  • additionalProperties: {}
post.publish_options.gif_attachment.*any JSON valueOptional / Element—
post.publish_options.text_attachmentobjectOptional / Element
  • additionalProperties: {}
post.publish_options.text_attachment.*any JSON valueOptional / Element—
post.publish_options.text_entitiesarrayOptional / Element—
post.publish_options.text_entities[]objectOptional / Element
  • additionalProperties: {}
post.publish_options.text_entities[].*any JSON valueOptional / Element—
post.publish_options.is_spoiler_mediabooleanOptional / Element—
post.publish_options.is_ghost_postbooleanOptional / Element—
post.publish_options.allowlisted_country_codesarrayOptional / Element—
post.publish_options.allowlisted_country_codes[]stringOptional / Element—
post.publish_options.crossreshare_to_igbooleanOptional / Element—
post.publish_options.crossreshare_to_ig_dark_modebooleanOptional / Element—
post.publish_options.auto_publish_textbooleanOptional / Element—
post.publish_options.publication_modestringOptional / Element
  • enum: ["PUBLISH","DRAFT"]
post.publish_options.backdated_timenumberOptional / Element—
post.publish_options.backdated_time_granularitystringOptional / Element
  • enum: ["year","month","day","hour","minute"]
post.publish_options.placestringOptional / Element—
post.publish_options.feed_targetingobjectOptional / Element
  • additionalProperties: {}
post.publish_options.feed_targeting.*any JSON valueOptional / Element—
post.publish_options.targetingobjectOptional / Element
  • additionalProperties: {}
post.publish_options.targeting.*any JSON valueOptional / Element—
post.publish_options.child_attachmentsarrayOptional / Element—
post.publish_options.child_attachments[]objectOptional / Element
  • additionalProperties: {}
post.publish_options.child_attachments[].*any JSON valueOptional / Element—
post.publish_options.multi_share_end_cardbooleanOptional / Element—
post.publish_options.multi_share_optimizedbooleanOptional / Element—
post.publish_options.unpublished_content_typestringOptional / Element—
post.publish_options.no_storybooleanOptional / Element—
post.publish_options.crossposted_video_idstringOptional / Element—
post.publish_options.sphericalbooleanOptional / Element—
post.scheduled_atstringIm Elternobjekt erforderlich—
post.display_timezonestringIm Elternobjekt erforderlich
  • minLength: 1
  • maxLength: 80
post.local_scheduled_atstring | nullOptional / Element—
post.local_scheduled_atanyOf 1stringOptional / Element
  • pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
post.local_scheduled_atanyOf 2nullOptional / Element—
post.schedule_timezonestring | nullOptional / Element—
post.schedule_timezoneanyOf 1stringOptional / Element
  • minLength: 1
  • maxLength: 80
post.schedule_timezoneanyOf 2nullOptional / Element—
post.schedule_dst_disambiguationstring | nullOptional / Element—
post.schedule_dst_disambiguationanyOf 1stringOptional / Element
  • enum: ["exact","earlier","later"]
post.schedule_dst_disambiguationanyOf 2nullOptional / Element—
post.schedule_intent_statestringOptional / Element
  • enum: ["verified","legacy_unverified"]
post.expires_atstring | nullIm Elternobjekt erforderlich—
post.expires_atanyOf 1stringIm Elternobjekt erforderlich—
post.expires_atanyOf 2nullIm Elternobjekt erforderlich—
post.statusstringIm Elternobjekt erforderlich
  • enum: ["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]
post.versionintegerIm Elternobjekt erforderlich
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.automatic_retry_enabledbooleanIm Elternobjekt erforderlich—
post.delete_requested_atstring | nullIm Elternobjekt erforderlich—
post.delete_requested_atanyOf 1stringIm Elternobjekt erforderlich—
post.delete_requested_atanyOf 2nullIm Elternobjekt erforderlich—
post.published_atstring | nullIm Elternobjekt erforderlich—
post.published_atanyOf 1stringIm Elternobjekt erforderlich—
post.published_atanyOf 2nullIm Elternobjekt erforderlich—
post.deleted_atstring | nullIm Elternobjekt erforderlich—
post.deleted_atanyOf 1stringIm Elternobjekt erforderlich—
post.deleted_atanyOf 2nullIm Elternobjekt erforderlich—
post.provider_post_idstring | nullIm Elternobjekt erforderlich—
post.provider_post_idanyOf 1stringIm Elternobjekt erforderlich—
post.provider_post_idanyOf 2nullIm Elternobjekt erforderlich—
post.permalinkstring | nullIm Elternobjekt erforderlich—
post.permalinkanyOf 1stringIm Elternobjekt erforderlich
  • format: "uri"
post.permalinkanyOf 2nullIm Elternobjekt erforderlich—
post.created_atstringIm Elternobjekt erforderlich—
post.updated_atstringIm Elternobjekt erforderlich—
deliveryobjectIm Elternobjekt erforderlich—
delivery.stagestringIm Elternobjekt erforderlich
  • enum: ["scheduled","preparing","delivering","reconciling","cancelling","terminal"]
delivery.messagestringIm Elternobjekt erforderlich
  • minLength: 1
  • maxLength: 500
actionsarrayIm Elternobjekt erforderlich
  • minItems: 5
  • maxItems: 5
actions[]objectOptional / Element—
actions[].actionstringIm Elternobjekt erforderlich
  • enum: ["edit","publish_now","retry","cancel","delete"]
actions[].allowedbooleanIm Elternobjekt erforderlich—
actions[].reason_codestringIm Elternobjekt erforderlich
  • 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[].messagestringIm Elternobjekt erforderlich
  • minLength: 1
  • maxLength: 500
attemptsarrayIm Elternobjekt erforderlich
  • maxItems: 200
attempts[]objectOptional / Element—
attempts[].idstringIm Elternobjekt erforderlich
  • 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)$"
attempts[].operationstringIm Elternobjekt erforderlich
  • enum: ["publish","delete"]
attempts[].attempt_numberintegerIm Elternobjekt erforderlich
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
attempts[].dispatched_atstringIm Elternobjekt erforderlich—
outcomesarrayIm Elternobjekt erforderlich
  • maxItems: 200
outcomes[]objectOptional / Element—
outcomes[].idstringIm Elternobjekt erforderlich
  • 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)$"
outcomes[].publication_attempt_idstring | nullIm Elternobjekt erforderlich—
outcomes[].publication_attempt_idanyOf 1stringIm Elternobjekt erforderlich
  • 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)$"
outcomes[].publication_attempt_idanyOf 2nullIm Elternobjekt erforderlich—
outcomes[].operationstringIm Elternobjekt erforderlich
  • enum: ["publish","delete"]
outcomes[].statusstringIm Elternobjekt erforderlich
  • enum: ["published","failed","deleted"]
outcomes[].provider_post_idstring | nullIm Elternobjekt erforderlich—
outcomes[].provider_post_idanyOf 1stringIm Elternobjekt erforderlich—
outcomes[].provider_post_idanyOf 2nullIm Elternobjekt erforderlich—
outcomes[].permalinkstring | nullIm Elternobjekt erforderlich—
outcomes[].permalinkanyOf 1stringIm Elternobjekt erforderlich
  • format: "uri"
outcomes[].permalinkanyOf 2nullIm Elternobjekt erforderlich—
outcomes[].messagestringIm Elternobjekt erforderlich
  • minLength: 1
  • maxLength: 500
outcomes[].observed_atstringIm Elternobjekt erforderlich—
outcomes[].terminal_suboperationobjectOptional / Element—
outcomes[].terminal_suboperation.kindstringIm Elternobjekt erforderlich
  • const: "instagram_first_comment"
outcomes[].terminal_suboperation.statusstringIm Elternobjekt erforderlich
  • enum: ["succeeded","failed","attention"]
outcomes[].terminal_suboperation.external_idstring | nullIm Elternobjekt erforderlich—
outcomes[].terminal_suboperation.external_idanyOf 1stringIm Elternobjekt erforderlich
  • minLength: 1
  • maxLength: 500
outcomes[].terminal_suboperation.external_idanyOf 2nullIm Elternobjekt erforderlich—
Vollständiges 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"
        }
      },
      "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"
      ]
    },
    "delivery": {
      "type": "object",
      "properties": {
        "stage": {
          "type": "string",
          "enum": [
            "scheduled",
            "preparing",
            "delivering",
            "reconciling",
            "cancelling",
            "terminal"
          ]
        },
        "message": {
          "type": "string",
          "minLength": 1,
          "maxLength": 500
        }
      },
      "required": [
        "stage",
        "message"
      ]
    },
    "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"
        ]
      }
    },
    "attempts": {
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "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)$"
          },
          "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"
        ]
      }
    },
    "outcomes": {
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "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)$"
          },
          "publication_attempt_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"
              }
            ]
          },
          "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"
            ]
          }
        },
        "required": [
          "id",
          "publication_attempt_id",
          "operation",
          "status",
          "provider_post_id",
          "permalink",
          "message",
          "observed_at"
        ]
      }
    }
  },
  "required": [
    "post",
    "delivery",
    "actions",
    "attempts",
    "outcomes"
  ]
}

Fehler und sichere Wiederholungen

Prüfe HTTP-Status und Antwortinhalt. Ein 400-Validierungsfehler kann einen ZodError enthalten; Handler-Fehler verwenden die Felder error, message und code. Bewahre request_id oder x-request-id zur Diagnose ohne Zugangsdaten auf. Behebe 401/403-Zugriffsfehler vor einem erneuten Versuch und beachte Retry-After bei 429. Ist ein Schreibvorgang ungewiss oder liefert 5xx, lies zuerst das bestehende Ergebnis. Verwende einen Idempotenzschlüssel nur wieder, wo dies unterstützt wird; Wiederholungen unterscheiden sich je nach Operation und garantieren keine genau einmalige Zustellung.

Anleitung zur Fehlerbehebung

Beispiele

Diese Beispiele nutzen anhand der Schemas geprüfte fiktive Werte. Ersetze IDs durch autorisierte IDs, Medien durch bereite Assets und Daten durch bestätigte Veröffentlichungszeiten. Prüfe Kontoeignung vor Schreibvorgängen. Diese Seite sendet keine API-Anfragen.

Setze SOSOAPI_ACCESS_TOKEN auf deinem Server auf akzeptierte Zugangsdaten dieser Operation und halte es aus Browsercode heraus. Für Agenten nutze sosoapi auth login zur Browseranmeldung und lass die CLI Zugangsdaten erneuern.

request.json

{
  "id": "11111111-1111-4111-8111-111111111111"
}

cURL

curl --request POST \
  "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/scheduled-posts/get" \
  -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/get", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: "Bearer " + token },
  body: JSON.stringify({
  "id": "11111111-1111-4111-8111-111111111111"
})
});
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/get < request.json

Synthetisches Antwortbeispiel

{
  "post": {
    "id": "11111111-1111-4111-8111-111111111111",
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "social_account_id": null,
    "platform": "instagram",
    "destination": {
      "social_account_id": null,
      "platform": "instagram",
      "platform_user_id": null,
      "account_label": null
    },
    "caption": null,
    "hashtags": [],
    "media": [],
    "publish_options": {},
    "scheduled_at": "example",
    "display_timezone": "UTC",
    "expires_at": null,
    "status": "scheduled",
    "version": 1,
    "automatic_retry_enabled": false,
    "delete_requested_at": null,
    "published_at": null,
    "deleted_at": null,
    "provider_post_id": null,
    "permalink": null,
    "created_at": "example",
    "updated_at": "example"
  },
  "delivery": {
    "stage": "scheduled",
    "message": "example"
  },
  "actions": [
    {
      "action": "edit",
      "allowed": true,
      "reason_code": "allowed",
      "message": "Allowed in this example state."
    },
    {
      "action": "publish_now",
      "allowed": true,
      "reason_code": "allowed",
      "message": "Allowed in this example state."
    },
    {
      "action": "retry",
      "allowed": false,
      "reason_code": "not_failed",
      "message": "This example post has not failed."
    },
    {
      "action": "cancel",
      "allowed": true,
      "reason_code": "allowed",
      "message": "Allowed in this example state."
    },
    {
      "action": "delete",
      "allowed": true,
      "reason_code": "allowed",
      "message": "Allowed in this example state."
    }
  ],
  "attempts": [],
  "outcomes": []
}

MCP: sosoapi_get_scheduled_post

Alle API-OperationenAuthentifizierung und Berechtigungen