Penjadwalan dan publikasi
Kirim postingan gambar lengkap
Kirim postingan URL gambar satu kali. SosoAPI menyiapkan media dan mengembalikan hasil publikasi saat tersedia; jika belum, simpan ID postingan dan periksa postingan itu lagi. Jangan kirim ulang dengan kunci baru. HTTP menggunakan kolom permintaan datar di bawah; alat MCP terkait membungkus kolom postingan dalam objek post.
POST /studio-api/scheduled-posts/create-image-urlKontrak ditinjau: · sha256:563d2d581da0ad29
Ringkasan
Kirim postingan URL gambar satu kali. SosoAPI menyiapkan media dan mengembalikan hasil publikasi saat tersedia; jika belum, simpan ID postingan dan periksa postingan itu lagi. Jangan kirim ulang dengan kunci baru. HTTP menggunakan kolom permintaan datar di bawah; alat MCP terkait membungkus kolom postingan dalam objek post.
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
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 / cabang | Jenis / wajib | Batasan |
|---|---|---|
$ | objectWajib dalam induk |
|
workspace_id | stringWajib dalam induk |
|
project_id | string | nullOpsional / item | — |
project_idanyOf 1 | stringOpsional / item |
|
project_idanyOf 2 | nullOpsional / item | — |
social_account_id | stringWajib dalam induk |
|
caption | string | nullOpsional / item |
|
captionanyOf 1 | stringOpsional / item |
|
captionanyOf 2 | nullOpsional / item | — |
hashtags | arrayOpsional / item |
|
hashtags[] | stringOpsional / item |
|
media | arrayOpsional / item |
|
media[] | objectOpsional / item |
|
media[].kind | stringWajib dalam induk |
|
media[].url | stringWajib dalam induk |
|
media[].cover_url | string | nullOpsional / item | — |
media[].cover_urlanyOf 1 | stringOpsional / item |
|
media[].cover_urlanyOf 2 | nullOpsional / item | — |
media[].cover_asset_id | integer | nullOpsional / item | — |
media[].cover_asset_idanyOf 1 | integerOpsional / item |
|
media[].cover_asset_idanyOf 2 | nullOpsional / item | — |
media[].asset_id | integer | nullOpsional / item | — |
media[].asset_idanyOf 1 | integerOpsional / item |
|
media[].asset_idanyOf 2 | nullOpsional / item | — |
media[].mime_type | string | nullOpsional / item | — |
media[].mime_typeanyOf 1 | stringOpsional / item |
|
media[].mime_typeanyOf 2 | nullOpsional / item | — |
link_url | string | nullOpsional / item | — |
link_urlanyOf 1 | stringOpsional / item |
|
link_urlanyOf 2 | nullOpsional / item | — |
provider_payload | objectWajib dalam induk | — |
provider_payloadoneOf 1 | objectWajib dalam induk |
|
provider_payload.platformoneOf 1 | stringWajib dalam induk |
|
provider_payload.publish_optionsoneOf 1 | objectWajib dalam induk |
|
provider_payload.publish_options.post_typeoneOf 1 | stringWajib dalam induk |
|
provider_payloadoneOf 2 | objectWajib dalam induk |
|
provider_payload.platformoneOf 2 | stringWajib dalam induk |
|
provider_payload.publish_optionsoneOf 2 | objectWajib dalam induk |
|
provider_payload.publish_options.post_typeoneOf 2 | stringWajib dalam induk |
|
provider_payload.publish_options.location_idoneOf 2 | stringOpsional / item |
|
provider_payload.publish_options.share_to_feedoneOf 2 | booleanOpsional / item | — |
provider_payload.publish_options.collaboratorsoneOf 2 | arrayOpsional / item |
|
provider_payload.publish_options.collaborators[]oneOf 2 | stringOpsional / item |
|
provider_payload.publish_options.first_commentoneOf 2 | stringOpsional / item |
|
provider_payload.publish_options.cover_asset_idoneOf 2 | integerOpsional / item |
|
provider_payload.publish_options.thumb_offset_msoneOf 2 | integerOpsional / item |
|
provider_payload.publish_options.audio_nameoneOf 2 | stringOpsional / item |
|
provider_payload.publish_options.trial_paramsoneOf 2 | objectOpsional / item |
|
provider_payload.publish_options.trial_params.graduation_strategyoneOf 2 | stringWajib dalam induk |
|
provider_payload.publish_options.is_ai_generatedoneOf 2 | booleanOpsional / item | — |
provider_payload.publish_options.branded_content_sponsor_idsoneOf 2 | arrayOpsional / item |
|
provider_payload.publish_options.branded_content_sponsor_ids[]oneOf 2 | stringOpsional / item |
|
provider_payload.publish_options.is_paid_partnershiponeOf 2 | booleanOpsional / item | — |
provider_payload.publish_options.media_optionsoneOf 2 | arrayOpsional / item |
|
provider_payload.publish_options.media_options[]oneOf 2 | objectOpsional / item |
|
provider_payload.publish_options.media_options[].asset_idoneOf 2 | integerWajib dalam induk |
|
provider_payload.publish_options.media_options[].alt_textoneOf 2 | stringOpsional / item |
|
provider_payload.publish_options.media_options[].user_tagsoneOf 2 | arrayOpsional / item |
|
provider_payload.publish_options.media_options[].user_tags[]oneOf 2 | objectOpsional / item |
|
provider_payload.publish_options.media_options[].user_tags[].usernameoneOf 2 | stringWajib dalam induk |
|
provider_payload.publish_options.media_options[].user_tags[].xoneOf 2 | numberOpsional / item |
|
provider_payload.publish_options.media_options[].user_tags[].yoneOf 2 | numberOpsional / item |
|
provider_payload.publish_options.media_options[].product_tagsoneOf 2 | arrayOpsional / item |
|
provider_payload.publish_options.media_options[].product_tags[]oneOf 2 | objectOpsional / item |
|
provider_payload.publish_options.media_options[].product_tags[].product_idoneOf 2 | stringWajib dalam induk |
|
provider_payload.publish_options.media_options[].product_tags[].xoneOf 2 | numberOpsional / item |
|
provider_payload.publish_options.media_options[].product_tags[].yoneOf 2 | numberOpsional / item |
|
provider_payload.publish_options.media_options[].thumb_offset_msoneOf 2 | integerOpsional / item |
|
provider_payloadoneOf 3 | objectWajib dalam induk |
|
provider_payload.platformoneOf 3 | stringWajib dalam induk |
|
provider_payload.publish_optionsoneOf 3 | objectWajib dalam induk |
|
provider_payload.publish_options.post_typeoneOf 3 | stringWajib dalam induk |
|
provider_payload.publish_options.titleoneOf 3 | stringOpsional / item |
|
provider_payload.publish_options.descriptiononeOf 3 | stringOpsional / item |
|
provider_payload.publish_options.publication_modeoneOf 3 | stringOpsional / item |
|
provider_payload.publish_options.backdated_timeoneOf 3 | numberOpsional / item | — |
provider_payload.publish_options.backdated_time_granularityoneOf 3 | stringOpsional / item |
|
provider_payload.publish_options.placeoneOf 3 | stringOpsional / item |
|
provider_payload.publish_options.tagsoneOf 3 | arrayOpsional / item |
|
provider_payload.publish_options.tags[]oneOf 3 | stringOpsional / item |
|
provider_payload.publish_options.feed_targetingoneOf 3 | objectOpsional / item |
|
provider_payload.publish_options.feed_targeting.age_minoneOf 3 | integerOpsional / item |
|
provider_payload.publish_options.feed_targeting.age_maxoneOf 3 | integerOpsional / item |
|
provider_payload.publish_options.feed_targeting.college_yearsoneOf 3 | arrayOpsional / item |
|
provider_payload.publish_options.feed_targeting.college_years[]oneOf 3 | integerOpsional / item |
|
provider_payload.publish_options.feed_targeting.education_statusesoneOf 3 | arrayOpsional / item |
|
provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 | numberOpsional / item | — |
provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 / anyOf 1 | numberOpsional / item |
|
provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 / anyOf 2 | numberOpsional / item |
|
provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 / anyOf 3 | numberOpsional / item |
|
provider_payload.publish_options.feed_targeting.gendersoneOf 3 | arrayOpsional / item |
|
provider_payload.publish_options.feed_targeting.genders[]oneOf 3 | numberOpsional / item | — |
provider_payload.publish_options.feed_targeting.genders[]oneOf 3 / anyOf 1 | numberOpsional / item |
|
provider_payload.publish_options.feed_targeting.genders[]oneOf 3 / anyOf 2 | numberOpsional / item |
|
provider_payload.publish_options.feed_targeting.geo_locationsoneOf 3 | objectOpsional / item |
|
provider_payload.publish_options.feed_targeting.geo_locations.countriesoneOf 3 | arrayOpsional / item |
|
provider_payload.publish_options.feed_targeting.geo_locations.countries[]oneOf 3 | stringOpsional / item |
|
provider_payload.publish_options.feed_targeting.geo_locations.regionsoneOf 3 | arrayOpsional / item |
|
provider_payload.publish_options.feed_targeting.geo_locations.regions[]oneOf 3 | objectOpsional / item |
|
provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyoneOf 3 | string | integerWajib dalam induk | — |
provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyoneOf 3 / anyOf 1 | stringWajib dalam induk |
|
provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyoneOf 3 / anyOf 2 | integerWajib dalam induk |
|
provider_payload.publish_options.feed_targeting.geo_locations.citiesoneOf 3 | arrayOpsional / item |
|
provider_payload.publish_options.feed_targeting.geo_locations.cities[]oneOf 3 | objectOpsional / item |
|
provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyoneOf 3 | string | integerWajib dalam induk | — |
provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyoneOf 3 / anyOf 1 | stringWajib dalam induk |
|
provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyoneOf 3 / anyOf 2 | integerWajib dalam induk |
|
provider_payload.publish_options.feed_targeting.geo_locations.cities[].radiusoneOf 3 | numberOpsional / item |
|
provider_payload.publish_options.feed_targeting.geo_locations.cities[].distance_unitoneOf 3 | stringOpsional / item |
|
provider_payload.publish_options.feed_targeting.geo_locations.zipsoneOf 3 | arrayOpsional / item |
|
provider_payload.publish_options.feed_targeting.geo_locations.zips[]oneOf 3 | objectOpsional / item |
|
provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyoneOf 3 | string | integerWajib dalam induk | — |
provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyoneOf 3 / anyOf 1 | stringWajib dalam induk |
|
provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyoneOf 3 / anyOf 2 | integerWajib dalam induk |
|
provider_payload.publish_options.feed_targeting.geo_locations.location_typesoneOf 3 | arrayOpsional / item |
|
provider_payload.publish_options.feed_targeting.geo_locations.location_types[]oneOf 3 | stringOpsional / item |
|
provider_payload.publish_options.feed_targeting.interestsoneOf 3 | arrayOpsional / item |
|
provider_payload.publish_options.feed_targeting.interests[]oneOf 3 | string | integerOpsional / item | — |
provider_payload.publish_options.feed_targeting.interests[]oneOf 3 / anyOf 1 | stringOpsional / item |
|
provider_payload.publish_options.feed_targeting.interests[]oneOf 3 / anyOf 2 | integerOpsional / item |
|
provider_payload.publish_options.feed_targeting.localesoneOf 3 | arrayOpsional / item |
|
provider_payload.publish_options.feed_targeting.locales[]oneOf 3 | integerOpsional / item |
|
provider_payload.publish_options.feed_targeting.relationship_statusesoneOf 3 | arrayOpsional / item |
|
provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 | numberOpsional / item | — |
provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 1 | numberOpsional / item |
|
provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 2 | numberOpsional / item |
|
provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 3 | numberOpsional / item |
|
provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 4 | numberOpsional / item |
|
provider_payload.publish_options.targetingoneOf 3 | objectOpsional / item |
|
provider_payload.publish_options.targeting.age_minoneOf 3 | numberOpsional / item | — |
provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 1 | numberOpsional / item |
|
provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 2 | numberOpsional / item |
|
provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 3 | numberOpsional / item |
|
provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 4 | numberOpsional / item |
|
provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 5 | numberOpsional / item |
|
provider_payload.publish_options.targeting.geo_locationsoneOf 3 | objectOpsional / item |
|
provider_payload.publish_options.targeting.geo_locations.countriesoneOf 3 | arrayOpsional / item |
|
provider_payload.publish_options.targeting.geo_locations.countries[]oneOf 3 | stringOpsional / item |
|
provider_payload.publish_options.targeting.geo_locations.regionsoneOf 3 | arrayOpsional / item |
|
provider_payload.publish_options.targeting.geo_locations.regions[]oneOf 3 | objectOpsional / item |
|
provider_payload.publish_options.targeting.geo_locations.regions[].keyoneOf 3 | string | integerWajib dalam induk | — |
provider_payload.publish_options.targeting.geo_locations.regions[].keyoneOf 3 / anyOf 1 | stringWajib dalam induk |
|
provider_payload.publish_options.targeting.geo_locations.regions[].keyoneOf 3 / anyOf 2 | integerWajib dalam induk |
|
provider_payload.publish_options.targeting.geo_locations.citiesoneOf 3 | arrayOpsional / item |
|
provider_payload.publish_options.targeting.geo_locations.cities[]oneOf 3 | objectOpsional / item |
|
provider_payload.publish_options.targeting.geo_locations.cities[].keyoneOf 3 | string | integerWajib dalam induk | — |
provider_payload.publish_options.targeting.geo_locations.cities[].keyoneOf 3 / anyOf 1 | stringWajib dalam induk |
|
provider_payload.publish_options.targeting.geo_locations.cities[].keyoneOf 3 / anyOf 2 | integerWajib dalam induk |
|
provider_payload.publish_options.targeting.geo_locations.cities[].radiusoneOf 3 | numberOpsional / item |
|
provider_payload.publish_options.targeting.geo_locations.cities[].distance_unitoneOf 3 | stringOpsional / item |
|
provider_payload.publish_options.targeting.geo_locations.zipsoneOf 3 | arrayOpsional / item |
|
provider_payload.publish_options.targeting.geo_locations.zips[]oneOf 3 | objectOpsional / item |
|
provider_payload.publish_options.targeting.geo_locations.zips[].keyoneOf 3 | string | integerWajib dalam induk | — |
provider_payload.publish_options.targeting.geo_locations.zips[].keyoneOf 3 / anyOf 1 | stringWajib dalam induk |
|
provider_payload.publish_options.targeting.geo_locations.zips[].keyoneOf 3 / anyOf 2 | integerWajib dalam induk |
|
provider_payload.publish_options.targeting.geo_locations.location_typesoneOf 3 | arrayOpsional / item |
|
provider_payload.publish_options.targeting.geo_locations.location_types[]oneOf 3 | stringOpsional / item |
|
provider_payload.publish_options.child_attachmentsoneOf 3 | arrayOpsional / item |
|
provider_payload.publish_options.child_attachments[]oneOf 3 | objectOpsional / item |
|
provider_payload.publish_options.child_attachments[].linkoneOf 3 | stringWajib dalam induk |
|
provider_payload.publish_options.child_attachments[].nameoneOf 3 | stringOpsional / item |
|
provider_payload.publish_options.child_attachments[].descriptiononeOf 3 | stringOpsional / item |
|
provider_payload.publish_options.child_attachments[].pictureoneOf 3 | stringWajib dalam induk |
|
provider_payload.publish_options.multi_share_end_cardoneOf 3 | booleanOpsional / item | — |
provider_payload.publish_options.multi_share_optimizedoneOf 3 | booleanOpsional / item | — |
provider_payload.publish_options.unpublished_content_typeoneOf 3 | stringOpsional / item |
|
provider_payload.publish_options.no_storyoneOf 3 | booleanOpsional / item | — |
provider_payload.publish_options.crossposted_video_idoneOf 3 | stringOpsional / item |
|
provider_payload.publish_options.sphericaloneOf 3 | booleanOpsional / item | — |
provider_payload.publish_options.media_optionsoneOf 3 | arrayOpsional / item |
|
provider_payload.publish_options.media_options[]oneOf 3 | objectOpsional / item |
|
provider_payload.publish_options.media_options[].asset_idoneOf 3 | integerWajib dalam induk |
|
provider_payload.publish_options.media_options[].alt_text_customoneOf 3 | stringOpsional / item |
|
provider_payloadoneOf 4 | objectWajib dalam induk |
|
provider_payload.platformoneOf 4 | stringWajib dalam induk |
|
provider_payload.publish_optionsoneOf 4 | objectWajib dalam induk |
|
provider_payload.publish_options.post_typeoneOf 4 | stringWajib dalam induk |
|
provider_payload.publish_options.reply_to_idoneOf 4 | stringOpsional / item |
|
provider_payload.publish_options.quote_post_idoneOf 4 | stringOpsional / item |
|
provider_payload.publish_options.repost_target_idoneOf 4 | stringOpsional / item |
|
provider_payload.publish_options.reply_controloneOf 4 | stringOpsional / item |
|
provider_payload.publish_options.enable_reply_approvalsoneOf 4 | booleanOpsional / item | — |
provider_payload.publish_options.link_attachmentoneOf 4 | stringOpsional / item |
|
provider_payload.publish_options.poll_attachmentoneOf 4 | objectOpsional / item |
|
provider_payload.publish_options.poll_attachment.option_aoneOf 4 | stringWajib dalam induk |
|
provider_payload.publish_options.poll_attachment.option_boneOf 4 | stringWajib dalam induk |
|
provider_payload.publish_options.poll_attachment.option_coneOf 4 | stringOpsional / item |
|
provider_payload.publish_options.poll_attachment.option_doneOf 4 | stringOpsional / item |
|
provider_payload.publish_options.gif_attachmentoneOf 4 | objectOpsional / item |
|
provider_payload.publish_options.gif_attachment.gif_idoneOf 4 | stringWajib dalam induk |
|
provider_payload.publish_options.gif_attachment.provideroneOf 4 | stringWajib dalam induk |
|
provider_payload.publish_options.text_attachmentoneOf 4 | objectOpsional / item |
|
provider_payload.publish_options.text_attachment.plaintextoneOf 4 | stringWajib dalam induk |
|
provider_payload.publish_options.text_attachment.link_attachment_urloneOf 4 | stringOpsional / item |
|
provider_payload.publish_options.text_attachment.text_with_styling_infooneOf 4 | arrayOpsional / item |
|
provider_payload.publish_options.text_attachment.text_with_styling_info[]oneOf 4 | objectOpsional / item |
|
provider_payload.publish_options.text_attachment.text_with_styling_info[].offsetoneOf 4 | integerWajib dalam induk |
|
provider_payload.publish_options.text_attachment.text_with_styling_info[].lengthoneOf 4 | integerWajib dalam induk |
|
provider_payload.publish_options.text_attachment.text_with_styling_info[].styling_infooneOf 4 | arrayWajib dalam induk |
|
provider_payload.publish_options.text_attachment.text_with_styling_info[].styling_info[]oneOf 4 | stringOpsional / item |
|
provider_payload.publish_options.topic_tagoneOf 4 | stringOpsional / item |
|
provider_payload.publish_options.text_entitiesoneOf 4 | arrayOpsional / item |
|
provider_payload.publish_options.text_entities[]oneOf 4 | objectOpsional / item |
|
provider_payload.publish_options.text_entities[].entity_typeoneOf 4 | stringWajib dalam induk |
|
provider_payload.publish_options.text_entities[].offsetoneOf 4 | integerWajib dalam induk |
|
provider_payload.publish_options.text_entities[].lengthoneOf 4 | integerWajib dalam induk |
|
provider_payload.publish_options.is_spoiler_mediaoneOf 4 | booleanOpsional / item | — |
provider_payload.publish_options.is_ghost_postoneOf 4 | booleanOpsional / item | — |
provider_payload.publish_options.location_idoneOf 4 | stringOpsional / item |
|
provider_payload.publish_options.allowlisted_country_codesoneOf 4 | arrayOpsional / item |
|
provider_payload.publish_options.allowlisted_country_codes[]oneOf 4 | stringOpsional / item |
|
provider_payload.publish_options.crossreshare_to_igoneOf 4 | booleanOpsional / item | — |
provider_payload.publish_options.crossreshare_to_ig_dark_modeoneOf 4 | booleanOpsional / item | — |
provider_payload.publish_options.auto_publish_textoneOf 4 | booleanOpsional / item | — |
provider_payload.publish_options.media_optionsoneOf 4 | arrayOpsional / item |
|
provider_payload.publish_options.media_options[]oneOf 4 | objectOpsional / item |
|
provider_payload.publish_options.media_options[].asset_idoneOf 4 | integerWajib dalam induk |
|
provider_payload.publish_options.media_options[].alt_textoneOf 4 | stringOpsional / item |
|
provider_payload.publish_options.media_options[].is_spoiler_mediaoneOf 4 | booleanOpsional / item | — |
provider_payloadoneOf 5 | objectWajib dalam induk |
|
provider_payload.platformoneOf 5 | stringWajib dalam induk |
|
provider_payload.publish_optionsoneOf 5 | objectWajib dalam induk |
|
provider_payload.publish_options.post_typeoneOf 5 | stringWajib dalam induk |
|
provider_payload.publish_options.titleoneOf 5 | stringWajib dalam induk |
|
provider_payload.publish_options.descriptiononeOf 5 | stringOpsional / item |
|
provider_payload.publish_options.tagsoneOf 5 | arrayOpsional / item |
|
provider_payload.publish_options.tags[]oneOf 5 | stringOpsional / item |
|
provider_payload.publish_options.category_idoneOf 5 | stringOpsional / item | — |
provider_payload.publish_options.category_idoneOf 5 / anyOf 1 | stringOpsional / item |
|
provider_payload.publish_options.category_idoneOf 5 / anyOf 2 | stringOpsional / item |
|
provider_payload.publish_options.default_languageoneOf 5 | stringOpsional / item |
|
provider_payload.publish_options.localizationsoneOf 5 | objectOpsional / item |
|
provider_payload.publish_options.localizations.*oneOf 5 | objectOpsional / item |
|
provider_payload.publish_options.localizations.*.titleoneOf 5 | stringWajib dalam induk |
|
provider_payload.publish_options.localizations.*.descriptiononeOf 5 | stringWajib dalam induk |
|
provider_payload.publish_options.privacy_statusoneOf 5 | stringWajib dalam induk |
|
provider_payload.publish_options.cancellation_modeoneOf 5 | stringWajib dalam induk |
|
provider_payload.publish_options.licenseoneOf 5 | stringOpsional / item |
|
provider_payload.publish_options.embeddableoneOf 5 | booleanOpsional / item | — |
provider_payload.publish_options.public_stats_viewableoneOf 5 | booleanOpsional / item | — |
provider_payload.publish_options.self_declared_made_for_kidsoneOf 5 | booleanOpsional / item | — |
provider_payload.publish_options.contains_synthetic_mediaoneOf 5 | booleanOpsional / item | — |
provider_payload.publish_options.has_paid_product_placementoneOf 5 | booleanOpsional / item | — |
provider_payload.publish_options.recording_dateoneOf 5 | stringOpsional / item |
|
provider_payload.publish_options.notify_subscribersoneOf 5 | booleanOpsional / item | — |
provider_payload.publish_options.thumbnail_asset_idoneOf 5 | integerOpsional / item |
|
provider_payload.publish_options.surface_expectationoneOf 5 | stringOpsional / item |
|
provider_payload.publish_options.brand_partneroneOf 5 | objectOpsional / item |
|
provider_payload.publish_options.brand_partner.channel_idoneOf 5 | stringOpsional / item |
|
provider_payload.publish_options.brand_partner.channel_handleoneOf 5 | stringOpsional / item |
|
scheduled_at | stringWajib dalam induk |
|
display_timezone | stringOpsional / item |
|
local_scheduled_at | stringOpsional / item |
|
schedule_dst_disambiguation | stringOpsional / item |
|
expires_at | string | nullOpsional / item | — |
expires_atanyOf 1 | stringOpsional / item |
|
expires_atanyOf 2 | nullOpsional / item | — |
source_ref | object | nullOpsional / item | — |
source_refanyOf 1 | objectOpsional / item |
|
source_ref.*anyOf 1 | any JSON valueOpsional / item | — |
source_refanyOf 2 | nullOpsional / item | — |
automatic_retry_enabled | booleanOpsional / item |
|
idempotency_key | stringWajib dalam induk |
|
source_url | stringWajib dalam induk |
|
wait_seconds | integerOpsional / item |
|
JSON Schema lengkap
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"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)$"
},
"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"
}
]
},
"social_account_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)$"
},
"caption": {
"default": null,
"anyOf": [
{
"type": "string",
"maxLength": 5000
},
{
"type": "null"
}
]
},
"hashtags": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"maxLength": 100
}
},
"media": {
"default": [],
"maxItems": 0,
"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"
}
]
}
},
"required": [
"kind",
"url"
],
"additionalProperties": false
}
},
"link_url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"provider_payload": {
"oneOf": [
{
"type": "object",
"properties": {
"platform": {
"type": "string",
"const": "x"
},
"publish_options": {
"type": "object",
"properties": {
"post_type": {
"type": "string",
"const": "TEXT"
}
},
"required": [
"post_type"
],
"additionalProperties": false
}
},
"required": [
"platform",
"publish_options"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"platform": {
"type": "string",
"const": "instagram"
},
"publish_options": {
"type": "object",
"properties": {
"post_type": {
"type": "string",
"enum": [
"IMAGE",
"VIDEO",
"CAROUSEL",
"REELS",
"STORY_IMAGE",
"STORY_VIDEO"
]
},
"location_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"share_to_feed": {
"type": "boolean"
},
"collaborators": {
"maxItems": 3,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 30
}
},
"first_comment": {
"type": "string",
"minLength": 1,
"maxLength": 2200
},
"cover_asset_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"thumb_offset_ms": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"audio_name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"trial_params": {
"type": "object",
"properties": {
"graduation_strategy": {
"type": "string",
"enum": [
"MANUAL",
"SS_PERFORMANCE"
]
}
},
"required": [
"graduation_strategy"
],
"additionalProperties": false
},
"is_ai_generated": {
"type": "boolean"
},
"branded_content_sponsor_ids": {
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"is_paid_partnership": {
"type": "boolean"
},
"media_options": {
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"asset_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"alt_text": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"user_tags": {
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"username": {
"type": "string",
"minLength": 1,
"maxLength": 30
},
"x": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"y": {
"type": "number",
"minimum": 0,
"maximum": 1
}
},
"required": [
"username"
],
"additionalProperties": false
}
},
"product_tags": {
"maxItems": 5,
"type": "array",
"items": {
"type": "object",
"properties": {
"product_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"x": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"y": {
"type": "number",
"minimum": 0,
"maximum": 1
}
},
"required": [
"product_id"
],
"additionalProperties": false
}
},
"thumb_offset_ms": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"asset_id"
],
"additionalProperties": false
}
}
},
"required": [
"post_type"
],
"additionalProperties": false
}
},
"required": [
"platform",
"publish_options"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"platform": {
"type": "string",
"const": "facebook"
},
"publish_options": {
"type": "object",
"properties": {
"post_type": {
"type": "string",
"enum": [
"TEXT",
"LINK",
"IMAGE",
"MULTI_IMAGE",
"VIDEO",
"REELS",
"STORY_IMAGE",
"STORY_VIDEO"
]
},
"title": {
"type": "string",
"maxLength": 255
},
"description": {
"type": "string",
"maxLength": 5000
},
"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",
"minLength": 1,
"maxLength": 256
},
"tags": {
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"feed_targeting": {
"type": "object",
"properties": {
"age_min": {
"type": "integer",
"minimum": 13,
"maximum": 65
},
"age_max": {
"type": "integer",
"minimum": 13,
"maximum": 65
},
"college_years": {
"maxItems": 100,
"type": "array",
"items": {
"type": "integer",
"minimum": 1900,
"maximum": 2200
}
},
"education_statuses": {
"maxItems": 3,
"type": "array",
"items": {
"anyOf": [
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 2
},
{
"type": "number",
"const": 3
}
]
}
},
"genders": {
"maxItems": 2,
"type": "array",
"items": {
"anyOf": [
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 2
}
]
}
},
"geo_locations": {
"type": "object",
"properties": {
"countries": {
"minItems": 1,
"maxItems": 25,
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Z]{2}$"
}
},
"regions": {
"minItems": 1,
"maxItems": 250,
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
]
}
},
"required": [
"key"
],
"additionalProperties": false
}
},
"cities": {
"minItems": 1,
"maxItems": 250,
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
]
},
"radius": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000
},
"distance_unit": {
"type": "string",
"enum": [
"mile",
"kilometer"
]
}
},
"required": [
"key"
],
"additionalProperties": false
}
},
"zips": {
"minItems": 1,
"maxItems": 250,
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
]
}
},
"required": [
"key"
],
"additionalProperties": false
}
},
"location_types": {
"minItems": 1,
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"enum": [
"home",
"recent"
]
}
}
},
"additionalProperties": false
},
"interests": {
"maxItems": 250,
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
]
}
},
"locales": {
"maxItems": 250,
"type": "array",
"items": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"relationship_statuses": {
"maxItems": 4,
"type": "array",
"items": {
"anyOf": [
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 2
},
{
"type": "number",
"const": 3
},
{
"type": "number",
"const": 4
}
]
}
}
},
"additionalProperties": false
},
"targeting": {
"type": "object",
"properties": {
"age_min": {
"anyOf": [
{
"type": "number",
"const": 13
},
{
"type": "number",
"const": 15
},
{
"type": "number",
"const": 18
},
{
"type": "number",
"const": 21
},
{
"type": "number",
"const": 25
}
]
},
"geo_locations": {
"type": "object",
"properties": {
"countries": {
"minItems": 1,
"maxItems": 25,
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Z]{2}$"
}
},
"regions": {
"minItems": 1,
"maxItems": 250,
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
]
}
},
"required": [
"key"
],
"additionalProperties": false
}
},
"cities": {
"minItems": 1,
"maxItems": 250,
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
]
},
"radius": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000
},
"distance_unit": {
"type": "string",
"enum": [
"mile",
"kilometer"
]
}
},
"required": [
"key"
],
"additionalProperties": false
}
},
"zips": {
"minItems": 1,
"maxItems": 250,
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
]
}
},
"required": [
"key"
],
"additionalProperties": false
}
},
"location_types": {
"minItems": 1,
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"enum": [
"home",
"recent"
]
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"child_attachments": {
"minItems": 2,
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"link": {
"type": "string",
"format": "uri"
},
"name": {
"type": "string",
"maxLength": 255
},
"description": {
"type": "string",
"maxLength": 1000
},
"picture": {
"type": "string",
"format": "uri"
}
},
"required": [
"link",
"picture"
],
"additionalProperties": false
}
},
"multi_share_end_card": {
"type": "boolean"
},
"multi_share_optimized": {
"type": "boolean"
},
"unpublished_content_type": {
"type": "string",
"enum": [
"SCHEDULED",
"SCHEDULED_RECURRING",
"DRAFT",
"PUBLISH_PENDING",
"ADS_POST",
"INLINE_CREATED",
"PUBLISHED",
"REVIEWABLE_BRANDED_CONTENT"
]
},
"no_story": {
"type": "boolean"
},
"crossposted_video_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"spherical": {
"type": "boolean"
},
"media_options": {
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"asset_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"alt_text_custom": {
"type": "string",
"minLength": 1,
"maxLength": 1000
}
},
"required": [
"asset_id"
],
"additionalProperties": false
}
}
},
"required": [
"post_type"
],
"additionalProperties": false
}
},
"required": [
"platform",
"publish_options"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"platform": {
"type": "string",
"const": "threads"
},
"publish_options": {
"type": "object",
"properties": {
"post_type": {
"type": "string",
"enum": [
"TEXT",
"IMAGE",
"VIDEO",
"CAROUSEL",
"REPOST"
]
},
"reply_to_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"quote_post_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"repost_target_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"reply_control": {
"type": "string",
"enum": [
"everyone",
"accounts_you_follow",
"mentioned_only",
"parent_post_author_only",
"followers_only"
]
},
"enable_reply_approvals": {
"type": "boolean"
},
"link_attachment": {
"type": "string",
"format": "uri"
},
"poll_attachment": {
"type": "object",
"properties": {
"option_a": {
"type": "string",
"minLength": 1,
"maxLength": 25
},
"option_b": {
"type": "string",
"minLength": 1,
"maxLength": 25
},
"option_c": {
"type": "string",
"minLength": 1,
"maxLength": 25
},
"option_d": {
"type": "string",
"minLength": 1,
"maxLength": 25
}
},
"required": [
"option_a",
"option_b"
],
"additionalProperties": false
},
"gif_attachment": {
"type": "object",
"properties": {
"gif_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"provider": {
"type": "string",
"const": "GIPHY"
}
},
"required": [
"gif_id",
"provider"
],
"additionalProperties": false
},
"text_attachment": {
"type": "object",
"properties": {
"plaintext": {
"type": "string",
"minLength": 1,
"maxLength": 10000
},
"link_attachment_url": {
"type": "string",
"format": "uri"
},
"text_with_styling_info": {
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"length": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"styling_info": {
"minItems": 1,
"type": "array",
"items": {
"type": "string",
"enum": [
"bold",
"italic",
"highlight",
"underline",
"strikethrough"
]
}
}
},
"required": [
"offset",
"length",
"styling_info"
],
"additionalProperties": false
}
}
},
"required": [
"plaintext"
],
"additionalProperties": false
},
"topic_tag": {
"type": "string",
"minLength": 1,
"maxLength": 50
},
"text_entities": {
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"entity_type": {
"type": "string",
"enum": [
"SPOILER",
"spoiler"
]
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"length": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"entity_type",
"offset",
"length"
],
"additionalProperties": false
}
},
"is_spoiler_media": {
"type": "boolean"
},
"is_ghost_post": {
"type": "boolean"
},
"location_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"allowlisted_country_codes": {
"minItems": 1,
"maxItems": 249,
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Z]{2}$"
}
},
"crossreshare_to_ig": {
"type": "boolean"
},
"crossreshare_to_ig_dark_mode": {
"type": "boolean"
},
"auto_publish_text": {
"type": "boolean"
},
"media_options": {
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"asset_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"alt_text": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"is_spoiler_media": {
"type": "boolean"
}
},
"required": [
"asset_id"
],
"additionalProperties": false
}
}
},
"required": [
"post_type"
],
"additionalProperties": false
}
},
"required": [
"platform",
"publish_options"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"platform": {
"type": "string",
"const": "youtube"
},
"publish_options": {
"type": "object",
"properties": {
"post_type": {
"type": "string",
"const": "VIDEO"
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"description": {
"type": "string",
"maxLength": 5000
},
"tags": {
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"category_id": {
"anyOf": [
{
"type": "string",
"minLength": 0,
"maxLength": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
},
"default_language": {
"type": "string",
"minLength": 2,
"maxLength": 35
},
"localizations": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"description": {
"type": "string",
"maxLength": 5000
}
},
"required": [
"title",
"description"
],
"additionalProperties": false
}
},
"privacy_status": {
"type": "string",
"enum": [
"private",
"unlisted",
"public"
]
},
"cancellation_mode": {
"type": "string",
"enum": [
"DELETE",
"UNSCHEDULE_KEEP_PRIVATE"
]
},
"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",
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"notify_subscribers": {
"type": "boolean"
},
"thumbnail_asset_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"surface_expectation": {
"type": "string",
"const": "SHORT"
},
"brand_partner": {
"type": "object",
"properties": {
"channel_id": {
"type": "string",
"pattern": "^UC[A-Za-z0-9_-]+$"
},
"channel_handle": {
"type": "string",
"pattern": "^@[A-Za-z0-9._-]+$"
}
},
"additionalProperties": false
}
},
"required": [
"post_type",
"title",
"privacy_status",
"cancellation_mode"
],
"additionalProperties": false
}
},
"required": [
"platform",
"publish_options"
],
"additionalProperties": false
}
]
},
"scheduled_at": {
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"display_timezone": {
"default": "UTC",
"type": "string",
"minLength": 1,
"maxLength": 80
},
"local_scheduled_at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
},
"schedule_dst_disambiguation": {
"type": "string",
"enum": [
"exact",
"earlier",
"later"
]
},
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
{
"type": "null"
}
]
},
"source_ref": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"automatic_retry_enabled": {
"default": true,
"type": "boolean"
},
"idempotency_key": {
"type": "string",
"minLength": 8,
"maxLength": 160
},
"source_url": {
"type": "string",
"maxLength": 2048,
"format": "uri"
},
"wait_seconds": {
"default": 35,
"type": "integer",
"minimum": 0,
"maximum": 35
}
},
"required": [
"workspace_id",
"social_account_id",
"provider_payload",
"scheduled_at",
"idempotency_key",
"source_url"
],
"additionalProperties": false
}Respons dan penyelesaian
Status HTTP berhasil: 200, 201. 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.
| Kolom / cabang | Jenis / wajib | Batasan |
|---|---|---|
$ | objectWajib dalam induk | — |
post | objectWajib dalam induk | — |
post.id | stringWajib dalam induk |
|
post.workspace_id | stringWajib dalam induk |
|
post.social_account_id | string | nullWajib dalam induk | — |
post.social_account_idanyOf 1 | stringWajib dalam induk |
|
post.social_account_idanyOf 2 | nullWajib dalam induk | — |
post.platform | stringWajib dalam induk |
|
post.destination | objectWajib dalam induk | — |
post.destination.social_account_id | string | nullWajib dalam induk | — |
post.destination.social_account_idanyOf 1 | stringWajib dalam induk |
|
post.destination.social_account_idanyOf 2 | nullWajib dalam induk | — |
post.destination.platform | stringWajib dalam induk |
|
post.destination.platform_user_id | string | nullWajib dalam induk | — |
post.destination.platform_user_idanyOf 1 | stringWajib dalam induk | — |
post.destination.platform_user_idanyOf 2 | nullWajib dalam induk | — |
post.destination.account_label | string | nullWajib dalam induk | — |
post.destination.account_labelanyOf 1 | stringWajib dalam induk | — |
post.destination.account_labelanyOf 2 | nullWajib dalam induk | — |
post.caption | string | nullWajib dalam induk | — |
post.captionanyOf 1 | stringWajib dalam induk | — |
post.captionanyOf 2 | nullWajib dalam induk | — |
post.hashtags | arrayWajib dalam induk | — |
post.hashtags[] | stringOpsional / item | — |
post.media | arrayWajib dalam induk | — |
post.media[] | objectOpsional / item | — |
post.media[].kind | stringWajib dalam induk |
|
post.media[].url | stringWajib dalam induk |
|
post.media[].cover_url | string | nullOpsional / item | — |
post.media[].cover_urlanyOf 1 | stringOpsional / item |
|
post.media[].cover_urlanyOf 2 | nullOpsional / item | — |
post.media[].cover_asset_id | integer | nullOpsional / item | — |
post.media[].cover_asset_idanyOf 1 | integerOpsional / item |
|
post.media[].cover_asset_idanyOf 2 | nullOpsional / item | — |
post.media[].asset_id | integer | nullOpsional / item | — |
post.media[].asset_idanyOf 1 | integerOpsional / item |
|
post.media[].asset_idanyOf 2 | nullOpsional / item | — |
post.media[].mime_type | string | nullOpsional / item | — |
post.media[].mime_typeanyOf 1 | stringOpsional / item |
|
post.media[].mime_typeanyOf 2 | nullOpsional / item | — |
post.media[].preview_url | string | nullOpsional / item | URL baca sementara yang diizinkan; pertahankan url sebagai identitas media Scheduled Post persisten. — |
post.media[].preview_urlanyOf 1 | stringOpsional / item |
|
post.media[].preview_urlanyOf 2 | nullOpsional / item | — |
post.media[].cover_preview_url | string | nullOpsional / item | URL baca sampul sementara yang diizinkan; pertahankan cover_url sebagai identitas media persisten. — |
post.media[].cover_preview_urlanyOf 1 | stringOpsional / item |
|
post.media[].cover_preview_urlanyOf 2 | nullOpsional / item | — |
post.media[].preview_expires_at | string | nullOpsional / item | — |
post.media[].preview_expires_atanyOf 1 | stringOpsional / item |
|
post.media[].preview_expires_atanyOf 2 | nullOpsional / item | — |
post.link_url | string | nullOpsional / item | — |
post.link_urlanyOf 1 | stringOpsional / item |
|
post.link_urlanyOf 2 | nullOpsional / item | — |
post.publish_options | objectWajib dalam induk | — |
post.publish_options.post_type | stringOpsional / item |
|
post.publish_options.location_id | stringOpsional / item |
|
post.publish_options.share_to_feed | booleanOpsional / item | — |
post.publish_options.collaborators | arrayOpsional / item |
|
post.publish_options.collaborators[] | stringOpsional / item |
|
post.publish_options.first_comment | stringOpsional / item |
|
post.publish_options.topic_tag | stringOpsional / item |
|
post.publish_options.thumb_offset_ms | integerOpsional / item |
|
post.publish_options.title | stringOpsional / item |
|
post.publish_options.youtube_privacy_status | stringOpsional / item |
|
post.publish_options.youtube_category_id | stringOpsional / item |
|
post.publish_options.youtube_contains_synthetic_media | booleanOpsional / item | — |
post.publish_options.description | stringOpsional / item |
|
post.publish_options.category_id | stringOpsional / item |
|
post.publish_options.privacy_status | stringOpsional / item |
|
post.publish_options.cancellation_mode | stringOpsional / item |
|
post.publish_options.tags | arrayOpsional / item | — |
post.publish_options.tags[] | stringOpsional / item | — |
post.publish_options.default_language | stringOpsional / item | — |
post.publish_options.localizations | objectOpsional / item |
|
post.publish_options.localizations.* | any JSON valueOpsional / item | — |
post.publish_options.license | stringOpsional / item |
|
post.publish_options.embeddable | booleanOpsional / item | — |
post.publish_options.public_stats_viewable | booleanOpsional / item | — |
post.publish_options.self_declared_made_for_kids | booleanOpsional / item | — |
post.publish_options.contains_synthetic_media | booleanOpsional / item | — |
post.publish_options.has_paid_product_placement | booleanOpsional / item | — |
post.publish_options.recording_date | stringOpsional / item | — |
post.publish_options.notify_subscribers | booleanOpsional / item | — |
post.publish_options.thumbnail_asset_id | integerOpsional / item |
|
post.publish_options.surface_expectation | stringOpsional / item |
|
post.publish_options.brand_partner | objectOpsional / item |
|
post.publish_options.brand_partner.* | any JSON valueOpsional / item | — |
post.publish_options.cover_asset_id | integerOpsional / item |
|
post.publish_options.audio_name | stringOpsional / item | — |
post.publish_options.trial_params | objectOpsional / item |
|
post.publish_options.trial_params.* | any JSON valueOpsional / item | — |
post.publish_options.is_ai_generated | booleanOpsional / item | — |
post.publish_options.branded_content_sponsor_ids | arrayOpsional / item | — |
post.publish_options.branded_content_sponsor_ids[] | stringOpsional / item | — |
post.publish_options.is_paid_partnership | booleanOpsional / item | — |
post.publish_options.media_options | arrayOpsional / item | — |
post.publish_options.media_options[] | objectOpsional / item |
|
post.publish_options.media_options[].* | any JSON valueOpsional / item | — |
post.publish_options.reply_to_id | stringOpsional / item | — |
post.publish_options.quote_post_id | stringOpsional / item | — |
post.publish_options.repost_target_id | stringOpsional / item | — |
post.publish_options.reply_control | stringOpsional / item | — |
post.publish_options.enable_reply_approvals | booleanOpsional / item | — |
post.publish_options.link_attachment | stringOpsional / item |
|
post.publish_options.poll_attachment | objectOpsional / item |
|
post.publish_options.poll_attachment.* | any JSON valueOpsional / item | — |
post.publish_options.gif_attachment | objectOpsional / item |
|
post.publish_options.gif_attachment.* | any JSON valueOpsional / item | — |
post.publish_options.text_attachment | objectOpsional / item |
|
post.publish_options.text_attachment.* | any JSON valueOpsional / item | — |
post.publish_options.text_entities | arrayOpsional / item | — |
post.publish_options.text_entities[] | objectOpsional / item |
|
post.publish_options.text_entities[].* | any JSON valueOpsional / item | — |
post.publish_options.is_spoiler_media | booleanOpsional / item | — |
post.publish_options.is_ghost_post | booleanOpsional / item | — |
post.publish_options.allowlisted_country_codes | arrayOpsional / item | — |
post.publish_options.allowlisted_country_codes[] | stringOpsional / item | — |
post.publish_options.crossreshare_to_ig | booleanOpsional / item | — |
post.publish_options.crossreshare_to_ig_dark_mode | booleanOpsional / item | — |
post.publish_options.auto_publish_text | booleanOpsional / item | — |
post.publish_options.publication_mode | stringOpsional / item |
|
post.publish_options.backdated_time | numberOpsional / item | — |
post.publish_options.backdated_time_granularity | stringOpsional / item |
|
post.publish_options.place | stringOpsional / item | — |
post.publish_options.feed_targeting | objectOpsional / item |
|
post.publish_options.feed_targeting.* | any JSON valueOpsional / item | — |
post.publish_options.targeting | objectOpsional / item |
|
post.publish_options.targeting.* | any JSON valueOpsional / item | — |
post.publish_options.child_attachments | arrayOpsional / item | — |
post.publish_options.child_attachments[] | objectOpsional / item |
|
post.publish_options.child_attachments[].* | any JSON valueOpsional / item | — |
post.publish_options.multi_share_end_card | booleanOpsional / item | — |
post.publish_options.multi_share_optimized | booleanOpsional / item | — |
post.publish_options.unpublished_content_type | stringOpsional / item | — |
post.publish_options.no_story | booleanOpsional / item | — |
post.publish_options.crossposted_video_id | stringOpsional / item | — |
post.publish_options.spherical | booleanOpsional / item | — |
post.scheduled_at | stringWajib dalam induk | — |
post.display_timezone | stringWajib dalam induk |
|
post.local_scheduled_at | string | nullOpsional / item | — |
post.local_scheduled_atanyOf 1 | stringOpsional / item |
|
post.local_scheduled_atanyOf 2 | nullOpsional / item | — |
post.schedule_timezone | string | nullOpsional / item | — |
post.schedule_timezoneanyOf 1 | stringOpsional / item |
|
post.schedule_timezoneanyOf 2 | nullOpsional / item | — |
post.schedule_dst_disambiguation | string | nullOpsional / item | — |
post.schedule_dst_disambiguationanyOf 1 | stringOpsional / item |
|
post.schedule_dst_disambiguationanyOf 2 | nullOpsional / item | — |
post.schedule_intent_state | stringOpsional / item |
|
post.expires_at | string | nullWajib dalam induk | — |
post.expires_atanyOf 1 | stringWajib dalam induk | — |
post.expires_atanyOf 2 | nullWajib dalam induk | — |
post.status | stringWajib dalam induk |
|
post.version | integerWajib dalam induk |
|
post.automatic_retry_enabled | booleanWajib dalam induk | — |
post.delete_requested_at | string | nullWajib dalam induk | — |
post.delete_requested_atanyOf 1 | stringWajib dalam induk | — |
post.delete_requested_atanyOf 2 | nullWajib dalam induk | — |
post.published_at | string | nullWajib dalam induk | — |
post.published_atanyOf 1 | stringWajib dalam induk | — |
post.published_atanyOf 2 | nullWajib dalam induk | — |
post.deleted_at | string | nullWajib dalam induk | — |
post.deleted_atanyOf 1 | stringWajib dalam induk | — |
post.deleted_atanyOf 2 | nullWajib dalam induk | — |
post.provider_post_id | string | nullWajib dalam induk | — |
post.provider_post_idanyOf 1 | stringWajib dalam induk | — |
post.provider_post_idanyOf 2 | nullWajib dalam induk | — |
post.permalink | string | nullWajib dalam induk | — |
post.permalinkanyOf 1 | stringWajib dalam induk |
|
post.permalinkanyOf 2 | nullWajib dalam induk | — |
post.created_at | stringWajib dalam induk | — |
post.updated_at | stringWajib dalam induk | — |
post.project_id | string | nullWajib dalam induk | — |
post.project_idanyOf 1 | stringWajib dalam induk |
|
post.project_idanyOf 2 | nullWajib dalam induk | — |
post.batch_id | string | nullWajib dalam induk | — |
post.batch_idanyOf 1 | stringWajib dalam induk |
|
post.batch_idanyOf 2 | nullWajib dalam induk | — |
post.source_ref | object | nullWajib dalam induk | — |
post.source_refanyOf 1 | objectWajib dalam induk |
|
post.source_ref.*anyOf 1 | any JSON valueOpsional / item | — |
post.source_refanyOf 2 | nullWajib dalam induk | — |
deduped | booleanWajib dalam induk | — |
import_id | stringWajib dalam induk |
|
media_preparation | stringWajib dalam induk |
|
completion | stringWajib 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"
]
},
"deduped": {
"type": "boolean"
},
"import_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)$"
},
"media_preparation": {
"type": "string",
"enum": [
"pending",
"ready",
"failed"
]
},
"completion": {
"type": "string",
"enum": [
"pending",
"terminal"
]
}
},
"required": [
"post",
"deduped",
"import_id",
"media_preparation",
"completion"
]
}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 masalahContoh
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
{
"workspace_id": "11111111-1111-4111-8111-111111111111",
"social_account_id": "11111111-1111-4111-8111-111111111111",
"provider_payload": {
"platform": "threads",
"publish_options": {
"post_type": "IMAGE"
}
},
"scheduled_at": "2099-01-15T09:00:00Z",
"idempotency_key": "example-intent-0001",
"source_url": "https://example.com/media.png"
}cURL
curl --request POST \
"https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/scheduled-posts/create-image-url" \
-H "Authorization: Bearer $SOSOAPI_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
--data-binary @request.jsonJavaScript
// 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/create-image-url", {
method: "POST",
headers: { "Content-Type": "application/json", Authorization: "Bearer " + token },
body: JSON.stringify({
"workspace_id": "11111111-1111-4111-8111-111111111111",
"social_account_id": "11111111-1111-4111-8111-111111111111",
"provider_payload": {
"platform": "threads",
"publish_options": {
"post_type": "IMAGE"
}
},
"scheduled_at": "2099-01-15T09:00:00Z",
"idempotency_key": "example-intent-0001",
"source_url": "https://example.com/media.png"
})
});
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/create-image-url < request.jsonContoh 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
},
"deduped": false,
"import_id": "11111111-1111-4111-8111-111111111111",
"media_preparation": "pending",
"completion": "pending"
}