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

Listar publicaciones programadas

Lista las publicaciones programadas de un espacio de trabajo, con filtros por proyecto, estado (scheduled, publishing, published, failed, expired, needs_reschedule, cancelled, deleted) e intervalo de tiempo, y paginación por cursor.

POST /studio-api/scheduled-posts/list

Contrato revisado: · sha256:563d2d581da0ad29

Leer en MarkdownDescargar contrato públicoDescargar OpenAPI

Descripción general

Lista las publicaciones programadas de un espacio de trabajo, con filtros por proyecto, estado (scheduled, publishing, published, failed, expired, needs_reschedule, cancelled, deleted) e intervalo de tiempo, y paginación por cursor.

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
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)$"
project_idstringOpcional / elemento
  • 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)$"
statusstringOpcional / elemento
  • enum: ["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]
scheduled_fromstringOpcional / 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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
scheduled_tostringOpcional / 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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
limitintegerOpcional / elemento
  • minimum: 1
  • maximum: 200
  • default: 50
cursorobjectOpcional / elemento
  • additionalProperties: false
cursor.scheduled_atstringObligatorio en el objeto principal
  • 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)))$"
cursor.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": {
    "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": {
      "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)$"
    },
    "status": {
      "type": "string",
      "enum": [
        "scheduled",
        "publishing",
        "published",
        "failed",
        "expired",
        "needs_reschedule",
        "cancelled",
        "deleted"
      ]
    },
    "scheduled_from": {
      "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)))$"
    },
    "scheduled_to": {
      "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)))$"
    },
    "limit": {
      "default": 50,
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "cursor": {
      "type": "object",
      "properties": {
        "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)))$"
        },
        "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": [
        "scheduled_at",
        "id"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "workspace_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—
postsarrayObligatorio en el objeto principal—
posts[]objectOpcional / elemento—
posts[].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}$"
posts[].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)$"
posts[].social_account_idstring | nullObligatorio en el objeto principal—
posts[].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)$"
posts[].social_account_idanyOf 2nullObligatorio en el objeto principal—
posts[].platformstringObligatorio en el objeto principal
  • enum: ["instagram","threads","facebook","youtube","x"]
posts[].destinationobjectObligatorio en el objeto principal—
posts[].destination.social_account_idstring | nullObligatorio en el objeto principal—
posts[].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)$"
posts[].destination.social_account_idanyOf 2nullObligatorio en el objeto principal—
posts[].destination.platformstringObligatorio en el objeto principal
  • enum: ["instagram","threads","facebook","youtube","x"]
posts[].destination.platform_user_idstring | nullObligatorio en el objeto principal—
posts[].destination.platform_user_idanyOf 1stringObligatorio en el objeto principal—
posts[].destination.platform_user_idanyOf 2nullObligatorio en el objeto principal—
posts[].destination.account_labelstring | nullObligatorio en el objeto principal—
posts[].destination.account_labelanyOf 1stringObligatorio en el objeto principal—
posts[].destination.account_labelanyOf 2nullObligatorio en el objeto principal—
posts[].captionstring | nullObligatorio en el objeto principal—
posts[].captionanyOf 1stringObligatorio en el objeto principal—
posts[].captionanyOf 2nullObligatorio en el objeto principal—
posts[].hashtagsarrayObligatorio en el objeto principal—
posts[].hashtags[]stringOpcional / elemento—
posts[].mediaarrayObligatorio en el objeto principal—
posts[].media[]objectOpcional / elemento—
posts[].media[].kindstringObligatorio en el objeto principal
  • enum: ["image","video"]
posts[].media[].urlstringObligatorio en el objeto principal
  • format: "uri"
posts[].media[].cover_urlstring | nullOpcional / elemento—
posts[].media[].cover_urlanyOf 1stringOpcional / elemento
  • format: "uri"
posts[].media[].cover_urlanyOf 2nullOpcional / elemento—
posts[].media[].cover_asset_idinteger | nullOpcional / elemento—
posts[].media[].cover_asset_idanyOf 1integerOpcional / elemento
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
posts[].media[].cover_asset_idanyOf 2nullOpcional / elemento—
posts[].media[].asset_idinteger | nullOpcional / elemento—
posts[].media[].asset_idanyOf 1integerOpcional / elemento
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
posts[].media[].asset_idanyOf 2nullOpcional / elemento—
posts[].media[].mime_typestring | nullOpcional / elemento—
posts[].media[].mime_typeanyOf 1stringOpcional / elemento
  • minLength: 1
  • maxLength: 160
posts[].media[].mime_typeanyOf 2nullOpcional / elemento—
posts[].media[].preview_urlstring | nullOpcional / elemento

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

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

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

—
posts[].media[].cover_preview_urlanyOf 1stringOpcional / elemento
  • format: "uri"
posts[].media[].cover_preview_urlanyOf 2nullOpcional / elemento—
posts[].media[].preview_expires_atstring | nullOpcional / elemento—
posts[].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))$"
posts[].media[].preview_expires_atanyOf 2nullOpcional / elemento—
posts[].link_urlstring | nullOpcional / elemento—
posts[].link_urlanyOf 1stringOpcional / elemento
  • format: "uri"
posts[].link_urlanyOf 2nullOpcional / elemento—
posts[].publish_optionsobjectObligatorio en el objeto principal—
posts[].publish_options.post_typestringOpcional / elemento
  • enum: ["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]
posts[].publish_options.location_idstringOpcional / elemento
  • minLength: 1
posts[].publish_options.share_to_feedbooleanOpcional / elemento—
posts[].publish_options.collaboratorsarrayOpcional / elemento
  • maxItems: 3
posts[].publish_options.collaborators[]stringOpcional / elemento
  • minLength: 1
posts[].publish_options.first_commentstringOpcional / elemento
  • minLength: 1
  • maxLength: 2200
posts[].publish_options.topic_tagstringOpcional / elemento
  • minLength: 1
posts[].publish_options.thumb_offset_msintegerOpcional / elemento
  • minimum: 0
  • maximum: 9007199254740991
posts[].publish_options.titlestringOpcional / elemento
  • maxLength: 255
posts[].publish_options.youtube_privacy_statusstringOpcional / elemento
  • enum: ["private","unlisted","public"]
posts[].publish_options.youtube_category_idstringOpcional / elemento
  • pattern: "^\\d+$"
posts[].publish_options.youtube_contains_synthetic_mediabooleanOpcional / elemento—
posts[].publish_options.descriptionstringOpcional / elemento
  • maxLength: 5000
posts[].publish_options.category_idstringOpcional / elemento
  • pattern: "^\\d+$"
posts[].publish_options.privacy_statusstringOpcional / elemento
  • enum: ["private","unlisted","public"]
posts[].publish_options.cancellation_modestringOpcional / elemento
  • enum: ["DELETE","UNSCHEDULE_KEEP_PRIVATE"]
posts[].publish_options.tagsarrayOpcional / elemento—
posts[].publish_options.tags[]stringOpcional / elemento—
posts[].publish_options.default_languagestringOpcional / elemento—
posts[].publish_options.localizationsobjectOpcional / elemento
  • additionalProperties: {}
posts[].publish_options.localizations.*any JSON valueOpcional / elemento—
posts[].publish_options.licensestringOpcional / elemento
  • enum: ["youtube","creativeCommon"]
posts[].publish_options.embeddablebooleanOpcional / elemento—
posts[].publish_options.public_stats_viewablebooleanOpcional / elemento—
posts[].publish_options.self_declared_made_for_kidsbooleanOpcional / elemento—
posts[].publish_options.contains_synthetic_mediabooleanOpcional / elemento—
posts[].publish_options.has_paid_product_placementbooleanOpcional / elemento—
posts[].publish_options.recording_datestringOpcional / elemento—
posts[].publish_options.notify_subscribersbooleanOpcional / elemento—
posts[].publish_options.thumbnail_asset_idintegerOpcional / elemento
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
posts[].publish_options.surface_expectationstringOpcional / elemento
  • const: "SHORT"
posts[].publish_options.brand_partnerobjectOpcional / elemento
  • additionalProperties: {}
posts[].publish_options.brand_partner.*any JSON valueOpcional / elemento—
posts[].publish_options.cover_asset_idintegerOpcional / elemento
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
posts[].publish_options.audio_namestringOpcional / elemento—
posts[].publish_options.trial_paramsobjectOpcional / elemento
  • additionalProperties: {}
posts[].publish_options.trial_params.*any JSON valueOpcional / elemento—
posts[].publish_options.is_ai_generatedbooleanOpcional / elemento—
posts[].publish_options.branded_content_sponsor_idsarrayOpcional / elemento—
posts[].publish_options.branded_content_sponsor_ids[]stringOpcional / elemento—
posts[].publish_options.is_paid_partnershipbooleanOpcional / elemento—
posts[].publish_options.media_optionsarrayOpcional / elemento—
posts[].publish_options.media_options[]objectOpcional / elemento
  • additionalProperties: {}
posts[].publish_options.media_options[].*any JSON valueOpcional / elemento—
posts[].publish_options.reply_to_idstringOpcional / elemento—
posts[].publish_options.quote_post_idstringOpcional / elemento—
posts[].publish_options.repost_target_idstringOpcional / elemento—
posts[].publish_options.reply_controlstringOpcional / elemento—
posts[].publish_options.enable_reply_approvalsbooleanOpcional / elemento—
posts[].publish_options.link_attachmentstringOpcional / elemento
  • format: "uri"
posts[].publish_options.poll_attachmentobjectOpcional / elemento
  • additionalProperties: {}
posts[].publish_options.poll_attachment.*any JSON valueOpcional / elemento—
posts[].publish_options.gif_attachmentobjectOpcional / elemento
  • additionalProperties: {}
posts[].publish_options.gif_attachment.*any JSON valueOpcional / elemento—
posts[].publish_options.text_attachmentobjectOpcional / elemento
  • additionalProperties: {}
posts[].publish_options.text_attachment.*any JSON valueOpcional / elemento—
posts[].publish_options.text_entitiesarrayOpcional / elemento—
posts[].publish_options.text_entities[]objectOpcional / elemento
  • additionalProperties: {}
posts[].publish_options.text_entities[].*any JSON valueOpcional / elemento—
posts[].publish_options.is_spoiler_mediabooleanOpcional / elemento—
posts[].publish_options.is_ghost_postbooleanOpcional / elemento—
posts[].publish_options.allowlisted_country_codesarrayOpcional / elemento—
posts[].publish_options.allowlisted_country_codes[]stringOpcional / elemento—
posts[].publish_options.crossreshare_to_igbooleanOpcional / elemento—
posts[].publish_options.crossreshare_to_ig_dark_modebooleanOpcional / elemento—
posts[].publish_options.auto_publish_textbooleanOpcional / elemento—
posts[].publish_options.publication_modestringOpcional / elemento
  • enum: ["PUBLISH","DRAFT"]
posts[].publish_options.backdated_timenumberOpcional / elemento—
posts[].publish_options.backdated_time_granularitystringOpcional / elemento
  • enum: ["year","month","day","hour","minute"]
posts[].publish_options.placestringOpcional / elemento—
posts[].publish_options.feed_targetingobjectOpcional / elemento
  • additionalProperties: {}
posts[].publish_options.feed_targeting.*any JSON valueOpcional / elemento—
posts[].publish_options.targetingobjectOpcional / elemento
  • additionalProperties: {}
posts[].publish_options.targeting.*any JSON valueOpcional / elemento—
posts[].publish_options.child_attachmentsarrayOpcional / elemento—
posts[].publish_options.child_attachments[]objectOpcional / elemento
  • additionalProperties: {}
posts[].publish_options.child_attachments[].*any JSON valueOpcional / elemento—
posts[].publish_options.multi_share_end_cardbooleanOpcional / elemento—
posts[].publish_options.multi_share_optimizedbooleanOpcional / elemento—
posts[].publish_options.unpublished_content_typestringOpcional / elemento—
posts[].publish_options.no_storybooleanOpcional / elemento—
posts[].publish_options.crossposted_video_idstringOpcional / elemento—
posts[].publish_options.sphericalbooleanOpcional / elemento—
posts[].scheduled_atstringObligatorio en el objeto principal—
posts[].display_timezonestringObligatorio en el objeto principal
  • minLength: 1
  • maxLength: 80
posts[].local_scheduled_atstring | nullOpcional / elemento—
posts[].local_scheduled_atanyOf 1stringOpcional / elemento
  • pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
posts[].local_scheduled_atanyOf 2nullOpcional / elemento—
posts[].schedule_timezonestring | nullOpcional / elemento—
posts[].schedule_timezoneanyOf 1stringOpcional / elemento
  • minLength: 1
  • maxLength: 80
posts[].schedule_timezoneanyOf 2nullOpcional / elemento—
posts[].schedule_dst_disambiguationstring | nullOpcional / elemento—
posts[].schedule_dst_disambiguationanyOf 1stringOpcional / elemento
  • enum: ["exact","earlier","later"]
posts[].schedule_dst_disambiguationanyOf 2nullOpcional / elemento—
posts[].schedule_intent_statestringOpcional / elemento
  • enum: ["verified","legacy_unverified"]
posts[].expires_atstring | nullObligatorio en el objeto principal—
posts[].expires_atanyOf 1stringObligatorio en el objeto principal—
posts[].expires_atanyOf 2nullObligatorio en el objeto principal—
posts[].statusstringObligatorio en el objeto principal
  • enum: ["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]
posts[].versionintegerObligatorio en el objeto principal
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
posts[].automatic_retry_enabledbooleanObligatorio en el objeto principal—
posts[].delete_requested_atstring | nullObligatorio en el objeto principal—
posts[].delete_requested_atanyOf 1stringObligatorio en el objeto principal—
posts[].delete_requested_atanyOf 2nullObligatorio en el objeto principal—
posts[].published_atstring | nullObligatorio en el objeto principal—
posts[].published_atanyOf 1stringObligatorio en el objeto principal—
posts[].published_atanyOf 2nullObligatorio en el objeto principal—
posts[].deleted_atstring | nullObligatorio en el objeto principal—
posts[].deleted_atanyOf 1stringObligatorio en el objeto principal—
posts[].deleted_atanyOf 2nullObligatorio en el objeto principal—
posts[].provider_post_idstring | nullObligatorio en el objeto principal—
posts[].provider_post_idanyOf 1stringObligatorio en el objeto principal—
posts[].provider_post_idanyOf 2nullObligatorio en el objeto principal—
posts[].permalinkstring | nullObligatorio en el objeto principal—
posts[].permalinkanyOf 1stringObligatorio en el objeto principal
  • format: "uri"
posts[].permalinkanyOf 2nullObligatorio en el objeto principal—
posts[].created_atstringObligatorio en el objeto principal—
posts[].updated_atstringObligatorio en el objeto principal—
posts[].project_idstring | nullObligatorio en el objeto principal—
posts[].project_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)$"
posts[].project_idanyOf 2nullObligatorio en el objeto principal—
posts[].batch_idstring | nullObligatorio en el objeto principal—
posts[].batch_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)$"
posts[].batch_idanyOf 2nullObligatorio en el objeto principal—
posts[].source_refobject | nullObligatorio en el objeto principal—
posts[].source_refanyOf 1objectObligatorio en el objeto principal
  • additionalProperties: {}
posts[].source_ref.*anyOf 1any JSON valueOpcional / elemento—
posts[].source_refanyOf 2nullObligatorio en el objeto principal—
next_cursorobject | nullObligatorio en el objeto principal—
next_cursoranyOf 1objectObligatorio en el objeto principal—
next_cursor.scheduled_atanyOf 1stringObligatorio en el objeto principal
  • 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)))$"
next_cursor.idanyOf 1stringObligatorio 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}$"
next_cursoranyOf 2nullObligatorio en el objeto principal—
returned_countintegerObligatorio en el objeto principal
  • minimum: 0
  • maximum: 9007199254740991
JSON Schema completo
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "posts": {
      "type": "array",
      "items": {
        "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"
        ]
      }
    },
    "next_cursor": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "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)))$"
            },
            "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": [
            "scheduled_at",
            "id"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "returned_count": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "posts",
    "next_cursor",
    "returned_count"
  ]
}

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

{
  "workspace_id": "11111111-1111-4111-8111-111111111111"
}

cURL

curl --request POST \
  "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/scheduled-posts/list" \
  -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/list", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: "Bearer " + token },
  body: JSON.stringify({
  "workspace_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/list < request.json

Ejemplo de respuesta sintética

{
  "posts": [],
  "next_cursor": null,
  "returned_count": 0
}

MCP: sosoapi_list_scheduled_posts

Todas las operaciones APIAutenticación y permisos