La recherche se charge uniquement lorsque vous l’utilisez. Parcourez toutes les catégories ci-dessous.

Outil MCP

Mettre à jour une publication programmée

sosoapi_update_scheduled_post

Modifier une publication programmée qui n’a pas encore été envoyée (légende, hashtags, médias, lien, heure). Nécessite expected_version issu de la dernière lecture ; une version périmée est rejetée.

Lire en Markdown

Profils et transports

Profils : core, full · Transports : stdio, http

Choisissez core ou full pour définir les outils visibles du client ; cela ne change pas ses autorisations. Le téléversement local nécessite stdio et n’est pas disponible sur HTTP. Définissez SOSOAPI_OUTPUT_SCHEMAS=1 pour inclure les schémas de sortie à la découverte. Les outils renvoient des résultats structurés avec ou sans ce réglage.

Autorisations et effets de bord

Les annotations aident les clients à décrire un outil. Chaque appel vérifie toujours l’authentification, le rôle, l’accès aux ressources et les capacités accordées de l’utilisateur.

{
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}

Champs d’entrée

Requis signifie requis dans l’objet parent et la branche sélectionnée. Un enfant requis ne rend pas obligatoire un parent facultatif. Les règles et noms de champs ci-dessous proviennent du contrat.

Champs d’entrée
Champ / brancheType / requisContraintes
$objectRequis dans le parent
  • additionalProperties: false
idstringRequis dans le parent
  • 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_versionintegerRequis dans le parent
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
patchobjectRequis dans le parent
  • additionalProperties: false
patch.captionstring | nullFacultatif / élément—
patch.captionanyOf 1stringFacultatif / élément
  • maxLength: 5000
patch.captionanyOf 2nullFacultatif / élément—
patch.hashtagsarrayFacultatif / élément
  • maxItems: 100
patch.hashtags[]stringFacultatif / élément
  • maxLength: 100
patch.mediaarrayFacultatif / élément
  • maxItems: 20
patch.media[]objectFacultatif / élément
  • additionalProperties: false
patch.media[].kindstringRequis dans le parent
  • enum: ["image","video"]
patch.media[].urlstringRequis dans le parent
  • format: "uri"
patch.media[].cover_urlstring | nullFacultatif / élément—
patch.media[].cover_urlanyOf 1stringFacultatif / élément
  • format: "uri"
patch.media[].cover_urlanyOf 2nullFacultatif / élément—
patch.media[].cover_asset_idinteger | nullFacultatif / élément—
patch.media[].cover_asset_idanyOf 1integerFacultatif / élément
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
patch.media[].cover_asset_idanyOf 2nullFacultatif / élément—
patch.media[].asset_idinteger | nullFacultatif / élément—
patch.media[].asset_idanyOf 1integerFacultatif / élément
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
patch.media[].asset_idanyOf 2nullFacultatif / élément—
patch.media[].mime_typestring | nullFacultatif / élément—
patch.media[].mime_typeanyOf 1stringFacultatif / élément
  • minLength: 1
  • maxLength: 160
patch.media[].mime_typeanyOf 2nullFacultatif / élément—
patch.link_urlstring | nullFacultatif / élément—
patch.link_urlanyOf 1stringFacultatif / élément
  • format: "uri"
patch.link_urlanyOf 2nullFacultatif / élément—
patch.scheduled_atstringFacultatif / élément
  • 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)))$"
patch.display_timezonestringFacultatif / élément
  • minLength: 1
  • maxLength: 80
patch.local_scheduled_atstringFacultatif / élément
  • pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
patch.schedule_dst_disambiguationstringFacultatif / élément
  • enum: ["exact","earlier","later"]
patch.expires_atstring | nullFacultatif / élément—
patch.expires_atanyOf 1stringFacultatif / élément
  • 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)))$"
patch.expires_atanyOf 2nullFacultatif / élément—
patch.source_refobject | nullFacultatif / élément—
patch.source_refanyOf 1objectFacultatif / élément
  • additionalProperties: {}
patch.source_ref.*anyOf 1any JSON valueFacultatif / élément—
patch.source_refanyOf 2nullFacultatif / élément—
provider_payloadobjectFacultatif / élément—
provider_payloadanyOf 1objectFacultatif / élément
  • additionalProperties: false
provider_payload.platformanyOf 1stringRequis dans le parent
  • enum: ["x"]
provider_payload.publish_optionsanyOf 1objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.post_typeanyOf 1stringRequis dans le parent
  • enum: ["TEXT"]
provider_payloadanyOf 2objectFacultatif / élément
  • additionalProperties: false
provider_payload.platformanyOf 2stringRequis dans le parent
  • enum: ["instagram"]
provider_payload.publish_optionsanyOf 2objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.post_typeanyOf 2stringRequis dans le parent
  • enum: ["IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO"]
provider_payload.publish_options.location_idanyOf 2stringFacultatif / élément
  • minLength: 1
  • maxLength: 256
provider_payload.publish_options.share_to_feedanyOf 2booleanFacultatif / élément—
provider_payload.publish_options.collaboratorsanyOf 2arrayFacultatif / élément
  • maxItems: 3
provider_payload.publish_options.collaborators[]anyOf 2stringFacultatif / élément
  • minLength: 1
  • maxLength: 30
provider_payload.publish_options.first_commentanyOf 2stringFacultatif / élément
  • minLength: 1
  • maxLength: 2200
provider_payload.publish_options.cover_asset_idanyOf 2integerFacultatif / élément
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
provider_payload.publish_options.thumb_offset_msanyOf 2integerFacultatif / élément
  • minimum: 0
  • maximum: 9007199254740991
provider_payload.publish_options.audio_nameanyOf 2stringFacultatif / élément
  • minLength: 1
  • maxLength: 100
provider_payload.publish_options.trial_paramsanyOf 2objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.trial_params.graduation_strategyanyOf 2stringRequis dans le parent
  • enum: ["MANUAL","SS_PERFORMANCE"]
provider_payload.publish_options.is_ai_generatedanyOf 2booleanFacultatif / élément—
provider_payload.publish_options.branded_content_sponsor_idsanyOf 2arrayFacultatif / élément
  • maxItems: 2
provider_payload.publish_options.branded_content_sponsor_ids[]anyOf 2stringFacultatif / élément
  • minLength: 1
  • maxLength: 256
provider_payload.publish_options.is_paid_partnershipanyOf 2booleanFacultatif / élément—
provider_payload.publish_options.media_optionsanyOf 2arrayFacultatif / élément
  • maxItems: 10
provider_payload.publish_options.media_options[]anyOf 2objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.media_options[].asset_idanyOf 2integerRequis dans le parent
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
provider_payload.publish_options.media_options[].alt_textanyOf 2stringFacultatif / élément
  • minLength: 1
  • maxLength: 1000
provider_payload.publish_options.media_options[].user_tagsanyOf 2arrayFacultatif / élément
  • maxItems: 20
provider_payload.publish_options.media_options[].user_tags[]anyOf 2objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.media_options[].user_tags[].usernameanyOf 2stringRequis dans le parent
  • minLength: 1
  • maxLength: 30
provider_payload.publish_options.media_options[].user_tags[].xanyOf 2numberFacultatif / élément
  • minimum: 0
  • maximum: 1
provider_payload.publish_options.media_options[].user_tags[].yanyOf 2numberFacultatif / élément
  • minimum: 0
  • maximum: 1
provider_payload.publish_options.media_options[].product_tagsanyOf 2arrayFacultatif / élément
  • maxItems: 5
provider_payload.publish_options.media_options[].product_tags[]anyOf 2objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.media_options[].product_tags[].product_idanyOf 2stringRequis dans le parent
  • minLength: 1
  • maxLength: 256
provider_payload.publish_options.media_options[].product_tags[].xanyOf 2numberFacultatif / élément
  • minimum: 0
  • maximum: 1
provider_payload.publish_options.media_options[].product_tags[].yanyOf 2numberFacultatif / élément
  • minimum: 0
  • maximum: 1
provider_payload.publish_options.media_options[].thumb_offset_msanyOf 2integerFacultatif / élément
  • minimum: 0
  • maximum: 9007199254740991
provider_payloadanyOf 3objectFacultatif / élément
  • additionalProperties: false
provider_payload.platformanyOf 3stringRequis dans le parent
  • enum: ["facebook"]
provider_payload.publish_optionsanyOf 3objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.post_typeanyOf 3stringRequis dans le parent
  • enum: ["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","REELS","STORY_IMAGE","STORY_VIDEO"]
provider_payload.publish_options.titleanyOf 3stringFacultatif / élément
  • maxLength: 255
provider_payload.publish_options.descriptionanyOf 3stringFacultatif / élément
  • maxLength: 5000
provider_payload.publish_options.publication_modeanyOf 3stringFacultatif / élément
  • enum: ["PUBLISH","DRAFT"]
provider_payload.publish_options.backdated_timeanyOf 3numberFacultatif / élément—
provider_payload.publish_options.backdated_time_granularityanyOf 3stringFacultatif / élément
  • enum: ["year","month","day","hour","minute"]
provider_payload.publish_options.placeanyOf 3stringFacultatif / élément
  • minLength: 1
  • maxLength: 256
provider_payload.publish_options.tagsanyOf 3arrayFacultatif / élément
  • maxItems: 50
provider_payload.publish_options.tags[]anyOf 3stringFacultatif / élément
  • minLength: 1
  • maxLength: 256
provider_payload.publish_options.feed_targetinganyOf 3objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.feed_targeting.age_minanyOf 3integerFacultatif / élément
  • minimum: 13
  • maximum: 65
provider_payload.publish_options.feed_targeting.age_maxanyOf 3integerFacultatif / élément
  • minimum: 13
  • maximum: 65
provider_payload.publish_options.feed_targeting.college_yearsanyOf 3arrayFacultatif / élément
  • maxItems: 100
provider_payload.publish_options.feed_targeting.college_years[]anyOf 3integerFacultatif / élément
  • minimum: 1900
  • maximum: 2200
provider_payload.publish_options.feed_targeting.education_statusesanyOf 3arrayFacultatif / élément
  • maxItems: 3
provider_payload.publish_options.feed_targeting.education_statuses[]anyOf 3numberFacultatif / élément—
provider_payload.publish_options.feed_targeting.education_statuses[]anyOf 3 / anyOf 1numberFacultatif / élément
  • enum: [1]
provider_payload.publish_options.feed_targeting.education_statuses[]anyOf 3 / anyOf 2numberFacultatif / élément
  • enum: [2]
provider_payload.publish_options.feed_targeting.education_statuses[]anyOf 3 / anyOf 3numberFacultatif / élément
  • enum: [3]
provider_payload.publish_options.feed_targeting.gendersanyOf 3arrayFacultatif / élément
  • maxItems: 2
provider_payload.publish_options.feed_targeting.genders[]anyOf 3numberFacultatif / élément—
provider_payload.publish_options.feed_targeting.genders[]anyOf 3 / anyOf 1numberFacultatif / élément
  • enum: [1]
provider_payload.publish_options.feed_targeting.genders[]anyOf 3 / anyOf 2numberFacultatif / élément
  • enum: [2]
provider_payload.publish_options.feed_targeting.geo_locationsanyOf 3objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.feed_targeting.geo_locations.countriesanyOf 3arrayFacultatif / élément
  • minItems: 1
  • maxItems: 25
provider_payload.publish_options.feed_targeting.geo_locations.countries[]anyOf 3stringFacultatif / élément
  • pattern: "^[A-Z]{2}$"
provider_payload.publish_options.feed_targeting.geo_locations.regionsanyOf 3arrayFacultatif / élément
  • minItems: 1
  • maxItems: 250
provider_payload.publish_options.feed_targeting.geo_locations.regions[]anyOf 3objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyanyOf 3string | integerRequis dans le parent—
provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyanyOf 3 / anyOf 1stringRequis dans le parent
  • minLength: 1
  • maxLength: 256
provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyanyOf 3 / anyOf 2integerRequis dans le parent
  • minimum: 0
  • maximum: 9007199254740991
provider_payload.publish_options.feed_targeting.geo_locations.citiesanyOf 3arrayFacultatif / élément
  • minItems: 1
  • maxItems: 250
provider_payload.publish_options.feed_targeting.geo_locations.cities[]anyOf 3objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyanyOf 3string | integerRequis dans le parent—
provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyanyOf 3 / anyOf 1stringRequis dans le parent
  • minLength: 1
  • maxLength: 256
provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyanyOf 3 / anyOf 2integerRequis dans le parent
  • minimum: 0
  • maximum: 9007199254740991
provider_payload.publish_options.feed_targeting.geo_locations.cities[].radiusanyOf 3numberFacultatif / élément
  • maximum: 1000
  • exclusiveMinimum: 0
provider_payload.publish_options.feed_targeting.geo_locations.cities[].distance_unitanyOf 3stringFacultatif / élément
  • enum: ["mile","kilometer"]
provider_payload.publish_options.feed_targeting.geo_locations.zipsanyOf 3arrayFacultatif / élément
  • minItems: 1
  • maxItems: 250
provider_payload.publish_options.feed_targeting.geo_locations.zips[]anyOf 3objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyanyOf 3string | integerRequis dans le parent—
provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyanyOf 3 / anyOf 1stringRequis dans le parent
  • minLength: 1
  • maxLength: 256
provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyanyOf 3 / anyOf 2integerRequis dans le parent
  • minimum: 0
  • maximum: 9007199254740991
provider_payload.publish_options.feed_targeting.geo_locations.location_typesanyOf 3arrayFacultatif / élément
  • minItems: 1
  • maxItems: 2
provider_payload.publish_options.feed_targeting.geo_locations.location_types[]anyOf 3stringFacultatif / élément
  • enum: ["home","recent"]
provider_payload.publish_options.feed_targeting.interestsanyOf 3arrayFacultatif / élément
  • maxItems: 250
provider_payload.publish_options.feed_targeting.interests[]anyOf 3string | integerFacultatif / élément—
provider_payload.publish_options.feed_targeting.interests[]anyOf 3 / anyOf 1stringFacultatif / élément
  • minLength: 1
  • maxLength: 256
provider_payload.publish_options.feed_targeting.interests[]anyOf 3 / anyOf 2integerFacultatif / élément
  • minimum: 0
  • maximum: 9007199254740991
provider_payload.publish_options.feed_targeting.localesanyOf 3arrayFacultatif / élément
  • maxItems: 250
provider_payload.publish_options.feed_targeting.locales[]anyOf 3integerFacultatif / élément
  • minimum: 0
  • maximum: 9007199254740991
provider_payload.publish_options.feed_targeting.relationship_statusesanyOf 3arrayFacultatif / élément
  • maxItems: 4
provider_payload.publish_options.feed_targeting.relationship_statuses[]anyOf 3numberFacultatif / élément—
provider_payload.publish_options.feed_targeting.relationship_statuses[]anyOf 3 / anyOf 1numberFacultatif / élément
  • enum: [1]
provider_payload.publish_options.feed_targeting.relationship_statuses[]anyOf 3 / anyOf 2numberFacultatif / élément
  • enum: [2]
provider_payload.publish_options.feed_targeting.relationship_statuses[]anyOf 3 / anyOf 3numberFacultatif / élément
  • enum: [3]
provider_payload.publish_options.feed_targeting.relationship_statuses[]anyOf 3 / anyOf 4numberFacultatif / élément
  • enum: [4]
provider_payload.publish_options.targetinganyOf 3objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.targeting.age_minanyOf 3numberFacultatif / élément—
provider_payload.publish_options.targeting.age_minanyOf 3 / anyOf 1numberFacultatif / élément
  • enum: [13]
provider_payload.publish_options.targeting.age_minanyOf 3 / anyOf 2numberFacultatif / élément
  • enum: [15]
provider_payload.publish_options.targeting.age_minanyOf 3 / anyOf 3numberFacultatif / élément
  • enum: [18]
provider_payload.publish_options.targeting.age_minanyOf 3 / anyOf 4numberFacultatif / élément
  • enum: [21]
provider_payload.publish_options.targeting.age_minanyOf 3 / anyOf 5numberFacultatif / élément
  • enum: [25]
provider_payload.publish_options.targeting.geo_locationsanyOf 3objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.targeting.geo_locations.countriesanyOf 3arrayFacultatif / élément
  • minItems: 1
  • maxItems: 25
provider_payload.publish_options.targeting.geo_locations.countries[]anyOf 3stringFacultatif / élément
  • pattern: "^[A-Z]{2}$"
provider_payload.publish_options.targeting.geo_locations.regionsanyOf 3arrayFacultatif / élément
  • minItems: 1
  • maxItems: 250
provider_payload.publish_options.targeting.geo_locations.regions[]anyOf 3objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.targeting.geo_locations.regions[].keyanyOf 3string | integerRequis dans le parent—
provider_payload.publish_options.targeting.geo_locations.regions[].keyanyOf 3 / anyOf 1stringRequis dans le parent
  • minLength: 1
  • maxLength: 256
provider_payload.publish_options.targeting.geo_locations.regions[].keyanyOf 3 / anyOf 2integerRequis dans le parent
  • minimum: 0
  • maximum: 9007199254740991
provider_payload.publish_options.targeting.geo_locations.citiesanyOf 3arrayFacultatif / élément
  • minItems: 1
  • maxItems: 250
provider_payload.publish_options.targeting.geo_locations.cities[]anyOf 3objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.targeting.geo_locations.cities[].keyanyOf 3string | integerRequis dans le parent—
provider_payload.publish_options.targeting.geo_locations.cities[].keyanyOf 3 / anyOf 1stringRequis dans le parent
  • minLength: 1
  • maxLength: 256
provider_payload.publish_options.targeting.geo_locations.cities[].keyanyOf 3 / anyOf 2integerRequis dans le parent
  • minimum: 0
  • maximum: 9007199254740991
provider_payload.publish_options.targeting.geo_locations.cities[].radiusanyOf 3numberFacultatif / élément
  • maximum: 1000
  • exclusiveMinimum: 0
provider_payload.publish_options.targeting.geo_locations.cities[].distance_unitanyOf 3stringFacultatif / élément
  • enum: ["mile","kilometer"]
provider_payload.publish_options.targeting.geo_locations.zipsanyOf 3arrayFacultatif / élément
  • minItems: 1
  • maxItems: 250
provider_payload.publish_options.targeting.geo_locations.zips[]anyOf 3objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.targeting.geo_locations.zips[].keyanyOf 3string | integerRequis dans le parent—
provider_payload.publish_options.targeting.geo_locations.zips[].keyanyOf 3 / anyOf 1stringRequis dans le parent
  • minLength: 1
  • maxLength: 256
provider_payload.publish_options.targeting.geo_locations.zips[].keyanyOf 3 / anyOf 2integerRequis dans le parent
  • minimum: 0
  • maximum: 9007199254740991
provider_payload.publish_options.targeting.geo_locations.location_typesanyOf 3arrayFacultatif / élément
  • minItems: 1
  • maxItems: 2
provider_payload.publish_options.targeting.geo_locations.location_types[]anyOf 3stringFacultatif / élément
  • enum: ["home","recent"]
provider_payload.publish_options.child_attachmentsanyOf 3arrayFacultatif / élément
  • minItems: 2
  • maxItems: 10
provider_payload.publish_options.child_attachments[]anyOf 3objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.child_attachments[].linkanyOf 3stringRequis dans le parent
  • format: "uri"
provider_payload.publish_options.child_attachments[].nameanyOf 3stringFacultatif / élément
  • maxLength: 255
provider_payload.publish_options.child_attachments[].descriptionanyOf 3stringFacultatif / élément
  • maxLength: 1000
provider_payload.publish_options.child_attachments[].pictureanyOf 3stringRequis dans le parent
  • format: "uri"
provider_payload.publish_options.multi_share_end_cardanyOf 3booleanFacultatif / élément—
provider_payload.publish_options.multi_share_optimizedanyOf 3booleanFacultatif / élément—
provider_payload.publish_options.unpublished_content_typeanyOf 3stringFacultatif / élément
  • enum: ["SCHEDULED","SCHEDULED_RECURRING","DRAFT","PUBLISH_PENDING","ADS_POST","INLINE_CREATED","PUBLISHED","REVIEWABLE_BRANDED_CONTENT"]
provider_payload.publish_options.no_storyanyOf 3booleanFacultatif / élément—
provider_payload.publish_options.crossposted_video_idanyOf 3stringFacultatif / élément
  • minLength: 1
  • maxLength: 256
provider_payload.publish_options.sphericalanyOf 3booleanFacultatif / élément—
provider_payload.publish_options.media_optionsanyOf 3arrayFacultatif / élément
  • maxItems: 20
provider_payload.publish_options.media_options[]anyOf 3objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.media_options[].asset_idanyOf 3integerRequis dans le parent
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
provider_payload.publish_options.media_options[].alt_text_customanyOf 3stringFacultatif / élément
  • minLength: 1
  • maxLength: 1000
provider_payloadanyOf 4objectFacultatif / élément
  • additionalProperties: false
provider_payload.platformanyOf 4stringRequis dans le parent
  • enum: ["threads"]
provider_payload.publish_optionsanyOf 4objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.post_typeanyOf 4stringRequis dans le parent
  • enum: ["TEXT","IMAGE","VIDEO","CAROUSEL","REPOST"]
provider_payload.publish_options.reply_to_idanyOf 4stringFacultatif / élément
  • minLength: 1
  • maxLength: 256
provider_payload.publish_options.quote_post_idanyOf 4stringFacultatif / élément
  • minLength: 1
  • maxLength: 256
provider_payload.publish_options.repost_target_idanyOf 4stringFacultatif / élément
  • minLength: 1
  • maxLength: 256
provider_payload.publish_options.reply_controlanyOf 4stringFacultatif / élément
  • enum: ["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only"]
provider_payload.publish_options.enable_reply_approvalsanyOf 4booleanFacultatif / élément—
provider_payload.publish_options.link_attachmentanyOf 4stringFacultatif / élément
  • format: "uri"
provider_payload.publish_options.poll_attachmentanyOf 4objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.poll_attachment.option_aanyOf 4stringRequis dans le parent
  • minLength: 1
  • maxLength: 25
provider_payload.publish_options.poll_attachment.option_banyOf 4stringRequis dans le parent
  • minLength: 1
  • maxLength: 25
provider_payload.publish_options.poll_attachment.option_canyOf 4stringFacultatif / élément
  • minLength: 1
  • maxLength: 25
provider_payload.publish_options.poll_attachment.option_danyOf 4stringFacultatif / élément
  • minLength: 1
  • maxLength: 25
provider_payload.publish_options.gif_attachmentanyOf 4objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.gif_attachment.gif_idanyOf 4stringRequis dans le parent
  • minLength: 1
  • maxLength: 256
provider_payload.publish_options.gif_attachment.provideranyOf 4stringRequis dans le parent
  • enum: ["GIPHY"]
provider_payload.publish_options.text_attachmentanyOf 4objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.text_attachment.plaintextanyOf 4stringRequis dans le parent
  • minLength: 1
  • maxLength: 10000
provider_payload.publish_options.text_attachment.link_attachment_urlanyOf 4stringFacultatif / élément
  • format: "uri"
provider_payload.publish_options.text_attachment.text_with_styling_infoanyOf 4arrayFacultatif / élément
  • maxItems: 100
provider_payload.publish_options.text_attachment.text_with_styling_info[]anyOf 4objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.text_attachment.text_with_styling_info[].offsetanyOf 4integerRequis dans le parent
  • minimum: 0
  • maximum: 9007199254740991
provider_payload.publish_options.text_attachment.text_with_styling_info[].lengthanyOf 4integerRequis dans le parent
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
provider_payload.publish_options.text_attachment.text_with_styling_info[].styling_infoanyOf 4arrayRequis dans le parent
  • minItems: 1
provider_payload.publish_options.text_attachment.text_with_styling_info[].styling_info[]anyOf 4stringFacultatif / élément
  • enum: ["bold","italic","highlight","underline","strikethrough"]
provider_payload.publish_options.topic_taganyOf 4stringFacultatif / élément
  • minLength: 1
  • maxLength: 50
provider_payload.publish_options.text_entitiesanyOf 4arrayFacultatif / élément
  • maxItems: 10
provider_payload.publish_options.text_entities[]anyOf 4objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.text_entities[].entity_typeanyOf 4stringRequis dans le parent
  • enum: ["SPOILER","spoiler"]
provider_payload.publish_options.text_entities[].offsetanyOf 4integerRequis dans le parent
  • minimum: 0
  • maximum: 9007199254740991
provider_payload.publish_options.text_entities[].lengthanyOf 4integerRequis dans le parent
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
provider_payload.publish_options.is_spoiler_mediaanyOf 4booleanFacultatif / élément—
provider_payload.publish_options.is_ghost_postanyOf 4booleanFacultatif / élément—
provider_payload.publish_options.location_idanyOf 4stringFacultatif / élément
  • minLength: 1
  • maxLength: 256
provider_payload.publish_options.allowlisted_country_codesanyOf 4arrayFacultatif / élément
  • minItems: 1
  • maxItems: 249
provider_payload.publish_options.allowlisted_country_codes[]anyOf 4stringFacultatif / élément
  • pattern: "^[A-Z]{2}$"
provider_payload.publish_options.crossreshare_to_iganyOf 4booleanFacultatif / élément—
provider_payload.publish_options.crossreshare_to_ig_dark_modeanyOf 4booleanFacultatif / élément—
provider_payload.publish_options.auto_publish_textanyOf 4booleanFacultatif / élément—
provider_payload.publish_options.media_optionsanyOf 4arrayFacultatif / élément
  • maxItems: 20
provider_payload.publish_options.media_options[]anyOf 4objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.media_options[].asset_idanyOf 4integerRequis dans le parent
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
provider_payload.publish_options.media_options[].alt_textanyOf 4stringFacultatif / élément
  • minLength: 1
  • maxLength: 1000
provider_payload.publish_options.media_options[].is_spoiler_mediaanyOf 4booleanFacultatif / élément—
provider_payloadanyOf 5objectFacultatif / élément
  • additionalProperties: false
provider_payload.platformanyOf 5stringRequis dans le parent
  • enum: ["youtube"]
provider_payload.publish_optionsanyOf 5objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.post_typeanyOf 5stringRequis dans le parent
  • enum: ["VIDEO"]
provider_payload.publish_options.titleanyOf 5stringRequis dans le parent
  • minLength: 1
  • maxLength: 100
provider_payload.publish_options.descriptionanyOf 5stringFacultatif / élément
  • maxLength: 5000
provider_payload.publish_options.tagsanyOf 5arrayFacultatif / élément
  • maxItems: 100
provider_payload.publish_options.tags[]anyOf 5stringFacultatif / élément
  • minLength: 1
  • maxLength: 500
provider_payload.publish_options.category_idanyOf 5stringFacultatif / élément—
provider_payload.publish_options.category_idanyOf 5 / anyOf 1stringFacultatif / élément
  • minLength: 0
  • maxLength: 0
provider_payload.publish_options.category_idanyOf 5 / anyOf 2stringFacultatif / élément
  • pattern: "^\\d+$"
provider_payload.publish_options.default_languageanyOf 5stringFacultatif / élément
  • minLength: 2
  • maxLength: 35
provider_payload.publish_options.localizationsanyOf 5objectFacultatif / élément
  • additionalProperties: {"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","maxLength":5000}},"required":["title","description"],"additionalProperties":false}
provider_payload.publish_options.localizations.*anyOf 5objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.localizations.*.titleanyOf 5stringRequis dans le parent
  • minLength: 1
  • maxLength: 100
provider_payload.publish_options.localizations.*.descriptionanyOf 5stringRequis dans le parent
  • maxLength: 5000
provider_payload.publish_options.privacy_statusanyOf 5stringRequis dans le parent
  • enum: ["private","unlisted","public"]
provider_payload.publish_options.cancellation_modeanyOf 5stringRequis dans le parent
  • enum: ["DELETE","UNSCHEDULE_KEEP_PRIVATE"]
provider_payload.publish_options.licenseanyOf 5stringFacultatif / élément
  • enum: ["youtube","creativeCommon"]
provider_payload.publish_options.embeddableanyOf 5booleanFacultatif / élément—
provider_payload.publish_options.public_stats_viewableanyOf 5booleanFacultatif / élément—
provider_payload.publish_options.self_declared_made_for_kidsanyOf 5booleanFacultatif / élément—
provider_payload.publish_options.contains_synthetic_mediaanyOf 5booleanFacultatif / élément—
provider_payload.publish_options.has_paid_product_placementanyOf 5booleanFacultatif / élément—
provider_payload.publish_options.recording_dateanyOf 5stringFacultatif / élément
  • 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)))$"
provider_payload.publish_options.notify_subscribersanyOf 5booleanFacultatif / élément—
provider_payload.publish_options.thumbnail_asset_idanyOf 5integerFacultatif / élément
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
provider_payload.publish_options.surface_expectationanyOf 5stringFacultatif / élément
  • enum: ["SHORT"]
provider_payload.publish_options.brand_partneranyOf 5objectFacultatif / élément
  • additionalProperties: false
provider_payload.publish_options.brand_partner.channel_idanyOf 5stringFacultatif / élément
  • pattern: "^UC[A-Za-z0-9_-]+$"
provider_payload.publish_options.brand_partner.channel_handleanyOf 5stringFacultatif / élément
  • pattern: "^@[A-Za-z0-9._-]+$"
JSON Schema complet
{
  "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
    },
    "patch": {
      "type": "object",
      "properties": {
        "caption": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 5000
            },
            {
              "type": "null"
            }
          ]
        },
        "hashtags": {
          "maxItems": 100,
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 100
          }
        },
        "media": {
          "maxItems": 20,
          "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"
            }
          ]
        },
        "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": {
          "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",
              "additionalProperties": {}
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "additionalProperties": false
    },
    "provider_payload": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "platform": {
              "type": "string",
              "enum": [
                "x"
              ]
            },
            "publish_options": {
              "type": "object",
              "properties": {
                "post_type": {
                  "type": "string",
                  "enum": [
                    "TEXT"
                  ]
                }
              },
              "required": [
                "post_type"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "platform"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "platform": {
              "type": "string",
              "enum": [
                "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"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "platform": {
              "type": "string",
              "enum": [
                "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",
                            "enum": [
                              1
                            ]
                          },
                          {
                            "type": "number",
                            "enum": [
                              2
                            ]
                          },
                          {
                            "type": "number",
                            "enum": [
                              3
                            ]
                          }
                        ]
                      }
                    },
                    "genders": {
                      "maxItems": 2,
                      "type": "array",
                      "items": {
                        "anyOf": [
                          {
                            "type": "number",
                            "enum": [
                              1
                            ]
                          },
                          {
                            "type": "number",
                            "enum": [
                              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",
                            "enum": [
                              1
                            ]
                          },
                          {
                            "type": "number",
                            "enum": [
                              2
                            ]
                          },
                          {
                            "type": "number",
                            "enum": [
                              3
                            ]
                          },
                          {
                            "type": "number",
                            "enum": [
                              4
                            ]
                          }
                        ]
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "targeting": {
                  "type": "object",
                  "properties": {
                    "age_min": {
                      "anyOf": [
                        {
                          "type": "number",
                          "enum": [
                            13
                          ]
                        },
                        {
                          "type": "number",
                          "enum": [
                            15
                          ]
                        },
                        {
                          "type": "number",
                          "enum": [
                            18
                          ]
                        },
                        {
                          "type": "number",
                          "enum": [
                            21
                          ]
                        },
                        {
                          "type": "number",
                          "enum": [
                            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"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "platform": {
              "type": "string",
              "enum": [
                "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",
                      "enum": [
                        "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"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "platform": {
              "type": "string",
              "enum": [
                "youtube"
              ]
            },
            "publish_options": {
              "type": "object",
              "properties": {
                "post_type": {
                  "type": "string",
                  "enum": [
                    "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",
                  "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",
                  "enum": [
                    "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"
          ],
          "additionalProperties": false
        }
      ]
    }
  },
  "required": [
    "id",
    "expected_version",
    "patch"
  ],
  "additionalProperties": false
}

Sortie structurée

Ce schéma décrit structuredContent dans un résultat d’outil réussi. La réponse MCP contient aussi content et peut définir isError en cas d’échec. Pour publier, lisez le résultat final de la publication plutôt que de considérer une requête acceptée ou une réponse texte comme une confirmation. L’opération API liée explique les autorisations et règles de nouvelle tentative.

Requis signifie requis dans l’objet parent et la branche sélectionnée. Un enfant requis ne rend pas obligatoire un parent facultatif. Les règles et noms de champs ci-dessous proviennent du contrat.

Sortie structurée
Champ / brancheType / requisContraintes
$objectRequis dans le parent
  • additionalProperties: false
postobjectRequis dans le parent
  • additionalProperties: false
post.idstringRequis dans le parent
  • 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_idstringRequis dans le parent
  • format: "uuid"
post.social_account_idstring | nullRequis dans le parent—
post.social_account_idanyOf 1stringRequis dans le parent
  • format: "uuid"
post.social_account_idanyOf 2nullRequis dans le parent—
post.platformstringRequis dans le parent
  • enum: ["instagram","threads","facebook","youtube","x"]
post.destinationobjectRequis dans le parent
  • additionalProperties: false
post.destination.social_account_idstring | nullRequis dans le parent—
post.destination.social_account_idanyOf 1stringRequis dans le parent
  • format: "uuid"
post.destination.social_account_idanyOf 2nullRequis dans le parent—
post.destination.platformstringRequis dans le parent
  • enum: ["instagram","threads","facebook","youtube","x"]
post.destination.platform_user_idstring | nullRequis dans le parent—
post.destination.platform_user_idanyOf 1stringRequis dans le parent—
post.destination.platform_user_idanyOf 2nullRequis dans le parent—
post.destination.account_labelstring | nullRequis dans le parent—
post.destination.account_labelanyOf 1stringRequis dans le parent—
post.destination.account_labelanyOf 2nullRequis dans le parent—
post.captionstring | nullRequis dans le parent—
post.captionanyOf 1stringRequis dans le parent—
post.captionanyOf 2nullRequis dans le parent—
post.hashtagsarrayRequis dans le parent—
post.hashtags[]stringFacultatif / élément—
post.mediaarrayRequis dans le parent—
post.media[]objectFacultatif / élément
  • additionalProperties: false
post.media[].kindstringRequis dans le parent
  • enum: ["image","video"]
post.media[].urlstringRequis dans le parent
  • format: "uri"
post.media[].cover_urlstring | nullFacultatif / élément—
post.media[].cover_urlanyOf 1stringFacultatif / élément
  • format: "uri"
post.media[].cover_urlanyOf 2nullFacultatif / élément—
post.media[].cover_asset_idinteger | nullFacultatif / élément—
post.media[].cover_asset_idanyOf 1integerFacultatif / élément
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.media[].cover_asset_idanyOf 2nullFacultatif / élément—
post.media[].asset_idinteger | nullFacultatif / élément—
post.media[].asset_idanyOf 1integerFacultatif / élément
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.media[].asset_idanyOf 2nullFacultatif / élément—
post.media[].mime_typestring | nullFacultatif / élément—
post.media[].mime_typeanyOf 1stringFacultatif / élément
  • minLength: 1
  • maxLength: 160
post.media[].mime_typeanyOf 2nullFacultatif / élément—
post.media[].preview_urlstring | nullFacultatif / élément

URL de lecture temporaire autorisée ; conservez url comme identité persistante du média Scheduled Post.

—
post.media[].preview_urlanyOf 1stringFacultatif / élément
  • format: "uri"
post.media[].preview_urlanyOf 2nullFacultatif / élément—
post.media[].cover_preview_urlstring | nullFacultatif / élément

URL temporaire autorisée de lecture de couverture ; conservez cover_url comme identité persistante du média.

—
post.media[].cover_preview_urlanyOf 1stringFacultatif / élément
  • format: "uri"
post.media[].cover_preview_urlanyOf 2nullFacultatif / élément—
post.media[].preview_expires_atstring | nullFacultatif / élément—
post.media[].preview_expires_atanyOf 1stringFacultatif / élément
  • 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 2nullFacultatif / élément—
post.link_urlstring | nullFacultatif / élément—
post.link_urlanyOf 1stringFacultatif / élément
  • format: "uri"
post.link_urlanyOf 2nullFacultatif / élément—
post.publish_optionsobjectRequis dans le parent
  • additionalProperties: false
post.publish_options.post_typestringFacultatif / élément
  • enum: ["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]
post.publish_options.location_idstringFacultatif / élément
  • minLength: 1
post.publish_options.share_to_feedbooleanFacultatif / élément—
post.publish_options.collaboratorsarrayFacultatif / élément
  • maxItems: 3
post.publish_options.collaborators[]stringFacultatif / élément
  • minLength: 1
post.publish_options.first_commentstringFacultatif / élément
  • minLength: 1
  • maxLength: 2200
post.publish_options.topic_tagstringFacultatif / élément
  • minLength: 1
post.publish_options.thumb_offset_msintegerFacultatif / élément
  • minimum: 0
  • maximum: 9007199254740991
post.publish_options.titlestringFacultatif / élément
  • maxLength: 255
post.publish_options.youtube_privacy_statusstringFacultatif / élément
  • enum: ["private","unlisted","public"]
post.publish_options.youtube_category_idstringFacultatif / élément
  • pattern: "^\\d+$"
post.publish_options.youtube_contains_synthetic_mediabooleanFacultatif / élément—
post.publish_options.descriptionstringFacultatif / élément
  • maxLength: 5000
post.publish_options.category_idstringFacultatif / élément
  • pattern: "^\\d+$"
post.publish_options.privacy_statusstringFacultatif / élément
  • enum: ["private","unlisted","public"]
post.publish_options.cancellation_modestringFacultatif / élément
  • enum: ["DELETE","UNSCHEDULE_KEEP_PRIVATE"]
post.publish_options.tagsarrayFacultatif / élément—
post.publish_options.tags[]stringFacultatif / élément—
post.publish_options.default_languagestringFacultatif / élément—
post.publish_options.localizationsobjectFacultatif / élément
  • additionalProperties: {}
post.publish_options.localizations.*any JSON valueFacultatif / élément—
post.publish_options.licensestringFacultatif / élément
  • enum: ["youtube","creativeCommon"]
post.publish_options.embeddablebooleanFacultatif / élément—
post.publish_options.public_stats_viewablebooleanFacultatif / élément—
post.publish_options.self_declared_made_for_kidsbooleanFacultatif / élément—
post.publish_options.contains_synthetic_mediabooleanFacultatif / élément—
post.publish_options.has_paid_product_placementbooleanFacultatif / élément—
post.publish_options.recording_datestringFacultatif / élément—
post.publish_options.notify_subscribersbooleanFacultatif / élément—
post.publish_options.thumbnail_asset_idintegerFacultatif / élément
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.publish_options.surface_expectationstringFacultatif / élément
  • const: "SHORT"
post.publish_options.brand_partnerobjectFacultatif / élément
  • additionalProperties: {}
post.publish_options.brand_partner.*any JSON valueFacultatif / élément—
post.publish_options.cover_asset_idintegerFacultatif / élément
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.publish_options.audio_namestringFacultatif / élément—
post.publish_options.trial_paramsobjectFacultatif / élément
  • additionalProperties: {}
post.publish_options.trial_params.*any JSON valueFacultatif / élément—
post.publish_options.is_ai_generatedbooleanFacultatif / élément—
post.publish_options.branded_content_sponsor_idsarrayFacultatif / élément—
post.publish_options.branded_content_sponsor_ids[]stringFacultatif / élément—
post.publish_options.is_paid_partnershipbooleanFacultatif / élément—
post.publish_options.media_optionsarrayFacultatif / élément—
post.publish_options.media_options[]objectFacultatif / élément
  • additionalProperties: {}
post.publish_options.media_options[].*any JSON valueFacultatif / élément—
post.publish_options.reply_to_idstringFacultatif / élément—
post.publish_options.quote_post_idstringFacultatif / élément—
post.publish_options.repost_target_idstringFacultatif / élément—
post.publish_options.reply_controlstringFacultatif / élément—
post.publish_options.enable_reply_approvalsbooleanFacultatif / élément—
post.publish_options.link_attachmentstringFacultatif / élément
  • format: "uri"
post.publish_options.poll_attachmentobjectFacultatif / élément
  • additionalProperties: {}
post.publish_options.poll_attachment.*any JSON valueFacultatif / élément—
post.publish_options.gif_attachmentobjectFacultatif / élément
  • additionalProperties: {}
post.publish_options.gif_attachment.*any JSON valueFacultatif / élément—
post.publish_options.text_attachmentobjectFacultatif / élément
  • additionalProperties: {}
post.publish_options.text_attachment.*any JSON valueFacultatif / élément—
post.publish_options.text_entitiesarrayFacultatif / élément—
post.publish_options.text_entities[]objectFacultatif / élément
  • additionalProperties: {}
post.publish_options.text_entities[].*any JSON valueFacultatif / élément—
post.publish_options.is_spoiler_mediabooleanFacultatif / élément—
post.publish_options.is_ghost_postbooleanFacultatif / élément—
post.publish_options.allowlisted_country_codesarrayFacultatif / élément—
post.publish_options.allowlisted_country_codes[]stringFacultatif / élément—
post.publish_options.crossreshare_to_igbooleanFacultatif / élément—
post.publish_options.crossreshare_to_ig_dark_modebooleanFacultatif / élément—
post.publish_options.auto_publish_textbooleanFacultatif / élément—
post.publish_options.publication_modestringFacultatif / élément
  • enum: ["PUBLISH","DRAFT"]
post.publish_options.backdated_timenumberFacultatif / élément—
post.publish_options.backdated_time_granularitystringFacultatif / élément
  • enum: ["year","month","day","hour","minute"]
post.publish_options.placestringFacultatif / élément—
post.publish_options.feed_targetingobjectFacultatif / élément
  • additionalProperties: {}
post.publish_options.feed_targeting.*any JSON valueFacultatif / élément—
post.publish_options.targetingobjectFacultatif / élément
  • additionalProperties: {}
post.publish_options.targeting.*any JSON valueFacultatif / élément—
post.publish_options.child_attachmentsarrayFacultatif / élément—
post.publish_options.child_attachments[]objectFacultatif / élément
  • additionalProperties: {}
post.publish_options.child_attachments[].*any JSON valueFacultatif / élément—
post.publish_options.multi_share_end_cardbooleanFacultatif / élément—
post.publish_options.multi_share_optimizedbooleanFacultatif / élément—
post.publish_options.unpublished_content_typestringFacultatif / élément—
post.publish_options.no_storybooleanFacultatif / élément—
post.publish_options.crossposted_video_idstringFacultatif / élément—
post.publish_options.sphericalbooleanFacultatif / élément—
post.scheduled_atstringRequis dans le parent—
post.display_timezonestringRequis dans le parent
  • minLength: 1
  • maxLength: 80
post.local_scheduled_atstring | nullFacultatif / élément—
post.local_scheduled_atanyOf 1stringFacultatif / élément
  • pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
post.local_scheduled_atanyOf 2nullFacultatif / élément—
post.schedule_timezonestring | nullFacultatif / élément—
post.schedule_timezoneanyOf 1stringFacultatif / élément
  • minLength: 1
  • maxLength: 80
post.schedule_timezoneanyOf 2nullFacultatif / élément—
post.schedule_dst_disambiguationstring | nullFacultatif / élément—
post.schedule_dst_disambiguationanyOf 1stringFacultatif / élément
  • enum: ["exact","earlier","later"]
post.schedule_dst_disambiguationanyOf 2nullFacultatif / élément—
post.schedule_intent_statestringFacultatif / élément
  • enum: ["verified","legacy_unverified"]
post.expires_atstring | nullRequis dans le parent—
post.expires_atanyOf 1stringRequis dans le parent—
post.expires_atanyOf 2nullRequis dans le parent—
post.statusstringRequis dans le parent
  • enum: ["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]
post.versionintegerRequis dans le parent
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.automatic_retry_enabledbooleanRequis dans le parent—
post.delete_requested_atstring | nullRequis dans le parent—
post.delete_requested_atanyOf 1stringRequis dans le parent—
post.delete_requested_atanyOf 2nullRequis dans le parent—
post.published_atstring | nullRequis dans le parent—
post.published_atanyOf 1stringRequis dans le parent—
post.published_atanyOf 2nullRequis dans le parent—
post.deleted_atstring | nullRequis dans le parent—
post.deleted_atanyOf 1stringRequis dans le parent—
post.deleted_atanyOf 2nullRequis dans le parent—
post.provider_post_idstring | nullRequis dans le parent—
post.provider_post_idanyOf 1stringRequis dans le parent—
post.provider_post_idanyOf 2nullRequis dans le parent—
post.permalinkstring | nullRequis dans le parent—
post.permalinkanyOf 1stringRequis dans le parent
  • format: "uri"
post.permalinkanyOf 2nullRequis dans le parent—
post.created_atstringRequis dans le parent—
post.updated_atstringRequis dans le parent—
post.project_idstring | nullRequis dans le parent—
post.project_idanyOf 1stringRequis dans le parent
  • format: "uuid"
post.project_idanyOf 2nullRequis dans le parent—
post.batch_idstring | nullRequis dans le parent—
post.batch_idanyOf 1stringRequis dans le parent
  • format: "uuid"
post.batch_idanyOf 2nullRequis dans le parent—
post.source_refobject | nullRequis dans le parent—
post.source_refanyOf 1objectRequis dans le parent
  • additionalProperties: {}
post.source_ref.*anyOf 1any JSON valueFacultatif / élément—
post.source_refanyOf 2nullRequis dans le parent—
JSON Schema complet
{
  "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"
        },
        "social_account_id": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid"
            },
            {
              "type": "null"
            }
          ]
        },
        "platform": {
          "type": "string",
          "enum": [
            "instagram",
            "threads",
            "facebook",
            "youtube",
            "x"
          ]
        },
        "destination": {
          "type": "object",
          "properties": {
            "social_account_id": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "uuid"
                },
                {
                  "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"
          ],
          "additionalProperties": false
        },
        "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"
            ],
            "additionalProperties": false
          }
        },
        "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"
            }
          },
          "additionalProperties": false
        },
        "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"
            },
            {
              "type": "null"
            }
          ]
        },
        "batch_id": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid"
            },
            {
              "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"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "post"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Exemple d’appel d’outil

Ces exemples utilisent des valeurs fictives vérifiées contre les schémas. Remplacez les identifiants par ceux que vous êtes autorisé à utiliser, les médias par des ressources prêtes et les dates par l’heure confirmée. Vérifiez l’éligibilité du compte avant toute écriture. Cette page n’envoie aucune requête API.

{
  "name": "sosoapi_update_scheduled_post",
  "arguments": {
    "id": "11111111-1111-4111-8111-111111111111",
    "expected_version": 1,
    "patch": {}
  }
}

structuredContent

{
  "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
  }
}
Installer ou connecter MCP