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

La recherche se charge uniquement lorsque vous l’utilisez. Parcourez toutes les catégories ci-dessous.

Outil MCP

Lister les publications programmées

sosoapi_list_scheduled_posts

Lister les publications programmées d’un espace de travail, filtrables par projet, statut (scheduled, publishing, published, failed, expired, needs_reschedule, cancelled, deleted) et période, avec pagination par curseur.

Lire en Markdown

Profils et transports

Profils : core, full · Transports : stdio, http

Choisissez core ou full pour définir les outils visibles du client ; cela ne change pas ses autorisations. Le téléversement local nécessite stdio et n’est pas disponible sur HTTP. Définissez SOSOAPI_OUTPUT_SCHEMAS=1 pour inclure les schémas de sortie à la découverte. Les outils renvoient des résultats structurés avec ou sans ce réglage.

Autorisations et effets de bord

Les annotations aident les clients à décrire un outil. Chaque appel vérifie toujours l’authentification, le rôle, l’accès aux ressources et les capacités accordées de l’utilisateur.

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

Champs d’entrée

Requis signifie requis dans l’objet parent et la branche sélectionnée. Un enfant requis ne rend pas obligatoire un parent facultatif. Les règles et noms de champs ci-dessous proviennent du contrat.

Champs d’entrée
Champ / brancheType / requisContraintes
$objectRequis dans le parent
  • additionalProperties: false
workspace_idstringRequis dans le parent
  • format: "uuid"
project_idstringFacultatif / élément
  • format: "uuid"
statusstringFacultatif / élément
  • enum: ["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]
scheduled_fromstringFacultatif / élément
  • 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_tostringFacultatif / élément
  • 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)))$"
limitintegerFacultatif / élément
  • minimum: 1
  • maximum: 200
cursorobjectFacultatif / élément
  • additionalProperties: false
cursor.scheduled_atstringRequis dans le parent
  • 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.idstringRequis dans le parent
  • 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 complet
{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "project_id": {
      "type": "string",
      "format": "uuid"
    },
    "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": {
      "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
}

Sortie structurée

Ce schéma décrit structuredContent dans un résultat d’outil réussi. La réponse MCP contient aussi content et peut définir isError en cas d’échec. Pour publier, lisez le résultat final de la publication plutôt que de considérer une requête acceptée ou une réponse texte comme une confirmation. L’opération API liée explique les autorisations et règles de nouvelle tentative.

Requis signifie requis dans l’objet parent et la branche sélectionnée. Un enfant requis ne rend pas obligatoire un parent facultatif. Les règles et noms de champs ci-dessous proviennent du contrat.

Sortie structurée
Champ / brancheType / requisContraintes
$objectRequis dans le parent
  • additionalProperties: false
postsarrayRequis dans le parent—
posts[]objectFacultatif / élément
  • additionalProperties: false
posts[].idstringRequis dans le parent
  • 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_idstringRequis dans le parent
  • format: "uuid"
posts[].social_account_idstring | nullRequis dans le parent—
posts[].social_account_idanyOf 1stringRequis dans le parent
  • format: "uuid"
posts[].social_account_idanyOf 2nullRequis dans le parent—
posts[].platformstringRequis dans le parent
  • enum: ["instagram","threads","facebook","youtube","x"]
posts[].destinationobjectRequis dans le parent
  • additionalProperties: false
posts[].destination.social_account_idstring | nullRequis dans le parent—
posts[].destination.social_account_idanyOf 1stringRequis dans le parent
  • format: "uuid"
posts[].destination.social_account_idanyOf 2nullRequis dans le parent—
posts[].destination.platformstringRequis dans le parent
  • enum: ["instagram","threads","facebook","youtube","x"]
posts[].destination.platform_user_idstring | nullRequis dans le parent—
posts[].destination.platform_user_idanyOf 1stringRequis dans le parent—
posts[].destination.platform_user_idanyOf 2nullRequis dans le parent—
posts[].destination.account_labelstring | nullRequis dans le parent—
posts[].destination.account_labelanyOf 1stringRequis dans le parent—
posts[].destination.account_labelanyOf 2nullRequis dans le parent—
posts[].captionstring | nullRequis dans le parent—
posts[].captionanyOf 1stringRequis dans le parent—
posts[].captionanyOf 2nullRequis dans le parent—
posts[].hashtagsarrayRequis dans le parent—
posts[].hashtags[]stringFacultatif / élément—
posts[].mediaarrayRequis dans le parent—
posts[].media[]objectFacultatif / élément
  • additionalProperties: false
posts[].media[].kindstringRequis dans le parent
  • enum: ["image","video"]
posts[].media[].urlstringRequis dans le parent
  • format: "uri"
posts[].media[].cover_urlstring | nullFacultatif / élément—
posts[].media[].cover_urlanyOf 1stringFacultatif / élément
  • format: "uri"
posts[].media[].cover_urlanyOf 2nullFacultatif / élément—
posts[].media[].cover_asset_idinteger | nullFacultatif / élément—
posts[].media[].cover_asset_idanyOf 1integerFacultatif / élément
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
posts[].media[].cover_asset_idanyOf 2nullFacultatif / élément—
posts[].media[].asset_idinteger | nullFacultatif / élément—
posts[].media[].asset_idanyOf 1integerFacultatif / élément
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
posts[].media[].asset_idanyOf 2nullFacultatif / élément—
posts[].media[].mime_typestring | nullFacultatif / élément—
posts[].media[].mime_typeanyOf 1stringFacultatif / élément
  • minLength: 1
  • maxLength: 160
posts[].media[].mime_typeanyOf 2nullFacultatif / élément—
posts[].media[].preview_urlstring | nullFacultatif / élément

URL de lecture temporaire autorisée ; conservez url comme identité persistante du média Scheduled Post.

—
posts[].media[].preview_urlanyOf 1stringFacultatif / élément
  • format: "uri"
posts[].media[].preview_urlanyOf 2nullFacultatif / élément—
posts[].media[].cover_preview_urlstring | nullFacultatif / élément

URL temporaire autorisée de lecture de couverture ; conservez cover_url comme identité persistante du média.

—
posts[].media[].cover_preview_urlanyOf 1stringFacultatif / élément
  • format: "uri"
posts[].media[].cover_preview_urlanyOf 2nullFacultatif / élément—
posts[].media[].preview_expires_atstring | nullFacultatif / élément—
posts[].media[].preview_expires_atanyOf 1stringFacultatif / élément
  • 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 2nullFacultatif / élément—
posts[].link_urlstring | nullFacultatif / élément—
posts[].link_urlanyOf 1stringFacultatif / élément
  • format: "uri"
posts[].link_urlanyOf 2nullFacultatif / élément—
posts[].publish_optionsobjectRequis dans le parent
  • additionalProperties: false
posts[].publish_options.post_typestringFacultatif / élément
  • enum: ["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]
posts[].publish_options.location_idstringFacultatif / élément
  • minLength: 1
posts[].publish_options.share_to_feedbooleanFacultatif / élément—
posts[].publish_options.collaboratorsarrayFacultatif / élément
  • maxItems: 3
posts[].publish_options.collaborators[]stringFacultatif / élément
  • minLength: 1
posts[].publish_options.first_commentstringFacultatif / élément
  • minLength: 1
  • maxLength: 2200
posts[].publish_options.topic_tagstringFacultatif / élément
  • minLength: 1
posts[].publish_options.thumb_offset_msintegerFacultatif / élément
  • minimum: 0
  • maximum: 9007199254740991
posts[].publish_options.titlestringFacultatif / élément
  • maxLength: 255
posts[].publish_options.youtube_privacy_statusstringFacultatif / élément
  • enum: ["private","unlisted","public"]
posts[].publish_options.youtube_category_idstringFacultatif / élément
  • pattern: "^\\d+$"
posts[].publish_options.youtube_contains_synthetic_mediabooleanFacultatif / élément—
posts[].publish_options.descriptionstringFacultatif / élément
  • maxLength: 5000
posts[].publish_options.category_idstringFacultatif / élément
  • pattern: "^\\d+$"
posts[].publish_options.privacy_statusstringFacultatif / élément
  • enum: ["private","unlisted","public"]
posts[].publish_options.cancellation_modestringFacultatif / élément
  • enum: ["DELETE","UNSCHEDULE_KEEP_PRIVATE"]
posts[].publish_options.tagsarrayFacultatif / élément—
posts[].publish_options.tags[]stringFacultatif / élément—
posts[].publish_options.default_languagestringFacultatif / élément—
posts[].publish_options.localizationsobjectFacultatif / élément
  • additionalProperties: {}
posts[].publish_options.localizations.*any JSON valueFacultatif / élément—
posts[].publish_options.licensestringFacultatif / élément
  • enum: ["youtube","creativeCommon"]
posts[].publish_options.embeddablebooleanFacultatif / élément—
posts[].publish_options.public_stats_viewablebooleanFacultatif / élément—
posts[].publish_options.self_declared_made_for_kidsbooleanFacultatif / élément—
posts[].publish_options.contains_synthetic_mediabooleanFacultatif / élément—
posts[].publish_options.has_paid_product_placementbooleanFacultatif / élément—
posts[].publish_options.recording_datestringFacultatif / élément—
posts[].publish_options.notify_subscribersbooleanFacultatif / élément—
posts[].publish_options.thumbnail_asset_idintegerFacultatif / élément
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
posts[].publish_options.surface_expectationstringFacultatif / élément
  • const: "SHORT"
posts[].publish_options.brand_partnerobjectFacultatif / élément
  • additionalProperties: {}
posts[].publish_options.brand_partner.*any JSON valueFacultatif / élément—
posts[].publish_options.cover_asset_idintegerFacultatif / élément
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
posts[].publish_options.audio_namestringFacultatif / élément—
posts[].publish_options.trial_paramsobjectFacultatif / élément
  • additionalProperties: {}
posts[].publish_options.trial_params.*any JSON valueFacultatif / élément—
posts[].publish_options.is_ai_generatedbooleanFacultatif / élément—
posts[].publish_options.branded_content_sponsor_idsarrayFacultatif / élément—
posts[].publish_options.branded_content_sponsor_ids[]stringFacultatif / élément—
posts[].publish_options.is_paid_partnershipbooleanFacultatif / élément—
posts[].publish_options.media_optionsarrayFacultatif / élément—
posts[].publish_options.media_options[]objectFacultatif / élément
  • additionalProperties: {}
posts[].publish_options.media_options[].*any JSON valueFacultatif / élément—
posts[].publish_options.reply_to_idstringFacultatif / élément—
posts[].publish_options.quote_post_idstringFacultatif / élément—
posts[].publish_options.repost_target_idstringFacultatif / élément—
posts[].publish_options.reply_controlstringFacultatif / élément—
posts[].publish_options.enable_reply_approvalsbooleanFacultatif / élément—
posts[].publish_options.link_attachmentstringFacultatif / élément
  • format: "uri"
posts[].publish_options.poll_attachmentobjectFacultatif / élément
  • additionalProperties: {}
posts[].publish_options.poll_attachment.*any JSON valueFacultatif / élément—
posts[].publish_options.gif_attachmentobjectFacultatif / élément
  • additionalProperties: {}
posts[].publish_options.gif_attachment.*any JSON valueFacultatif / élément—
posts[].publish_options.text_attachmentobjectFacultatif / élément
  • additionalProperties: {}
posts[].publish_options.text_attachment.*any JSON valueFacultatif / élément—
posts[].publish_options.text_entitiesarrayFacultatif / élément—
posts[].publish_options.text_entities[]objectFacultatif / élément
  • additionalProperties: {}
posts[].publish_options.text_entities[].*any JSON valueFacultatif / élément—
posts[].publish_options.is_spoiler_mediabooleanFacultatif / élément—
posts[].publish_options.is_ghost_postbooleanFacultatif / élément—
posts[].publish_options.allowlisted_country_codesarrayFacultatif / élément—
posts[].publish_options.allowlisted_country_codes[]stringFacultatif / élément—
posts[].publish_options.crossreshare_to_igbooleanFacultatif / élément—
posts[].publish_options.crossreshare_to_ig_dark_modebooleanFacultatif / élément—
posts[].publish_options.auto_publish_textbooleanFacultatif / élément—
posts[].publish_options.publication_modestringFacultatif / élément
  • enum: ["PUBLISH","DRAFT"]
posts[].publish_options.backdated_timenumberFacultatif / élément—
posts[].publish_options.backdated_time_granularitystringFacultatif / élément
  • enum: ["year","month","day","hour","minute"]
posts[].publish_options.placestringFacultatif / élément—
posts[].publish_options.feed_targetingobjectFacultatif / élément
  • additionalProperties: {}
posts[].publish_options.feed_targeting.*any JSON valueFacultatif / élément—
posts[].publish_options.targetingobjectFacultatif / élément
  • additionalProperties: {}
posts[].publish_options.targeting.*any JSON valueFacultatif / élément—
posts[].publish_options.child_attachmentsarrayFacultatif / élément—
posts[].publish_options.child_attachments[]objectFacultatif / élément
  • additionalProperties: {}
posts[].publish_options.child_attachments[].*any JSON valueFacultatif / élément—
posts[].publish_options.multi_share_end_cardbooleanFacultatif / élément—
posts[].publish_options.multi_share_optimizedbooleanFacultatif / élément—
posts[].publish_options.unpublished_content_typestringFacultatif / élément—
posts[].publish_options.no_storybooleanFacultatif / élément—
posts[].publish_options.crossposted_video_idstringFacultatif / élément—
posts[].publish_options.sphericalbooleanFacultatif / élément—
posts[].scheduled_atstringRequis dans le parent—
posts[].display_timezonestringRequis dans le parent
  • minLength: 1
  • maxLength: 80
posts[].local_scheduled_atstring | nullFacultatif / élément—
posts[].local_scheduled_atanyOf 1stringFacultatif / élément
  • pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
posts[].local_scheduled_atanyOf 2nullFacultatif / élément—
posts[].schedule_timezonestring | nullFacultatif / élément—
posts[].schedule_timezoneanyOf 1stringFacultatif / élément
  • minLength: 1
  • maxLength: 80
posts[].schedule_timezoneanyOf 2nullFacultatif / élément—
posts[].schedule_dst_disambiguationstring | nullFacultatif / élément—
posts[].schedule_dst_disambiguationanyOf 1stringFacultatif / élément
  • enum: ["exact","earlier","later"]
posts[].schedule_dst_disambiguationanyOf 2nullFacultatif / élément—
posts[].schedule_intent_statestringFacultatif / élément
  • enum: ["verified","legacy_unverified"]
posts[].expires_atstring | nullRequis dans le parent—
posts[].expires_atanyOf 1stringRequis dans le parent—
posts[].expires_atanyOf 2nullRequis dans le parent—
posts[].statusstringRequis dans le parent
  • enum: ["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]
posts[].versionintegerRequis dans le parent
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
posts[].automatic_retry_enabledbooleanRequis dans le parent—
posts[].delete_requested_atstring | nullRequis dans le parent—
posts[].delete_requested_atanyOf 1stringRequis dans le parent—
posts[].delete_requested_atanyOf 2nullRequis dans le parent—
posts[].published_atstring | nullRequis dans le parent—
posts[].published_atanyOf 1stringRequis dans le parent—
posts[].published_atanyOf 2nullRequis dans le parent—
posts[].deleted_atstring | nullRequis dans le parent—
posts[].deleted_atanyOf 1stringRequis dans le parent—
posts[].deleted_atanyOf 2nullRequis dans le parent—
posts[].provider_post_idstring | nullRequis dans le parent—
posts[].provider_post_idanyOf 1stringRequis dans le parent—
posts[].provider_post_idanyOf 2nullRequis dans le parent—
posts[].permalinkstring | nullRequis dans le parent—
posts[].permalinkanyOf 1stringRequis dans le parent
  • format: "uri"
posts[].permalinkanyOf 2nullRequis dans le parent—
posts[].created_atstringRequis dans le parent—
posts[].updated_atstringRequis dans le parent—
posts[].project_idstring | nullRequis dans le parent—
posts[].project_idanyOf 1stringRequis dans le parent
  • format: "uuid"
posts[].project_idanyOf 2nullRequis dans le parent—
posts[].batch_idstring | nullRequis dans le parent—
posts[].batch_idanyOf 1stringRequis dans le parent
  • format: "uuid"
posts[].batch_idanyOf 2nullRequis dans le parent—
posts[].source_refobject | nullRequis dans le parent—
posts[].source_refanyOf 1objectRequis dans le parent
  • additionalProperties: {}
posts[].source_ref.*anyOf 1any JSON valueFacultatif / élément—
posts[].source_refanyOf 2nullRequis dans le parent—
next_cursorobject | nullRequis dans le parent—
next_cursoranyOf 1objectRequis dans le parent
  • additionalProperties: false
next_cursor.scheduled_atanyOf 1stringRequis dans le parent
  • 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 1stringRequis dans le parent
  • 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 2nullRequis dans le parent—
returned_countintegerRequis dans le parent
  • minimum: 0
  • maximum: 9007199254740991
JSON Schema complet
{
  "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"
          },
          "social_account_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ]
          },
          "platform": {
            "type": "string",
            "enum": [
              "instagram",
              "threads",
              "facebook",
              "youtube",
              "x"
            ]
          },
          "destination": {
            "type": "object",
            "properties": {
              "social_account_id": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "uuid"
                  },
                  {
                    "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"
            ],
            "additionalProperties": false
          },
          "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"
              ],
              "additionalProperties": false
            }
          },
          "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"
              }
            },
            "additionalProperties": false
          },
          "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"
              },
              {
                "type": "null"
              }
            ]
          },
          "batch_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "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"
        ],
        "additionalProperties": false
      }
    },
    "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"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "returned_count": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "posts",
    "next_cursor",
    "returned_count"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Exemple d’appel d’outil

Ces exemples utilisent des valeurs fictives vérifiées contre les schémas. Remplacez les identifiants par ceux que vous êtes autorisé à utiliser, les médias par des ressources prêtes et les dates par l’heure confirmée. Vérifiez l’éligibilité du compte avant toute écriture. Cette page n’envoie aucune requête API.

{
  "name": "sosoapi_list_scheduled_posts",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111"
  }
}

structuredContent

{
  "posts": [],
  "next_cursor": null,
  "returned_count": 0
}
Installer ou connecter MCP