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

Batalkan postingan terjadwal

Batalkan postingan terjadwal yang belum dipublikasikan agar tidak pernah terkirim. Postingan yang sudah dipublikasikan ditolak, dan agen juga tidak dapat menghapus konten yang sudah dipublikasikan: pengguna melakukannya di aplikasi web. Memerlukan expected_version.

POST /studio-api/scheduled-posts/cancel

Kontrak ditinjau: · sha256:563d2d581da0ad29

Baca sebagai MarkdownUnduh kontrak publikUnduh OpenAPI

Ringkasan

Batalkan postingan terjadwal yang belum dipublikasikan agar tidak pernah terkirim. Postingan yang sudah dipublikasikan ditolak, dan agen juga tidak dapat menghapus konten yang sudah dipublikasikan: pengguna melakukannya di aplikasi web. Memerlukan expected_version.

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:publish
Peran ruang kerja minimum
editor
Cakupan akses
Sumber daya yang boleh diakses pengguna ini
Persetujuan seluruh ruang kerja diperlukan
Tidak
Mengubah status
Ya
Saat operasi selesai
terminal publication outcome

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}$"
expected_versionintegerWajib dalam induk
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
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}$"
    },
    "expected_version": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "id",
    "expected_version"
  ],
  "additionalProperties": false
}

Respons dan penyelesaian

Status HTTP berhasil: 200. Saat operasi selesai: terminal publication outcome.

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—
post.project_idstring | nullWajib dalam induk—
post.project_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.project_idanyOf 2nullWajib dalam induk—
post.batch_idstring | nullWajib dalam induk—
post.batch_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.batch_idanyOf 2nullWajib dalam induk—
post.source_refobject | nullWajib dalam induk—
post.source_refanyOf 1objectWajib dalam induk
  • additionalProperties: {}
post.source_ref.*anyOf 1any JSON valueOpsional / item—
post.source_refanyOf 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"
        },
        "project_id": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            {
              "type": "null"
            }
          ]
        },
        "batch_id": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            {
              "type": "null"
            }
          ]
        },
        "source_ref": {
          "anyOf": [
            {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "id",
        "workspace_id",
        "social_account_id",
        "platform",
        "destination",
        "caption",
        "hashtags",
        "media",
        "publish_options",
        "scheduled_at",
        "display_timezone",
        "expires_at",
        "status",
        "version",
        "automatic_retry_enabled",
        "delete_requested_at",
        "published_at",
        "deleted_at",
        "provider_post_id",
        "permalink",
        "created_at",
        "updated_at",
        "project_id",
        "batch_id",
        "source_ref"
      ]
    }
  },
  "required": [
    "post"
  ]
}

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",
  "expected_version": 1
}

cURL

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

JavaScript

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

CLI

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

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",
    "project_id": null,
    "batch_id": null,
    "source_ref": null
  }
}

MCP: sosoapi_cancel_scheduled_post

Semua operasi APIAutentikasi dan izin