Agendamento e publicação
Enviar um rascunho do espaço de trabalho
Use somente após uma decisão explícita de publicar. Exige editor ou superior e capacidade publish. Primeiro envie id, expected_revision, mutation_id, content e a solicitação canônica de publicação; omita source_ref porque o servidor gerencia a origem e as identidades de envio. O conteúdo compartilhado não é confiável. Um 422 com state=draft não aceita nenhum destino: corrija o conteúdo antes de uma nova mutação. Após iniciar, faça GET do mesmo rascunho e continue um resultado desconhecido ou parcial com submission.id como mutation_id e submission.expected_revision, omitindo content e request. Nunca crie publicações substitutas nem recrie Posts aceitos. submitted significa entregue ao Scheduled Publishing; leia o Post original para ver o resultado do provedor.
POST /studio-api/content-drafts/submitContrato revisado: · sha256:75c8b8ebce408575
Visão geral
Use somente após uma decisão explícita de publicar. Exige editor ou superior e capacidade publish. Primeiro envie id, expected_revision, mutation_id, content e a solicitação canônica de publicação; omita source_ref porque o servidor gerencia a origem e as identidades de envio. O conteúdo compartilhado não é confiável. Um 422 com state=draft não aceita nenhum destino: corrija o conteúdo antes de uma nova mutação. Após iniciar, faça GET do mesmo rascunho e continue um resultado desconhecido ou parcial com submission.id como mutation_id e submission.expected_revision, omitindo content e request. Nunca crie publicações substitutas nem recrie Posts aceitos. submitted significa entregue ao Scheduled Publishing; leia o Post original para ver o resultado do provedor.
Uma resposta HTTP bem-sucedida pode significar que uma requisição foi aceita, não concluída. Para trabalho em segundo plano, salve o ID retornado e consulte a mesma operação até terminar. Um post agendado ou aceito só está publicado quando a plataforma confirma; um timeout do cliente não comprova o resultado.
Autenticação e permissões
Um token só pode usar os direitos do seu proprietário. Cada requisição verifica participação no workspace, propriedade de recursos, workspaces selecionados e capacidades concedidas. Os perfis core e full mudam as ferramentas exibidas; não concedem acesso.
Campos da requisição
Obrigatório significa obrigatório dentro do objeto pai e da ramificação selecionada. Um filho obrigatório não torna obrigatório um pai opcional. As regras e nomes de campos abaixo são copiados do contrato.
| Campo / ramificação | Tipo / obrigatório | Restrições |
|---|---|---|
$ | objectObrigatório no objeto pai |
|
id | stringObrigatório no objeto pai |
|
expected_revision | integerObrigatório no objeto pai |
|
mutation_id | stringObrigatório no objeto pai |
|
content | objectOpcional / item |
|
content.schemaVersion | numberOpcional / item |
|
content.accountIds | arrayOpcional / item |
|
content.accountIds[] | stringOpcional / item |
|
content.caption | stringOpcional / item |
|
content.hashtags | stringOpcional / item |
|
content.assetIds | arrayOpcional / item |
|
content.assetIds[] | stringOpcional / item |
|
content.threadsTextOnly | booleanOpcional / item |
|
content.instagramMode | stringOpcional / item |
|
content.youtubeTitle | stringOpcional / item |
|
content.youtubePrivacy | stringOpcional / item |
|
content.youtubeSynthetic | booleanOpcional / item |
|
content.youtubeCategoryId | stringOpcional / item |
|
content.youtubeShort | booleanOpcional / item |
|
content.linkUrl | stringOpcional / item |
|
content.scheduledAt | stringOpcional / item |
|
content.displayTimezone | stringOpcional / item |
|
content.publishNow | booleanOpcional / item |
|
content.destinationOverrides | objectOpcional / item |
|
content.destinationOverrides.* | objectOpcional / item |
|
content.destinationOverrides.*.caption | stringOpcional / item |
|
content.destinationOverrides.*.scheduledAt | stringOpcional / item |
|
content.expiresAt | stringOpcional / item |
|
request | objectOpcional / item |
|
request.workspace_id | stringObrigatório no objeto pai |
|
request.project_id | string | nullOpcional / item | — |
request.project_idanyOf 1 | stringOpcional / item |
|
request.project_idanyOf 2 | nullOpcional / item | — |
request.source_ref | object | nullOpcional / item | — |
request.source_refanyOf 1 | objectOpcional / item |
|
request.source_ref.*anyOf 1 | any JSON valueOpcional / item | — |
request.source_refanyOf 2 | nullOpcional / item | — |
request.targets | arrayObrigatório no objeto pai |
|
request.targets[] | objectOpcional / item |
|
request.targets[].social_account_id | stringObrigatório no objeto pai |
|
request.targets[].caption | string | nullOpcional / item |
|
request.targets[].captionanyOf 1 | stringOpcional / item |
|
request.targets[].captionanyOf 2 | nullOpcional / item | — |
request.targets[].hashtags | arrayOpcional / item |
|
request.targets[].hashtags[] | stringOpcional / item |
|
request.targets[].media | arrayOpcional / item |
|
request.targets[].media[] | objectOpcional / item |
|
request.targets[].media[].kind | stringObrigatório no objeto pai |
|
request.targets[].media[].url | stringObrigatório no objeto pai |
|
request.targets[].media[].cover_url | string | nullOpcional / item | — |
request.targets[].media[].cover_urlanyOf 1 | stringOpcional / item |
|
request.targets[].media[].cover_urlanyOf 2 | nullOpcional / item | — |
request.targets[].media[].cover_asset_id | integer | nullOpcional / item | — |
request.targets[].media[].cover_asset_idanyOf 1 | integerOpcional / item |
|
request.targets[].media[].cover_asset_idanyOf 2 | nullOpcional / item | — |
request.targets[].media[].asset_id | integer | nullOpcional / item | — |
request.targets[].media[].asset_idanyOf 1 | integerOpcional / item |
|
request.targets[].media[].asset_idanyOf 2 | nullOpcional / item | — |
request.targets[].media[].mime_type | string | nullOpcional / item | — |
request.targets[].media[].mime_typeanyOf 1 | stringOpcional / item |
|
request.targets[].media[].mime_typeanyOf 2 | nullOpcional / item | — |
request.targets[].link_url | string | nullOpcional / item | — |
request.targets[].link_urlanyOf 1 | stringOpcional / item |
|
request.targets[].link_urlanyOf 2 | nullOpcional / item | — |
request.targets[].provider_payload | objectObrigatório no objeto pai | — |
request.targets[].provider_payloadoneOf 1 | objectObrigatório no objeto pai |
|
request.targets[].provider_payload.platformoneOf 1 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_optionsoneOf 1 | objectObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.post_typeoneOf 1 | stringObrigatório no objeto pai |
|
request.targets[].provider_payloadoneOf 2 | objectObrigatório no objeto pai |
|
request.targets[].provider_payload.platformoneOf 2 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_optionsoneOf 2 | objectObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.post_typeoneOf 2 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.location_idoneOf 2 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.share_to_feedoneOf 2 | booleanOpcional / item | — |
request.targets[].provider_payload.publish_options.collaboratorsoneOf 2 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.collaborators[]oneOf 2 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.first_commentoneOf 2 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.cover_asset_idoneOf 2 | integerOpcional / item |
|
request.targets[].provider_payload.publish_options.thumb_offset_msoneOf 2 | integerOpcional / item |
|
request.targets[].provider_payload.publish_options.audio_nameoneOf 2 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.trial_paramsoneOf 2 | objectOpcional / item |
|
request.targets[].provider_payload.publish_options.trial_params.graduation_strategyoneOf 2 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.is_ai_generatedoneOf 2 | booleanOpcional / item | — |
request.targets[].provider_payload.publish_options.branded_content_sponsor_idsoneOf 2 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.branded_content_sponsor_ids[]oneOf 2 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.is_paid_partnershiponeOf 2 | booleanOpcional / item | — |
request.targets[].provider_payload.publish_options.media_optionsoneOf 2 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.media_options[]oneOf 2 | objectOpcional / item |
|
request.targets[].provider_payload.publish_options.media_options[].asset_idoneOf 2 | integerObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.media_options[].alt_textoneOf 2 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.media_options[].user_tagsoneOf 2 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.media_options[].user_tags[]oneOf 2 | objectOpcional / item |
|
request.targets[].provider_payload.publish_options.media_options[].user_tags[].usernameoneOf 2 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.media_options[].user_tags[].xoneOf 2 | numberOpcional / item |
|
request.targets[].provider_payload.publish_options.media_options[].user_tags[].yoneOf 2 | numberOpcional / item |
|
request.targets[].provider_payload.publish_options.media_options[].product_tagsoneOf 2 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.media_options[].product_tags[]oneOf 2 | objectOpcional / item |
|
request.targets[].provider_payload.publish_options.media_options[].product_tags[].product_idoneOf 2 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.media_options[].product_tags[].xoneOf 2 | numberOpcional / item |
|
request.targets[].provider_payload.publish_options.media_options[].product_tags[].yoneOf 2 | numberOpcional / item |
|
request.targets[].provider_payload.publish_options.media_options[].thumb_offset_msoneOf 2 | integerOpcional / item |
|
request.targets[].provider_payloadoneOf 3 | objectObrigatório no objeto pai |
|
request.targets[].provider_payload.platformoneOf 3 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_optionsoneOf 3 | objectObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.post_typeoneOf 3 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.titleoneOf 3 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.descriptiononeOf 3 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.publication_modeoneOf 3 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.backdated_timeoneOf 3 | numberOpcional / item | — |
request.targets[].provider_payload.publish_options.backdated_time_granularityoneOf 3 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.placeoneOf 3 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.tagsoneOf 3 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.tags[]oneOf 3 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targetingoneOf 3 | objectOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.age_minoneOf 3 | integerOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.age_maxoneOf 3 | integerOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.college_yearsoneOf 3 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.college_years[]oneOf 3 | integerOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.education_statusesoneOf 3 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 | numberOpcional / item | — |
request.targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 / anyOf 1 | numberOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 / anyOf 2 | numberOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 / anyOf 3 | numberOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.gendersoneOf 3 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.genders[]oneOf 3 | numberOpcional / item | — |
request.targets[].provider_payload.publish_options.feed_targeting.genders[]oneOf 3 / anyOf 1 | numberOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.genders[]oneOf 3 / anyOf 2 | numberOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locationsoneOf 3 | objectOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.countriesoneOf 3 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.countries[]oneOf 3 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.regionsoneOf 3 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[]oneOf 3 | objectOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyoneOf 3 | string | integerObrigatório no objeto pai | — |
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyoneOf 3 / anyOf 1 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyoneOf 3 / anyOf 2 | integerObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.citiesoneOf 3 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[]oneOf 3 | objectOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyoneOf 3 | string | integerObrigatório no objeto pai | — |
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyoneOf 3 / anyOf 1 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyoneOf 3 / anyOf 2 | integerObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].radiusoneOf 3 | numberOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].distance_unitoneOf 3 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.zipsoneOf 3 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[]oneOf 3 | objectOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyoneOf 3 | string | integerObrigatório no objeto pai | — |
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyoneOf 3 / anyOf 1 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyoneOf 3 / anyOf 2 | integerObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.location_typesoneOf 3 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.location_types[]oneOf 3 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.interestsoneOf 3 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.interests[]oneOf 3 | string | integerOpcional / item | — |
request.targets[].provider_payload.publish_options.feed_targeting.interests[]oneOf 3 / anyOf 1 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.interests[]oneOf 3 / anyOf 2 | integerOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.localesoneOf 3 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.locales[]oneOf 3 | integerOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statusesoneOf 3 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 | numberOpcional / item | — |
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 1 | numberOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 2 | numberOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 3 | numberOpcional / item |
|
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 4 | numberOpcional / item |
|
request.targets[].provider_payload.publish_options.targetingoneOf 3 | objectOpcional / item |
|
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 | numberOpcional / item | — |
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 1 | numberOpcional / item |
|
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 2 | numberOpcional / item |
|
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 3 | numberOpcional / item |
|
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 4 | numberOpcional / item |
|
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 5 | numberOpcional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locationsoneOf 3 | objectOpcional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.countriesoneOf 3 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.countries[]oneOf 3 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.regionsoneOf 3 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.regions[]oneOf 3 | objectOpcional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.regions[].keyoneOf 3 | string | integerObrigatório no objeto pai | — |
request.targets[].provider_payload.publish_options.targeting.geo_locations.regions[].keyoneOf 3 / anyOf 1 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.regions[].keyoneOf 3 / anyOf 2 | integerObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.citiesoneOf 3 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[]oneOf 3 | objectOpcional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[].keyoneOf 3 | string | integerObrigatório no objeto pai | — |
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[].keyoneOf 3 / anyOf 1 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[].keyoneOf 3 / anyOf 2 | integerObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[].radiusoneOf 3 | numberOpcional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[].distance_unitoneOf 3 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.zipsoneOf 3 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.zips[]oneOf 3 | objectOpcional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.zips[].keyoneOf 3 | string | integerObrigatório no objeto pai | — |
request.targets[].provider_payload.publish_options.targeting.geo_locations.zips[].keyoneOf 3 / anyOf 1 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.zips[].keyoneOf 3 / anyOf 2 | integerObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.location_typesoneOf 3 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.location_types[]oneOf 3 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.child_attachmentsoneOf 3 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.child_attachments[]oneOf 3 | objectOpcional / item |
|
request.targets[].provider_payload.publish_options.child_attachments[].linkoneOf 3 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.child_attachments[].nameoneOf 3 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.child_attachments[].descriptiononeOf 3 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.child_attachments[].pictureoneOf 3 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.multi_share_end_cardoneOf 3 | booleanOpcional / item | — |
request.targets[].provider_payload.publish_options.multi_share_optimizedoneOf 3 | booleanOpcional / item | — |
request.targets[].provider_payload.publish_options.unpublished_content_typeoneOf 3 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.no_storyoneOf 3 | booleanOpcional / item | — |
request.targets[].provider_payload.publish_options.crossposted_video_idoneOf 3 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.sphericaloneOf 3 | booleanOpcional / item | — |
request.targets[].provider_payload.publish_options.media_optionsoneOf 3 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.media_options[]oneOf 3 | objectOpcional / item |
|
request.targets[].provider_payload.publish_options.media_options[].asset_idoneOf 3 | integerObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.media_options[].alt_text_customoneOf 3 | stringOpcional / item |
|
request.targets[].provider_payloadoneOf 4 | objectObrigatório no objeto pai |
|
request.targets[].provider_payload.platformoneOf 4 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_optionsoneOf 4 | objectObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.post_typeoneOf 4 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.reply_to_idoneOf 4 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.quote_post_idoneOf 4 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.repost_target_idoneOf 4 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.reply_controloneOf 4 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.enable_reply_approvalsoneOf 4 | booleanOpcional / item | — |
request.targets[].provider_payload.publish_options.link_attachmentoneOf 4 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.poll_attachmentoneOf 4 | objectOpcional / item |
|
request.targets[].provider_payload.publish_options.poll_attachment.option_aoneOf 4 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.poll_attachment.option_boneOf 4 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.poll_attachment.option_coneOf 4 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.poll_attachment.option_doneOf 4 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.gif_attachmentoneOf 4 | objectOpcional / item |
|
request.targets[].provider_payload.publish_options.gif_attachment.gif_idoneOf 4 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.gif_attachment.provideroneOf 4 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.text_attachmentoneOf 4 | objectOpcional / item |
|
request.targets[].provider_payload.publish_options.text_attachment.plaintextoneOf 4 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.text_attachment.link_attachment_urloneOf 4 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_infooneOf 4 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[]oneOf 4 | objectOpcional / item |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].offsetoneOf 4 | integerObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].lengthoneOf 4 | integerObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].styling_infooneOf 4 | arrayObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].styling_info[]oneOf 4 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.topic_tagoneOf 4 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.text_entitiesoneOf 4 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.text_entities[]oneOf 4 | objectOpcional / item |
|
request.targets[].provider_payload.publish_options.text_entities[].entity_typeoneOf 4 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.text_entities[].offsetoneOf 4 | integerObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.text_entities[].lengthoneOf 4 | integerObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.is_spoiler_mediaoneOf 4 | booleanOpcional / item | — |
request.targets[].provider_payload.publish_options.is_ghost_postoneOf 4 | booleanOpcional / item | — |
request.targets[].provider_payload.publish_options.location_idoneOf 4 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.allowlisted_country_codesoneOf 4 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.allowlisted_country_codes[]oneOf 4 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.crossreshare_to_igoneOf 4 | booleanOpcional / item | — |
request.targets[].provider_payload.publish_options.crossreshare_to_ig_dark_modeoneOf 4 | booleanOpcional / item | — |
request.targets[].provider_payload.publish_options.auto_publish_textoneOf 4 | booleanOpcional / item | — |
request.targets[].provider_payload.publish_options.media_optionsoneOf 4 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.media_options[]oneOf 4 | objectOpcional / item |
|
request.targets[].provider_payload.publish_options.media_options[].asset_idoneOf 4 | integerObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.media_options[].alt_textoneOf 4 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.media_options[].is_spoiler_mediaoneOf 4 | booleanOpcional / item | — |
request.targets[].provider_payloadoneOf 5 | objectObrigatório no objeto pai |
|
request.targets[].provider_payload.platformoneOf 5 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_optionsoneOf 5 | objectObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.post_typeoneOf 5 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.titleoneOf 5 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.descriptiononeOf 5 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.tagsoneOf 5 | arrayOpcional / item |
|
request.targets[].provider_payload.publish_options.tags[]oneOf 5 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.category_idoneOf 5 | stringOpcional / item | — |
request.targets[].provider_payload.publish_options.category_idoneOf 5 / anyOf 1 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.category_idoneOf 5 / anyOf 2 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.default_languageoneOf 5 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.localizationsoneOf 5 | objectOpcional / item |
|
request.targets[].provider_payload.publish_options.localizations.*oneOf 5 | objectOpcional / item |
|
request.targets[].provider_payload.publish_options.localizations.*.titleoneOf 5 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.localizations.*.descriptiononeOf 5 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.privacy_statusoneOf 5 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.cancellation_modeoneOf 5 | stringObrigatório no objeto pai |
|
request.targets[].provider_payload.publish_options.licenseoneOf 5 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.embeddableoneOf 5 | booleanOpcional / item | — |
request.targets[].provider_payload.publish_options.public_stats_viewableoneOf 5 | booleanOpcional / item | — |
request.targets[].provider_payload.publish_options.self_declared_made_for_kidsoneOf 5 | booleanOpcional / item | — |
request.targets[].provider_payload.publish_options.contains_synthetic_mediaoneOf 5 | booleanOpcional / item | — |
request.targets[].provider_payload.publish_options.has_paid_product_placementoneOf 5 | booleanOpcional / item | — |
request.targets[].provider_payload.publish_options.recording_dateoneOf 5 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.notify_subscribersoneOf 5 | booleanOpcional / item | — |
request.targets[].provider_payload.publish_options.thumbnail_asset_idoneOf 5 | integerOpcional / item |
|
request.targets[].provider_payload.publish_options.surface_expectationoneOf 5 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.brand_partneroneOf 5 | objectOpcional / item |
|
request.targets[].provider_payload.publish_options.brand_partner.channel_idoneOf 5 | stringOpcional / item |
|
request.targets[].provider_payload.publish_options.brand_partner.channel_handleoneOf 5 | stringOpcional / item |
|
request.targets[].scheduled_at | stringObrigatório no objeto pai |
|
request.targets[].display_timezone | stringOpcional / item |
|
request.targets[].local_scheduled_at | stringOpcional / item |
|
request.targets[].schedule_dst_disambiguation | stringOpcional / item |
|
request.targets[].expires_at | string | nullOpcional / item | — |
request.targets[].expires_atanyOf 1 | stringOpcional / item |
|
request.targets[].expires_atanyOf 2 | nullOpcional / item | — |
request.targets[].source_ref | object | nullOpcional / item | — |
request.targets[].source_refanyOf 1 | objectOpcional / item |
|
request.targets[].source_ref.*anyOf 1 | any JSON valueOpcional / item | — |
request.targets[].source_refanyOf 2 | nullOpcional / item | — |
request.targets[].automatic_retry_enabled | booleanOpcional / item |
|
request.targets[].idempotency_key | stringObrigatório no objeto pai |
|
JSON Schema completo
{
"$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
}Resposta e conclusão
Códigos HTTP de sucesso: 200, 422. Quando a operação estiver concluída: durable destination acceptance; provider publication is separate.
Uma resposta HTTP bem-sucedida pode significar que uma requisição foi aceita, não concluída. Para trabalho em segundo plano, salve o ID retornado e consulte a mesma operação até terminar. Um post agendado ou aceito só está publicado quando a plataforma confirma; um timeout do cliente não comprova o resultado.
Obrigatório significa obrigatório dentro do objeto pai e da ramificação selecionada. Um filho obrigatório não torna obrigatório um pai opcional. As regras e nomes de campos abaixo são copiados do contrato.
| Campo / ramificação | Tipo / obrigatório | Restrições |
|---|---|---|
$ | objectObrigatório no objeto pai | — |
draft | objectObrigatório no objeto pai | — |
draft.id | stringObrigatório no objeto pai |
|
draft.workspace_id | stringObrigatório no objeto pai |
|
draft.revision | integerObrigatório no objeto pai |
|
draft.state | stringObrigatório no objeto pai |
|
draft.content | objectObrigatório no objeto pai | — |
draft.content.schemaVersion | numberObrigatório no objeto pai |
|
draft.content.accountIds | arrayObrigatório no objeto pai |
|
draft.content.accountIds[] | stringOpcional / item |
|
draft.content.caption | stringObrigatório no objeto pai |
|
draft.content.hashtags | stringObrigatório no objeto pai |
|
draft.content.assetIds | arrayObrigatório no objeto pai |
|
draft.content.assetIds[] | stringOpcional / item |
|
draft.content.threadsTextOnly | booleanObrigatório no objeto pai |
|
draft.content.instagramMode | stringObrigatório no objeto pai |
|
draft.content.youtubeTitle | stringObrigatório no objeto pai |
|
draft.content.youtubePrivacy | stringObrigatório no objeto pai |
|
draft.content.youtubeSynthetic | booleanObrigatório no objeto pai |
|
draft.content.youtubeCategoryId | stringObrigatório no objeto pai |
|
draft.content.youtubeShort | booleanObrigatório no objeto pai |
|
draft.content.linkUrl | stringObrigatório no objeto pai |
|
draft.content.scheduledAt | stringObrigatório no objeto pai |
|
draft.content.displayTimezone | stringObrigatório no objeto pai |
|
draft.content.publishNow | booleanObrigatório no objeto pai |
|
draft.content.destinationOverrides | objectObrigatório no objeto pai |
|
draft.content.destinationOverrides.* | objectOpcional / item | — |
draft.content.destinationOverrides.*.caption | stringOpcional / item |
|
draft.content.destinationOverrides.*.scheduledAt | stringOpcional / item |
|
draft.content.expiresAt | stringObrigatório no objeto pai |
|
draft.created_by | string | nullObrigatório no objeto pai | — |
draft.created_byanyOf 1 | stringObrigatório no objeto pai |
|
draft.created_byanyOf 2 | nullObrigatório no objeto pai | — |
draft.updated_by | string | nullObrigatório no objeto pai | — |
draft.updated_byanyOf 1 | stringObrigatório no objeto pai |
|
draft.updated_byanyOf 2 | nullObrigatório no objeto pai | — |
draft.created_at | stringObrigatório no objeto pai |
|
draft.updated_at | stringObrigatório no objeto pai |
|
draft.submission | object | nullObrigatório no objeto pai | — |
draft.submissionanyOf 1 | objectObrigatório no objeto pai | — |
draft.submission.idanyOf 1 | stringObrigatório no objeto pai |
|
draft.submission.expected_revisionanyOf 1 | integerObrigatório no objeto pai |
|
draft.submission.started_atanyOf 1 | stringObrigatório no objeto pai |
|
draft.submission.receiptanyOf 1 | object | nullObrigatório no objeto pai | — |
draft.submission.receiptanyOf 1 / anyOf 1 | objectObrigatório no objeto pai | — |
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 | string | nullObrigatório no objeto pai | — |
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 / anyOf 1 | stringObrigatório no objeto pai |
|
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 / anyOf 2 | nullObrigatório no objeto pai | — |
draft.submission.receipt.successesanyOf 1 / anyOf 1 | arrayObrigatório no objeto pai |
|
draft.submission.receipt.successes[]anyOf 1 / anyOf 1 | objectOpcional / item | — |
draft.submission.receipt.successes[].social_account_idanyOf 1 / anyOf 1 | stringObrigatório no objeto pai |
|
draft.submission.receipt.successes[].post_idanyOf 1 / anyOf 1 | stringObrigatório no objeto pai |
|
draft.submission.receipt.failuresanyOf 1 / anyOf 1 | arrayObrigatório no objeto pai |
|
draft.submission.receipt.failures[]anyOf 1 / anyOf 1 | objectOpcional / item | — |
draft.submission.receipt.failures[].social_account_idanyOf 1 / anyOf 1 | stringObrigatório no objeto pai |
|
draft.submission.receipt.failures[].codeanyOf 1 / anyOf 1 | stringObrigatório no objeto pai |
|
draft.submission.receipt.failures[].messageanyOf 1 / anyOf 1 | stringObrigatório no objeto pai |
|
draft.submission.receiptanyOf 1 / anyOf 2 | nullObrigatório no objeto pai | — |
draft.submissionanyOf 2 | nullObrigatório no objeto pai | — |
result | objectObrigatório no objeto pai | — |
result.batch_id | string | nullObrigatório no objeto pai | — |
result.batch_idanyOf 1 | stringObrigatório no objeto pai |
|
result.batch_idanyOf 2 | nullObrigatório no objeto pai | — |
result.successes | arrayObrigatório no objeto pai | — |
result.successes[] | objectOpcional / item | — |
result.successes[].social_account_id | stringObrigatório no objeto pai |
|
result.successes[].post | objectObrigatório no objeto pai | — |
result.successes[].post.id | stringObrigatório no objeto pai |
|
result.successes[].post.workspace_id | stringObrigatório no objeto pai |
|
result.successes[].post.social_account_id | string | nullObrigatório no objeto pai | — |
result.successes[].post.social_account_idanyOf 1 | stringObrigatório no objeto pai |
|
result.successes[].post.social_account_idanyOf 2 | nullObrigatório no objeto pai | — |
result.successes[].post.platform | stringObrigatório no objeto pai |
|
result.successes[].post.destination | objectObrigatório no objeto pai | — |
result.successes[].post.destination.social_account_id | string | nullObrigatório no objeto pai | — |
result.successes[].post.destination.social_account_idanyOf 1 | stringObrigatório no objeto pai |
|
result.successes[].post.destination.social_account_idanyOf 2 | nullObrigatório no objeto pai | — |
result.successes[].post.destination.platform | stringObrigatório no objeto pai |
|
result.successes[].post.destination.platform_user_id | string | nullObrigatório no objeto pai | — |
result.successes[].post.destination.platform_user_idanyOf 1 | stringObrigatório no objeto pai | — |
result.successes[].post.destination.platform_user_idanyOf 2 | nullObrigatório no objeto pai | — |
result.successes[].post.destination.account_label | string | nullObrigatório no objeto pai | — |
result.successes[].post.destination.account_labelanyOf 1 | stringObrigatório no objeto pai | — |
result.successes[].post.destination.account_labelanyOf 2 | nullObrigatório no objeto pai | — |
result.successes[].post.caption | string | nullObrigatório no objeto pai | — |
result.successes[].post.captionanyOf 1 | stringObrigatório no objeto pai | — |
result.successes[].post.captionanyOf 2 | nullObrigatório no objeto pai | — |
result.successes[].post.hashtags | arrayObrigatório no objeto pai | — |
result.successes[].post.hashtags[] | stringOpcional / item | — |
result.successes[].post.media | arrayObrigatório no objeto pai | — |
result.successes[].post.media[] | objectOpcional / item | — |
result.successes[].post.media[].kind | stringObrigatório no objeto pai |
|
result.successes[].post.media[].url | stringObrigatório no objeto pai |
|
result.successes[].post.media[].cover_url | string | nullOpcional / item | — |
result.successes[].post.media[].cover_urlanyOf 1 | stringOpcional / item |
|
result.successes[].post.media[].cover_urlanyOf 2 | nullOpcional / item | — |
result.successes[].post.media[].cover_asset_id | integer | nullOpcional / item | — |
result.successes[].post.media[].cover_asset_idanyOf 1 | integerOpcional / item |
|
result.successes[].post.media[].cover_asset_idanyOf 2 | nullOpcional / item | — |
result.successes[].post.media[].asset_id | integer | nullOpcional / item | — |
result.successes[].post.media[].asset_idanyOf 1 | integerOpcional / item |
|
result.successes[].post.media[].asset_idanyOf 2 | nullOpcional / item | — |
result.successes[].post.media[].mime_type | string | nullOpcional / item | — |
result.successes[].post.media[].mime_typeanyOf 1 | stringOpcional / item |
|
result.successes[].post.media[].mime_typeanyOf 2 | nullOpcional / item | — |
result.successes[].post.media[].preview_url | string | nullOpcional / item | URL temporária autorizada de leitura; mantenha url como identidade persistida da mídia do Scheduled Post. — |
result.successes[].post.media[].preview_urlanyOf 1 | stringOpcional / item |
|
result.successes[].post.media[].preview_urlanyOf 2 | nullOpcional / item | — |
result.successes[].post.media[].cover_preview_url | string | nullOpcional / item | URL temporária autorizada de leitura de capa; mantenha cover_url como identidade persistida da mídia. — |
result.successes[].post.media[].cover_preview_urlanyOf 1 | stringOpcional / item |
|
result.successes[].post.media[].cover_preview_urlanyOf 2 | nullOpcional / item | — |
result.successes[].post.media[].preview_expires_at | string | nullOpcional / item | — |
result.successes[].post.media[].preview_expires_atanyOf 1 | stringOpcional / item |
|
result.successes[].post.media[].preview_expires_atanyOf 2 | nullOpcional / item | — |
result.successes[].post.link_url | string | nullOpcional / item | — |
result.successes[].post.link_urlanyOf 1 | stringOpcional / item |
|
result.successes[].post.link_urlanyOf 2 | nullOpcional / item | — |
result.successes[].post.publish_options | objectObrigatório no objeto pai | — |
result.successes[].post.publish_options.post_type | stringOpcional / item |
|
result.successes[].post.publish_options.location_id | stringOpcional / item |
|
result.successes[].post.publish_options.share_to_feed | booleanOpcional / item | — |
result.successes[].post.publish_options.collaborators | arrayOpcional / item |
|
result.successes[].post.publish_options.collaborators[] | stringOpcional / item |
|
result.successes[].post.publish_options.first_comment | stringOpcional / item |
|
result.successes[].post.publish_options.topic_tag | stringOpcional / item |
|
result.successes[].post.publish_options.thumb_offset_ms | integerOpcional / item |
|
result.successes[].post.publish_options.title | stringOpcional / item |
|
result.successes[].post.publish_options.youtube_privacy_status | stringOpcional / item |
|
result.successes[].post.publish_options.youtube_category_id | stringOpcional / item |
|
result.successes[].post.publish_options.youtube_contains_synthetic_media | booleanOpcional / item | — |
result.successes[].post.publish_options.description | stringOpcional / item |
|
result.successes[].post.publish_options.category_id | stringOpcional / item |
|
result.successes[].post.publish_options.privacy_status | stringOpcional / item |
|
result.successes[].post.publish_options.cancellation_mode | stringOpcional / item |
|
result.successes[].post.publish_options.tags | arrayOpcional / item | — |
result.successes[].post.publish_options.tags[] | stringOpcional / item | — |
result.successes[].post.publish_options.default_language | stringOpcional / item | — |
result.successes[].post.publish_options.localizations | objectOpcional / item |
|
result.successes[].post.publish_options.localizations.* | any JSON valueOpcional / item | — |
result.successes[].post.publish_options.license | stringOpcional / item |
|
result.successes[].post.publish_options.embeddable | booleanOpcional / item | — |
result.successes[].post.publish_options.public_stats_viewable | booleanOpcional / item | — |
result.successes[].post.publish_options.self_declared_made_for_kids | booleanOpcional / item | — |
result.successes[].post.publish_options.contains_synthetic_media | booleanOpcional / item | — |
result.successes[].post.publish_options.has_paid_product_placement | booleanOpcional / item | — |
result.successes[].post.publish_options.recording_date | stringOpcional / item | — |
result.successes[].post.publish_options.notify_subscribers | booleanOpcional / item | — |
result.successes[].post.publish_options.thumbnail_asset_id | integerOpcional / item |
|
result.successes[].post.publish_options.surface_expectation | stringOpcional / item |
|
result.successes[].post.publish_options.brand_partner | objectOpcional / item |
|
result.successes[].post.publish_options.brand_partner.* | any JSON valueOpcional / item | — |
result.successes[].post.publish_options.cover_asset_id | integerOpcional / item |
|
result.successes[].post.publish_options.audio_name | stringOpcional / item | — |
result.successes[].post.publish_options.trial_params | objectOpcional / item |
|
result.successes[].post.publish_options.trial_params.* | any JSON valueOpcional / item | — |
result.successes[].post.publish_options.is_ai_generated | booleanOpcional / item | — |
result.successes[].post.publish_options.branded_content_sponsor_ids | arrayOpcional / item | — |
result.successes[].post.publish_options.branded_content_sponsor_ids[] | stringOpcional / item | — |
result.successes[].post.publish_options.is_paid_partnership | booleanOpcional / item | — |
result.successes[].post.publish_options.media_options | arrayOpcional / item | — |
result.successes[].post.publish_options.media_options[] | objectOpcional / item |
|
result.successes[].post.publish_options.media_options[].* | any JSON valueOpcional / item | — |
result.successes[].post.publish_options.reply_to_id | stringOpcional / item | — |
result.successes[].post.publish_options.quote_post_id | stringOpcional / item | — |
result.successes[].post.publish_options.repost_target_id | stringOpcional / item | — |
result.successes[].post.publish_options.reply_control | stringOpcional / item | — |
result.successes[].post.publish_options.enable_reply_approvals | booleanOpcional / item | — |
result.successes[].post.publish_options.link_attachment | stringOpcional / item |
|
result.successes[].post.publish_options.poll_attachment | objectOpcional / item |
|
result.successes[].post.publish_options.poll_attachment.* | any JSON valueOpcional / item | — |
result.successes[].post.publish_options.gif_attachment | objectOpcional / item |
|
result.successes[].post.publish_options.gif_attachment.* | any JSON valueOpcional / item | — |
result.successes[].post.publish_options.text_attachment | objectOpcional / item |
|
result.successes[].post.publish_options.text_attachment.* | any JSON valueOpcional / item | — |
result.successes[].post.publish_options.text_entities | arrayOpcional / item | — |
result.successes[].post.publish_options.text_entities[] | objectOpcional / item |
|
result.successes[].post.publish_options.text_entities[].* | any JSON valueOpcional / item | — |
result.successes[].post.publish_options.is_spoiler_media | booleanOpcional / item | — |
result.successes[].post.publish_options.is_ghost_post | booleanOpcional / item | — |
result.successes[].post.publish_options.allowlisted_country_codes | arrayOpcional / item | — |
result.successes[].post.publish_options.allowlisted_country_codes[] | stringOpcional / item | — |
result.successes[].post.publish_options.crossreshare_to_ig | booleanOpcional / item | — |
result.successes[].post.publish_options.crossreshare_to_ig_dark_mode | booleanOpcional / item | — |
result.successes[].post.publish_options.auto_publish_text | booleanOpcional / item | — |
result.successes[].post.publish_options.publication_mode | stringOpcional / item |
|
result.successes[].post.publish_options.backdated_time | numberOpcional / item | — |
result.successes[].post.publish_options.backdated_time_granularity | stringOpcional / item |
|
result.successes[].post.publish_options.place | stringOpcional / item | — |
result.successes[].post.publish_options.feed_targeting | objectOpcional / item |
|
result.successes[].post.publish_options.feed_targeting.* | any JSON valueOpcional / item | — |
result.successes[].post.publish_options.targeting | objectOpcional / item |
|
result.successes[].post.publish_options.targeting.* | any JSON valueOpcional / item | — |
result.successes[].post.publish_options.child_attachments | arrayOpcional / item | — |
result.successes[].post.publish_options.child_attachments[] | objectOpcional / item |
|
result.successes[].post.publish_options.child_attachments[].* | any JSON valueOpcional / item | — |
result.successes[].post.publish_options.multi_share_end_card | booleanOpcional / item | — |
result.successes[].post.publish_options.multi_share_optimized | booleanOpcional / item | — |
result.successes[].post.publish_options.unpublished_content_type | stringOpcional / item | — |
result.successes[].post.publish_options.no_story | booleanOpcional / item | — |
result.successes[].post.publish_options.crossposted_video_id | stringOpcional / item | — |
result.successes[].post.publish_options.spherical | booleanOpcional / item | — |
result.successes[].post.scheduled_at | stringObrigatório no objeto pai | — |
result.successes[].post.display_timezone | stringObrigatório no objeto pai |
|
result.successes[].post.local_scheduled_at | string | nullOpcional / item | — |
result.successes[].post.local_scheduled_atanyOf 1 | stringOpcional / item |
|
result.successes[].post.local_scheduled_atanyOf 2 | nullOpcional / item | — |
result.successes[].post.schedule_timezone | string | nullOpcional / item | — |
result.successes[].post.schedule_timezoneanyOf 1 | stringOpcional / item |
|
result.successes[].post.schedule_timezoneanyOf 2 | nullOpcional / item | — |
result.successes[].post.schedule_dst_disambiguation | string | nullOpcional / item | — |
result.successes[].post.schedule_dst_disambiguationanyOf 1 | stringOpcional / item |
|
result.successes[].post.schedule_dst_disambiguationanyOf 2 | nullOpcional / item | — |
result.successes[].post.schedule_intent_state | stringOpcional / item |
|
result.successes[].post.expires_at | string | nullObrigatório no objeto pai | — |
result.successes[].post.expires_atanyOf 1 | stringObrigatório no objeto pai | — |
result.successes[].post.expires_atanyOf 2 | nullObrigatório no objeto pai | — |
result.successes[].post.status | stringObrigatório no objeto pai |
|
result.successes[].post.version | integerObrigatório no objeto pai |
|
result.successes[].post.automatic_retry_enabled | booleanObrigatório no objeto pai | — |
result.successes[].post.delete_requested_at | string | nullObrigatório no objeto pai | — |
result.successes[].post.delete_requested_atanyOf 1 | stringObrigatório no objeto pai | — |
result.successes[].post.delete_requested_atanyOf 2 | nullObrigatório no objeto pai | — |
result.successes[].post.published_at | string | nullObrigatório no objeto pai | — |
result.successes[].post.published_atanyOf 1 | stringObrigatório no objeto pai | — |
result.successes[].post.published_atanyOf 2 | nullObrigatório no objeto pai | — |
result.successes[].post.deleted_at | string | nullObrigatório no objeto pai | — |
result.successes[].post.deleted_atanyOf 1 | stringObrigatório no objeto pai | — |
result.successes[].post.deleted_atanyOf 2 | nullObrigatório no objeto pai | — |
result.successes[].post.provider_post_id | string | nullObrigatório no objeto pai | — |
result.successes[].post.provider_post_idanyOf 1 | stringObrigatório no objeto pai | — |
result.successes[].post.provider_post_idanyOf 2 | nullObrigatório no objeto pai | — |
result.successes[].post.permalink | string | nullObrigatório no objeto pai | — |
result.successes[].post.permalinkanyOf 1 | stringObrigatório no objeto pai |
|
result.successes[].post.permalinkanyOf 2 | nullObrigatório no objeto pai | — |
result.successes[].post.created_at | stringObrigatório no objeto pai | — |
result.successes[].post.updated_at | stringObrigatório no objeto pai | — |
result.successes[].post.project_id | string | nullObrigatório no objeto pai | — |
result.successes[].post.project_idanyOf 1 | stringObrigatório no objeto pai |
|
result.successes[].post.project_idanyOf 2 | nullObrigatório no objeto pai | — |
result.successes[].post.batch_id | string | nullObrigatório no objeto pai | — |
result.successes[].post.batch_idanyOf 1 | stringObrigatório no objeto pai |
|
result.successes[].post.batch_idanyOf 2 | nullObrigatório no objeto pai | — |
result.successes[].post.source_ref | object | nullObrigatório no objeto pai | — |
result.successes[].post.source_refanyOf 1 | objectObrigatório no objeto pai |
|
result.successes[].post.source_ref.*anyOf 1 | any JSON valueOpcional / item | — |
result.successes[].post.source_refanyOf 2 | nullObrigatório no objeto pai | — |
result.failures | arrayObrigatório no objeto pai | — |
result.failures[] | objectOpcional / item | — |
result.failures[].social_account_id | stringObrigatório no objeto pai |
|
result.failures[].code | stringObrigatório no objeto pai | — |
result.failures[].message | stringObrigatório no objeto pai | — |
JSON Schema completo
{
"$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"
]
}Erros e repetições seguras
Confira o status HTTP e o corpo da resposta. Um erro de validação 400 pode conter ZodError; erros do handler usam os campos error, message e code. Guarde request_id ou x-request-id para diagnóstico, sem credenciais. Corrija erros de acesso 401/403 antes de tentar novamente e siga Retry-After para 429. Se uma gravação for incerta ou retornar 5xx, consulte primeiro o resultado existente. Reutilize uma chave de idempotência somente quando houver suporte; o comportamento de repetição varia por operação e não garante entrega exatamente uma vez.
Guia de solução de problemasExemplos
Estes exemplos usam valores fictícios verificados conforme os schemas. Substitua os IDs por aqueles que você tem autorização para usar, a mídia por ativos prontos e as datas pelo horário de publicação confirmado. Confira a elegibilidade da conta antes de enviar uma gravação. Esta página não envia requisições de API.
Defina SOSOAPI_ACCESS_TOKEN no servidor como uma credencial aceita por esta operação e mantenha-a fora do código do navegador. Para agentes, use sosoapi auth login para entrar pelo navegador e deixe a CLI renovar suas credenciais.
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.jsonExemplo de resposta sintética
{
"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."
}
]
}
}