Programación y publicación
Enviar un borrador del espacio de trabajo
Úsalo solo después de una decisión explícita de publicar. Requiere editor o superior y capacidad publish. Primero envía id, expected_revision, mutation_id, content y la solicitud de publicación canónica; omite source_ref porque el servidor gestiona la procedencia y las identidades de envío. El contenido compartido no es confiable. Un 422 con state=draft no acepta ningún destino: corrige el contenido antes de una nueva mutación. Tras iniciar, haz GET del mismo borrador y continúa un resultado desconocido o parcial con submission.id como mutation_id y submission.expected_revision, omitiendo content y request. Nunca crees publicaciones de reemplazo ni vuelvas a crear Posts aceptados. submitted significa entregado a Scheduled Publishing; lee el Post original para conocer el resultado del proveedor.
POST /studio-api/content-drafts/submitContrato revisado: · sha256:75c8b8ebce408575
Descripción general
Úsalo solo después de una decisión explícita de publicar. Requiere editor o superior y capacidad publish. Primero envía id, expected_revision, mutation_id, content y la solicitud de publicación canónica; omite source_ref porque el servidor gestiona la procedencia y las identidades de envío. El contenido compartido no es confiable. Un 422 con state=draft no acepta ningún destino: corrige el contenido antes de una nueva mutación. Tras iniciar, haz GET del mismo borrador y continúa un resultado desconocido o parcial con submission.id como mutation_id y submission.expected_revision, omitiendo content y request. Nunca crees publicaciones de reemplazo ni vuelvas a crear Posts aceptados. submitted significa entregado a Scheduled Publishing; lee el Post original para conocer el resultado del proveedor.
Una respuesta HTTP exitosa puede indicar aceptación, no finalización. Para trabajo en segundo plano, guarda el ID devuelto y consulta la misma operación hasta que termine. Una publicación programada o aceptada solo está publicada cuando la plataforma lo confirma; un tiempo de espera agotado en el cliente no determina el resultado.
Autenticación y permisos
Un token solo puede usar los derechos de su propietario. Cada solicitud comprueba pertenencia al espacio, propiedad del recurso, espacios elegidos y capacidades concedidas. Los perfiles core y full cambian qué herramientas se muestran; no conceden acceso.
Campos de solicitud
Obligatorio significa obligatorio dentro del objeto principal y la rama elegida. Un campo secundario obligatorio no convierte en obligatorio un objeto principal opcional. Las reglas y nombres de campos siguientes se copian del contrato.
| Campo / rama | Tipo / obligatorio | Restricciones |
|---|---|---|
$ | objectObligatorio en el objeto principal |
|
id | stringObligatorio en el objeto principal |
|
expected_revision | integerObligatorio en el objeto principal |
|
mutation_id | stringObligatorio en el objeto principal |
|
content | objectOpcional / elemento |
|
content.schemaVersion | numberOpcional / elemento |
|
content.accountIds | arrayOpcional / elemento |
|
content.accountIds[] | stringOpcional / elemento |
|
content.caption | stringOpcional / elemento |
|
content.hashtags | stringOpcional / elemento |
|
content.assetIds | arrayOpcional / elemento |
|
content.assetIds[] | stringOpcional / elemento |
|
content.threadsTextOnly | booleanOpcional / elemento |
|
content.instagramMode | stringOpcional / elemento |
|
content.youtubeTitle | stringOpcional / elemento |
|
content.youtubePrivacy | stringOpcional / elemento |
|
content.youtubeSynthetic | booleanOpcional / elemento |
|
content.youtubeCategoryId | stringOpcional / elemento |
|
content.youtubeShort | booleanOpcional / elemento |
|
content.linkUrl | stringOpcional / elemento |
|
content.scheduledAt | stringOpcional / elemento |
|
content.displayTimezone | stringOpcional / elemento |
|
content.publishNow | booleanOpcional / elemento |
|
content.destinationOverrides | objectOpcional / elemento |
|
content.destinationOverrides.* | objectOpcional / elemento |
|
content.destinationOverrides.*.caption | stringOpcional / elemento |
|
content.destinationOverrides.*.scheduledAt | stringOpcional / elemento |
|
content.expiresAt | stringOpcional / elemento |
|
request | objectOpcional / elemento |
|
request.workspace_id | stringObligatorio en el objeto principal |
|
request.project_id | string | nullOpcional / elemento | — |
request.project_idanyOf 1 | stringOpcional / elemento |
|
request.project_idanyOf 2 | nullOpcional / elemento | — |
request.source_ref | object | nullOpcional / elemento | — |
request.source_refanyOf 1 | objectOpcional / elemento |
|
request.source_ref.*anyOf 1 | any JSON valueOpcional / elemento | — |
request.source_refanyOf 2 | nullOpcional / elemento | — |
request.targets | arrayObligatorio en el objeto principal |
|
request.targets[] | objectOpcional / elemento |
|
request.targets[].social_account_id | stringObligatorio en el objeto principal |
|
request.targets[].caption | string | nullOpcional / elemento |
|
request.targets[].captionanyOf 1 | stringOpcional / elemento |
|
request.targets[].captionanyOf 2 | nullOpcional / elemento | — |
request.targets[].hashtags | arrayOpcional / elemento |
|
request.targets[].hashtags[] | stringOpcional / elemento |
|
request.targets[].media | arrayOpcional / elemento |
|
request.targets[].media[] | objectOpcional / elemento |
|
request.targets[].media[].kind | stringObligatorio en el objeto principal |
|
request.targets[].media[].url | stringObligatorio en el objeto principal |
|
request.targets[].media[].cover_url | string | nullOpcional / elemento | — |
request.targets[].media[].cover_urlanyOf 1 | stringOpcional / elemento |
|
request.targets[].media[].cover_urlanyOf 2 | nullOpcional / elemento | — |
request.targets[].media[].cover_asset_id | integer | nullOpcional / elemento | — |
request.targets[].media[].cover_asset_idanyOf 1 | integerOpcional / elemento |
|
request.targets[].media[].cover_asset_idanyOf 2 | nullOpcional / elemento | — |
request.targets[].media[].asset_id | integer | nullOpcional / elemento | — |
request.targets[].media[].asset_idanyOf 1 | integerOpcional / elemento |
|
request.targets[].media[].asset_idanyOf 2 | nullOpcional / elemento | — |
request.targets[].media[].mime_type | string | nullOpcional / elemento | — |
request.targets[].media[].mime_typeanyOf 1 | stringOpcional / elemento |
|
request.targets[].media[].mime_typeanyOf 2 | nullOpcional / elemento | — |
request.targets[].link_url | string | nullOpcional / elemento | — |
request.targets[].link_urlanyOf 1 | stringOpcional / elemento |
|
request.targets[].link_urlanyOf 2 | nullOpcional / elemento | — |
request.targets[].provider_payload | objectObligatorio en el objeto principal | — |
request.targets[].provider_payloadoneOf 1 | objectObligatorio en el objeto principal |
|
request.targets[].provider_payload.platformoneOf 1 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_optionsoneOf 1 | objectObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.post_typeoneOf 1 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payloadoneOf 2 | objectObligatorio en el objeto principal |
|
request.targets[].provider_payload.platformoneOf 2 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_optionsoneOf 2 | objectObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.post_typeoneOf 2 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.location_idoneOf 2 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.share_to_feedoneOf 2 | booleanOpcional / elemento | — |
request.targets[].provider_payload.publish_options.collaboratorsoneOf 2 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.collaborators[]oneOf 2 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.first_commentoneOf 2 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.cover_asset_idoneOf 2 | integerOpcional / elemento |
|
request.targets[].provider_payload.publish_options.thumb_offset_msoneOf 2 | integerOpcional / elemento |
|
request.targets[].provider_payload.publish_options.audio_nameoneOf 2 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.trial_paramsoneOf 2 | objectOpcional / elemento |
|
request.targets[].provider_payload.publish_options.trial_params.graduation_strategyoneOf 2 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.is_ai_generatedoneOf 2 | booleanOpcional / elemento | — |
request.targets[].provider_payload.publish_options.branded_content_sponsor_idsoneOf 2 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.branded_content_sponsor_ids[]oneOf 2 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.is_paid_partnershiponeOf 2 | booleanOpcional / elemento | — |
request.targets[].provider_payload.publish_options.media_optionsoneOf 2 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.media_options[]oneOf 2 | objectOpcional / elemento |
|
request.targets[].provider_payload.publish_options.media_options[].asset_idoneOf 2 | integerObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.media_options[].alt_textoneOf 2 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.media_options[].user_tagsoneOf 2 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.media_options[].user_tags[]oneOf 2 | objectOpcional / elemento |
|
request.targets[].provider_payload.publish_options.media_options[].user_tags[].usernameoneOf 2 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.media_options[].user_tags[].xoneOf 2 | numberOpcional / elemento |
|
request.targets[].provider_payload.publish_options.media_options[].user_tags[].yoneOf 2 | numberOpcional / elemento |
|
request.targets[].provider_payload.publish_options.media_options[].product_tagsoneOf 2 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.media_options[].product_tags[]oneOf 2 | objectOpcional / elemento |
|
request.targets[].provider_payload.publish_options.media_options[].product_tags[].product_idoneOf 2 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.media_options[].product_tags[].xoneOf 2 | numberOpcional / elemento |
|
request.targets[].provider_payload.publish_options.media_options[].product_tags[].yoneOf 2 | numberOpcional / elemento |
|
request.targets[].provider_payload.publish_options.media_options[].thumb_offset_msoneOf 2 | integerOpcional / elemento |
|
request.targets[].provider_payloadoneOf 3 | objectObligatorio en el objeto principal |
|
request.targets[].provider_payload.platformoneOf 3 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_optionsoneOf 3 | objectObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.post_typeoneOf 3 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.titleoneOf 3 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.descriptiononeOf 3 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.publication_modeoneOf 3 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.backdated_timeoneOf 3 | numberOpcional / elemento | — |
request.targets[].provider_payload.publish_options.backdated_time_granularityoneOf 3 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.placeoneOf 3 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.tagsoneOf 3 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.tags[]oneOf 3 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targetingoneOf 3 | objectOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.age_minoneOf 3 | integerOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.age_maxoneOf 3 | integerOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.college_yearsoneOf 3 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.college_years[]oneOf 3 | integerOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.education_statusesoneOf 3 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 | numberOpcional / elemento | — |
request.targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 / anyOf 1 | numberOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 / anyOf 2 | numberOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 / anyOf 3 | numberOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.gendersoneOf 3 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.genders[]oneOf 3 | numberOpcional / elemento | — |
request.targets[].provider_payload.publish_options.feed_targeting.genders[]oneOf 3 / anyOf 1 | numberOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.genders[]oneOf 3 / anyOf 2 | numberOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locationsoneOf 3 | objectOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.countriesoneOf 3 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.countries[]oneOf 3 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.regionsoneOf 3 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[]oneOf 3 | objectOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyoneOf 3 | string | integerObligatorio en el objeto principal | — |
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyoneOf 3 / anyOf 1 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyoneOf 3 / anyOf 2 | integerObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.citiesoneOf 3 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[]oneOf 3 | objectOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyoneOf 3 | string | integerObligatorio en el objeto principal | — |
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyoneOf 3 / anyOf 1 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyoneOf 3 / anyOf 2 | integerObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].radiusoneOf 3 | numberOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].distance_unitoneOf 3 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.zipsoneOf 3 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[]oneOf 3 | objectOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyoneOf 3 | string | integerObligatorio en el objeto principal | — |
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyoneOf 3 / anyOf 1 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyoneOf 3 / anyOf 2 | integerObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.location_typesoneOf 3 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.geo_locations.location_types[]oneOf 3 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.interestsoneOf 3 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.interests[]oneOf 3 | string | integerOpcional / elemento | — |
request.targets[].provider_payload.publish_options.feed_targeting.interests[]oneOf 3 / anyOf 1 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.interests[]oneOf 3 / anyOf 2 | integerOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.localesoneOf 3 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.locales[]oneOf 3 | integerOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statusesoneOf 3 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 | numberOpcional / elemento | — |
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 1 | numberOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 2 | numberOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 3 | numberOpcional / elemento |
|
request.targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 4 | numberOpcional / elemento |
|
request.targets[].provider_payload.publish_options.targetingoneOf 3 | objectOpcional / elemento |
|
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 | numberOpcional / elemento | — |
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 1 | numberOpcional / elemento |
|
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 2 | numberOpcional / elemento |
|
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 3 | numberOpcional / elemento |
|
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 4 | numberOpcional / elemento |
|
request.targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 5 | numberOpcional / elemento |
|
request.targets[].provider_payload.publish_options.targeting.geo_locationsoneOf 3 | objectOpcional / elemento |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.countriesoneOf 3 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.countries[]oneOf 3 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.regionsoneOf 3 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.regions[]oneOf 3 | objectOpcional / elemento |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.regions[].keyoneOf 3 | string | integerObligatorio en el objeto principal | — |
request.targets[].provider_payload.publish_options.targeting.geo_locations.regions[].keyoneOf 3 / anyOf 1 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.regions[].keyoneOf 3 / anyOf 2 | integerObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.citiesoneOf 3 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[]oneOf 3 | objectOpcional / elemento |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[].keyoneOf 3 | string | integerObligatorio en el objeto principal | — |
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[].keyoneOf 3 / anyOf 1 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[].keyoneOf 3 / anyOf 2 | integerObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[].radiusoneOf 3 | numberOpcional / elemento |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.cities[].distance_unitoneOf 3 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.zipsoneOf 3 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.zips[]oneOf 3 | objectOpcional / elemento |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.zips[].keyoneOf 3 | string | integerObligatorio en el objeto principal | — |
request.targets[].provider_payload.publish_options.targeting.geo_locations.zips[].keyoneOf 3 / anyOf 1 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.zips[].keyoneOf 3 / anyOf 2 | integerObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.location_typesoneOf 3 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.targeting.geo_locations.location_types[]oneOf 3 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.child_attachmentsoneOf 3 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.child_attachments[]oneOf 3 | objectOpcional / elemento |
|
request.targets[].provider_payload.publish_options.child_attachments[].linkoneOf 3 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.child_attachments[].nameoneOf 3 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.child_attachments[].descriptiononeOf 3 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.child_attachments[].pictureoneOf 3 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.multi_share_end_cardoneOf 3 | booleanOpcional / elemento | — |
request.targets[].provider_payload.publish_options.multi_share_optimizedoneOf 3 | booleanOpcional / elemento | — |
request.targets[].provider_payload.publish_options.unpublished_content_typeoneOf 3 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.no_storyoneOf 3 | booleanOpcional / elemento | — |
request.targets[].provider_payload.publish_options.crossposted_video_idoneOf 3 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.sphericaloneOf 3 | booleanOpcional / elemento | — |
request.targets[].provider_payload.publish_options.media_optionsoneOf 3 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.media_options[]oneOf 3 | objectOpcional / elemento |
|
request.targets[].provider_payload.publish_options.media_options[].asset_idoneOf 3 | integerObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.media_options[].alt_text_customoneOf 3 | stringOpcional / elemento |
|
request.targets[].provider_payloadoneOf 4 | objectObligatorio en el objeto principal |
|
request.targets[].provider_payload.platformoneOf 4 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_optionsoneOf 4 | objectObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.post_typeoneOf 4 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.reply_to_idoneOf 4 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.quote_post_idoneOf 4 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.repost_target_idoneOf 4 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.reply_controloneOf 4 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.enable_reply_approvalsoneOf 4 | booleanOpcional / elemento | — |
request.targets[].provider_payload.publish_options.link_attachmentoneOf 4 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.poll_attachmentoneOf 4 | objectOpcional / elemento |
|
request.targets[].provider_payload.publish_options.poll_attachment.option_aoneOf 4 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.poll_attachment.option_boneOf 4 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.poll_attachment.option_coneOf 4 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.poll_attachment.option_doneOf 4 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.gif_attachmentoneOf 4 | objectOpcional / elemento |
|
request.targets[].provider_payload.publish_options.gif_attachment.gif_idoneOf 4 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.gif_attachment.provideroneOf 4 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.text_attachmentoneOf 4 | objectOpcional / elemento |
|
request.targets[].provider_payload.publish_options.text_attachment.plaintextoneOf 4 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.text_attachment.link_attachment_urloneOf 4 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_infooneOf 4 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[]oneOf 4 | objectOpcional / elemento |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].offsetoneOf 4 | integerObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].lengthoneOf 4 | integerObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].styling_infooneOf 4 | arrayObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].styling_info[]oneOf 4 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.topic_tagoneOf 4 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.text_entitiesoneOf 4 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.text_entities[]oneOf 4 | objectOpcional / elemento |
|
request.targets[].provider_payload.publish_options.text_entities[].entity_typeoneOf 4 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.text_entities[].offsetoneOf 4 | integerObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.text_entities[].lengthoneOf 4 | integerObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.is_spoiler_mediaoneOf 4 | booleanOpcional / elemento | — |
request.targets[].provider_payload.publish_options.is_ghost_postoneOf 4 | booleanOpcional / elemento | — |
request.targets[].provider_payload.publish_options.location_idoneOf 4 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.allowlisted_country_codesoneOf 4 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.allowlisted_country_codes[]oneOf 4 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.crossreshare_to_igoneOf 4 | booleanOpcional / elemento | — |
request.targets[].provider_payload.publish_options.crossreshare_to_ig_dark_modeoneOf 4 | booleanOpcional / elemento | — |
request.targets[].provider_payload.publish_options.auto_publish_textoneOf 4 | booleanOpcional / elemento | — |
request.targets[].provider_payload.publish_options.media_optionsoneOf 4 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.media_options[]oneOf 4 | objectOpcional / elemento |
|
request.targets[].provider_payload.publish_options.media_options[].asset_idoneOf 4 | integerObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.media_options[].alt_textoneOf 4 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.media_options[].is_spoiler_mediaoneOf 4 | booleanOpcional / elemento | — |
request.targets[].provider_payloadoneOf 5 | objectObligatorio en el objeto principal |
|
request.targets[].provider_payload.platformoneOf 5 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_optionsoneOf 5 | objectObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.post_typeoneOf 5 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.titleoneOf 5 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.descriptiononeOf 5 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.tagsoneOf 5 | arrayOpcional / elemento |
|
request.targets[].provider_payload.publish_options.tags[]oneOf 5 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.category_idoneOf 5 | stringOpcional / elemento | — |
request.targets[].provider_payload.publish_options.category_idoneOf 5 / anyOf 1 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.category_idoneOf 5 / anyOf 2 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.default_languageoneOf 5 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.localizationsoneOf 5 | objectOpcional / elemento |
|
request.targets[].provider_payload.publish_options.localizations.*oneOf 5 | objectOpcional / elemento |
|
request.targets[].provider_payload.publish_options.localizations.*.titleoneOf 5 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.localizations.*.descriptiononeOf 5 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.privacy_statusoneOf 5 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.cancellation_modeoneOf 5 | stringObligatorio en el objeto principal |
|
request.targets[].provider_payload.publish_options.licenseoneOf 5 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.embeddableoneOf 5 | booleanOpcional / elemento | — |
request.targets[].provider_payload.publish_options.public_stats_viewableoneOf 5 | booleanOpcional / elemento | — |
request.targets[].provider_payload.publish_options.self_declared_made_for_kidsoneOf 5 | booleanOpcional / elemento | — |
request.targets[].provider_payload.publish_options.contains_synthetic_mediaoneOf 5 | booleanOpcional / elemento | — |
request.targets[].provider_payload.publish_options.has_paid_product_placementoneOf 5 | booleanOpcional / elemento | — |
request.targets[].provider_payload.publish_options.recording_dateoneOf 5 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.notify_subscribersoneOf 5 | booleanOpcional / elemento | — |
request.targets[].provider_payload.publish_options.thumbnail_asset_idoneOf 5 | integerOpcional / elemento |
|
request.targets[].provider_payload.publish_options.surface_expectationoneOf 5 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.brand_partneroneOf 5 | objectOpcional / elemento |
|
request.targets[].provider_payload.publish_options.brand_partner.channel_idoneOf 5 | stringOpcional / elemento |
|
request.targets[].provider_payload.publish_options.brand_partner.channel_handleoneOf 5 | stringOpcional / elemento |
|
request.targets[].scheduled_at | stringObligatorio en el objeto principal |
|
request.targets[].display_timezone | stringOpcional / elemento |
|
request.targets[].local_scheduled_at | stringOpcional / elemento |
|
request.targets[].schedule_dst_disambiguation | stringOpcional / elemento |
|
request.targets[].expires_at | string | nullOpcional / elemento | — |
request.targets[].expires_atanyOf 1 | stringOpcional / elemento |
|
request.targets[].expires_atanyOf 2 | nullOpcional / elemento | — |
request.targets[].source_ref | object | nullOpcional / elemento | — |
request.targets[].source_refanyOf 1 | objectOpcional / elemento |
|
request.targets[].source_ref.*anyOf 1 | any JSON valueOpcional / elemento | — |
request.targets[].source_refanyOf 2 | nullOpcional / elemento | — |
request.targets[].automatic_retry_enabled | booleanOpcional / elemento |
|
request.targets[].idempotency_key | stringObligatorio en el objeto principal |
|
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
}Respuesta y finalización
Estados HTTP de éxito: 200, 422. Cuando la operación se completa: durable destination acceptance; provider publication is separate.
Una respuesta HTTP exitosa puede indicar aceptación, no finalización. Para trabajo en segundo plano, guarda el ID devuelto y consulta la misma operación hasta que termine. Una publicación programada o aceptada solo está publicada cuando la plataforma lo confirma; un tiempo de espera agotado en el cliente no determina el resultado.
Obligatorio significa obligatorio dentro del objeto principal y la rama elegida. Un campo secundario obligatorio no convierte en obligatorio un objeto principal opcional. Las reglas y nombres de campos siguientes se copian del contrato.
| Campo / rama | Tipo / obligatorio | Restricciones |
|---|---|---|
$ | objectObligatorio en el objeto principal | — |
draft | objectObligatorio en el objeto principal | — |
draft.id | stringObligatorio en el objeto principal |
|
draft.workspace_id | stringObligatorio en el objeto principal |
|
draft.revision | integerObligatorio en el objeto principal |
|
draft.state | stringObligatorio en el objeto principal |
|
draft.content | objectObligatorio en el objeto principal | — |
draft.content.schemaVersion | numberObligatorio en el objeto principal |
|
draft.content.accountIds | arrayObligatorio en el objeto principal |
|
draft.content.accountIds[] | stringOpcional / elemento |
|
draft.content.caption | stringObligatorio en el objeto principal |
|
draft.content.hashtags | stringObligatorio en el objeto principal |
|
draft.content.assetIds | arrayObligatorio en el objeto principal |
|
draft.content.assetIds[] | stringOpcional / elemento |
|
draft.content.threadsTextOnly | booleanObligatorio en el objeto principal |
|
draft.content.instagramMode | stringObligatorio en el objeto principal |
|
draft.content.youtubeTitle | stringObligatorio en el objeto principal |
|
draft.content.youtubePrivacy | stringObligatorio en el objeto principal |
|
draft.content.youtubeSynthetic | booleanObligatorio en el objeto principal |
|
draft.content.youtubeCategoryId | stringObligatorio en el objeto principal |
|
draft.content.youtubeShort | booleanObligatorio en el objeto principal |
|
draft.content.linkUrl | stringObligatorio en el objeto principal |
|
draft.content.scheduledAt | stringObligatorio en el objeto principal |
|
draft.content.displayTimezone | stringObligatorio en el objeto principal |
|
draft.content.publishNow | booleanObligatorio en el objeto principal |
|
draft.content.destinationOverrides | objectObligatorio en el objeto principal |
|
draft.content.destinationOverrides.* | objectOpcional / elemento | — |
draft.content.destinationOverrides.*.caption | stringOpcional / elemento |
|
draft.content.destinationOverrides.*.scheduledAt | stringOpcional / elemento |
|
draft.content.expiresAt | stringObligatorio en el objeto principal |
|
draft.created_by | string | nullObligatorio en el objeto principal | — |
draft.created_byanyOf 1 | stringObligatorio en el objeto principal |
|
draft.created_byanyOf 2 | nullObligatorio en el objeto principal | — |
draft.updated_by | string | nullObligatorio en el objeto principal | — |
draft.updated_byanyOf 1 | stringObligatorio en el objeto principal |
|
draft.updated_byanyOf 2 | nullObligatorio en el objeto principal | — |
draft.created_at | stringObligatorio en el objeto principal |
|
draft.updated_at | stringObligatorio en el objeto principal |
|
draft.submission | object | nullObligatorio en el objeto principal | — |
draft.submissionanyOf 1 | objectObligatorio en el objeto principal | — |
draft.submission.idanyOf 1 | stringObligatorio en el objeto principal |
|
draft.submission.expected_revisionanyOf 1 | integerObligatorio en el objeto principal |
|
draft.submission.started_atanyOf 1 | stringObligatorio en el objeto principal |
|
draft.submission.receiptanyOf 1 | object | nullObligatorio en el objeto principal | — |
draft.submission.receiptanyOf 1 / anyOf 1 | objectObligatorio en el objeto principal | — |
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 | string | nullObligatorio en el objeto principal | — |
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 / anyOf 1 | stringObligatorio en el objeto principal |
|
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 / anyOf 2 | nullObligatorio en el objeto principal | — |
draft.submission.receipt.successesanyOf 1 / anyOf 1 | arrayObligatorio en el objeto principal |
|
draft.submission.receipt.successes[]anyOf 1 / anyOf 1 | objectOpcional / elemento | — |
draft.submission.receipt.successes[].social_account_idanyOf 1 / anyOf 1 | stringObligatorio en el objeto principal |
|
draft.submission.receipt.successes[].post_idanyOf 1 / anyOf 1 | stringObligatorio en el objeto principal |
|
draft.submission.receipt.failuresanyOf 1 / anyOf 1 | arrayObligatorio en el objeto principal |
|
draft.submission.receipt.failures[]anyOf 1 / anyOf 1 | objectOpcional / elemento | — |
draft.submission.receipt.failures[].social_account_idanyOf 1 / anyOf 1 | stringObligatorio en el objeto principal |
|
draft.submission.receipt.failures[].codeanyOf 1 / anyOf 1 | stringObligatorio en el objeto principal |
|
draft.submission.receipt.failures[].messageanyOf 1 / anyOf 1 | stringObligatorio en el objeto principal |
|
draft.submission.receiptanyOf 1 / anyOf 2 | nullObligatorio en el objeto principal | — |
draft.submissionanyOf 2 | nullObligatorio en el objeto principal | — |
result | objectObligatorio en el objeto principal | — |
result.batch_id | string | nullObligatorio en el objeto principal | — |
result.batch_idanyOf 1 | stringObligatorio en el objeto principal |
|
result.batch_idanyOf 2 | nullObligatorio en el objeto principal | — |
result.successes | arrayObligatorio en el objeto principal | — |
result.successes[] | objectOpcional / elemento | — |
result.successes[].social_account_id | stringObligatorio en el objeto principal |
|
result.successes[].post | objectObligatorio en el objeto principal | — |
result.successes[].post.id | stringObligatorio en el objeto principal |
|
result.successes[].post.workspace_id | stringObligatorio en el objeto principal |
|
result.successes[].post.social_account_id | string | nullObligatorio en el objeto principal | — |
result.successes[].post.social_account_idanyOf 1 | stringObligatorio en el objeto principal |
|
result.successes[].post.social_account_idanyOf 2 | nullObligatorio en el objeto principal | — |
result.successes[].post.platform | stringObligatorio en el objeto principal |
|
result.successes[].post.destination | objectObligatorio en el objeto principal | — |
result.successes[].post.destination.social_account_id | string | nullObligatorio en el objeto principal | — |
result.successes[].post.destination.social_account_idanyOf 1 | stringObligatorio en el objeto principal |
|
result.successes[].post.destination.social_account_idanyOf 2 | nullObligatorio en el objeto principal | — |
result.successes[].post.destination.platform | stringObligatorio en el objeto principal |
|
result.successes[].post.destination.platform_user_id | string | nullObligatorio en el objeto principal | — |
result.successes[].post.destination.platform_user_idanyOf 1 | stringObligatorio en el objeto principal | — |
result.successes[].post.destination.platform_user_idanyOf 2 | nullObligatorio en el objeto principal | — |
result.successes[].post.destination.account_label | string | nullObligatorio en el objeto principal | — |
result.successes[].post.destination.account_labelanyOf 1 | stringObligatorio en el objeto principal | — |
result.successes[].post.destination.account_labelanyOf 2 | nullObligatorio en el objeto principal | — |
result.successes[].post.caption | string | nullObligatorio en el objeto principal | — |
result.successes[].post.captionanyOf 1 | stringObligatorio en el objeto principal | — |
result.successes[].post.captionanyOf 2 | nullObligatorio en el objeto principal | — |
result.successes[].post.hashtags | arrayObligatorio en el objeto principal | — |
result.successes[].post.hashtags[] | stringOpcional / elemento | — |
result.successes[].post.media | arrayObligatorio en el objeto principal | — |
result.successes[].post.media[] | objectOpcional / elemento | — |
result.successes[].post.media[].kind | stringObligatorio en el objeto principal |
|
result.successes[].post.media[].url | stringObligatorio en el objeto principal |
|
result.successes[].post.media[].cover_url | string | nullOpcional / elemento | — |
result.successes[].post.media[].cover_urlanyOf 1 | stringOpcional / elemento |
|
result.successes[].post.media[].cover_urlanyOf 2 | nullOpcional / elemento | — |
result.successes[].post.media[].cover_asset_id | integer | nullOpcional / elemento | — |
result.successes[].post.media[].cover_asset_idanyOf 1 | integerOpcional / elemento |
|
result.successes[].post.media[].cover_asset_idanyOf 2 | nullOpcional / elemento | — |
result.successes[].post.media[].asset_id | integer | nullOpcional / elemento | — |
result.successes[].post.media[].asset_idanyOf 1 | integerOpcional / elemento |
|
result.successes[].post.media[].asset_idanyOf 2 | nullOpcional / elemento | — |
result.successes[].post.media[].mime_type | string | nullOpcional / elemento | — |
result.successes[].post.media[].mime_typeanyOf 1 | stringOpcional / elemento |
|
result.successes[].post.media[].mime_typeanyOf 2 | nullOpcional / elemento | — |
result.successes[].post.media[].preview_url | string | nullOpcional / elemento | URL temporal autorizada de lectura; conserva url como identidad multimedia persistente de la publicación programada. — |
result.successes[].post.media[].preview_urlanyOf 1 | stringOpcional / elemento |
|
result.successes[].post.media[].preview_urlanyOf 2 | nullOpcional / elemento | — |
result.successes[].post.media[].cover_preview_url | string | nullOpcional / elemento | URL temporal autorizada de lectura de portada; conserva cover_url como identidad multimedia persistente. — |
result.successes[].post.media[].cover_preview_urlanyOf 1 | stringOpcional / elemento |
|
result.successes[].post.media[].cover_preview_urlanyOf 2 | nullOpcional / elemento | — |
result.successes[].post.media[].preview_expires_at | string | nullOpcional / elemento | — |
result.successes[].post.media[].preview_expires_atanyOf 1 | stringOpcional / elemento |
|
result.successes[].post.media[].preview_expires_atanyOf 2 | nullOpcional / elemento | — |
result.successes[].post.link_url | string | nullOpcional / elemento | — |
result.successes[].post.link_urlanyOf 1 | stringOpcional / elemento |
|
result.successes[].post.link_urlanyOf 2 | nullOpcional / elemento | — |
result.successes[].post.publish_options | objectObligatorio en el objeto principal | — |
result.successes[].post.publish_options.post_type | stringOpcional / elemento |
|
result.successes[].post.publish_options.location_id | stringOpcional / elemento |
|
result.successes[].post.publish_options.share_to_feed | booleanOpcional / elemento | — |
result.successes[].post.publish_options.collaborators | arrayOpcional / elemento |
|
result.successes[].post.publish_options.collaborators[] | stringOpcional / elemento |
|
result.successes[].post.publish_options.first_comment | stringOpcional / elemento |
|
result.successes[].post.publish_options.topic_tag | stringOpcional / elemento |
|
result.successes[].post.publish_options.thumb_offset_ms | integerOpcional / elemento |
|
result.successes[].post.publish_options.title | stringOpcional / elemento |
|
result.successes[].post.publish_options.youtube_privacy_status | stringOpcional / elemento |
|
result.successes[].post.publish_options.youtube_category_id | stringOpcional / elemento |
|
result.successes[].post.publish_options.youtube_contains_synthetic_media | booleanOpcional / elemento | — |
result.successes[].post.publish_options.description | stringOpcional / elemento |
|
result.successes[].post.publish_options.category_id | stringOpcional / elemento |
|
result.successes[].post.publish_options.privacy_status | stringOpcional / elemento |
|
result.successes[].post.publish_options.cancellation_mode | stringOpcional / elemento |
|
result.successes[].post.publish_options.tags | arrayOpcional / elemento | — |
result.successes[].post.publish_options.tags[] | stringOpcional / elemento | — |
result.successes[].post.publish_options.default_language | stringOpcional / elemento | — |
result.successes[].post.publish_options.localizations | objectOpcional / elemento |
|
result.successes[].post.publish_options.localizations.* | any JSON valueOpcional / elemento | — |
result.successes[].post.publish_options.license | stringOpcional / elemento |
|
result.successes[].post.publish_options.embeddable | booleanOpcional / elemento | — |
result.successes[].post.publish_options.public_stats_viewable | booleanOpcional / elemento | — |
result.successes[].post.publish_options.self_declared_made_for_kids | booleanOpcional / elemento | — |
result.successes[].post.publish_options.contains_synthetic_media | booleanOpcional / elemento | — |
result.successes[].post.publish_options.has_paid_product_placement | booleanOpcional / elemento | — |
result.successes[].post.publish_options.recording_date | stringOpcional / elemento | — |
result.successes[].post.publish_options.notify_subscribers | booleanOpcional / elemento | — |
result.successes[].post.publish_options.thumbnail_asset_id | integerOpcional / elemento |
|
result.successes[].post.publish_options.surface_expectation | stringOpcional / elemento |
|
result.successes[].post.publish_options.brand_partner | objectOpcional / elemento |
|
result.successes[].post.publish_options.brand_partner.* | any JSON valueOpcional / elemento | — |
result.successes[].post.publish_options.cover_asset_id | integerOpcional / elemento |
|
result.successes[].post.publish_options.audio_name | stringOpcional / elemento | — |
result.successes[].post.publish_options.trial_params | objectOpcional / elemento |
|
result.successes[].post.publish_options.trial_params.* | any JSON valueOpcional / elemento | — |
result.successes[].post.publish_options.is_ai_generated | booleanOpcional / elemento | — |
result.successes[].post.publish_options.branded_content_sponsor_ids | arrayOpcional / elemento | — |
result.successes[].post.publish_options.branded_content_sponsor_ids[] | stringOpcional / elemento | — |
result.successes[].post.publish_options.is_paid_partnership | booleanOpcional / elemento | — |
result.successes[].post.publish_options.media_options | arrayOpcional / elemento | — |
result.successes[].post.publish_options.media_options[] | objectOpcional / elemento |
|
result.successes[].post.publish_options.media_options[].* | any JSON valueOpcional / elemento | — |
result.successes[].post.publish_options.reply_to_id | stringOpcional / elemento | — |
result.successes[].post.publish_options.quote_post_id | stringOpcional / elemento | — |
result.successes[].post.publish_options.repost_target_id | stringOpcional / elemento | — |
result.successes[].post.publish_options.reply_control | stringOpcional / elemento | — |
result.successes[].post.publish_options.enable_reply_approvals | booleanOpcional / elemento | — |
result.successes[].post.publish_options.link_attachment | stringOpcional / elemento |
|
result.successes[].post.publish_options.poll_attachment | objectOpcional / elemento |
|
result.successes[].post.publish_options.poll_attachment.* | any JSON valueOpcional / elemento | — |
result.successes[].post.publish_options.gif_attachment | objectOpcional / elemento |
|
result.successes[].post.publish_options.gif_attachment.* | any JSON valueOpcional / elemento | — |
result.successes[].post.publish_options.text_attachment | objectOpcional / elemento |
|
result.successes[].post.publish_options.text_attachment.* | any JSON valueOpcional / elemento | — |
result.successes[].post.publish_options.text_entities | arrayOpcional / elemento | — |
result.successes[].post.publish_options.text_entities[] | objectOpcional / elemento |
|
result.successes[].post.publish_options.text_entities[].* | any JSON valueOpcional / elemento | — |
result.successes[].post.publish_options.is_spoiler_media | booleanOpcional / elemento | — |
result.successes[].post.publish_options.is_ghost_post | booleanOpcional / elemento | — |
result.successes[].post.publish_options.allowlisted_country_codes | arrayOpcional / elemento | — |
result.successes[].post.publish_options.allowlisted_country_codes[] | stringOpcional / elemento | — |
result.successes[].post.publish_options.crossreshare_to_ig | booleanOpcional / elemento | — |
result.successes[].post.publish_options.crossreshare_to_ig_dark_mode | booleanOpcional / elemento | — |
result.successes[].post.publish_options.auto_publish_text | booleanOpcional / elemento | — |
result.successes[].post.publish_options.publication_mode | stringOpcional / elemento |
|
result.successes[].post.publish_options.backdated_time | numberOpcional / elemento | — |
result.successes[].post.publish_options.backdated_time_granularity | stringOpcional / elemento |
|
result.successes[].post.publish_options.place | stringOpcional / elemento | — |
result.successes[].post.publish_options.feed_targeting | objectOpcional / elemento |
|
result.successes[].post.publish_options.feed_targeting.* | any JSON valueOpcional / elemento | — |
result.successes[].post.publish_options.targeting | objectOpcional / elemento |
|
result.successes[].post.publish_options.targeting.* | any JSON valueOpcional / elemento | — |
result.successes[].post.publish_options.child_attachments | arrayOpcional / elemento | — |
result.successes[].post.publish_options.child_attachments[] | objectOpcional / elemento |
|
result.successes[].post.publish_options.child_attachments[].* | any JSON valueOpcional / elemento | — |
result.successes[].post.publish_options.multi_share_end_card | booleanOpcional / elemento | — |
result.successes[].post.publish_options.multi_share_optimized | booleanOpcional / elemento | — |
result.successes[].post.publish_options.unpublished_content_type | stringOpcional / elemento | — |
result.successes[].post.publish_options.no_story | booleanOpcional / elemento | — |
result.successes[].post.publish_options.crossposted_video_id | stringOpcional / elemento | — |
result.successes[].post.publish_options.spherical | booleanOpcional / elemento | — |
result.successes[].post.scheduled_at | stringObligatorio en el objeto principal | — |
result.successes[].post.display_timezone | stringObligatorio en el objeto principal |
|
result.successes[].post.local_scheduled_at | string | nullOpcional / elemento | — |
result.successes[].post.local_scheduled_atanyOf 1 | stringOpcional / elemento |
|
result.successes[].post.local_scheduled_atanyOf 2 | nullOpcional / elemento | — |
result.successes[].post.schedule_timezone | string | nullOpcional / elemento | — |
result.successes[].post.schedule_timezoneanyOf 1 | stringOpcional / elemento |
|
result.successes[].post.schedule_timezoneanyOf 2 | nullOpcional / elemento | — |
result.successes[].post.schedule_dst_disambiguation | string | nullOpcional / elemento | — |
result.successes[].post.schedule_dst_disambiguationanyOf 1 | stringOpcional / elemento |
|
result.successes[].post.schedule_dst_disambiguationanyOf 2 | nullOpcional / elemento | — |
result.successes[].post.schedule_intent_state | stringOpcional / elemento |
|
result.successes[].post.expires_at | string | nullObligatorio en el objeto principal | — |
result.successes[].post.expires_atanyOf 1 | stringObligatorio en el objeto principal | — |
result.successes[].post.expires_atanyOf 2 | nullObligatorio en el objeto principal | — |
result.successes[].post.status | stringObligatorio en el objeto principal |
|
result.successes[].post.version | integerObligatorio en el objeto principal |
|
result.successes[].post.automatic_retry_enabled | booleanObligatorio en el objeto principal | — |
result.successes[].post.delete_requested_at | string | nullObligatorio en el objeto principal | — |
result.successes[].post.delete_requested_atanyOf 1 | stringObligatorio en el objeto principal | — |
result.successes[].post.delete_requested_atanyOf 2 | nullObligatorio en el objeto principal | — |
result.successes[].post.published_at | string | nullObligatorio en el objeto principal | — |
result.successes[].post.published_atanyOf 1 | stringObligatorio en el objeto principal | — |
result.successes[].post.published_atanyOf 2 | nullObligatorio en el objeto principal | — |
result.successes[].post.deleted_at | string | nullObligatorio en el objeto principal | — |
result.successes[].post.deleted_atanyOf 1 | stringObligatorio en el objeto principal | — |
result.successes[].post.deleted_atanyOf 2 | nullObligatorio en el objeto principal | — |
result.successes[].post.provider_post_id | string | nullObligatorio en el objeto principal | — |
result.successes[].post.provider_post_idanyOf 1 | stringObligatorio en el objeto principal | — |
result.successes[].post.provider_post_idanyOf 2 | nullObligatorio en el objeto principal | — |
result.successes[].post.permalink | string | nullObligatorio en el objeto principal | — |
result.successes[].post.permalinkanyOf 1 | stringObligatorio en el objeto principal |
|
result.successes[].post.permalinkanyOf 2 | nullObligatorio en el objeto principal | — |
result.successes[].post.created_at | stringObligatorio en el objeto principal | — |
result.successes[].post.updated_at | stringObligatorio en el objeto principal | — |
result.successes[].post.project_id | string | nullObligatorio en el objeto principal | — |
result.successes[].post.project_idanyOf 1 | stringObligatorio en el objeto principal |
|
result.successes[].post.project_idanyOf 2 | nullObligatorio en el objeto principal | — |
result.successes[].post.batch_id | string | nullObligatorio en el objeto principal | — |
result.successes[].post.batch_idanyOf 1 | stringObligatorio en el objeto principal |
|
result.successes[].post.batch_idanyOf 2 | nullObligatorio en el objeto principal | — |
result.successes[].post.source_ref | object | nullObligatorio en el objeto principal | — |
result.successes[].post.source_refanyOf 1 | objectObligatorio en el objeto principal |
|
result.successes[].post.source_ref.*anyOf 1 | any JSON valueOpcional / elemento | — |
result.successes[].post.source_refanyOf 2 | nullObligatorio en el objeto principal | — |
result.failures | arrayObligatorio en el objeto principal | — |
result.failures[] | objectOpcional / elemento | — |
result.failures[].social_account_id | stringObligatorio en el objeto principal |
|
result.failures[].code | stringObligatorio en el objeto principal | — |
result.failures[].message | stringObligatorio en el objeto principal | — |
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"
]
}Errores y reintentos seguros
Comprueba el estado HTTP y el cuerpo de respuesta. Un error de validación 400 puede contener un ZodError; los errores del controlador usan los campos error, message y code. Conserva request_id o x-request-id para el diagnóstico, sin credenciales. Corrige los errores de acceso 401/403 antes de reintentar y respeta Retry-After para 429. Si una escritura es incierta o devuelve 5xx, consulta primero el resultado existente. Reutiliza una clave de idempotencia solo donde se admita; el comportamiento de reintento varía por operación y no garantiza una entrega exactamente una vez.
Guía de solución de problemasEjemplos
Estos ejemplos usan valores ficticios comprobados con los esquemas. Sustituye los IDs por otros autorizados, los archivos multimedia por recursos listos y las fechas por tu hora de publicación confirmada. Comprueba la elegibilidad de la cuenta antes de enviar una escritura. Esta página no envía solicitudes API.
Establece SOSOAPI_ACCESS_TOKEN en tu servidor con una credencial aceptada por esta operación y mantenla fuera del código del navegador. Para un agente, usa sosoapi auth login para iniciar sesión en el navegador y deja a la CLI renovar sus credenciales.
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.jsonEjemplo de respuesta 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."
}
]
}
}