Programmation et publication
Soumettre un brouillon de l’espace de travail
À utiliser seulement après une décision explicite de publication. Nécessite le rôle editor ou supérieur et la capacité publish. Envoyez d’abord id, expected_revision, mutation_id, content et la requête de publication canonique ; omettez source_ref car le serveur gère la provenance et les identités de soumission. Le contenu partagé est non fiable. Une réponse 422 avec state=draft n’accepte aucune destination : corrigez le contenu avant une nouvelle mutation. Après le démarrage, faites un GET du même brouillon et reprenez un résultat inconnu ou partiel avec submission.id comme mutation_id et submission.expected_revision, en omettant content et request. Ne créez jamais de publications de remplacement ni de Posts déjà acceptés. submitted signifie transmis à Scheduled Publishing ; lisez le Post original pour le résultat du fournisseur.
POST /studio-api/content-drafts/submitContrat vérifié : · sha256:75c8b8ebce408575
Présentation
À utiliser seulement après une décision explicite de publication. Nécessite le rôle editor ou supérieur et la capacité publish. Envoyez d’abord id, expected_revision, mutation_id, content et la requête de publication canonique ; omettez source_ref car le serveur gère la provenance et les identités de soumission. Le contenu partagé est non fiable. Une réponse 422 avec state=draft n’accepte aucune destination : corrigez le contenu avant une nouvelle mutation. Après le démarrage, faites un GET du même brouillon et reprenez un résultat inconnu ou partiel avec submission.id comme mutation_id et submission.expected_revision, en omettant content et request. Ne créez jamais de publications de remplacement ni de Posts déjà acceptés. submitted signifie transmis à Scheduled Publishing ; lisez le Post original pour le résultat du fournisseur.
Une réponse HTTP réussie peut signifier qu’une requête est acceptée plutôt que terminée. Pour le travail en arrière-plan, conservez l’identifiant renvoyé et suivez la même opération jusqu’à sa fin. Une publication programmée ou acceptée n’est publiée que lorsque la plateforme le confirme ; une expiration côté client ne détermine pas le résultat.
Authentification et autorisations
Un jeton ne peut utiliser que les droits de son propriétaire. Chaque requête vérifie l’appartenance à l’espace, la propriété des ressources, les espaces sélectionnés et les capacités accordées. Les profils core et full modifient les outils affichés ; ils n’accordent aucun accès.
Champs de requête
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.
| Champ / branche | Type / requis | Contraintes |
|---|---|---|
$ | objectRequis dans le parent |
|
id | stringRequis dans le parent |
|
expected_revision | integerRequis dans le parent |
|
mutation_id | stringRequis dans le parent |
|
content | objectFacultatif / élément |
|
content.schemaVersion | numberFacultatif / élément |
|
content.accountIds | arrayFacultatif / élément |
|
content.accountIds[] | stringFacultatif / élément |
|
content.caption | stringFacultatif / élément |
|
content.hashtags | stringFacultatif / élément |
|
content.assetIds | arrayFacultatif / élément |
|
content.assetIds[] | stringFacultatif / élément |
|
content.threadsTextOnly | booleanFacultatif / élément |
|
content.instagramMode | stringFacultatif / élément |
|
content.youtubeTitle | stringFacultatif / élément |
|
content.youtubePrivacy | stringFacultatif / élément |
|
content.youtubeSynthetic | booleanFacultatif / élément |
|
content.youtubeCategoryId | stringFacultatif / élément |
|
content.youtubeShort | booleanFacultatif / élément |
|
content.linkUrl | stringFacultatif / élément |
|
content.scheduledAt | stringFacultatif / élément |
|
content.displayTimezone | stringFacultatif / élément |
|
content.publishNow | booleanFacultatif / élément |
|
content.destinationOverrides | objectFacultatif / élément |
|
content.destinationOverrides.* | objectFacultatif / élément |
|
content.destinationOverrides.*.caption | stringFacultatif / élément |
|
content.destinationOverrides.*.scheduledAt | stringFacultatif / élément |
|
content.expiresAt | stringFacultatif / élément |
|
request | objectFacultatif / élément |
|
request.workspace_id | stringRequis dans le parent |
|
request.project_id | string | nullFacultatif / élément | — |
request.project_idanyOf 1 | stringFacultatif / élément |
|
request.project_idanyOf 2 | nullFacultatif / élément | — |
request.source_ref | object | nullFacultatif / élément | — |
request.source_refanyOf 1 | objectFacultatif / élément |
|
request.source_ref.*anyOf 1 | any JSON valueFacultatif / élément | — |
request.source_refanyOf 2 | nullFacultatif / élément | — |
request.targets | arrayRequis dans le parent |
|
request.targets[] | objectFacultatif / élément |
|
request.targets[].social_account_id | stringRequis dans le parent |
|
request.targets[].caption | string | nullFacultatif / élément |
|
request.targets[].captionanyOf 1 | stringFacultatif / élément |
|
request.targets[].captionanyOf 2 | nullFacultatif / élément | — |
request.targets[].hashtags | arrayFacultatif / élément |
|
request.targets[].hashtags[] | stringFacultatif / élément |
|
request.targets[].media | arrayFacultatif / élément |
|
request.targets[].media[] | objectFacultatif / élément |
|
request.targets[].media[].kind | stringRequis dans le parent |
|
request.targets[].media[].url | stringRequis dans le parent |
|
request.targets[].media[].cover_url | string | nullFacultatif / élément | — |
request.targets[].media[].cover_urlanyOf 1 | stringFacultatif / élément |
|
request.targets[].media[].cover_urlanyOf 2 | nullFacultatif / élément | — |
request.targets[].media[].cover_asset_id | integer | nullFacultatif / élément | — |
request.targets[].media[].cover_asset_idanyOf 1 | integerFacultatif / élément |
|
request.targets[].media[].cover_asset_idanyOf 2 | nullFacultatif / élément | — |
request.targets[].media[].asset_id | integer | nullFacultatif / élément | — |
request.targets[].media[].asset_idanyOf 1 | integerFacultatif / élément |
|
request.targets[].media[].asset_idanyOf 2 | nullFacultatif / élément | — |
request.targets[].media[].mime_type | string | nullFacultatif / élément | — |
request.targets[].media[].mime_typeanyOf 1 | stringFacultatif / élément |
|
request.targets[].media[].mime_typeanyOf 2 | nullFacultatif / élément | — |
request.targets[].link_url | string | nullFacultatif / élément | — |
request.targets[].link_urlanyOf 1 | stringFacultatif / élément |
|
request.targets[].link_urlanyOf 2 | nullFacultatif / élément | — |
request.targets[].provider_payload | objectRequis dans le parent | — |
request.targets[].provider_payloadoneOf 1 | objectRequis dans le parent |
|
request.targets[].provider_payload.platformoneOf 1 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_optionsoneOf 1 | objectRequis dans le parent |
|
request.targets[].provider_payload.publish_options.post_typeoneOf 1 | stringRequis dans le parent |
|
request.targets[].provider_payloadoneOf 2 | objectRequis dans le parent |
|
request.targets[].provider_payload.platformoneOf 2 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_optionsoneOf 2 | objectRequis dans le parent |
|
request.targets[].provider_payload.publish_options.post_typeoneOf 2 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.location_idoneOf 2 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.share_to_feedoneOf 2 | booleanFacultatif / élément | — |
request.targets[].provider_payload.publish_options.collaboratorsoneOf 2 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.collaborators[]oneOf 2 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.first_commentoneOf 2 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.cover_asset_idoneOf 2 | integerFacultatif / élément |
|
request.targets[].provider_payload.publish_options.thumb_offset_msoneOf 2 | integerFacultatif / élément |
|
request.targets[].provider_payload.publish_options.audio_nameoneOf 2 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.trial_paramsoneOf 2 | objectFacultatif / élément |
|
request.targets[].provider_payload.publish_options.trial_params.graduation_strategyoneOf 2 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.is_ai_generatedoneOf 2 | booleanFacultatif / élément | — |
request.targets[].provider_payload.publish_options.branded_content_sponsor_idsoneOf 2 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.branded_content_sponsor_ids[]oneOf 2 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.is_paid_partnershiponeOf 2 | booleanFacultatif / élément | — |
request.targets[].provider_payload.publish_options.media_optionsoneOf 2 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.media_options[]oneOf 2 | objectFacultatif / élément |
|
request.targets[].provider_payload.publish_options.media_options[].asset_idoneOf 2 | integerRequis dans le parent |
|
request.targets[].provider_payload.publish_options.media_options[].alt_textoneOf 2 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.media_options[].user_tagsoneOf 2 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.media_options[].user_tags[]oneOf 2 | objectFacultatif / élément |
|
request.targets[].provider_payload.publish_options.media_options[].user_tags[].usernameoneOf 2 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.media_options[].user_tags[].xoneOf 2 | numberFacultatif / élément |
|
request.targets[].provider_payload.publish_options.media_options[].user_tags[].yoneOf 2 | numberFacultatif / élément |
|
request.targets[].provider_payload.publish_options.media_options[].product_tagsoneOf 2 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.media_options[].product_tags[]oneOf 2 | objectFacultatif / élément |
|
request.targets[].provider_payload.publish_options.media_options[].product_tags[].product_idoneOf 2 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.media_options[].product_tags[].xoneOf 2 | numberFacultatif / élément |
|
request.targets[].provider_payload.publish_options.media_options[].product_tags[].yoneOf 2 | numberFacultatif / élément |
|
request.targets[].provider_payload.publish_options.media_options[].thumb_offset_msoneOf 2 | integerFacultatif / élément |
|
request.targets[].provider_payloadoneOf 3 | objectRequis dans le parent |
|
request.targets[].provider_payload.platformoneOf 3 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_optionsoneOf 3 | objectRequis dans le parent |
|
request.targets[].provider_payload.publish_options.post_typeoneOf 3 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.titleoneOf 3 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.descriptiononeOf 3 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.publication_modeoneOf 3 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.backdated_timeoneOf 3 | numberFacultatif / élément | — |
request.targets[].provider_payload.publish_options.backdated_time_granularityoneOf 3 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.placeoneOf 3 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.tagsoneOf 3 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.tags[]oneOf 3 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targetingoneOf 3 | objectFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.age_minoneOf 3 | integerFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.age_maxoneOf 3 | integerFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.college_yearsoneOf 3 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.college_years[]oneOf 3 | integerFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.education_statusesoneOf 3 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 | numberFacultatif / élément | — |
request.targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 / anyOf 1 | numberFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 / anyOf 2 | numberFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 / anyOf 3 | numberFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.gendersoneOf 3 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.genders[]oneOf 3 | numberFacultatif / élément | — |
request.targets[].provider_payload.publish_options.feed_targeting.genders[]oneOf 3 / anyOf 1 | numberFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.genders[]oneOf 3 / anyOf 2 | numberFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locationsoneOf 3 | objectFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.countriesoneOf 3 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.countries[]oneOf 3 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.regionsoneOf 3 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[]oneOf 3 | objectFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyoneOf 3 | string | integerRequis dans le parent | — |
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyoneOf 3 / anyOf 1 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyoneOf 3 / anyOf 2 | integerRequis dans le parent |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.citiesoneOf 3 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[]oneOf 3 | objectFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyoneOf 3 | string | integerRequis dans le parent | — |
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyoneOf 3 / anyOf 1 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyoneOf 3 / anyOf 2 | integerRequis dans le parent |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].radiusoneOf 3 | numberFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].distance_unitoneOf 3 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.zipsoneOf 3 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[]oneOf 3 | objectFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyoneOf 3 | string | integerRequis dans le parent | — |
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyoneOf 3 / anyOf 1 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyoneOf 3 / anyOf 2 | integerRequis dans le parent |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.location_typesoneOf 3 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.location_types[]oneOf 3 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.interestsoneOf 3 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.interests[]oneOf 3 | string | integerFacultatif / élément | — |
request.targets[].provider_payload.publish_options.feed_targeting.interests[]oneOf 3 / anyOf 1 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.interests[]oneOf 3 / anyOf 2 | integerFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.localesoneOf 3 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.locales[]oneOf 3 | integerFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statusesoneOf 3 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 | numberFacultatif / élément | — |
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 1 | numberFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 2 | numberFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 3 | numberFacultatif / élément |
|
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 4 | numberFacultatif / élément |
|
request.targets[].provider_payload.publish_options.targetingoneOf 3 | objectFacultatif / élément |
|
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 | numberFacultatif / élément | — |
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 1 | numberFacultatif / élément |
|
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 2 | numberFacultatif / élément |
|
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 3 | numberFacultatif / élément |
|
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 4 | numberFacultatif / élément |
|
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 5 | numberFacultatif / élément |
|
request.targets[].provider_payload.publish_options.targeting.geo_locationsoneOf 3 | objectFacultatif / élément |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.countriesoneOf 3 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.countries[]oneOf 3 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.regionsoneOf 3 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.regions[]oneOf 3 | objectFacultatif / élément |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.regions[].keyoneOf 3 | string | integerRequis dans le parent | — |
request.targets[].provider_payload.publish_options.targeting.geo_locations.regions[].keyoneOf 3 / anyOf 1 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.regions[].keyoneOf 3 / anyOf 2 | integerRequis dans le parent |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.citiesoneOf 3 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[]oneOf 3 | objectFacultatif / élément |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[].keyoneOf 3 | string | integerRequis dans le parent | — |
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[].keyoneOf 3 / anyOf 1 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[].keyoneOf 3 / anyOf 2 | integerRequis dans le parent |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[].radiusoneOf 3 | numberFacultatif / élément |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[].distance_unitoneOf 3 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.zipsoneOf 3 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.zips[]oneOf 3 | objectFacultatif / élément |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.zips[].keyoneOf 3 | string | integerRequis dans le parent | — |
request.targets[].provider_payload.publish_options.targeting.geo_locations.zips[].keyoneOf 3 / anyOf 1 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.zips[].keyoneOf 3 / anyOf 2 | integerRequis dans le parent |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.location_typesoneOf 3 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.location_types[]oneOf 3 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.child_attachmentsoneOf 3 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.child_attachments[]oneOf 3 | objectFacultatif / élément |
|
request.targets[].provider_payload.publish_options.child_attachments[].linkoneOf 3 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.child_attachments[].nameoneOf 3 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.child_attachments[].descriptiononeOf 3 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.child_attachments[].pictureoneOf 3 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.multi_share_end_cardoneOf 3 | booleanFacultatif / élément | — |
request.targets[].provider_payload.publish_options.multi_share_optimizedoneOf 3 | booleanFacultatif / élément | — |
request.targets[].provider_payload.publish_options.unpublished_content_typeoneOf 3 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.no_storyoneOf 3 | booleanFacultatif / élément | — |
request.targets[].provider_payload.publish_options.crossposted_video_idoneOf 3 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.sphericaloneOf 3 | booleanFacultatif / élément | — |
request.targets[].provider_payload.publish_options.media_optionsoneOf 3 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.media_options[]oneOf 3 | objectFacultatif / élément |
|
request.targets[].provider_payload.publish_options.media_options[].asset_idoneOf 3 | integerRequis dans le parent |
|
request.targets[].provider_payload.publish_options.media_options[].alt_text_customoneOf 3 | stringFacultatif / élément |
|
request.targets[].provider_payloadoneOf 4 | objectRequis dans le parent |
|
request.targets[].provider_payload.platformoneOf 4 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_optionsoneOf 4 | objectRequis dans le parent |
|
request.targets[].provider_payload.publish_options.post_typeoneOf 4 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.reply_to_idoneOf 4 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.quote_post_idoneOf 4 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.repost_target_idoneOf 4 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.reply_controloneOf 4 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.enable_reply_approvalsoneOf 4 | booleanFacultatif / élément | — |
request.targets[].provider_payload.publish_options.link_attachmentoneOf 4 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.poll_attachmentoneOf 4 | objectFacultatif / élément |
|
request.targets[].provider_payload.publish_options.poll_attachment.option_aoneOf 4 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.poll_attachment.option_boneOf 4 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.poll_attachment.option_coneOf 4 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.poll_attachment.option_doneOf 4 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.gif_attachmentoneOf 4 | objectFacultatif / élément |
|
request.targets[].provider_payload.publish_options.gif_attachment.gif_idoneOf 4 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.gif_attachment.provideroneOf 4 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.text_attachmentoneOf 4 | objectFacultatif / élément |
|
request.targets[].provider_payload.publish_options.text_attachment.plaintextoneOf 4 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.text_attachment.link_attachment_urloneOf 4 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_infooneOf 4 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[]oneOf 4 | objectFacultatif / élément |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].offsetoneOf 4 | integerRequis dans le parent |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].lengthoneOf 4 | integerRequis dans le parent |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].styling_infooneOf 4 | arrayRequis dans le parent |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].styling_info[]oneOf 4 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.topic_tagoneOf 4 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.text_entitiesoneOf 4 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.text_entities[]oneOf 4 | objectFacultatif / élément |
|
request.targets[].provider_payload.publish_options.text_entities[].entity_typeoneOf 4 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.text_entities[].offsetoneOf 4 | integerRequis dans le parent |
|
request.targets[].provider_payload.publish_options.text_entities[].lengthoneOf 4 | integerRequis dans le parent |
|
request.targets[].provider_payload.publish_options.is_spoiler_mediaoneOf 4 | booleanFacultatif / élément | — |
request.targets[].provider_payload.publish_options.is_ghost_postoneOf 4 | booleanFacultatif / élément | — |
request.targets[].provider_payload.publish_options.location_idoneOf 4 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.allowlisted_country_codesoneOf 4 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.allowlisted_country_codes[]oneOf 4 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.crossreshare_to_igoneOf 4 | booleanFacultatif / élément | — |
request.targets[].provider_payload.publish_options.crossreshare_to_ig_dark_modeoneOf 4 | booleanFacultatif / élément | — |
request.targets[].provider_payload.publish_options.auto_publish_textoneOf 4 | booleanFacultatif / élément | — |
request.targets[].provider_payload.publish_options.media_optionsoneOf 4 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.media_options[]oneOf 4 | objectFacultatif / élément |
|
request.targets[].provider_payload.publish_options.media_options[].asset_idoneOf 4 | integerRequis dans le parent |
|
request.targets[].provider_payload.publish_options.media_options[].alt_textoneOf 4 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.media_options[].is_spoiler_mediaoneOf 4 | booleanFacultatif / élément | — |
request.targets[].provider_payloadoneOf 5 | objectRequis dans le parent |
|
request.targets[].provider_payload.platformoneOf 5 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_optionsoneOf 5 | objectRequis dans le parent |
|
request.targets[].provider_payload.publish_options.post_typeoneOf 5 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.titleoneOf 5 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.descriptiononeOf 5 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.tagsoneOf 5 | arrayFacultatif / élément |
|
request.targets[].provider_payload.publish_options.tags[]oneOf 5 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.category_idoneOf 5 | stringFacultatif / élément | — |
request.targets[].provider_payload.publish_options.category_idoneOf 5 / anyOf 1 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.category_idoneOf 5 / anyOf 2 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.default_languageoneOf 5 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.localizationsoneOf 5 | objectFacultatif / élément |
|
request.targets[].provider_payload.publish_options.localizations.*oneOf 5 | objectFacultatif / élément |
|
request.targets[].provider_payload.publish_options.localizations.*.titleoneOf 5 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.localizations.*.descriptiononeOf 5 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.privacy_statusoneOf 5 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.cancellation_modeoneOf 5 | stringRequis dans le parent |
|
request.targets[].provider_payload.publish_options.licenseoneOf 5 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.embeddableoneOf 5 | booleanFacultatif / élément | — |
request.targets[].provider_payload.publish_options.public_stats_viewableoneOf 5 | booleanFacultatif / élément | — |
request.targets[].provider_payload.publish_options.self_declared_made_for_kidsoneOf 5 | booleanFacultatif / élément | — |
request.targets[].provider_payload.publish_options.contains_synthetic_mediaoneOf 5 | booleanFacultatif / élément | — |
request.targets[].provider_payload.publish_options.has_paid_product_placementoneOf 5 | booleanFacultatif / élément | — |
request.targets[].provider_payload.publish_options.recording_dateoneOf 5 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.notify_subscribersoneOf 5 | booleanFacultatif / élément | — |
request.targets[].provider_payload.publish_options.thumbnail_asset_idoneOf 5 | integerFacultatif / élément |
|
request.targets[].provider_payload.publish_options.surface_expectationoneOf 5 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.brand_partneroneOf 5 | objectFacultatif / élément |
|
request.targets[].provider_payload.publish_options.brand_partner.channel_idoneOf 5 | stringFacultatif / élément |
|
request.targets[].provider_payload.publish_options.brand_partner.channel_handleoneOf 5 | stringFacultatif / élément |
|
request.targets[].scheduled_at | stringRequis dans le parent |
|
request.targets[].display_timezone | stringFacultatif / élément |
|
request.targets[].local_scheduled_at | stringFacultatif / élément |
|
request.targets[].schedule_dst_disambiguation | stringFacultatif / élément |
|
request.targets[].expires_at | string | nullFacultatif / élément | — |
request.targets[].expires_atanyOf 1 | stringFacultatif / élément |
|
request.targets[].expires_atanyOf 2 | nullFacultatif / élément | — |
request.targets[].source_ref | object | nullFacultatif / élément | — |
request.targets[].source_refanyOf 1 | objectFacultatif / élément |
|
request.targets[].source_ref.*anyOf 1 | any JSON valueFacultatif / élément | — |
request.targets[].source_refanyOf 2 | nullFacultatif / élément | — |
request.targets[].automatic_retry_enabled | booleanFacultatif / élément |
|
request.targets[].idempotency_key | stringRequis dans le parent |
|
JSON Schema complet
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"expected_revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"mutation_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"content": {
"type": "object",
"properties": {
"schemaVersion": {
"default": 1,
"type": "number",
"const": 1
},
"accountIds": {
"default": [],
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"caption": {
"default": "",
"type": "string",
"maxLength": 5000
},
"hashtags": {
"default": "",
"type": "string",
"maxLength": 5000
},
"assetIds": {
"default": [],
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"maxLength": 16,
"pattern": "^[1-9][0-9]*$"
}
},
"threadsTextOnly": {
"default": false,
"type": "boolean"
},
"instagramMode": {
"default": "REELS",
"type": "string",
"enum": [
"IMAGE",
"REELS",
"CAROUSEL",
"STORY_IMAGE",
"STORY_VIDEO"
]
},
"youtubeTitle": {
"default": "",
"type": "string",
"maxLength": 100
},
"youtubePrivacy": {
"default": "private",
"type": "string",
"enum": [
"private",
"unlisted",
"public"
]
},
"youtubeSynthetic": {
"default": false,
"type": "boolean"
},
"youtubeCategoryId": {
"default": "",
"type": "string",
"maxLength": 32
},
"youtubeShort": {
"default": false,
"type": "boolean"
},
"linkUrl": {
"default": "",
"type": "string",
"maxLength": 2048
},
"scheduledAt": {
"default": "",
"type": "string",
"maxLength": 64
},
"displayTimezone": {
"default": "UTC",
"type": "string",
"minLength": 1,
"maxLength": 128
},
"publishNow": {
"default": false,
"type": "boolean"
},
"destinationOverrides": {
"default": {},
"type": "object",
"propertyNames": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"additionalProperties": {
"type": "object",
"properties": {
"caption": {
"type": "string",
"maxLength": 5000
},
"scheduledAt": {
"type": "string",
"maxLength": 64
}
},
"additionalProperties": false
}
},
"expiresAt": {
"default": "",
"type": "string",
"maxLength": 64
}
},
"additionalProperties": false
},
"request": {
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"project_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
]
},
"source_ref": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"targets": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"social_account_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"caption": {
"default": null,
"anyOf": [
{
"type": "string",
"maxLength": 5000
},
{
"type": "null"
}
]
},
"hashtags": {
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"maxLength": 100
}
},
"media": {
"default": [],
"maxItems": 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"
}
]
},
"provider_payload": {
"oneOf": [
{
"type": "object",
"properties": {
"platform": {
"type": "string",
"const": "x"
},
"publish_options": {
"type": "object",
"properties": {
"post_type": {
"type": "string",
"enum": [
"TEXT",
"VIDEO"
]
}
},
"required": [
"post_type"
],
"additionalProperties": false
}
},
"required": [
"platform",
"publish_options"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"platform": {
"type": "string",
"const": "instagram"
},
"publish_options": {
"type": "object",
"properties": {
"post_type": {
"type": "string",
"enum": [
"IMAGE",
"VIDEO",
"CAROUSEL",
"REELS",
"STORY_IMAGE",
"STORY_VIDEO"
]
},
"location_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"share_to_feed": {
"type": "boolean"
},
"collaborators": {
"maxItems": 3,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 30
}
},
"first_comment": {
"type": "string",
"minLength": 1,
"maxLength": 2200
},
"cover_asset_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"thumb_offset_ms": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"audio_name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"trial_params": {
"type": "object",
"properties": {
"graduation_strategy": {
"type": "string",
"enum": [
"MANUAL",
"SS_PERFORMANCE"
]
}
},
"required": [
"graduation_strategy"
],
"additionalProperties": false
},
"is_ai_generated": {
"type": "boolean"
},
"branded_content_sponsor_ids": {
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"is_paid_partnership": {
"type": "boolean"
},
"media_options": {
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"asset_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"alt_text": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"user_tags": {
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"username": {
"type": "string",
"minLength": 1,
"maxLength": 30
},
"x": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"y": {
"type": "number",
"minimum": 0,
"maximum": 1
}
},
"required": [
"username"
],
"additionalProperties": false
}
},
"product_tags": {
"maxItems": 5,
"type": "array",
"items": {
"type": "object",
"properties": {
"product_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"x": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"y": {
"type": "number",
"minimum": 0,
"maximum": 1
}
},
"required": [
"product_id"
],
"additionalProperties": false
}
},
"thumb_offset_ms": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"asset_id"
],
"additionalProperties": false
}
}
},
"required": [
"post_type"
],
"additionalProperties": false
}
},
"required": [
"platform",
"publish_options"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"platform": {
"type": "string",
"const": "facebook"
},
"publish_options": {
"type": "object",
"properties": {
"post_type": {
"type": "string",
"enum": [
"TEXT",
"LINK",
"IMAGE",
"MULTI_IMAGE",
"VIDEO",
"REELS",
"STORY_IMAGE",
"STORY_VIDEO"
]
},
"title": {
"type": "string",
"maxLength": 255
},
"description": {
"type": "string",
"maxLength": 5000
},
"publication_mode": {
"type": "string",
"enum": [
"PUBLISH",
"DRAFT"
]
},
"backdated_time": {
"type": "number"
},
"backdated_time_granularity": {
"type": "string",
"enum": [
"year",
"month",
"day",
"hour",
"minute"
]
},
"place": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"tags": {
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"feed_targeting": {
"type": "object",
"properties": {
"age_min": {
"type": "integer",
"minimum": 13,
"maximum": 65
},
"age_max": {
"type": "integer",
"minimum": 13,
"maximum": 65
},
"college_years": {
"maxItems": 100,
"type": "array",
"items": {
"type": "integer",
"minimum": 1900,
"maximum": 2200
}
},
"education_statuses": {
"maxItems": 3,
"type": "array",
"items": {
"anyOf": [
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 2
},
{
"type": "number",
"const": 3
}
]
}
},
"genders": {
"maxItems": 2,
"type": "array",
"items": {
"anyOf": [
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 2
}
]
}
},
"geo_locations": {
"type": "object",
"properties": {
"countries": {
"minItems": 1,
"maxItems": 25,
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Z]{2}$"
}
},
"regions": {
"minItems": 1,
"maxItems": 250,
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
]
}
},
"required": [
"key"
],
"additionalProperties": false
}
},
"cities": {
"minItems": 1,
"maxItems": 250,
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
]
},
"radius": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000
},
"distance_unit": {
"type": "string",
"enum": [
"mile",
"kilometer"
]
}
},
"required": [
"key"
],
"additionalProperties": false
}
},
"zips": {
"minItems": 1,
"maxItems": 250,
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
]
}
},
"required": [
"key"
],
"additionalProperties": false
}
},
"location_types": {
"minItems": 1,
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"enum": [
"home",
"recent"
]
}
}
},
"additionalProperties": false
},
"interests": {
"maxItems": 250,
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
]
}
},
"locales": {
"maxItems": 250,
"type": "array",
"items": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"relationship_statuses": {
"maxItems": 4,
"type": "array",
"items": {
"anyOf": [
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 2
},
{
"type": "number",
"const": 3
},
{
"type": "number",
"const": 4
}
]
}
}
},
"additionalProperties": false
},
"targeting": {
"type": "object",
"properties": {
"age_min": {
"anyOf": [
{
"type": "number",
"const": 13
},
{
"type": "number",
"const": 15
},
{
"type": "number",
"const": 18
},
{
"type": "number",
"const": 21
},
{
"type": "number",
"const": 25
}
]
},
"geo_locations": {
"type": "object",
"properties": {
"countries": {
"minItems": 1,
"maxItems": 25,
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Z]{2}$"
}
},
"regions": {
"minItems": 1,
"maxItems": 250,
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
]
}
},
"required": [
"key"
],
"additionalProperties": false
}
},
"cities": {
"minItems": 1,
"maxItems": 250,
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
]
},
"radius": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000
},
"distance_unit": {
"type": "string",
"enum": [
"mile",
"kilometer"
]
}
},
"required": [
"key"
],
"additionalProperties": false
}
},
"zips": {
"minItems": 1,
"maxItems": 250,
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
]
}
},
"required": [
"key"
],
"additionalProperties": false
}
},
"location_types": {
"minItems": 1,
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"enum": [
"home",
"recent"
]
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"child_attachments": {
"minItems": 2,
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"link": {
"type": "string",
"format": "uri"
},
"name": {
"type": "string",
"maxLength": 255
},
"description": {
"type": "string",
"maxLength": 1000
},
"picture": {
"type": "string",
"format": "uri"
}
},
"required": [
"link",
"picture"
],
"additionalProperties": false
}
},
"multi_share_end_card": {
"type": "boolean"
},
"multi_share_optimized": {
"type": "boolean"
},
"unpublished_content_type": {
"type": "string",
"enum": [
"SCHEDULED",
"SCHEDULED_RECURRING",
"DRAFT",
"PUBLISH_PENDING",
"ADS_POST",
"INLINE_CREATED",
"PUBLISHED",
"REVIEWABLE_BRANDED_CONTENT"
]
},
"no_story": {
"type": "boolean"
},
"crossposted_video_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"spherical": {
"type": "boolean"
},
"media_options": {
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"asset_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"alt_text_custom": {
"type": "string",
"minLength": 1,
"maxLength": 1000
}
},
"required": [
"asset_id"
],
"additionalProperties": false
}
}
},
"required": [
"post_type"
],
"additionalProperties": false
}
},
"required": [
"platform",
"publish_options"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"platform": {
"type": "string",
"const": "threads"
},
"publish_options": {
"type": "object",
"properties": {
"post_type": {
"type": "string",
"enum": [
"TEXT",
"IMAGE",
"VIDEO",
"CAROUSEL",
"REPOST"
]
},
"reply_to_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"quote_post_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"repost_target_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"reply_control": {
"type": "string",
"enum": [
"everyone",
"accounts_you_follow",
"mentioned_only",
"parent_post_author_only",
"followers_only"
]
},
"enable_reply_approvals": {
"type": "boolean"
},
"link_attachment": {
"type": "string",
"format": "uri"
},
"poll_attachment": {
"type": "object",
"properties": {
"option_a": {
"type": "string",
"minLength": 1,
"maxLength": 25
},
"option_b": {
"type": "string",
"minLength": 1,
"maxLength": 25
},
"option_c": {
"type": "string",
"minLength": 1,
"maxLength": 25
},
"option_d": {
"type": "string",
"minLength": 1,
"maxLength": 25
}
},
"required": [
"option_a",
"option_b"
],
"additionalProperties": false
},
"gif_attachment": {
"type": "object",
"properties": {
"gif_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"provider": {
"type": "string",
"const": "GIPHY"
}
},
"required": [
"gif_id",
"provider"
],
"additionalProperties": false
},
"text_attachment": {
"type": "object",
"properties": {
"plaintext": {
"type": "string",
"minLength": 1,
"maxLength": 10000
},
"link_attachment_url": {
"type": "string",
"format": "uri"
},
"text_with_styling_info": {
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"length": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"styling_info": {
"minItems": 1,
"type": "array",
"items": {
"type": "string",
"enum": [
"bold",
"italic",
"highlight",
"underline",
"strikethrough"
]
}
}
},
"required": [
"offset",
"length",
"styling_info"
],
"additionalProperties": false
}
}
},
"required": [
"plaintext"
],
"additionalProperties": false
},
"topic_tag": {
"type": "string",
"minLength": 1,
"maxLength": 50
},
"text_entities": {
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"entity_type": {
"type": "string",
"enum": [
"SPOILER",
"spoiler"
]
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"length": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"entity_type",
"offset",
"length"
],
"additionalProperties": false
}
},
"is_spoiler_media": {
"type": "boolean"
},
"is_ghost_post": {
"type": "boolean"
},
"location_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"allowlisted_country_codes": {
"minItems": 1,
"maxItems": 249,
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Z]{2}$"
}
},
"crossreshare_to_ig": {
"type": "boolean"
},
"crossreshare_to_ig_dark_mode": {
"type": "boolean"
},
"auto_publish_text": {
"type": "boolean"
},
"media_options": {
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"asset_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"alt_text": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"is_spoiler_media": {
"type": "boolean"
}
},
"required": [
"asset_id"
],
"additionalProperties": false
}
}
},
"required": [
"post_type"
],
"additionalProperties": false
}
},
"required": [
"platform",
"publish_options"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"platform": {
"type": "string",
"const": "youtube"
},
"publish_options": {
"type": "object",
"properties": {
"post_type": {
"type": "string",
"const": "VIDEO"
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"description": {
"type": "string",
"maxLength": 5000
},
"tags": {
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"category_id": {
"anyOf": [
{
"type": "string",
"minLength": 0,
"maxLength": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
},
"default_language": {
"type": "string",
"minLength": 2,
"maxLength": 35
},
"localizations": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"description": {
"type": "string",
"maxLength": 5000
}
},
"required": [
"title",
"description"
],
"additionalProperties": false
}
},
"privacy_status": {
"type": "string",
"enum": [
"private",
"unlisted",
"public"
]
},
"cancellation_mode": {
"type": "string",
"enum": [
"DELETE",
"UNSCHEDULE_KEEP_PRIVATE"
]
},
"license": {
"type": "string",
"enum": [
"youtube",
"creativeCommon"
]
},
"embeddable": {
"type": "boolean"
},
"public_stats_viewable": {
"type": "boolean"
},
"self_declared_made_for_kids": {
"type": "boolean"
},
"contains_synthetic_media": {
"type": "boolean"
},
"has_paid_product_placement": {
"type": "boolean"
},
"recording_date": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"notify_subscribers": {
"type": "boolean"
},
"thumbnail_asset_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"surface_expectation": {
"type": "string",
"const": "SHORT"
},
"brand_partner": {
"type": "object",
"properties": {
"channel_id": {
"type": "string",
"pattern": "^UC[A-Za-z0-9_-]+$"
},
"channel_handle": {
"type": "string",
"pattern": "^@[A-Za-z0-9._-]+$"
}
},
"additionalProperties": false
}
},
"required": [
"post_type",
"title",
"privacy_status",
"cancellation_mode"
],
"additionalProperties": false
}
},
"required": [
"platform",
"publish_options"
],
"additionalProperties": false
}
]
},
"scheduled_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"display_timezone": {
"default": "UTC",
"type": "string",
"minLength": 1,
"maxLength": 80
},
"local_scheduled_at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
},
"schedule_dst_disambiguation": {
"type": "string",
"enum": [
"exact",
"earlier",
"later"
]
},
"expires_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
{
"type": "null"
}
]
},
"source_ref": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"automatic_retry_enabled": {
"default": true,
"type": "boolean"
},
"idempotency_key": {
"type": "string",
"minLength": 8,
"maxLength": 160
}
},
"required": [
"social_account_id",
"provider_payload",
"scheduled_at",
"idempotency_key"
],
"additionalProperties": false
}
}
},
"required": [
"workspace_id",
"targets"
],
"additionalProperties": false
}
},
"required": [
"id",
"expected_revision",
"mutation_id"
],
"additionalProperties": false
}Réponse et achèvement
Statuts HTTP de réussite : 200, 422. Lorsque l’opération est terminée: durable destination acceptance; provider publication is separate.
Une réponse HTTP réussie peut signifier qu’une requête est acceptée plutôt que terminée. Pour le travail en arrière-plan, conservez l’identifiant renvoyé et suivez la même opération jusqu’à sa fin. Une publication programmée ou acceptée n’est publiée que lorsque la plateforme le confirme ; une expiration côté client ne détermine pas le résultat.
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.
| Champ / branche | Type / requis | Contraintes |
|---|---|---|
$ | objectRequis dans le parent | — |
draft | objectRequis dans le parent | — |
draft.id | stringRequis dans le parent |
|
draft.workspace_id | stringRequis dans le parent |
|
draft.revision | integerRequis dans le parent |
|
draft.state | stringRequis dans le parent |
|
draft.content | objectRequis dans le parent | — |
draft.content.schemaVersion | numberRequis dans le parent |
|
draft.content.accountIds | arrayRequis dans le parent |
|
draft.content.accountIds[] | stringFacultatif / élément |
|
draft.content.caption | stringRequis dans le parent |
|
draft.content.hashtags | stringRequis dans le parent |
|
draft.content.assetIds | arrayRequis dans le parent |
|
draft.content.assetIds[] | stringFacultatif / élément |
|
draft.content.threadsTextOnly | booleanRequis dans le parent |
|
draft.content.instagramMode | stringRequis dans le parent |
|
draft.content.youtubeTitle | stringRequis dans le parent |
|
draft.content.youtubePrivacy | stringRequis dans le parent |
|
draft.content.youtubeSynthetic | booleanRequis dans le parent |
|
draft.content.youtubeCategoryId | stringRequis dans le parent |
|
draft.content.youtubeShort | booleanRequis dans le parent |
|
draft.content.linkUrl | stringRequis dans le parent |
|
draft.content.scheduledAt | stringRequis dans le parent |
|
draft.content.displayTimezone | stringRequis dans le parent |
|
draft.content.publishNow | booleanRequis dans le parent |
|
draft.content.destinationOverrides | objectRequis dans le parent |
|
draft.content.destinationOverrides.* | objectFacultatif / élément | — |
draft.content.destinationOverrides.*.caption | stringFacultatif / élément |
|
draft.content.destinationOverrides.*.scheduledAt | stringFacultatif / élément |
|
draft.content.expiresAt | stringRequis dans le parent |
|
draft.created_by | string | nullRequis dans le parent | — |
draft.created_byanyOf 1 | stringRequis dans le parent |
|
draft.created_byanyOf 2 | nullRequis dans le parent | — |
draft.updated_by | string | nullRequis dans le parent | — |
draft.updated_byanyOf 1 | stringRequis dans le parent |
|
draft.updated_byanyOf 2 | nullRequis dans le parent | — |
draft.created_at | stringRequis dans le parent |
|
draft.updated_at | stringRequis dans le parent |
|
draft.submission | object | nullRequis dans le parent | — |
draft.submissionanyOf 1 | objectRequis dans le parent | — |
draft.submission.idanyOf 1 | stringRequis dans le parent |
|
draft.submission.expected_revisionanyOf 1 | integerRequis dans le parent |
|
draft.submission.started_atanyOf 1 | stringRequis dans le parent |
|
draft.submission.receiptanyOf 1 | object | nullRequis dans le parent | — |
draft.submission.receiptanyOf 1 / anyOf 1 | objectRequis dans le parent | — |
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 | string | nullRequis dans le parent | — |
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 / anyOf 1 | stringRequis dans le parent |
|
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 / anyOf 2 | nullRequis dans le parent | — |
draft.submission.receipt.successesanyOf 1 / anyOf 1 | arrayRequis dans le parent |
|
draft.submission.receipt.successes[]anyOf 1 / anyOf 1 | objectFacultatif / élément | — |
draft.submission.receipt.successes[].social_account_idanyOf 1 / anyOf 1 | stringRequis dans le parent |
|
draft.submission.receipt.successes[].post_idanyOf 1 / anyOf 1 | stringRequis dans le parent |
|
draft.submission.receipt.failuresanyOf 1 / anyOf 1 | arrayRequis dans le parent |
|
draft.submission.receipt.failures[]anyOf 1 / anyOf 1 | objectFacultatif / élément | — |
draft.submission.receipt.failures[].social_account_idanyOf 1 / anyOf 1 | stringRequis dans le parent |
|
draft.submission.receipt.failures[].codeanyOf 1 / anyOf 1 | stringRequis dans le parent |
|
draft.submission.receipt.failures[].messageanyOf 1 / anyOf 1 | stringRequis dans le parent |
|
draft.submission.receiptanyOf 1 / anyOf 2 | nullRequis dans le parent | — |
draft.submissionanyOf 2 | nullRequis dans le parent | — |
result | objectRequis dans le parent | — |
result.batch_id | string | nullRequis dans le parent | — |
result.batch_idanyOf 1 | stringRequis dans le parent |
|
result.batch_idanyOf 2 | nullRequis dans le parent | — |
result.successes | arrayRequis dans le parent | — |
result.successes[] | objectFacultatif / élément | — |
result.successes[].social_account_id | stringRequis dans le parent |
|
result.successes[].post | objectRequis dans le parent | — |
result.successes[].post.id | stringRequis dans le parent |
|
result.successes[].post.workspace_id | stringRequis dans le parent |
|
result.successes[].post.social_account_id | string | nullRequis dans le parent | — |
result.successes[].post.social_account_idanyOf 1 | stringRequis dans le parent |
|
result.successes[].post.social_account_idanyOf 2 | nullRequis dans le parent | — |
result.successes[].post.platform | stringRequis dans le parent |
|
result.successes[].post.destination | objectRequis dans le parent | — |
result.successes[].post.destination.social_account_id | string | nullRequis dans le parent | — |
result.successes[].post.destination.social_account_idanyOf 1 | stringRequis dans le parent |
|
result.successes[].post.destination.social_account_idanyOf 2 | nullRequis dans le parent | — |
result.successes[].post.destination.platform | stringRequis dans le parent |
|
result.successes[].post.destination.platform_user_id | string | nullRequis dans le parent | — |
result.successes[].post.destination.platform_user_idanyOf 1 | stringRequis dans le parent | — |
result.successes[].post.destination.platform_user_idanyOf 2 | nullRequis dans le parent | — |
result.successes[].post.destination.account_label | string | nullRequis dans le parent | — |
result.successes[].post.destination.account_labelanyOf 1 | stringRequis dans le parent | — |
result.successes[].post.destination.account_labelanyOf 2 | nullRequis dans le parent | — |
result.successes[].post.caption | string | nullRequis dans le parent | — |
result.successes[].post.captionanyOf 1 | stringRequis dans le parent | — |
result.successes[].post.captionanyOf 2 | nullRequis dans le parent | — |
result.successes[].post.hashtags | arrayRequis dans le parent | — |
result.successes[].post.hashtags[] | stringFacultatif / élément | — |
result.successes[].post.media | arrayRequis dans le parent | — |
result.successes[].post.media[] | objectFacultatif / élément | — |
result.successes[].post.media[].kind | stringRequis dans le parent |
|
result.successes[].post.media[].url | stringRequis dans le parent |
|
result.successes[].post.media[].cover_url | string | nullFacultatif / élément | — |
result.successes[].post.media[].cover_urlanyOf 1 | stringFacultatif / élément |
|
result.successes[].post.media[].cover_urlanyOf 2 | nullFacultatif / élément | — |
result.successes[].post.media[].cover_asset_id | integer | nullFacultatif / élément | — |
result.successes[].post.media[].cover_asset_idanyOf 1 | integerFacultatif / élément |
|
result.successes[].post.media[].cover_asset_idanyOf 2 | nullFacultatif / élément | — |
result.successes[].post.media[].asset_id | integer | nullFacultatif / élément | — |
result.successes[].post.media[].asset_idanyOf 1 | integerFacultatif / élément |
|
result.successes[].post.media[].asset_idanyOf 2 | nullFacultatif / élément | — |
result.successes[].post.media[].mime_type | string | nullFacultatif / élément | — |
result.successes[].post.media[].mime_typeanyOf 1 | stringFacultatif / élément |
|
result.successes[].post.media[].mime_typeanyOf 2 | nullFacultatif / élément | — |
result.successes[].post.media[].preview_url | string | nullFacultatif / élément | URL de lecture temporaire autorisée ; conservez url comme identité persistante du média Scheduled Post. — |
result.successes[].post.media[].preview_urlanyOf 1 | stringFacultatif / élément |
|
result.successes[].post.media[].preview_urlanyOf 2 | nullFacultatif / élément | — |
result.successes[].post.media[].cover_preview_url | string | nullFacultatif / élément | URL temporaire autorisée de lecture de couverture ; conservez cover_url comme identité persistante du média. — |
result.successes[].post.media[].cover_preview_urlanyOf 1 | stringFacultatif / élément |
|
result.successes[].post.media[].cover_preview_urlanyOf 2 | nullFacultatif / élément | — |
result.successes[].post.media[].preview_expires_at | string | nullFacultatif / élément | — |
result.successes[].post.media[].preview_expires_atanyOf 1 | stringFacultatif / élément |
|
result.successes[].post.media[].preview_expires_atanyOf 2 | nullFacultatif / élément | — |
result.successes[].post.link_url | string | nullFacultatif / élément | — |
result.successes[].post.link_urlanyOf 1 | stringFacultatif / élément |
|
result.successes[].post.link_urlanyOf 2 | nullFacultatif / élément | — |
result.successes[].post.publish_options | objectRequis dans le parent | — |
result.successes[].post.publish_options.post_type | stringFacultatif / élément |
|
result.successes[].post.publish_options.location_id | stringFacultatif / élément |
|
result.successes[].post.publish_options.share_to_feed | booleanFacultatif / élément | — |
result.successes[].post.publish_options.collaborators | arrayFacultatif / élément |
|
result.successes[].post.publish_options.collaborators[] | stringFacultatif / élément |
|
result.successes[].post.publish_options.first_comment | stringFacultatif / élément |
|
result.successes[].post.publish_options.topic_tag | stringFacultatif / élément |
|
result.successes[].post.publish_options.thumb_offset_ms | integerFacultatif / élément |
|
result.successes[].post.publish_options.title | stringFacultatif / élément |
|
result.successes[].post.publish_options.youtube_privacy_status | stringFacultatif / élément |
|
result.successes[].post.publish_options.youtube_category_id | stringFacultatif / élément |
|
result.successes[].post.publish_options.youtube_contains_synthetic_media | booleanFacultatif / élément | — |
result.successes[].post.publish_options.description | stringFacultatif / élément |
|
result.successes[].post.publish_options.category_id | stringFacultatif / élément |
|
result.successes[].post.publish_options.privacy_status | stringFacultatif / élément |
|
result.successes[].post.publish_options.cancellation_mode | stringFacultatif / élément |
|
result.successes[].post.publish_options.tags | arrayFacultatif / élément | — |
result.successes[].post.publish_options.tags[] | stringFacultatif / élément | — |
result.successes[].post.publish_options.default_language | stringFacultatif / élément | — |
result.successes[].post.publish_options.localizations | objectFacultatif / élément |
|
result.successes[].post.publish_options.localizations.* | any JSON valueFacultatif / élément | — |
result.successes[].post.publish_options.license | stringFacultatif / élément |
|
result.successes[].post.publish_options.embeddable | booleanFacultatif / élément | — |
result.successes[].post.publish_options.public_stats_viewable | booleanFacultatif / élément | — |
result.successes[].post.publish_options.self_declared_made_for_kids | booleanFacultatif / élément | — |
result.successes[].post.publish_options.contains_synthetic_media | booleanFacultatif / élément | — |
result.successes[].post.publish_options.has_paid_product_placement | booleanFacultatif / élément | — |
result.successes[].post.publish_options.recording_date | stringFacultatif / élément | — |
result.successes[].post.publish_options.notify_subscribers | booleanFacultatif / élément | — |
result.successes[].post.publish_options.thumbnail_asset_id | integerFacultatif / élément |
|
result.successes[].post.publish_options.surface_expectation | stringFacultatif / élément |
|
result.successes[].post.publish_options.brand_partner | objectFacultatif / élément |
|
result.successes[].post.publish_options.brand_partner.* | any JSON valueFacultatif / élément | — |
result.successes[].post.publish_options.cover_asset_id | integerFacultatif / élément |
|
result.successes[].post.publish_options.audio_name | stringFacultatif / élément | — |
result.successes[].post.publish_options.trial_params | objectFacultatif / élément |
|
result.successes[].post.publish_options.trial_params.* | any JSON valueFacultatif / élément | — |
result.successes[].post.publish_options.is_ai_generated | booleanFacultatif / élément | — |
result.successes[].post.publish_options.branded_content_sponsor_ids | arrayFacultatif / élément | — |
result.successes[].post.publish_options.branded_content_sponsor_ids[] | stringFacultatif / élément | — |
result.successes[].post.publish_options.is_paid_partnership | booleanFacultatif / élément | — |
result.successes[].post.publish_options.media_options | arrayFacultatif / élément | — |
result.successes[].post.publish_options.media_options[] | objectFacultatif / élément |
|
result.successes[].post.publish_options.media_options[].* | any JSON valueFacultatif / élément | — |
result.successes[].post.publish_options.reply_to_id | stringFacultatif / élément | — |
result.successes[].post.publish_options.quote_post_id | stringFacultatif / élément | — |
result.successes[].post.publish_options.repost_target_id | stringFacultatif / élément | — |
result.successes[].post.publish_options.reply_control | stringFacultatif / élément | — |
result.successes[].post.publish_options.enable_reply_approvals | booleanFacultatif / élément | — |
result.successes[].post.publish_options.link_attachment | stringFacultatif / élément |
|
result.successes[].post.publish_options.poll_attachment | objectFacultatif / élément |
|
result.successes[].post.publish_options.poll_attachment.* | any JSON valueFacultatif / élément | — |
result.successes[].post.publish_options.gif_attachment | objectFacultatif / élément |
|
result.successes[].post.publish_options.gif_attachment.* | any JSON valueFacultatif / élément | — |
result.successes[].post.publish_options.text_attachment | objectFacultatif / élément |
|
result.successes[].post.publish_options.text_attachment.* | any JSON valueFacultatif / élément | — |
result.successes[].post.publish_options.text_entities | arrayFacultatif / élément | — |
result.successes[].post.publish_options.text_entities[] | objectFacultatif / élément |
|
result.successes[].post.publish_options.text_entities[].* | any JSON valueFacultatif / élément | — |
result.successes[].post.publish_options.is_spoiler_media | booleanFacultatif / élément | — |
result.successes[].post.publish_options.is_ghost_post | booleanFacultatif / élément | — |
result.successes[].post.publish_options.allowlisted_country_codes | arrayFacultatif / élément | — |
result.successes[].post.publish_options.allowlisted_country_codes[] | stringFacultatif / élément | — |
result.successes[].post.publish_options.crossreshare_to_ig | booleanFacultatif / élément | — |
result.successes[].post.publish_options.crossreshare_to_ig_dark_mode | booleanFacultatif / élément | — |
result.successes[].post.publish_options.auto_publish_text | booleanFacultatif / élément | — |
result.successes[].post.publish_options.publication_mode | stringFacultatif / élément |
|
result.successes[].post.publish_options.backdated_time | numberFacultatif / élément | — |
result.successes[].post.publish_options.backdated_time_granularity | stringFacultatif / élément |
|
result.successes[].post.publish_options.place | stringFacultatif / élément | — |
result.successes[].post.publish_options.feed_targeting | objectFacultatif / élément |
|
result.successes[].post.publish_options.feed_targeting.* | any JSON valueFacultatif / élément | — |
result.successes[].post.publish_options.targeting | objectFacultatif / élément |
|
result.successes[].post.publish_options.targeting.* | any JSON valueFacultatif / élément | — |
result.successes[].post.publish_options.child_attachments | arrayFacultatif / élément | — |
result.successes[].post.publish_options.child_attachments[] | objectFacultatif / élément |
|
result.successes[].post.publish_options.child_attachments[].* | any JSON valueFacultatif / élément | — |
result.successes[].post.publish_options.multi_share_end_card | booleanFacultatif / élément | — |
result.successes[].post.publish_options.multi_share_optimized | booleanFacultatif / élément | — |
result.successes[].post.publish_options.unpublished_content_type | stringFacultatif / élément | — |
result.successes[].post.publish_options.no_story | booleanFacultatif / élément | — |
result.successes[].post.publish_options.crossposted_video_id | stringFacultatif / élément | — |
result.successes[].post.publish_options.spherical | booleanFacultatif / élément | — |
result.successes[].post.scheduled_at | stringRequis dans le parent | — |
result.successes[].post.display_timezone | stringRequis dans le parent |
|
result.successes[].post.local_scheduled_at | string | nullFacultatif / élément | — |
result.successes[].post.local_scheduled_atanyOf 1 | stringFacultatif / élément |
|
result.successes[].post.local_scheduled_atanyOf 2 | nullFacultatif / élément | — |
result.successes[].post.schedule_timezone | string | nullFacultatif / élément | — |
result.successes[].post.schedule_timezoneanyOf 1 | stringFacultatif / élément |
|
result.successes[].post.schedule_timezoneanyOf 2 | nullFacultatif / élément | — |
result.successes[].post.schedule_dst_disambiguation | string | nullFacultatif / élément | — |
result.successes[].post.schedule_dst_disambiguationanyOf 1 | stringFacultatif / élément |
|
result.successes[].post.schedule_dst_disambiguationanyOf 2 | nullFacultatif / élément | — |
result.successes[].post.schedule_intent_state | stringFacultatif / élément |
|
result.successes[].post.expires_at | string | nullRequis dans le parent | — |
result.successes[].post.expires_atanyOf 1 | stringRequis dans le parent | — |
result.successes[].post.expires_atanyOf 2 | nullRequis dans le parent | — |
result.successes[].post.status | stringRequis dans le parent |
|
result.successes[].post.version | integerRequis dans le parent |
|
result.successes[].post.automatic_retry_enabled | booleanRequis dans le parent | — |
result.successes[].post.delete_requested_at | string | nullRequis dans le parent | — |
result.successes[].post.delete_requested_atanyOf 1 | stringRequis dans le parent | — |
result.successes[].post.delete_requested_atanyOf 2 | nullRequis dans le parent | — |
result.successes[].post.published_at | string | nullRequis dans le parent | — |
result.successes[].post.published_atanyOf 1 | stringRequis dans le parent | — |
result.successes[].post.published_atanyOf 2 | nullRequis dans le parent | — |
result.successes[].post.deleted_at | string | nullRequis dans le parent | — |
result.successes[].post.deleted_atanyOf 1 | stringRequis dans le parent | — |
result.successes[].post.deleted_atanyOf 2 | nullRequis dans le parent | — |
result.successes[].post.provider_post_id | string | nullRequis dans le parent | — |
result.successes[].post.provider_post_idanyOf 1 | stringRequis dans le parent | — |
result.successes[].post.provider_post_idanyOf 2 | nullRequis dans le parent | — |
result.successes[].post.permalink | string | nullRequis dans le parent | — |
result.successes[].post.permalinkanyOf 1 | stringRequis dans le parent |
|
result.successes[].post.permalinkanyOf 2 | nullRequis dans le parent | — |
result.successes[].post.created_at | stringRequis dans le parent | — |
result.successes[].post.updated_at | stringRequis dans le parent | — |
result.successes[].post.project_id | string | nullRequis dans le parent | — |
result.successes[].post.project_idanyOf 1 | stringRequis dans le parent |
|
result.successes[].post.project_idanyOf 2 | nullRequis dans le parent | — |
result.successes[].post.batch_id | string | nullRequis dans le parent | — |
result.successes[].post.batch_idanyOf 1 | stringRequis dans le parent |
|
result.successes[].post.batch_idanyOf 2 | nullRequis dans le parent | — |
result.successes[].post.source_ref | object | nullRequis dans le parent | — |
result.successes[].post.source_refanyOf 1 | objectRequis dans le parent |
|
result.successes[].post.source_ref.*anyOf 1 | any JSON valueFacultatif / élément | — |
result.successes[].post.source_refanyOf 2 | nullRequis dans le parent | — |
result.failures | arrayRequis dans le parent | — |
result.failures[] | objectFacultatif / élément | — |
result.failures[].social_account_id | stringRequis dans le parent |
|
result.failures[].code | stringRequis dans le parent | — |
result.failures[].message | stringRequis dans le parent | — |
JSON Schema complet
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"draft": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"state": {
"type": "string",
"enum": [
"draft",
"submitting",
"submitted"
]
},
"content": {
"type": "object",
"properties": {
"schemaVersion": {
"default": 1,
"type": "number",
"const": 1
},
"accountIds": {
"default": [],
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"caption": {
"default": "",
"type": "string",
"maxLength": 5000
},
"hashtags": {
"default": "",
"type": "string",
"maxLength": 5000
},
"assetIds": {
"default": [],
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"maxLength": 16,
"pattern": "^[1-9][0-9]*$"
}
},
"threadsTextOnly": {
"default": false,
"type": "boolean"
},
"instagramMode": {
"default": "REELS",
"type": "string",
"enum": [
"IMAGE",
"REELS",
"CAROUSEL",
"STORY_IMAGE",
"STORY_VIDEO"
]
},
"youtubeTitle": {
"default": "",
"type": "string",
"maxLength": 100
},
"youtubePrivacy": {
"default": "private",
"type": "string",
"enum": [
"private",
"unlisted",
"public"
]
},
"youtubeSynthetic": {
"default": false,
"type": "boolean"
},
"youtubeCategoryId": {
"default": "",
"type": "string",
"maxLength": 32
},
"youtubeShort": {
"default": false,
"type": "boolean"
},
"linkUrl": {
"default": "",
"type": "string",
"maxLength": 2048
},
"scheduledAt": {
"default": "",
"type": "string",
"maxLength": 64
},
"displayTimezone": {
"default": "UTC",
"type": "string",
"minLength": 1,
"maxLength": 128
},
"publishNow": {
"default": false,
"type": "boolean"
},
"destinationOverrides": {
"default": {},
"type": "object",
"propertyNames": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"additionalProperties": {
"type": "object",
"properties": {
"caption": {
"type": "string",
"maxLength": 5000
},
"scheduledAt": {
"type": "string",
"maxLength": 64
}
}
}
},
"expiresAt": {
"default": "",
"type": "string",
"maxLength": 64
}
},
"required": [
"schemaVersion",
"accountIds",
"caption",
"hashtags",
"assetIds",
"threadsTextOnly",
"instagramMode",
"youtubeTitle",
"youtubePrivacy",
"youtubeSynthetic",
"youtubeCategoryId",
"youtubeShort",
"linkUrl",
"scheduledAt",
"displayTimezone",
"publishNow",
"destinationOverrides",
"expiresAt"
]
},
"created_by": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
]
},
"updated_by": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
]
},
"created_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)))$"
},
"updated_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)))$"
},
"submission": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"expected_revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"started_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)))$"
},
"receipt": {
"anyOf": [
{
"type": "object",
"properties": {
"batch_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
]
},
"successes": {
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"social_account_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"post_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
}
},
"required": [
"social_account_id",
"post_id"
]
}
},
"failures": {
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"social_account_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"code": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"message": {
"type": "string",
"maxLength": 2000
}
},
"required": [
"social_account_id",
"code",
"message"
]
}
}
},
"required": [
"batch_id",
"successes",
"failures"
]
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"expected_revision",
"started_at",
"receipt"
]
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"workspace_id",
"revision",
"state",
"content",
"created_by",
"updated_by",
"created_at",
"updated_at",
"submission"
]
},
"result": {
"type": "object",
"properties": {
"batch_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
]
},
"successes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"social_account_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"post": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"social_account_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
]
},
"platform": {
"type": "string",
"enum": [
"instagram",
"threads",
"facebook",
"youtube",
"x"
]
},
"destination": {
"type": "object",
"properties": {
"social_account_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
]
},
"platform": {
"type": "string",
"enum": [
"instagram",
"threads",
"facebook",
"youtube",
"x"
]
},
"platform_user_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"account_label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"social_account_id",
"platform",
"platform_user_id",
"account_label"
]
},
"caption": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"hashtags": {
"type": "array",
"items": {
"type": "string"
}
},
"media": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"image",
"video"
]
},
"url": {
"type": "string",
"format": "uri"
},
"cover_url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"cover_asset_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"asset_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"mime_type": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 160
},
{
"type": "null"
}
]
},
"preview_url": {
"description": "Temporary authorized read URL; keep url as persisted Scheduled Post media identity.",
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"cover_preview_url": {
"description": "Temporary authorized cover read URL; keep cover_url as persisted media identity.",
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"preview_expires_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
{
"type": "null"
}
]
}
},
"required": [
"kind",
"url"
]
}
},
"link_url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"publish_options": {
"type": "object",
"properties": {
"post_type": {
"type": "string",
"enum": [
"TEXT",
"LINK",
"IMAGE",
"MULTI_IMAGE",
"VIDEO",
"CAROUSEL",
"REELS",
"STORY_IMAGE",
"STORY_VIDEO",
"REPOST",
"SHORT"
]
},
"location_id": {
"type": "string",
"minLength": 1
},
"share_to_feed": {
"type": "boolean"
},
"collaborators": {
"maxItems": 3,
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"first_comment": {
"type": "string",
"minLength": 1,
"maxLength": 2200
},
"topic_tag": {
"type": "string",
"minLength": 1
},
"thumb_offset_ms": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"title": {
"type": "string",
"maxLength": 255
},
"youtube_privacy_status": {
"type": "string",
"enum": [
"private",
"unlisted",
"public"
]
},
"youtube_category_id": {
"type": "string",
"pattern": "^\\d+$"
},
"youtube_contains_synthetic_media": {
"type": "boolean"
},
"description": {
"type": "string",
"maxLength": 5000
},
"category_id": {
"type": "string",
"pattern": "^\\d+$"
},
"privacy_status": {
"type": "string",
"enum": [
"private",
"unlisted",
"public"
]
},
"cancellation_mode": {
"type": "string",
"enum": [
"DELETE",
"UNSCHEDULE_KEEP_PRIVATE"
]
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"default_language": {
"type": "string"
},
"localizations": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"license": {
"type": "string",
"enum": [
"youtube",
"creativeCommon"
]
},
"embeddable": {
"type": "boolean"
},
"public_stats_viewable": {
"type": "boolean"
},
"self_declared_made_for_kids": {
"type": "boolean"
},
"contains_synthetic_media": {
"type": "boolean"
},
"has_paid_product_placement": {
"type": "boolean"
},
"recording_date": {
"type": "string"
},
"notify_subscribers": {
"type": "boolean"
},
"thumbnail_asset_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"surface_expectation": {
"type": "string",
"const": "SHORT"
},
"brand_partner": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"cover_asset_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"audio_name": {
"type": "string"
},
"trial_params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"is_ai_generated": {
"type": "boolean"
},
"branded_content_sponsor_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"is_paid_partnership": {
"type": "boolean"
},
"media_options": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"reply_to_id": {
"type": "string"
},
"quote_post_id": {
"type": "string"
},
"repost_target_id": {
"type": "string"
},
"reply_control": {
"type": "string"
},
"enable_reply_approvals": {
"type": "boolean"
},
"link_attachment": {
"type": "string",
"format": "uri"
},
"poll_attachment": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"gif_attachment": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"text_attachment": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"text_entities": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"is_spoiler_media": {
"type": "boolean"
},
"is_ghost_post": {
"type": "boolean"
},
"allowlisted_country_codes": {
"type": "array",
"items": {
"type": "string"
}
},
"crossreshare_to_ig": {
"type": "boolean"
},
"crossreshare_to_ig_dark_mode": {
"type": "boolean"
},
"auto_publish_text": {
"type": "boolean"
},
"publication_mode": {
"type": "string",
"enum": [
"PUBLISH",
"DRAFT"
]
},
"backdated_time": {
"type": "number"
},
"backdated_time_granularity": {
"type": "string",
"enum": [
"year",
"month",
"day",
"hour",
"minute"
]
},
"place": {
"type": "string"
},
"feed_targeting": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"targeting": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"child_attachments": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"multi_share_end_card": {
"type": "boolean"
},
"multi_share_optimized": {
"type": "boolean"
},
"unpublished_content_type": {
"type": "string"
},
"no_story": {
"type": "boolean"
},
"crossposted_video_id": {
"type": "string"
},
"spherical": {
"type": "boolean"
}
}
},
"scheduled_at": {
"type": "string"
},
"display_timezone": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"local_scheduled_at": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
},
{
"type": "null"
}
]
},
"schedule_timezone": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 80
},
{
"type": "null"
}
]
},
"schedule_dst_disambiguation": {
"anyOf": [
{
"type": "string",
"enum": [
"exact",
"earlier",
"later"
]
},
{
"type": "null"
}
]
},
"schedule_intent_state": {
"type": "string",
"enum": [
"verified",
"legacy_unverified"
]
},
"expires_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"type": "string",
"enum": [
"scheduled",
"publishing",
"published",
"failed",
"expired",
"needs_reschedule",
"cancelled",
"deleted"
]
},
"version": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"automatic_retry_enabled": {
"type": "boolean"
},
"delete_requested_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"published_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"deleted_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"provider_post_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"permalink": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"created_at": {
"type": "string"
},
"updated_at": {
"type": "string"
},
"project_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
]
},
"batch_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
]
},
"source_ref": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"workspace_id",
"social_account_id",
"platform",
"destination",
"caption",
"hashtags",
"media",
"publish_options",
"scheduled_at",
"display_timezone",
"expires_at",
"status",
"version",
"automatic_retry_enabled",
"delete_requested_at",
"published_at",
"deleted_at",
"provider_post_id",
"permalink",
"created_at",
"updated_at",
"project_id",
"batch_id",
"source_ref"
]
}
},
"required": [
"social_account_id",
"post"
]
}
},
"failures": {
"type": "array",
"items": {
"type": "object",
"properties": {
"social_account_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"social_account_id",
"code",
"message"
]
}
}
},
"required": [
"batch_id",
"successes",
"failures"
]
}
},
"required": [
"draft",
"result"
]
}Erreurs et nouvelles tentatives sûres
Vérifiez le statut HTTP et le corps de réponse. Une erreur de validation 400 peut contenir un ZodError ; les erreurs des gestionnaires utilisent les champs error, message et code. Conservez request_id ou x-request-id pour le diagnostic, sans identifiants secrets. Corrigez les erreurs d’accès 401/403 avant de réessayer et respectez Retry-After pour 429. Si une écriture est incertaine ou renvoie 5xx, lisez d’abord le résultat existant. Réutilisez une clé d’idempotence uniquement lorsque c’est pris en charge ; le comportement des nouvelles tentatives varie selon l’opération et ne garantit pas une diffusion exactement une fois.
Guide de dépannageExemples
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.
Définissez SOSOAPI_ACCESS_TOKEN sur votre serveur avec un identifiant accepté par cette opération et gardez-le hors du code navigateur. Pour un agent, utilisez sosoapi auth login pour vous connecter dans le navigateur et laissez la CLI actualiser ses identifiants.
request.json
{
"id": "44444444-4444-4444-8444-444444444444",
"expected_revision": 2,
"mutation_id": "77777777-7777-4777-8777-777777777777",
"content": {
"schemaVersion": 1,
"accountIds": [
"22222222-2222-4222-8222-222222222222"
],
"caption": "A fictional announcement approved for this example.",
"hashtags": "",
"assetIds": [],
"threadsTextOnly": false,
"instagramMode": "REELS",
"youtubeTitle": "",
"youtubePrivacy": "private",
"youtubeSynthetic": false,
"youtubeCategoryId": "",
"youtubeShort": false,
"linkUrl": "",
"scheduledAt": "2099-01-15T09:00:00",
"displayTimezone": "UTC",
"publishNow": false,
"destinationOverrides": {},
"expiresAt": ""
},
"request": {
"workspace_id": "11111111-1111-4111-8111-111111111111",
"targets": [
{
"social_account_id": "22222222-2222-4222-8222-222222222222",
"caption": "A fictional announcement approved for this example.",
"hashtags": [],
"media": [],
"provider_payload": {
"platform": "x",
"publish_options": {
"post_type": "TEXT"
}
},
"scheduled_at": "2099-01-15T09:00:00Z",
"display_timezone": "UTC",
"idempotency_key": "example-target-0001"
}
]
}
}cURL
curl --request POST \
"https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/content-drafts/submit" \
-H "Authorization: Bearer $SOSOAPI_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
--data-binary @request.jsonJavaScript
// Server-side JavaScript. Do not print tokens or credential-bearing responses.
const token = process.env.SOSOAPI_ACCESS_TOKEN;
if (!token) throw new Error("Set an accepted credential for this operation");
const response = await fetch("https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/content-drafts/submit", {
method: "POST",
headers: { "Content-Type": "application/json", Authorization: "Bearer " + token },
body: JSON.stringify({
"id": "44444444-4444-4444-8444-444444444444",
"expected_revision": 2,
"mutation_id": "77777777-7777-4777-8777-777777777777",
"content": {
"schemaVersion": 1,
"accountIds": [
"22222222-2222-4222-8222-222222222222"
],
"caption": "A fictional announcement approved for this example.",
"hashtags": "",
"assetIds": [],
"threadsTextOnly": false,
"instagramMode": "REELS",
"youtubeTitle": "",
"youtubePrivacy": "private",
"youtubeSynthetic": false,
"youtubeCategoryId": "",
"youtubeShort": false,
"linkUrl": "",
"scheduledAt": "2099-01-15T09:00:00",
"displayTimezone": "UTC",
"publishNow": false,
"destinationOverrides": {},
"expiresAt": ""
},
"request": {
"workspace_id": "11111111-1111-4111-8111-111111111111",
"targets": [
{
"social_account_id": "22222222-2222-4222-8222-222222222222",
"caption": "A fictional announcement approved for this example.",
"hashtags": [],
"media": [],
"provider_payload": {
"platform": "x",
"publish_options": {
"post_type": "TEXT"
}
},
"scheduled_at": "2099-01-15T09:00:00Z",
"display_timezone": "UTC",
"idempotency_key": "example-target-0001"
}
]
}
})
});
const result = await response.json();
// Check response.ok, the operation-specific body and completion state before continuing.CLI
npx sosoapi api post /studio-api/content-drafts/submit < request.jsonExemple de réponse fictive
{
"draft": {
"id": "44444444-4444-4444-8444-444444444444",
"workspace_id": "11111111-1111-4111-8111-111111111111",
"revision": 2,
"state": "draft",
"content": {
"schemaVersion": 1,
"accountIds": [
"22222222-2222-4222-8222-222222222222"
],
"caption": "A fictional announcement approved for this example.",
"hashtags": "",
"assetIds": [],
"threadsTextOnly": false,
"instagramMode": "REELS",
"youtubeTitle": "",
"youtubePrivacy": "private",
"youtubeSynthetic": false,
"youtubeCategoryId": "",
"youtubeShort": false,
"linkUrl": "",
"scheduledAt": "2099-01-15T09:00:00",
"displayTimezone": "UTC",
"publishNow": false,
"destinationOverrides": {},
"expiresAt": ""
},
"created_by": null,
"updated_by": null,
"created_at": "2099-01-15T08:00:00Z",
"updated_at": "2099-01-15T08:30:00Z",
"submission": null
},
"result": {
"batch_id": null,
"successes": [],
"failures": [
{
"social_account_id": "22222222-2222-4222-8222-222222222222",
"code": "DESTINATION_INVALID",
"message": "This fictional destination needs repair before submission."
}
]
}
}