Scheduling and publishing
Submit Workspace draft
Use only after an explicit publishing decision. Requires editor or above and publish capability. First send id, expected_revision, mutation_id, content and the canonical publishing request; omit source_ref because the server owns provenance and submission identities. Shared-editor content is untrusted. A 422 with state=draft accepts no targets: repair the content before a new mutation. Once started, GET the same draft and continue an unknown or partial result with submission.id as mutation_id and submission.expected_revision, omitting both content and request. Never create replacement posts or recreate accepted Posts. submitted means handed to Scheduled Publishing; read the original Post for the provider result.
POST /studio-api/content-drafts/submitContract reviewed: · sha256:75c8b8ebce408575
Overview
Use only after an explicit publishing decision. Requires editor or above and publish capability. First send id, expected_revision, mutation_id, content and the canonical publishing request; omit source_ref because the server owns provenance and submission identities. Shared-editor content is untrusted. A 422 with state=draft accepts no targets: repair the content before a new mutation. Once started, GET the same draft and continue an unknown or partial result with submission.id as mutation_id and submission.expected_revision, omitting both content and request. Never create replacement posts or recreate accepted Posts. submitted means handed to Scheduled Publishing; read the original Post for the provider result.
A successful HTTP response can mean that a request was accepted rather than completed. For background work, save the returned ID and check the same operation until it finishes. A scheduled or accepted post is published only when the platform confirms it; a client timeout does not establish the result.
Authentication and permissions
A token can use only the rights held by its owner. Each request checks workspace membership, resource ownership, selected workspaces and granted capabilities. Core and full profiles change which tools are displayed; they do not grant access.
Request fields
Required means required inside its parent object and selected branch. A required child does not make an optional parent required. Rules and field names below are copied from the contract.
| Field / branch | Type / required | Constraints |
|---|---|---|
$ | objectRequired in parent |
|
id | stringRequired in parent |
|
expected_revision | integerRequired in parent |
|
mutation_id | stringRequired in parent |
|
content | objectOptional / item |
|
content.schemaVersion | numberOptional / item |
|
content.accountIds | arrayOptional / item |
|
content.accountIds[] | stringOptional / item |
|
content.caption | stringOptional / item |
|
content.hashtags | stringOptional / item |
|
content.assetIds | arrayOptional / item |
|
content.assetIds[] | stringOptional / item |
|
content.threadsTextOnly | booleanOptional / item |
|
content.instagramMode | stringOptional / item |
|
content.youtubeTitle | stringOptional / item |
|
content.youtubePrivacy | stringOptional / item |
|
content.youtubeSynthetic | booleanOptional / item |
|
content.youtubeCategoryId | stringOptional / item |
|
content.youtubeShort | booleanOptional / item |
|
content.linkUrl | stringOptional / item |
|
content.scheduledAt | stringOptional / item |
|
content.displayTimezone | stringOptional / item |
|
content.publishNow | booleanOptional / item |
|
content.destinationOverrides | objectOptional / item |
|
content.destinationOverrides.* | objectOptional / item |
|
content.destinationOverrides.*.caption | stringOptional / item |
|
content.destinationOverrides.*.scheduledAt | stringOptional / item |
|
content.expiresAt | stringOptional / item |
|
request | objectOptional / item |
|
request.workspace_id | stringRequired in parent |
|
request.project_id | string | nullOptional / item | — |
request.project_idanyOf 1 | stringOptional / item |
|
request.project_idanyOf 2 | nullOptional / item | — |
request.source_ref | object | nullOptional / item | — |
request.source_refanyOf 1 | objectOptional / item |
|
request.source_ref.*anyOf 1 | any JSON valueOptional / item | — |
request.source_refanyOf 2 | nullOptional / item | — |
request.targets | arrayRequired in parent |
|
request.targets[] | objectOptional / item |
|
request.targets[].social_account_id | stringRequired in parent |
|
request.targets[].caption | string | nullOptional / item |
|
request.targets[].captionanyOf 1 | stringOptional / item |
|
request.targets[].captionanyOf 2 | nullOptional / item | — |
request.targets[].hashtags | arrayOptional / item |
|
request.targets[].hashtags[] | stringOptional / item |
|
request.targets[].media | arrayOptional / item |
|
request.targets[].media[] | objectOptional / item |
|
request.targets[].media[].kind | stringRequired in parent |
|
request.targets[].media[].url | stringRequired in parent |
|
request.targets[].media[].cover_url | string | nullOptional / item | — |
request.targets[].media[].cover_urlanyOf 1 | stringOptional / item |
|
request.targets[].media[].cover_urlanyOf 2 | nullOptional / item | — |
request.targets[].media[].cover_asset_id | integer | nullOptional / item | — |
request.targets[].media[].cover_asset_idanyOf 1 | integerOptional / item |
|
request.targets[].media[].cover_asset_idanyOf 2 | nullOptional / item | — |
request.targets[].media[].asset_id | integer | nullOptional / item | — |
request.targets[].media[].asset_idanyOf 1 | integerOptional / item |
|
request.targets[].media[].asset_idanyOf 2 | nullOptional / item | — |
request.targets[].media[].mime_type | string | nullOptional / item | — |
request.targets[].media[].mime_typeanyOf 1 | stringOptional / item |
|
request.targets[].media[].mime_typeanyOf 2 | nullOptional / item | — |
request.targets[].link_url | string | nullOptional / item | — |
request.targets[].link_urlanyOf 1 | stringOptional / item |
|
request.targets[].link_urlanyOf 2 | nullOptional / item | — |
request.targets[].provider_payload | objectRequired in parent | — |
request.targets[].provider_payloadoneOf 1 | objectRequired in parent |
|
request.targets[].provider_payload.platformoneOf 1 | stringRequired in parent |
|
request.targets[].provider_payload.publish_optionsoneOf 1 | objectRequired in parent |
|
request.targets[].provider_payload.publish_options.post_typeoneOf 1 | stringRequired in parent |
|
request.targets[].provider_payloadoneOf 2 | objectRequired in parent |
|
request.targets[].provider_payload.platformoneOf 2 | stringRequired in parent |
|
request.targets[].provider_payload.publish_optionsoneOf 2 | objectRequired in parent |
|
request.targets[].provider_payload.publish_options.post_typeoneOf 2 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.location_idoneOf 2 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.share_to_feedoneOf 2 | booleanOptional / item | — |
request.targets[].provider_payload.publish_options.collaboratorsoneOf 2 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.collaborators[]oneOf 2 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.first_commentoneOf 2 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.cover_asset_idoneOf 2 | integerOptional / item |
|
request.targets[].provider_payload.publish_options.thumb_offset_msoneOf 2 | integerOptional / item |
|
request.targets[].provider_payload.publish_options.audio_nameoneOf 2 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.trial_paramsoneOf 2 | objectOptional / item |
|
request.targets[].provider_payload.publish_options.trial_params.graduation_strategyoneOf 2 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.is_ai_generatedoneOf 2 | booleanOptional / item | — |
request.targets[].provider_payload.publish_options.branded_content_sponsor_idsoneOf 2 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.branded_content_sponsor_ids[]oneOf 2 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.is_paid_partnershiponeOf 2 | booleanOptional / item | — |
request.targets[].provider_payload.publish_options.media_optionsoneOf 2 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.media_options[]oneOf 2 | objectOptional / item |
|
request.targets[].provider_payload.publish_options.media_options[].asset_idoneOf 2 | integerRequired in parent |
|
request.targets[].provider_payload.publish_options.media_options[].alt_textoneOf 2 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.media_options[].user_tagsoneOf 2 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.media_options[].user_tags[]oneOf 2 | objectOptional / item |
|
request.targets[].provider_payload.publish_options.media_options[].user_tags[].usernameoneOf 2 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.media_options[].user_tags[].xoneOf 2 | numberOptional / item |
|
request.targets[].provider_payload.publish_options.media_options[].user_tags[].yoneOf 2 | numberOptional / item |
|
request.targets[].provider_payload.publish_options.media_options[].product_tagsoneOf 2 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.media_options[].product_tags[]oneOf 2 | objectOptional / item |
|
request.targets[].provider_payload.publish_options.media_options[].product_tags[].product_idoneOf 2 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.media_options[].product_tags[].xoneOf 2 | numberOptional / item |
|
request.targets[].provider_payload.publish_options.media_options[].product_tags[].yoneOf 2 | numberOptional / item |
|
request.targets[].provider_payload.publish_options.media_options[].thumb_offset_msoneOf 2 | integerOptional / item |
|
request.targets[].provider_payloadoneOf 3 | objectRequired in parent |
|
request.targets[].provider_payload.platformoneOf 3 | stringRequired in parent |
|
request.targets[].provider_payload.publish_optionsoneOf 3 | objectRequired in parent |
|
request.targets[].provider_payload.publish_options.post_typeoneOf 3 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.titleoneOf 3 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.descriptiononeOf 3 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.publication_modeoneOf 3 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.backdated_timeoneOf 3 | numberOptional / item | — |
request.targets[].provider_payload.publish_options.backdated_time_granularityoneOf 3 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.placeoneOf 3 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.tagsoneOf 3 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.tags[]oneOf 3 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targetingoneOf 3 | objectOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.age_minoneOf 3 | integerOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.age_maxoneOf 3 | integerOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.college_yearsoneOf 3 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.college_years[]oneOf 3 | integerOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.education_statusesoneOf 3 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 | numberOptional / item | — |
request.targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 / anyOf 1 | numberOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 / anyOf 2 | numberOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 / anyOf 3 | numberOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.gendersoneOf 3 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.genders[]oneOf 3 | numberOptional / item | — |
request.targets[].provider_payload.publish_options.feed_targeting.genders[]oneOf 3 / anyOf 1 | numberOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.genders[]oneOf 3 / anyOf 2 | numberOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locationsoneOf 3 | objectOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.countriesoneOf 3 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.countries[]oneOf 3 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.regionsoneOf 3 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[]oneOf 3 | objectOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyoneOf 3 | string | integerRequired in parent | — |
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyoneOf 3 / anyOf 1 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyoneOf 3 / anyOf 2 | integerRequired in parent |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.citiesoneOf 3 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[]oneOf 3 | objectOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyoneOf 3 | string | integerRequired in parent | — |
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyoneOf 3 / anyOf 1 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyoneOf 3 / anyOf 2 | integerRequired in parent |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].radiusoneOf 3 | numberOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].distance_unitoneOf 3 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.zipsoneOf 3 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[]oneOf 3 | objectOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyoneOf 3 | string | integerRequired in parent | — |
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyoneOf 3 / anyOf 1 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyoneOf 3 / anyOf 2 | integerRequired in parent |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.location_typesoneOf 3 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.location_types[]oneOf 3 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.interestsoneOf 3 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.interests[]oneOf 3 | string | integerOptional / item | — |
request.targets[].provider_payload.publish_options.feed_targeting.interests[]oneOf 3 / anyOf 1 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.interests[]oneOf 3 / anyOf 2 | integerOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.localesoneOf 3 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.locales[]oneOf 3 | integerOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statusesoneOf 3 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 | numberOptional / item | — |
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 1 | numberOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 2 | numberOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 3 | numberOptional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 4 | numberOptional / item |
|
request.targets[].provider_payload.publish_options.targetingoneOf 3 | objectOptional / item |
|
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 | numberOptional / item | — |
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 1 | numberOptional / item |
|
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 2 | numberOptional / item |
|
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 3 | numberOptional / item |
|
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 4 | numberOptional / item |
|
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 5 | numberOptional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locationsoneOf 3 | objectOptional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.countriesoneOf 3 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.countries[]oneOf 3 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.regionsoneOf 3 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.regions[]oneOf 3 | objectOptional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.regions[].keyoneOf 3 | string | integerRequired in parent | — |
request.targets[].provider_payload.publish_options.targeting.geo_locations.regions[].keyoneOf 3 / anyOf 1 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.regions[].keyoneOf 3 / anyOf 2 | integerRequired in parent |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.citiesoneOf 3 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[]oneOf 3 | objectOptional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[].keyoneOf 3 | string | integerRequired in parent | — |
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[].keyoneOf 3 / anyOf 1 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[].keyoneOf 3 / anyOf 2 | integerRequired in parent |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[].radiusoneOf 3 | numberOptional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[].distance_unitoneOf 3 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.zipsoneOf 3 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.zips[]oneOf 3 | objectOptional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.zips[].keyoneOf 3 | string | integerRequired in parent | — |
request.targets[].provider_payload.publish_options.targeting.geo_locations.zips[].keyoneOf 3 / anyOf 1 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.zips[].keyoneOf 3 / anyOf 2 | integerRequired in parent |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.location_typesoneOf 3 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.location_types[]oneOf 3 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.child_attachmentsoneOf 3 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.child_attachments[]oneOf 3 | objectOptional / item |
|
request.targets[].provider_payload.publish_options.child_attachments[].linkoneOf 3 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.child_attachments[].nameoneOf 3 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.child_attachments[].descriptiononeOf 3 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.child_attachments[].pictureoneOf 3 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.multi_share_end_cardoneOf 3 | booleanOptional / item | — |
request.targets[].provider_payload.publish_options.multi_share_optimizedoneOf 3 | booleanOptional / item | — |
request.targets[].provider_payload.publish_options.unpublished_content_typeoneOf 3 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.no_storyoneOf 3 | booleanOptional / item | — |
request.targets[].provider_payload.publish_options.crossposted_video_idoneOf 3 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.sphericaloneOf 3 | booleanOptional / item | — |
request.targets[].provider_payload.publish_options.media_optionsoneOf 3 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.media_options[]oneOf 3 | objectOptional / item |
|
request.targets[].provider_payload.publish_options.media_options[].asset_idoneOf 3 | integerRequired in parent |
|
request.targets[].provider_payload.publish_options.media_options[].alt_text_customoneOf 3 | stringOptional / item |
|
request.targets[].provider_payloadoneOf 4 | objectRequired in parent |
|
request.targets[].provider_payload.platformoneOf 4 | stringRequired in parent |
|
request.targets[].provider_payload.publish_optionsoneOf 4 | objectRequired in parent |
|
request.targets[].provider_payload.publish_options.post_typeoneOf 4 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.reply_to_idoneOf 4 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.quote_post_idoneOf 4 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.repost_target_idoneOf 4 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.reply_controloneOf 4 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.enable_reply_approvalsoneOf 4 | booleanOptional / item | — |
request.targets[].provider_payload.publish_options.link_attachmentoneOf 4 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.poll_attachmentoneOf 4 | objectOptional / item |
|
request.targets[].provider_payload.publish_options.poll_attachment.option_aoneOf 4 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.poll_attachment.option_boneOf 4 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.poll_attachment.option_coneOf 4 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.poll_attachment.option_doneOf 4 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.gif_attachmentoneOf 4 | objectOptional / item |
|
request.targets[].provider_payload.publish_options.gif_attachment.gif_idoneOf 4 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.gif_attachment.provideroneOf 4 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.text_attachmentoneOf 4 | objectOptional / item |
|
request.targets[].provider_payload.publish_options.text_attachment.plaintextoneOf 4 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.text_attachment.link_attachment_urloneOf 4 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_infooneOf 4 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[]oneOf 4 | objectOptional / item |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].offsetoneOf 4 | integerRequired in parent |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].lengthoneOf 4 | integerRequired in parent |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].styling_infooneOf 4 | arrayRequired in parent |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].styling_info[]oneOf 4 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.topic_tagoneOf 4 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.text_entitiesoneOf 4 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.text_entities[]oneOf 4 | objectOptional / item |
|
request.targets[].provider_payload.publish_options.text_entities[].entity_typeoneOf 4 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.text_entities[].offsetoneOf 4 | integerRequired in parent |
|
request.targets[].provider_payload.publish_options.text_entities[].lengthoneOf 4 | integerRequired in parent |
|
request.targets[].provider_payload.publish_options.is_spoiler_mediaoneOf 4 | booleanOptional / item | — |
request.targets[].provider_payload.publish_options.is_ghost_postoneOf 4 | booleanOptional / item | — |
request.targets[].provider_payload.publish_options.location_idoneOf 4 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.allowlisted_country_codesoneOf 4 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.allowlisted_country_codes[]oneOf 4 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.crossreshare_to_igoneOf 4 | booleanOptional / item | — |
request.targets[].provider_payload.publish_options.crossreshare_to_ig_dark_modeoneOf 4 | booleanOptional / item | — |
request.targets[].provider_payload.publish_options.auto_publish_textoneOf 4 | booleanOptional / item | — |
request.targets[].provider_payload.publish_options.media_optionsoneOf 4 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.media_options[]oneOf 4 | objectOptional / item |
|
request.targets[].provider_payload.publish_options.media_options[].asset_idoneOf 4 | integerRequired in parent |
|
request.targets[].provider_payload.publish_options.media_options[].alt_textoneOf 4 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.media_options[].is_spoiler_mediaoneOf 4 | booleanOptional / item | — |
request.targets[].provider_payloadoneOf 5 | objectRequired in parent |
|
request.targets[].provider_payload.platformoneOf 5 | stringRequired in parent |
|
request.targets[].provider_payload.publish_optionsoneOf 5 | objectRequired in parent |
|
request.targets[].provider_payload.publish_options.post_typeoneOf 5 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.titleoneOf 5 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.descriptiononeOf 5 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.tagsoneOf 5 | arrayOptional / item |
|
request.targets[].provider_payload.publish_options.tags[]oneOf 5 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.category_idoneOf 5 | stringOptional / item | — |
request.targets[].provider_payload.publish_options.category_idoneOf 5 / anyOf 1 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.category_idoneOf 5 / anyOf 2 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.default_languageoneOf 5 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.localizationsoneOf 5 | objectOptional / item |
|
request.targets[].provider_payload.publish_options.localizations.*oneOf 5 | objectOptional / item |
|
request.targets[].provider_payload.publish_options.localizations.*.titleoneOf 5 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.localizations.*.descriptiononeOf 5 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.privacy_statusoneOf 5 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.cancellation_modeoneOf 5 | stringRequired in parent |
|
request.targets[].provider_payload.publish_options.licenseoneOf 5 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.embeddableoneOf 5 | booleanOptional / item | — |
request.targets[].provider_payload.publish_options.public_stats_viewableoneOf 5 | booleanOptional / item | — |
request.targets[].provider_payload.publish_options.self_declared_made_for_kidsoneOf 5 | booleanOptional / item | — |
request.targets[].provider_payload.publish_options.contains_synthetic_mediaoneOf 5 | booleanOptional / item | — |
request.targets[].provider_payload.publish_options.has_paid_product_placementoneOf 5 | booleanOptional / item | — |
request.targets[].provider_payload.publish_options.recording_dateoneOf 5 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.notify_subscribersoneOf 5 | booleanOptional / item | — |
request.targets[].provider_payload.publish_options.thumbnail_asset_idoneOf 5 | integerOptional / item |
|
request.targets[].provider_payload.publish_options.surface_expectationoneOf 5 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.brand_partneroneOf 5 | objectOptional / item |
|
request.targets[].provider_payload.publish_options.brand_partner.channel_idoneOf 5 | stringOptional / item |
|
request.targets[].provider_payload.publish_options.brand_partner.channel_handleoneOf 5 | stringOptional / item |
|
request.targets[].scheduled_at | stringRequired in parent |
|
request.targets[].display_timezone | stringOptional / item |
|
request.targets[].local_scheduled_at | stringOptional / item |
|
request.targets[].schedule_dst_disambiguation | stringOptional / item |
|
request.targets[].expires_at | string | nullOptional / item | — |
request.targets[].expires_atanyOf 1 | stringOptional / item |
|
request.targets[].expires_atanyOf 2 | nullOptional / item | — |
request.targets[].source_ref | object | nullOptional / item | — |
request.targets[].source_refanyOf 1 | objectOptional / item |
|
request.targets[].source_ref.*anyOf 1 | any JSON valueOptional / item | — |
request.targets[].source_refanyOf 2 | nullOptional / item | — |
request.targets[].automatic_retry_enabled | booleanOptional / item |
|
request.targets[].idempotency_key | stringRequired in parent |
|
Complete JSON Schema
{
"$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
}Response and completion
Success HTTP statuses: 200, 422. When the operation is complete: durable destination acceptance; provider publication is separate.
A successful HTTP response can mean that a request was accepted rather than completed. For background work, save the returned ID and check the same operation until it finishes. A scheduled or accepted post is published only when the platform confirms it; a client timeout does not establish the result.
Required means required inside its parent object and selected branch. A required child does not make an optional parent required. Rules and field names below are copied from the contract.
| Field / branch | Type / required | Constraints |
|---|---|---|
$ | objectRequired in parent | — |
draft | objectRequired in parent | — |
draft.id | stringRequired in parent |
|
draft.workspace_id | stringRequired in parent |
|
draft.revision | integerRequired in parent |
|
draft.state | stringRequired in parent |
|
draft.content | objectRequired in parent | — |
draft.content.schemaVersion | numberRequired in parent |
|
draft.content.accountIds | arrayRequired in parent |
|
draft.content.accountIds[] | stringOptional / item |
|
draft.content.caption | stringRequired in parent |
|
draft.content.hashtags | stringRequired in parent |
|
draft.content.assetIds | arrayRequired in parent |
|
draft.content.assetIds[] | stringOptional / item |
|
draft.content.threadsTextOnly | booleanRequired in parent |
|
draft.content.instagramMode | stringRequired in parent |
|
draft.content.youtubeTitle | stringRequired in parent |
|
draft.content.youtubePrivacy | stringRequired in parent |
|
draft.content.youtubeSynthetic | booleanRequired in parent |
|
draft.content.youtubeCategoryId | stringRequired in parent |
|
draft.content.youtubeShort | booleanRequired in parent |
|
draft.content.linkUrl | stringRequired in parent |
|
draft.content.scheduledAt | stringRequired in parent |
|
draft.content.displayTimezone | stringRequired in parent |
|
draft.content.publishNow | booleanRequired in parent |
|
draft.content.destinationOverrides | objectRequired in parent |
|
draft.content.destinationOverrides.* | objectOptional / item | — |
draft.content.destinationOverrides.*.caption | stringOptional / item |
|
draft.content.destinationOverrides.*.scheduledAt | stringOptional / item |
|
draft.content.expiresAt | stringRequired in parent |
|
draft.created_by | string | nullRequired in parent | — |
draft.created_byanyOf 1 | stringRequired in parent |
|
draft.created_byanyOf 2 | nullRequired in parent | — |
draft.updated_by | string | nullRequired in parent | — |
draft.updated_byanyOf 1 | stringRequired in parent |
|
draft.updated_byanyOf 2 | nullRequired in parent | — |
draft.created_at | stringRequired in parent |
|
draft.updated_at | stringRequired in parent |
|
draft.submission | object | nullRequired in parent | — |
draft.submissionanyOf 1 | objectRequired in parent | — |
draft.submission.idanyOf 1 | stringRequired in parent |
|
draft.submission.expected_revisionanyOf 1 | integerRequired in parent |
|
draft.submission.started_atanyOf 1 | stringRequired in parent |
|
draft.submission.receiptanyOf 1 | object | nullRequired in parent | — |
draft.submission.receiptanyOf 1 / anyOf 1 | objectRequired in parent | — |
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 | string | nullRequired in parent | — |
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 / anyOf 2 | nullRequired in parent | — |
draft.submission.receipt.successesanyOf 1 / anyOf 1 | arrayRequired in parent |
|
draft.submission.receipt.successes[]anyOf 1 / anyOf 1 | objectOptional / item | — |
draft.submission.receipt.successes[].social_account_idanyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.submission.receipt.successes[].post_idanyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.submission.receipt.failuresanyOf 1 / anyOf 1 | arrayRequired in parent |
|
draft.submission.receipt.failures[]anyOf 1 / anyOf 1 | objectOptional / item | — |
draft.submission.receipt.failures[].social_account_idanyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.submission.receipt.failures[].codeanyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.submission.receipt.failures[].messageanyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.submission.receiptanyOf 1 / anyOf 2 | nullRequired in parent | — |
draft.submissionanyOf 2 | nullRequired in parent | — |
result | objectRequired in parent | — |
result.batch_id | string | nullRequired in parent | — |
result.batch_idanyOf 1 | stringRequired in parent |
|
result.batch_idanyOf 2 | nullRequired in parent | — |
result.successes | arrayRequired in parent | — |
result.successes[] | objectOptional / item | — |
result.successes[].social_account_id | stringRequired in parent |
|
result.successes[].post | objectRequired in parent | — |
result.successes[].post.id | stringRequired in parent |
|
result.successes[].post.workspace_id | stringRequired in parent |
|
result.successes[].post.social_account_id | string | nullRequired in parent | — |
result.successes[].post.social_account_idanyOf 1 | stringRequired in parent |
|
result.successes[].post.social_account_idanyOf 2 | nullRequired in parent | — |
result.successes[].post.platform | stringRequired in parent |
|
result.successes[].post.destination | objectRequired in parent | — |
result.successes[].post.destination.social_account_id | string | nullRequired in parent | — |
result.successes[].post.destination.social_account_idanyOf 1 | stringRequired in parent |
|
result.successes[].post.destination.social_account_idanyOf 2 | nullRequired in parent | — |
result.successes[].post.destination.platform | stringRequired in parent |
|
result.successes[].post.destination.platform_user_id | string | nullRequired in parent | — |
result.successes[].post.destination.platform_user_idanyOf 1 | stringRequired in parent | — |
result.successes[].post.destination.platform_user_idanyOf 2 | nullRequired in parent | — |
result.successes[].post.destination.account_label | string | nullRequired in parent | — |
result.successes[].post.destination.account_labelanyOf 1 | stringRequired in parent | — |
result.successes[].post.destination.account_labelanyOf 2 | nullRequired in parent | — |
result.successes[].post.caption | string | nullRequired in parent | — |
result.successes[].post.captionanyOf 1 | stringRequired in parent | — |
result.successes[].post.captionanyOf 2 | nullRequired in parent | — |
result.successes[].post.hashtags | arrayRequired in parent | — |
result.successes[].post.hashtags[] | stringOptional / item | — |
result.successes[].post.media | arrayRequired in parent | — |
result.successes[].post.media[] | objectOptional / item | — |
result.successes[].post.media[].kind | stringRequired in parent |
|
result.successes[].post.media[].url | stringRequired in parent |
|
result.successes[].post.media[].cover_url | string | nullOptional / item | — |
result.successes[].post.media[].cover_urlanyOf 1 | stringOptional / item |
|
result.successes[].post.media[].cover_urlanyOf 2 | nullOptional / item | — |
result.successes[].post.media[].cover_asset_id | integer | nullOptional / item | — |
result.successes[].post.media[].cover_asset_idanyOf 1 | integerOptional / item |
|
result.successes[].post.media[].cover_asset_idanyOf 2 | nullOptional / item | — |
result.successes[].post.media[].asset_id | integer | nullOptional / item | — |
result.successes[].post.media[].asset_idanyOf 1 | integerOptional / item |
|
result.successes[].post.media[].asset_idanyOf 2 | nullOptional / item | — |
result.successes[].post.media[].mime_type | string | nullOptional / item | — |
result.successes[].post.media[].mime_typeanyOf 1 | stringOptional / item |
|
result.successes[].post.media[].mime_typeanyOf 2 | nullOptional / item | — |
result.successes[].post.media[].preview_url | string | nullOptional / item | Temporary authorized read URL; keep url as persisted Scheduled Post media identity. — |
result.successes[].post.media[].preview_urlanyOf 1 | stringOptional / item |
|
result.successes[].post.media[].preview_urlanyOf 2 | nullOptional / item | — |
result.successes[].post.media[].cover_preview_url | string | nullOptional / item | Temporary authorized cover read URL; keep cover_url as persisted media identity. — |
result.successes[].post.media[].cover_preview_urlanyOf 1 | stringOptional / item |
|
result.successes[].post.media[].cover_preview_urlanyOf 2 | nullOptional / item | — |
result.successes[].post.media[].preview_expires_at | string | nullOptional / item | — |
result.successes[].post.media[].preview_expires_atanyOf 1 | stringOptional / item |
|
result.successes[].post.media[].preview_expires_atanyOf 2 | nullOptional / item | — |
result.successes[].post.link_url | string | nullOptional / item | — |
result.successes[].post.link_urlanyOf 1 | stringOptional / item |
|
result.successes[].post.link_urlanyOf 2 | nullOptional / item | — |
result.successes[].post.publish_options | objectRequired in parent | — |
result.successes[].post.publish_options.post_type | stringOptional / item |
|
result.successes[].post.publish_options.location_id | stringOptional / item |
|
result.successes[].post.publish_options.share_to_feed | booleanOptional / item | — |
result.successes[].post.publish_options.collaborators | arrayOptional / item |
|
result.successes[].post.publish_options.collaborators[] | stringOptional / item |
|
result.successes[].post.publish_options.first_comment | stringOptional / item |
|
result.successes[].post.publish_options.topic_tag | stringOptional / item |
|
result.successes[].post.publish_options.thumb_offset_ms | integerOptional / item |
|
result.successes[].post.publish_options.title | stringOptional / item |
|
result.successes[].post.publish_options.youtube_privacy_status | stringOptional / item |
|
result.successes[].post.publish_options.youtube_category_id | stringOptional / item |
|
result.successes[].post.publish_options.youtube_contains_synthetic_media | booleanOptional / item | — |
result.successes[].post.publish_options.description | stringOptional / item |
|
result.successes[].post.publish_options.category_id | stringOptional / item |
|
result.successes[].post.publish_options.privacy_status | stringOptional / item |
|
result.successes[].post.publish_options.cancellation_mode | stringOptional / item |
|
result.successes[].post.publish_options.tags | arrayOptional / item | — |
result.successes[].post.publish_options.tags[] | stringOptional / item | — |
result.successes[].post.publish_options.default_language | stringOptional / item | — |
result.successes[].post.publish_options.localizations | objectOptional / item |
|
result.successes[].post.publish_options.localizations.* | any JSON valueOptional / item | — |
result.successes[].post.publish_options.license | stringOptional / item |
|
result.successes[].post.publish_options.embeddable | booleanOptional / item | — |
result.successes[].post.publish_options.public_stats_viewable | booleanOptional / item | — |
result.successes[].post.publish_options.self_declared_made_for_kids | booleanOptional / item | — |
result.successes[].post.publish_options.contains_synthetic_media | booleanOptional / item | — |
result.successes[].post.publish_options.has_paid_product_placement | booleanOptional / item | — |
result.successes[].post.publish_options.recording_date | stringOptional / item | — |
result.successes[].post.publish_options.notify_subscribers | booleanOptional / item | — |
result.successes[].post.publish_options.thumbnail_asset_id | integerOptional / item |
|
result.successes[].post.publish_options.surface_expectation | stringOptional / item |
|
result.successes[].post.publish_options.brand_partner | objectOptional / item |
|
result.successes[].post.publish_options.brand_partner.* | any JSON valueOptional / item | — |
result.successes[].post.publish_options.cover_asset_id | integerOptional / item |
|
result.successes[].post.publish_options.audio_name | stringOptional / item | — |
result.successes[].post.publish_options.trial_params | objectOptional / item |
|
result.successes[].post.publish_options.trial_params.* | any JSON valueOptional / item | — |
result.successes[].post.publish_options.is_ai_generated | booleanOptional / item | — |
result.successes[].post.publish_options.branded_content_sponsor_ids | arrayOptional / item | — |
result.successes[].post.publish_options.branded_content_sponsor_ids[] | stringOptional / item | — |
result.successes[].post.publish_options.is_paid_partnership | booleanOptional / item | — |
result.successes[].post.publish_options.media_options | arrayOptional / item | — |
result.successes[].post.publish_options.media_options[] | objectOptional / item |
|
result.successes[].post.publish_options.media_options[].* | any JSON valueOptional / item | — |
result.successes[].post.publish_options.reply_to_id | stringOptional / item | — |
result.successes[].post.publish_options.quote_post_id | stringOptional / item | — |
result.successes[].post.publish_options.repost_target_id | stringOptional / item | — |
result.successes[].post.publish_options.reply_control | stringOptional / item | — |
result.successes[].post.publish_options.enable_reply_approvals | booleanOptional / item | — |
result.successes[].post.publish_options.link_attachment | stringOptional / item |
|
result.successes[].post.publish_options.poll_attachment | objectOptional / item |
|
result.successes[].post.publish_options.poll_attachment.* | any JSON valueOptional / item | — |
result.successes[].post.publish_options.gif_attachment | objectOptional / item |
|
result.successes[].post.publish_options.gif_attachment.* | any JSON valueOptional / item | — |
result.successes[].post.publish_options.text_attachment | objectOptional / item |
|
result.successes[].post.publish_options.text_attachment.* | any JSON valueOptional / item | — |
result.successes[].post.publish_options.text_entities | arrayOptional / item | — |
result.successes[].post.publish_options.text_entities[] | objectOptional / item |
|
result.successes[].post.publish_options.text_entities[].* | any JSON valueOptional / item | — |
result.successes[].post.publish_options.is_spoiler_media | booleanOptional / item | — |
result.successes[].post.publish_options.is_ghost_post | booleanOptional / item | — |
result.successes[].post.publish_options.allowlisted_country_codes | arrayOptional / item | — |
result.successes[].post.publish_options.allowlisted_country_codes[] | stringOptional / item | — |
result.successes[].post.publish_options.crossreshare_to_ig | booleanOptional / item | — |
result.successes[].post.publish_options.crossreshare_to_ig_dark_mode | booleanOptional / item | — |
result.successes[].post.publish_options.auto_publish_text | booleanOptional / item | — |
result.successes[].post.publish_options.publication_mode | stringOptional / item |
|
result.successes[].post.publish_options.backdated_time | numberOptional / item | — |
result.successes[].post.publish_options.backdated_time_granularity | stringOptional / item |
|
result.successes[].post.publish_options.place | stringOptional / item | — |
result.successes[].post.publish_options.feed_targeting | objectOptional / item |
|
result.successes[].post.publish_options.feed_targeting.* | any JSON valueOptional / item | — |
result.successes[].post.publish_options.targeting | objectOptional / item |
|
result.successes[].post.publish_options.targeting.* | any JSON valueOptional / item | — |
result.successes[].post.publish_options.child_attachments | arrayOptional / item | — |
result.successes[].post.publish_options.child_attachments[] | objectOptional / item |
|
result.successes[].post.publish_options.child_attachments[].* | any JSON valueOptional / item | — |
result.successes[].post.publish_options.multi_share_end_card | booleanOptional / item | — |
result.successes[].post.publish_options.multi_share_optimized | booleanOptional / item | — |
result.successes[].post.publish_options.unpublished_content_type | stringOptional / item | — |
result.successes[].post.publish_options.no_story | booleanOptional / item | — |
result.successes[].post.publish_options.crossposted_video_id | stringOptional / item | — |
result.successes[].post.publish_options.spherical | booleanOptional / item | — |
result.successes[].post.scheduled_at | stringRequired in parent | — |
result.successes[].post.display_timezone | stringRequired in parent |
|
result.successes[].post.local_scheduled_at | string | nullOptional / item | — |
result.successes[].post.local_scheduled_atanyOf 1 | stringOptional / item |
|
result.successes[].post.local_scheduled_atanyOf 2 | nullOptional / item | — |
result.successes[].post.schedule_timezone | string | nullOptional / item | — |
result.successes[].post.schedule_timezoneanyOf 1 | stringOptional / item |
|
result.successes[].post.schedule_timezoneanyOf 2 | nullOptional / item | — |
result.successes[].post.schedule_dst_disambiguation | string | nullOptional / item | — |
result.successes[].post.schedule_dst_disambiguationanyOf 1 | stringOptional / item |
|
result.successes[].post.schedule_dst_disambiguationanyOf 2 | nullOptional / item | — |
result.successes[].post.schedule_intent_state | stringOptional / item |
|
result.successes[].post.expires_at | string | nullRequired in parent | — |
result.successes[].post.expires_atanyOf 1 | stringRequired in parent | — |
result.successes[].post.expires_atanyOf 2 | nullRequired in parent | — |
result.successes[].post.status | stringRequired in parent |
|
result.successes[].post.version | integerRequired in parent |
|
result.successes[].post.automatic_retry_enabled | booleanRequired in parent | — |
result.successes[].post.delete_requested_at | string | nullRequired in parent | — |
result.successes[].post.delete_requested_atanyOf 1 | stringRequired in parent | — |
result.successes[].post.delete_requested_atanyOf 2 | nullRequired in parent | — |
result.successes[].post.published_at | string | nullRequired in parent | — |
result.successes[].post.published_atanyOf 1 | stringRequired in parent | — |
result.successes[].post.published_atanyOf 2 | nullRequired in parent | — |
result.successes[].post.deleted_at | string | nullRequired in parent | — |
result.successes[].post.deleted_atanyOf 1 | stringRequired in parent | — |
result.successes[].post.deleted_atanyOf 2 | nullRequired in parent | — |
result.successes[].post.provider_post_id | string | nullRequired in parent | — |
result.successes[].post.provider_post_idanyOf 1 | stringRequired in parent | — |
result.successes[].post.provider_post_idanyOf 2 | nullRequired in parent | — |
result.successes[].post.permalink | string | nullRequired in parent | — |
result.successes[].post.permalinkanyOf 1 | stringRequired in parent |
|
result.successes[].post.permalinkanyOf 2 | nullRequired in parent | — |
result.successes[].post.created_at | stringRequired in parent | — |
result.successes[].post.updated_at | stringRequired in parent | — |
result.successes[].post.project_id | string | nullRequired in parent | — |
result.successes[].post.project_idanyOf 1 | stringRequired in parent |
|
result.successes[].post.project_idanyOf 2 | nullRequired in parent | — |
result.successes[].post.batch_id | string | nullRequired in parent | — |
result.successes[].post.batch_idanyOf 1 | stringRequired in parent |
|
result.successes[].post.batch_idanyOf 2 | nullRequired in parent | — |
result.successes[].post.source_ref | object | nullRequired in parent | — |
result.successes[].post.source_refanyOf 1 | objectRequired in parent |
|
result.successes[].post.source_ref.*anyOf 1 | any JSON valueOptional / item | — |
result.successes[].post.source_refanyOf 2 | nullRequired in parent | — |
result.failures | arrayRequired in parent | — |
result.failures[] | objectOptional / item | — |
result.failures[].social_account_id | stringRequired in parent |
|
result.failures[].code | stringRequired in parent | — |
result.failures[].message | stringRequired in parent | — |
Complete JSON Schema
{
"$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"
]
}Errors and safe retries
Check the HTTP status and response body. A 400 validation error may contain a ZodError; handler errors use error, message and code fields. Keep request_id or x-request-id for diagnosis, without credentials. Fix 401/403 access errors before retrying, and follow Retry-After for 429. If a write is uncertain or returns 5xx, read the existing result first. Reuse an idempotency key only where supported; retry behaviour varies by operation and does not guarantee exactly-once delivery.
Troubleshooting guideExamples
These examples use fictional values checked against the schemas. Replace the IDs with ones you are authorized to use, the media with ready assets and the dates with your confirmed publishing time. Check the account’s eligibility before submitting a write. This page sends no API requests.
Set SOSOAPI_ACCESS_TOKEN on your server to a credential accepted by this operation, and keep it out of browser code. For an agent, use sosoapi auth login to sign in through the browser and let the CLI refresh its credentials.
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.jsonSynthetic response example
{
"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."
}
]
}
}