SosoAPI
ES
EN繁中繁體中文（台灣）简体中文日本語한국어DeutschFrançaisEspañolPortuguês (Brasil)العربيةעבריתNederlandsहिन्दीBahasa IndonesiaNorsk bokmålSvenskaMagyar
Iniciar sesión

La búsqueda solo se carga cuando la usas. Explora todas las categorías a continuación.

Programación y publicación

Obtener publicación programada

Consulta una publicación programada por id: contenido, estado, estado de entrega y resultados. Su versión es el valor expected_version que necesitan las operaciones de actualización, publicación, reintento y cancelación.

POST /studio-api/scheduled-posts/get

Contrato revisado: · sha256:563d2d581da0ad29

Leer en MarkdownDescargar contrato públicoDescargar OpenAPI

Descripción general

Consulta una publicación programada por id: contenido, estado, estado de entrega y resultados. Su versión es el valor expected_version que necesitan las operaciones de actualización, publicación, reintento y cancelación.

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

Clases de credenciales aceptadas
user_session, delegated_oauth, personal_access_token
Capacidad delegada
agent:operate
Rol mínimo del espacio de trabajo
viewer
Alcance del acceso
Recursos a los que este usuario está autorizado a acceder
Se requiere consentimiento para todos los espacios de trabajo
No
Cambia el estado
No
Cuando la operación se completa
synchronous_http_response

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.

Campos de solicitud
Campo / ramaTipo / obligatorioRestricciones
$objectObligatorio en el objeto principal
  • additionalProperties: false
idstringObligatorio en el objeto principal
  • 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}$"
JSON Schema completo
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "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}$"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Respuesta y finalización

Estados HTTP de éxito: 200. Cuando la operación se completa: synchronous_http_response.

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.

Respuesta y finalización
Campo / ramaTipo / obligatorioRestricciones
$objectObligatorio en el objeto principal—
postobjectObligatorio en el objeto principal—
post.idstringObligatorio en el objeto principal
  • pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
post.workspace_idstringObligatorio en el objeto principal
  • 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.social_account_idstring | nullObligatorio en el objeto principal—
post.social_account_idanyOf 1stringObligatorio en el objeto principal
  • 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.social_account_idanyOf 2nullObligatorio en el objeto principal—
post.platformstringObligatorio en el objeto principal
  • enum: ["instagram","threads","facebook","youtube","x"]
post.destinationobjectObligatorio en el objeto principal—
post.destination.social_account_idstring | nullObligatorio en el objeto principal—
post.destination.social_account_idanyOf 1stringObligatorio en el objeto principal
  • 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.destination.social_account_idanyOf 2nullObligatorio en el objeto principal—
post.destination.platformstringObligatorio en el objeto principal
  • enum: ["instagram","threads","facebook","youtube","x"]
post.destination.platform_user_idstring | nullObligatorio en el objeto principal—
post.destination.platform_user_idanyOf 1stringObligatorio en el objeto principal—
post.destination.platform_user_idanyOf 2nullObligatorio en el objeto principal—
post.destination.account_labelstring | nullObligatorio en el objeto principal—
post.destination.account_labelanyOf 1stringObligatorio en el objeto principal—
post.destination.account_labelanyOf 2nullObligatorio en el objeto principal—
post.captionstring | nullObligatorio en el objeto principal—
post.captionanyOf 1stringObligatorio en el objeto principal—
post.captionanyOf 2nullObligatorio en el objeto principal—
post.hashtagsarrayObligatorio en el objeto principal—
post.hashtags[]stringOpcional / elemento—
post.mediaarrayObligatorio en el objeto principal—
post.media[]objectOpcional / elemento—
post.media[].kindstringObligatorio en el objeto principal
  • enum: ["image","video"]
post.media[].urlstringObligatorio en el objeto principal
  • format: "uri"
post.media[].cover_urlstring | nullOpcional / elemento—
post.media[].cover_urlanyOf 1stringOpcional / elemento
  • format: "uri"
post.media[].cover_urlanyOf 2nullOpcional / elemento—
post.media[].cover_asset_idinteger | nullOpcional / elemento—
post.media[].cover_asset_idanyOf 1integerOpcional / elemento
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.media[].cover_asset_idanyOf 2nullOpcional / elemento—
post.media[].asset_idinteger | nullOpcional / elemento—
post.media[].asset_idanyOf 1integerOpcional / elemento
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.media[].asset_idanyOf 2nullOpcional / elemento—
post.media[].mime_typestring | nullOpcional / elemento—
post.media[].mime_typeanyOf 1stringOpcional / elemento
  • minLength: 1
  • maxLength: 160
post.media[].mime_typeanyOf 2nullOpcional / elemento—
post.media[].preview_urlstring | nullOpcional / elemento

URL temporal autorizada de lectura; conserva url como identidad multimedia persistente de la publicación programada.

—
post.media[].preview_urlanyOf 1stringOpcional / elemento
  • format: "uri"
post.media[].preview_urlanyOf 2nullOpcional / elemento—
post.media[].cover_preview_urlstring | nullOpcional / elemento

URL temporal autorizada de lectura de portada; conserva cover_url como identidad multimedia persistente.

—
post.media[].cover_preview_urlanyOf 1stringOpcional / elemento
  • format: "uri"
post.media[].cover_preview_urlanyOf 2nullOpcional / elemento—
post.media[].preview_expires_atstring | nullOpcional / elemento—
post.media[].preview_expires_atanyOf 1stringOpcional / elemento
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
post.media[].preview_expires_atanyOf 2nullOpcional / elemento—
post.link_urlstring | nullOpcional / elemento—
post.link_urlanyOf 1stringOpcional / elemento
  • format: "uri"
post.link_urlanyOf 2nullOpcional / elemento—
post.publish_optionsobjectObligatorio en el objeto principal—
post.publish_options.post_typestringOpcional / elemento
  • enum: ["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]
post.publish_options.location_idstringOpcional / elemento
  • minLength: 1
post.publish_options.share_to_feedbooleanOpcional / elemento—
post.publish_options.collaboratorsarrayOpcional / elemento
  • maxItems: 3
post.publish_options.collaborators[]stringOpcional / elemento
  • minLength: 1
post.publish_options.first_commentstringOpcional / elemento
  • minLength: 1
  • maxLength: 2200
post.publish_options.topic_tagstringOpcional / elemento
  • minLength: 1
post.publish_options.thumb_offset_msintegerOpcional / elemento
  • minimum: 0
  • maximum: 9007199254740991
post.publish_options.titlestringOpcional / elemento
  • maxLength: 255
post.publish_options.youtube_privacy_statusstringOpcional / elemento
  • enum: ["private","unlisted","public"]
post.publish_options.youtube_category_idstringOpcional / elemento
  • pattern: "^\\d+$"
post.publish_options.youtube_contains_synthetic_mediabooleanOpcional / elemento—
post.publish_options.descriptionstringOpcional / elemento
  • maxLength: 5000
post.publish_options.category_idstringOpcional / elemento
  • pattern: "^\\d+$"
post.publish_options.privacy_statusstringOpcional / elemento
  • enum: ["private","unlisted","public"]
post.publish_options.cancellation_modestringOpcional / elemento
  • enum: ["DELETE","UNSCHEDULE_KEEP_PRIVATE"]
post.publish_options.tagsarrayOpcional / elemento—
post.publish_options.tags[]stringOpcional / elemento—
post.publish_options.default_languagestringOpcional / elemento—
post.publish_options.localizationsobjectOpcional / elemento
  • additionalProperties: {}
post.publish_options.localizations.*any JSON valueOpcional / elemento—
post.publish_options.licensestringOpcional / elemento
  • enum: ["youtube","creativeCommon"]
post.publish_options.embeddablebooleanOpcional / elemento—
post.publish_options.public_stats_viewablebooleanOpcional / elemento—
post.publish_options.self_declared_made_for_kidsbooleanOpcional / elemento—
post.publish_options.contains_synthetic_mediabooleanOpcional / elemento—
post.publish_options.has_paid_product_placementbooleanOpcional / elemento—
post.publish_options.recording_datestringOpcional / elemento—
post.publish_options.notify_subscribersbooleanOpcional / elemento—
post.publish_options.thumbnail_asset_idintegerOpcional / elemento
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.publish_options.surface_expectationstringOpcional / elemento
  • const: "SHORT"
post.publish_options.brand_partnerobjectOpcional / elemento
  • additionalProperties: {}
post.publish_options.brand_partner.*any JSON valueOpcional / elemento—
post.publish_options.cover_asset_idintegerOpcional / elemento
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.publish_options.audio_namestringOpcional / elemento—
post.publish_options.trial_paramsobjectOpcional / elemento
  • additionalProperties: {}
post.publish_options.trial_params.*any JSON valueOpcional / elemento—
post.publish_options.is_ai_generatedbooleanOpcional / elemento—
post.publish_options.branded_content_sponsor_idsarrayOpcional / elemento—
post.publish_options.branded_content_sponsor_ids[]stringOpcional / elemento—
post.publish_options.is_paid_partnershipbooleanOpcional / elemento—
post.publish_options.media_optionsarrayOpcional / elemento—
post.publish_options.media_options[]objectOpcional / elemento
  • additionalProperties: {}
post.publish_options.media_options[].*any JSON valueOpcional / elemento—
post.publish_options.reply_to_idstringOpcional / elemento—
post.publish_options.quote_post_idstringOpcional / elemento—
post.publish_options.repost_target_idstringOpcional / elemento—
post.publish_options.reply_controlstringOpcional / elemento—
post.publish_options.enable_reply_approvalsbooleanOpcional / elemento—
post.publish_options.link_attachmentstringOpcional / elemento
  • format: "uri"
post.publish_options.poll_attachmentobjectOpcional / elemento
  • additionalProperties: {}
post.publish_options.poll_attachment.*any JSON valueOpcional / elemento—
post.publish_options.gif_attachmentobjectOpcional / elemento
  • additionalProperties: {}
post.publish_options.gif_attachment.*any JSON valueOpcional / elemento—
post.publish_options.text_attachmentobjectOpcional / elemento
  • additionalProperties: {}
post.publish_options.text_attachment.*any JSON valueOpcional / elemento—
post.publish_options.text_entitiesarrayOpcional / elemento—
post.publish_options.text_entities[]objectOpcional / elemento
  • additionalProperties: {}
post.publish_options.text_entities[].*any JSON valueOpcional / elemento—
post.publish_options.is_spoiler_mediabooleanOpcional / elemento—
post.publish_options.is_ghost_postbooleanOpcional / elemento—
post.publish_options.allowlisted_country_codesarrayOpcional / elemento—
post.publish_options.allowlisted_country_codes[]stringOpcional / elemento—
post.publish_options.crossreshare_to_igbooleanOpcional / elemento—
post.publish_options.crossreshare_to_ig_dark_modebooleanOpcional / elemento—
post.publish_options.auto_publish_textbooleanOpcional / elemento—
post.publish_options.publication_modestringOpcional / elemento
  • enum: ["PUBLISH","DRAFT"]
post.publish_options.backdated_timenumberOpcional / elemento—
post.publish_options.backdated_time_granularitystringOpcional / elemento
  • enum: ["year","month","day","hour","minute"]
post.publish_options.placestringOpcional / elemento—
post.publish_options.feed_targetingobjectOpcional / elemento
  • additionalProperties: {}
post.publish_options.feed_targeting.*any JSON valueOpcional / elemento—
post.publish_options.targetingobjectOpcional / elemento
  • additionalProperties: {}
post.publish_options.targeting.*any JSON valueOpcional / elemento—
post.publish_options.child_attachmentsarrayOpcional / elemento—
post.publish_options.child_attachments[]objectOpcional / elemento
  • additionalProperties: {}
post.publish_options.child_attachments[].*any JSON valueOpcional / elemento—
post.publish_options.multi_share_end_cardbooleanOpcional / elemento—
post.publish_options.multi_share_optimizedbooleanOpcional / elemento—
post.publish_options.unpublished_content_typestringOpcional / elemento—
post.publish_options.no_storybooleanOpcional / elemento—
post.publish_options.crossposted_video_idstringOpcional / elemento—
post.publish_options.sphericalbooleanOpcional / elemento—
post.scheduled_atstringObligatorio en el objeto principal—
post.display_timezonestringObligatorio en el objeto principal
  • minLength: 1
  • maxLength: 80
post.local_scheduled_atstring | nullOpcional / elemento—
post.local_scheduled_atanyOf 1stringOpcional / elemento
  • pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
post.local_scheduled_atanyOf 2nullOpcional / elemento—
post.schedule_timezonestring | nullOpcional / elemento—
post.schedule_timezoneanyOf 1stringOpcional / elemento
  • minLength: 1
  • maxLength: 80
post.schedule_timezoneanyOf 2nullOpcional / elemento—
post.schedule_dst_disambiguationstring | nullOpcional / elemento—
post.schedule_dst_disambiguationanyOf 1stringOpcional / elemento
  • enum: ["exact","earlier","later"]
post.schedule_dst_disambiguationanyOf 2nullOpcional / elemento—
post.schedule_intent_statestringOpcional / elemento
  • enum: ["verified","legacy_unverified"]
post.expires_atstring | nullObligatorio en el objeto principal—
post.expires_atanyOf 1stringObligatorio en el objeto principal—
post.expires_atanyOf 2nullObligatorio en el objeto principal—
post.statusstringObligatorio en el objeto principal
  • enum: ["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]
post.versionintegerObligatorio en el objeto principal
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
post.automatic_retry_enabledbooleanObligatorio en el objeto principal—
post.delete_requested_atstring | nullObligatorio en el objeto principal—
post.delete_requested_atanyOf 1stringObligatorio en el objeto principal—
post.delete_requested_atanyOf 2nullObligatorio en el objeto principal—
post.published_atstring | nullObligatorio en el objeto principal—
post.published_atanyOf 1stringObligatorio en el objeto principal—
post.published_atanyOf 2nullObligatorio en el objeto principal—
post.deleted_atstring | nullObligatorio en el objeto principal—
post.deleted_atanyOf 1stringObligatorio en el objeto principal—
post.deleted_atanyOf 2nullObligatorio en el objeto principal—
post.provider_post_idstring | nullObligatorio en el objeto principal—
post.provider_post_idanyOf 1stringObligatorio en el objeto principal—
post.provider_post_idanyOf 2nullObligatorio en el objeto principal—
post.permalinkstring | nullObligatorio en el objeto principal—
post.permalinkanyOf 1stringObligatorio en el objeto principal
  • format: "uri"
post.permalinkanyOf 2nullObligatorio en el objeto principal—
post.created_atstringObligatorio en el objeto principal—
post.updated_atstringObligatorio en el objeto principal—
deliveryobjectObligatorio en el objeto principal—
delivery.stagestringObligatorio en el objeto principal
  • enum: ["scheduled","preparing","delivering","reconciling","cancelling","terminal"]
delivery.messagestringObligatorio en el objeto principal
  • minLength: 1
  • maxLength: 500
actionsarrayObligatorio en el objeto principal
  • minItems: 5
  • maxItems: 5
actions[]objectOpcional / elemento—
actions[].actionstringObligatorio en el objeto principal
  • enum: ["edit","publish_now","retry","cancel","delete"]
actions[].allowedbooleanObligatorio en el objeto principal—
actions[].reason_codestringObligatorio en el objeto principal
  • enum: ["allowed","terminal_state","provider_preparation_started","delivery_started","not_scheduled","not_failed","retry_evidence_missing","destination_disconnected","expiry_passed","cancellation_in_progress","delete_in_progress","not_published"]
actions[].messagestringObligatorio en el objeto principal
  • minLength: 1
  • maxLength: 500
attemptsarrayObligatorio en el objeto principal
  • maxItems: 200
attempts[]objectOpcional / elemento—
attempts[].idstringObligatorio en el objeto principal
  • 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)$"
attempts[].operationstringObligatorio en el objeto principal
  • enum: ["publish","delete"]
attempts[].attempt_numberintegerObligatorio en el objeto principal
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
attempts[].dispatched_atstringObligatorio en el objeto principal—
outcomesarrayObligatorio en el objeto principal
  • maxItems: 200
outcomes[]objectOpcional / elemento—
outcomes[].idstringObligatorio en el objeto principal
  • 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)$"
outcomes[].publication_attempt_idstring | nullObligatorio en el objeto principal—
outcomes[].publication_attempt_idanyOf 1stringObligatorio en el objeto principal
  • 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)$"
outcomes[].publication_attempt_idanyOf 2nullObligatorio en el objeto principal—
outcomes[].operationstringObligatorio en el objeto principal
  • enum: ["publish","delete"]
outcomes[].statusstringObligatorio en el objeto principal
  • enum: ["published","failed","deleted"]
outcomes[].provider_post_idstring | nullObligatorio en el objeto principal—
outcomes[].provider_post_idanyOf 1stringObligatorio en el objeto principal—
outcomes[].provider_post_idanyOf 2nullObligatorio en el objeto principal—
outcomes[].permalinkstring | nullObligatorio en el objeto principal—
outcomes[].permalinkanyOf 1stringObligatorio en el objeto principal
  • format: "uri"
outcomes[].permalinkanyOf 2nullObligatorio en el objeto principal—
outcomes[].messagestringObligatorio en el objeto principal
  • minLength: 1
  • maxLength: 500
outcomes[].observed_atstringObligatorio en el objeto principal—
outcomes[].terminal_suboperationobjectOpcional / elemento—
outcomes[].terminal_suboperation.kindstringObligatorio en el objeto principal
  • const: "instagram_first_comment"
outcomes[].terminal_suboperation.statusstringObligatorio en el objeto principal
  • enum: ["succeeded","failed","attention"]
outcomes[].terminal_suboperation.external_idstring | nullObligatorio en el objeto principal—
outcomes[].terminal_suboperation.external_idanyOf 1stringObligatorio en el objeto principal
  • minLength: 1
  • maxLength: 500
outcomes[].terminal_suboperation.external_idanyOf 2nullObligatorio en el objeto principal—
JSON Schema completo
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "post": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
        },
        "workspace_id": {
          "type": "string",
          "format": "uuid",
          "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"
        }
      },
      "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"
      ]
    },
    "delivery": {
      "type": "object",
      "properties": {
        "stage": {
          "type": "string",
          "enum": [
            "scheduled",
            "preparing",
            "delivering",
            "reconciling",
            "cancelling",
            "terminal"
          ]
        },
        "message": {
          "type": "string",
          "minLength": 1,
          "maxLength": 500
        }
      },
      "required": [
        "stage",
        "message"
      ]
    },
    "actions": {
      "minItems": 5,
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "edit",
              "publish_now",
              "retry",
              "cancel",
              "delete"
            ]
          },
          "allowed": {
            "type": "boolean"
          },
          "reason_code": {
            "type": "string",
            "enum": [
              "allowed",
              "terminal_state",
              "provider_preparation_started",
              "delivery_started",
              "not_scheduled",
              "not_failed",
              "retry_evidence_missing",
              "destination_disconnected",
              "expiry_passed",
              "cancellation_in_progress",
              "delete_in_progress",
              "not_published"
            ]
          },
          "message": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          }
        },
        "required": [
          "action",
          "allowed",
          "reason_code",
          "message"
        ]
      }
    },
    "attempts": {
      "maxItems": 200,
      "type": "array",
      "items": {
        "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)$"
          },
          "operation": {
            "type": "string",
            "enum": [
              "publish",
              "delete"
            ]
          },
          "attempt_number": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          },
          "dispatched_at": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "operation",
          "attempt_number",
          "dispatched_at"
        ]
      }
    },
    "outcomes": {
      "maxItems": 200,
      "type": "array",
      "items": {
        "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)$"
          },
          "publication_attempt_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"
              }
            ]
          },
          "operation": {
            "type": "string",
            "enum": [
              "publish",
              "delete"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "published",
              "failed",
              "deleted"
            ]
          },
          "provider_post_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "permalink": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ]
          },
          "message": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          },
          "observed_at": {
            "type": "string"
          },
          "terminal_suboperation": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "instagram_first_comment"
              },
              "status": {
                "type": "string",
                "enum": [
                  "succeeded",
                  "failed",
                  "attention"
                ]
              },
              "external_id": {
                "anyOf": [
                  {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 500
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "kind",
              "status",
              "external_id"
            ]
          }
        },
        "required": [
          "id",
          "publication_attempt_id",
          "operation",
          "status",
          "provider_post_id",
          "permalink",
          "message",
          "observed_at"
        ]
      }
    }
  },
  "required": [
    "post",
    "delivery",
    "actions",
    "attempts",
    "outcomes"
  ]
}

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 problemas

Ejemplos

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": "11111111-1111-4111-8111-111111111111"
}

cURL

curl --request POST \
  "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/scheduled-posts/get" \
  -H "Authorization: Bearer $SOSOAPI_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @request.json

JavaScript

// 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/scheduled-posts/get", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: "Bearer " + token },
  body: JSON.stringify({
  "id": "11111111-1111-4111-8111-111111111111"
})
});
const result = await response.json();
// Check response.ok, the operation-specific body and completion state before continuing.

CLI

npx sosoapi api post /studio-api/scheduled-posts/get < request.json

Ejemplo de respuesta sintética

{
  "post": {
    "id": "11111111-1111-4111-8111-111111111111",
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "social_account_id": null,
    "platform": "instagram",
    "destination": {
      "social_account_id": null,
      "platform": "instagram",
      "platform_user_id": null,
      "account_label": null
    },
    "caption": null,
    "hashtags": [],
    "media": [],
    "publish_options": {},
    "scheduled_at": "example",
    "display_timezone": "UTC",
    "expires_at": null,
    "status": "scheduled",
    "version": 1,
    "automatic_retry_enabled": false,
    "delete_requested_at": null,
    "published_at": null,
    "deleted_at": null,
    "provider_post_id": null,
    "permalink": null,
    "created_at": "example",
    "updated_at": "example"
  },
  "delivery": {
    "stage": "scheduled",
    "message": "example"
  },
  "actions": [
    {
      "action": "edit",
      "allowed": true,
      "reason_code": "allowed",
      "message": "Allowed in this example state."
    },
    {
      "action": "publish_now",
      "allowed": true,
      "reason_code": "allowed",
      "message": "Allowed in this example state."
    },
    {
      "action": "retry",
      "allowed": false,
      "reason_code": "not_failed",
      "message": "This example post has not failed."
    },
    {
      "action": "cancel",
      "allowed": true,
      "reason_code": "allowed",
      "message": "Allowed in this example state."
    },
    {
      "action": "delete",
      "allowed": true,
      "reason_code": "allowed",
      "message": "Allowed in this example state."
    }
  ],
  "attempts": [],
  "outcomes": []
}

MCP: sosoapi_get_scheduled_post

Todas las operaciones APIAutenticación y permisos