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

Pencarian hanya dimuat saat digunakan. Jelajahi semua kategori di bawah.

Penjadwalan dan publikasi

Dapatkan postingan terjadwal

Baca satu postingan terjadwal berdasarkan id: konten, status, status pengiriman, dan hasil. Versinya diperlukan sebagai expected_version untuk update, publish, retry, dan cancel.

POST /studio-api/scheduled-posts/get

Kontrak ditinjau: · sha256:563d2d581da0ad29

Baca sebagai MarkdownUnduh kontrak publikUnduh OpenAPI

Ringkasan

Baca satu postingan terjadwal berdasarkan id: konten, status, status pengiriman, dan hasil. Versinya diperlukan sebagai expected_version untuk update, publish, retry, dan cancel.

Respons HTTP berhasil dapat berarti permintaan diterima, bukan selesai. Untuk pekerjaan latar belakang, simpan ID yang dikembalikan dan periksa operasi yang sama sampai selesai. Postingan terjadwal atau diterima baru dipublikasikan setelah platform mengonfirmasi; timeout klien tidak membuktikan hasilnya.

Autentikasi dan izin

Jenis kredensial yang diterima
user_session, delegated_oauth, personal_access_token
Kemampuan yang didelegasikan
agent:operate
Peran ruang kerja minimum
viewer
Cakupan akses
Sumber daya yang boleh diakses pengguna ini
Persetujuan seluruh ruang kerja diperlukan
Tidak
Mengubah status
Tidak
Saat operasi selesai
synchronous_http_response

Token hanya dapat menggunakan hak pemiliknya. Setiap permintaan memeriksa keanggotaan ruang kerja, kepemilikan sumber daya, ruang kerja terpilih, dan kemampuan yang diberikan. Profil core dan full mengubah alat yang ditampilkan; tidak memberikan akses.

Kolom permintaan

Wajib berarti wajib dalam objek induk dan cabang yang dipilih. Anak wajib tidak membuat induk opsional menjadi wajib. Aturan dan nama kolom di bawah disalin dari kontrak.

Kolom permintaan
Kolom / cabangJenis / wajibBatasan
$objectWajib dalam induk
  • additionalProperties: false
idstringWajib dalam induk
  • 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}$"
JSON Schema lengkap
{
  "$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
}

Respons dan penyelesaian

Status HTTP berhasil: 200. Saat operasi selesai: synchronous_http_response.

Respons HTTP berhasil dapat berarti permintaan diterima, bukan selesai. Untuk pekerjaan latar belakang, simpan ID yang dikembalikan dan periksa operasi yang sama sampai selesai. Postingan terjadwal atau diterima baru dipublikasikan setelah platform mengonfirmasi; timeout klien tidak membuktikan hasilnya.

Wajib berarti wajib dalam objek induk dan cabang yang dipilih. Anak wajib tidak membuat induk opsional menjadi wajib. Aturan dan nama kolom di bawah disalin dari kontrak.

Respons dan penyelesaian
Kolom / cabangJenis / wajibBatasan
$objectWajib dalam induk—
postobjectWajib dalam induk—
post.idstringWajib dalam induk
  • 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_idstringWajib dalam induk
  • 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 | nullWajib dalam induk—
post.social_account_idanyOf 1stringWajib dalam induk
  • 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 2nullWajib dalam induk—
post.platformstringWajib dalam induk
  • enum: ["instagram","threads","facebook","youtube","x"]
post.destinationobjectWajib dalam induk—
post.destination.social_account_idstring | nullWajib dalam induk—
post.destination.social_account_idanyOf 1stringWajib dalam induk
  • 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 2nullWajib dalam induk—
post.destination.platformstringWajib dalam induk
  • enum: ["instagram","threads","facebook","youtube","x"]
post.destination.platform_user_idstring | nullWajib dalam induk—
post.destination.platform_user_idanyOf 1stringWajib dalam induk—
post.destination.platform_user_idanyOf 2nullWajib dalam induk—
post.destination.account_labelstring | nullWajib dalam induk—
post.destination.account_labelanyOf 1stringWajib dalam induk—
post.destination.account_labelanyOf 2nullWajib dalam induk—
post.captionstring | nullWajib dalam induk—
post.captionanyOf 1stringWajib dalam induk—
post.captionanyOf 2nullWajib dalam induk—
post.hashtagsarrayWajib dalam induk—
post.hashtags[]stringOpsional / item—
post.mediaarrayWajib dalam induk—
post.media[]objectOpsional / item—
post.media[].kindstringWajib dalam induk
  • enum: ["image","video"]
post.media[].urlstringWajib dalam induk
  • format: "uri"
post.media[].cover_urlstring | nullOpsional / item—
post.media[].cover_urlanyOf 1stringOpsional / item
  • format: "uri"
post.media[].cover_urlanyOf 2nullOpsional / item—
post.media[].cover_asset_idinteger | nullOpsional / item—
post.media[].cover_asset_idanyOf 1integerOpsional / item
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.media[].cover_asset_idanyOf 2nullOpsional / item—
post.media[].asset_idinteger | nullOpsional / item—
post.media[].asset_idanyOf 1integerOpsional / item
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.media[].asset_idanyOf 2nullOpsional / item—
post.media[].mime_typestring | nullOpsional / item—
post.media[].mime_typeanyOf 1stringOpsional / item
  • minLength: 1
  • maxLength: 160
post.media[].mime_typeanyOf 2nullOpsional / item—
post.media[].preview_urlstring | nullOpsional / item

URL baca sementara yang diizinkan; pertahankan url sebagai identitas media Scheduled Post persisten.

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

URL baca sampul sementara yang diizinkan; pertahankan cover_url sebagai identitas media persisten.

—
post.media[].cover_preview_urlanyOf 1stringOpsional / item
  • format: "uri"
post.media[].cover_preview_urlanyOf 2nullOpsional / item—
post.media[].preview_expires_atstring | nullOpsional / item—
post.media[].preview_expires_atanyOf 1stringOpsional / 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 2nullOpsional / item—
post.link_urlstring | nullOpsional / item—
post.link_urlanyOf 1stringOpsional / item
  • format: "uri"
post.link_urlanyOf 2nullOpsional / item—
post.publish_optionsobjectWajib dalam induk—
post.publish_options.post_typestringOpsional / item
  • enum: ["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]
post.publish_options.location_idstringOpsional / item
  • minLength: 1
post.publish_options.share_to_feedbooleanOpsional / item—
post.publish_options.collaboratorsarrayOpsional / item
  • maxItems: 3
post.publish_options.collaborators[]stringOpsional / item
  • minLength: 1
post.publish_options.first_commentstringOpsional / item
  • minLength: 1
  • maxLength: 2200
post.publish_options.topic_tagstringOpsional / item
  • minLength: 1
post.publish_options.thumb_offset_msintegerOpsional / item
  • minimum: 0
  • maximum: 9007199254740991
post.publish_options.titlestringOpsional / item
  • maxLength: 255
post.publish_options.youtube_privacy_statusstringOpsional / item
  • enum: ["private","unlisted","public"]
post.publish_options.youtube_category_idstringOpsional / item
  • pattern: "^\\d+$"
post.publish_options.youtube_contains_synthetic_mediabooleanOpsional / item—
post.publish_options.descriptionstringOpsional / item
  • maxLength: 5000
post.publish_options.category_idstringOpsional / item
  • pattern: "^\\d+$"
post.publish_options.privacy_statusstringOpsional / item
  • enum: ["private","unlisted","public"]
post.publish_options.cancellation_modestringOpsional / item
  • enum: ["DELETE","UNSCHEDULE_KEEP_PRIVATE"]
post.publish_options.tagsarrayOpsional / item—
post.publish_options.tags[]stringOpsional / item—
post.publish_options.default_languagestringOpsional / item—
post.publish_options.localizationsobjectOpsional / item
  • additionalProperties: {}
post.publish_options.localizations.*any JSON valueOpsional / item—
post.publish_options.licensestringOpsional / item
  • enum: ["youtube","creativeCommon"]
post.publish_options.embeddablebooleanOpsional / item—
post.publish_options.public_stats_viewablebooleanOpsional / item—
post.publish_options.self_declared_made_for_kidsbooleanOpsional / item—
post.publish_options.contains_synthetic_mediabooleanOpsional / item—
post.publish_options.has_paid_product_placementbooleanOpsional / item—
post.publish_options.recording_datestringOpsional / item—
post.publish_options.notify_subscribersbooleanOpsional / item—
post.publish_options.thumbnail_asset_idintegerOpsional / item
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.publish_options.surface_expectationstringOpsional / item
  • const: "SHORT"
post.publish_options.brand_partnerobjectOpsional / item
  • additionalProperties: {}
post.publish_options.brand_partner.*any JSON valueOpsional / item—
post.publish_options.cover_asset_idintegerOpsional / item
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.publish_options.audio_namestringOpsional / item—
post.publish_options.trial_paramsobjectOpsional / item
  • additionalProperties: {}
post.publish_options.trial_params.*any JSON valueOpsional / item—
post.publish_options.is_ai_generatedbooleanOpsional / item—
post.publish_options.branded_content_sponsor_idsarrayOpsional / item—
post.publish_options.branded_content_sponsor_ids[]stringOpsional / item—
post.publish_options.is_paid_partnershipbooleanOpsional / item—
post.publish_options.media_optionsarrayOpsional / item—
post.publish_options.media_options[]objectOpsional / item
  • additionalProperties: {}
post.publish_options.media_options[].*any JSON valueOpsional / item—
post.publish_options.reply_to_idstringOpsional / item—
post.publish_options.quote_post_idstringOpsional / item—
post.publish_options.repost_target_idstringOpsional / item—
post.publish_options.reply_controlstringOpsional / item—
post.publish_options.enable_reply_approvalsbooleanOpsional / item—
post.publish_options.link_attachmentstringOpsional / item
  • format: "uri"
post.publish_options.poll_attachmentobjectOpsional / item
  • additionalProperties: {}
post.publish_options.poll_attachment.*any JSON valueOpsional / item—
post.publish_options.gif_attachmentobjectOpsional / item
  • additionalProperties: {}
post.publish_options.gif_attachment.*any JSON valueOpsional / item—
post.publish_options.text_attachmentobjectOpsional / item
  • additionalProperties: {}
post.publish_options.text_attachment.*any JSON valueOpsional / item—
post.publish_options.text_entitiesarrayOpsional / item—
post.publish_options.text_entities[]objectOpsional / item
  • additionalProperties: {}
post.publish_options.text_entities[].*any JSON valueOpsional / item—
post.publish_options.is_spoiler_mediabooleanOpsional / item—
post.publish_options.is_ghost_postbooleanOpsional / item—
post.publish_options.allowlisted_country_codesarrayOpsional / item—
post.publish_options.allowlisted_country_codes[]stringOpsional / item—
post.publish_options.crossreshare_to_igbooleanOpsional / item—
post.publish_options.crossreshare_to_ig_dark_modebooleanOpsional / item—
post.publish_options.auto_publish_textbooleanOpsional / item—
post.publish_options.publication_modestringOpsional / item
  • enum: ["PUBLISH","DRAFT"]
post.publish_options.backdated_timenumberOpsional / item—
post.publish_options.backdated_time_granularitystringOpsional / item
  • enum: ["year","month","day","hour","minute"]
post.publish_options.placestringOpsional / item—
post.publish_options.feed_targetingobjectOpsional / item
  • additionalProperties: {}
post.publish_options.feed_targeting.*any JSON valueOpsional / item—
post.publish_options.targetingobjectOpsional / item
  • additionalProperties: {}
post.publish_options.targeting.*any JSON valueOpsional / item—
post.publish_options.child_attachmentsarrayOpsional / item—
post.publish_options.child_attachments[]objectOpsional / item
  • additionalProperties: {}
post.publish_options.child_attachments[].*any JSON valueOpsional / item—
post.publish_options.multi_share_end_cardbooleanOpsional / item—
post.publish_options.multi_share_optimizedbooleanOpsional / item—
post.publish_options.unpublished_content_typestringOpsional / item—
post.publish_options.no_storybooleanOpsional / item—
post.publish_options.crossposted_video_idstringOpsional / item—
post.publish_options.sphericalbooleanOpsional / item—
post.scheduled_atstringWajib dalam induk—
post.display_timezonestringWajib dalam induk
  • minLength: 1
  • maxLength: 80
post.local_scheduled_atstring | nullOpsional / item—
post.local_scheduled_atanyOf 1stringOpsional / item
  • pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
post.local_scheduled_atanyOf 2nullOpsional / item—
post.schedule_timezonestring | nullOpsional / item—
post.schedule_timezoneanyOf 1stringOpsional / item
  • minLength: 1
  • maxLength: 80
post.schedule_timezoneanyOf 2nullOpsional / item—
post.schedule_dst_disambiguationstring | nullOpsional / item—
post.schedule_dst_disambiguationanyOf 1stringOpsional / item
  • enum: ["exact","earlier","later"]
post.schedule_dst_disambiguationanyOf 2nullOpsional / item—
post.schedule_intent_statestringOpsional / item
  • enum: ["verified","legacy_unverified"]
post.expires_atstring | nullWajib dalam induk—
post.expires_atanyOf 1stringWajib dalam induk—
post.expires_atanyOf 2nullWajib dalam induk—
post.statusstringWajib dalam induk
  • enum: ["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]
post.versionintegerWajib dalam induk
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.automatic_retry_enabledbooleanWajib dalam induk—
post.delete_requested_atstring | nullWajib dalam induk—
post.delete_requested_atanyOf 1stringWajib dalam induk—
post.delete_requested_atanyOf 2nullWajib dalam induk—
post.published_atstring | nullWajib dalam induk—
post.published_atanyOf 1stringWajib dalam induk—
post.published_atanyOf 2nullWajib dalam induk—
post.deleted_atstring | nullWajib dalam induk—
post.deleted_atanyOf 1stringWajib dalam induk—
post.deleted_atanyOf 2nullWajib dalam induk—
post.provider_post_idstring | nullWajib dalam induk—
post.provider_post_idanyOf 1stringWajib dalam induk—
post.provider_post_idanyOf 2nullWajib dalam induk—
post.permalinkstring | nullWajib dalam induk—
post.permalinkanyOf 1stringWajib dalam induk
  • format: "uri"
post.permalinkanyOf 2nullWajib dalam induk—
post.created_atstringWajib dalam induk—
post.updated_atstringWajib dalam induk—
deliveryobjectWajib dalam induk—
delivery.stagestringWajib dalam induk
  • enum: ["scheduled","preparing","delivering","reconciling","cancelling","terminal"]
delivery.messagestringWajib dalam induk
  • minLength: 1
  • maxLength: 500
actionsarrayWajib dalam induk
  • minItems: 5
  • maxItems: 5
actions[]objectOpsional / item—
actions[].actionstringWajib dalam induk
  • enum: ["edit","publish_now","retry","cancel","delete"]
actions[].allowedbooleanWajib dalam induk—
actions[].reason_codestringWajib dalam induk
  • 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[].messagestringWajib dalam induk
  • minLength: 1
  • maxLength: 500
attemptsarrayWajib dalam induk
  • maxItems: 200
attempts[]objectOpsional / item—
attempts[].idstringWajib dalam induk
  • 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[].operationstringWajib dalam induk
  • enum: ["publish","delete"]
attempts[].attempt_numberintegerWajib dalam induk
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
attempts[].dispatched_atstringWajib dalam induk—
outcomesarrayWajib dalam induk
  • maxItems: 200
outcomes[]objectOpsional / item—
outcomes[].idstringWajib dalam induk
  • 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 | nullWajib dalam induk—
outcomes[].publication_attempt_idanyOf 1stringWajib dalam induk
  • 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 2nullWajib dalam induk—
outcomes[].operationstringWajib dalam induk
  • enum: ["publish","delete"]
outcomes[].statusstringWajib dalam induk
  • enum: ["published","failed","deleted"]
outcomes[].provider_post_idstring | nullWajib dalam induk—
outcomes[].provider_post_idanyOf 1stringWajib dalam induk—
outcomes[].provider_post_idanyOf 2nullWajib dalam induk—
outcomes[].permalinkstring | nullWajib dalam induk—
outcomes[].permalinkanyOf 1stringWajib dalam induk
  • format: "uri"
outcomes[].permalinkanyOf 2nullWajib dalam induk—
outcomes[].messagestringWajib dalam induk
  • minLength: 1
  • maxLength: 500
outcomes[].observed_atstringWajib dalam induk—
outcomes[].terminal_suboperationobjectOpsional / item—
outcomes[].terminal_suboperation.kindstringWajib dalam induk
  • const: "instagram_first_comment"
outcomes[].terminal_suboperation.statusstringWajib dalam induk
  • enum: ["succeeded","failed","attention"]
outcomes[].terminal_suboperation.external_idstring | nullWajib dalam induk—
outcomes[].terminal_suboperation.external_idanyOf 1stringWajib dalam induk
  • minLength: 1
  • maxLength: 500
outcomes[].terminal_suboperation.external_idanyOf 2nullWajib dalam induk—
JSON Schema lengkap
{
  "$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"
  ]
}

Kesalahan dan percobaan ulang aman

Periksa status HTTP dan isi respons. Kesalahan validasi 400 mungkin berisi ZodError; kesalahan handler menggunakan kolom error, message, dan code. Simpan request_id atau x-request-id untuk diagnosis, tanpa kredensial. Atasi kesalahan akses 401/403 sebelum mencoba lagi, dan ikuti Retry-After untuk 429. Jika penulisan belum pasti atau mengembalikan 5xx, baca hasil yang sudah ada terlebih dahulu. Gunakan kembali kunci idempotensi hanya jika didukung; perilaku percobaan ulang berbeda menurut operasi dan tidak menjamin pengiriman tepat satu kali.

Panduan pemecahan masalah

Contoh

Contoh ini menggunakan nilai fiktif yang diperiksa terhadap skema. Ganti ID dengan yang diizinkan bagi Anda, media dengan aset siap, dan tanggal dengan waktu publikasi yang dikonfirmasi. Periksa kelayakan akun sebelum mengirim penulisan. Halaman ini tidak mengirim permintaan API.

Atur SOSOAPI_ACCESS_TOKEN di server Anda ke kredensial yang diterima operasi ini, dan jauhkan dari kode browser. Untuk agen, gunakan sosoapi auth login untuk masuk melalui browser dan biarkan CLI memperbarui kredensialnya.

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

Contoh respons sintetis

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

Semua operasi APIAutentikasi dan izin