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

Søk lastes bare når du bruker det. Bla gjennom alle kategoriene nedenfor.

MCP-verktøy

Vis planlagte innlegg

sosoapi_list_scheduled_posts

Vis planlagte innlegg i et arbeidsområde, filtrert etter prosjekt, status (scheduled, publishing, published, failed, expired, needs_reschedule, cancelled, deleted) og tidsrom, med markørbasert paginering.

Les som Markdown

Profiler og transporter

Profiler: core, full · Transporter: stdio, http

Velg core eller full for å kontrollere hvilke verktøy klienten ser; dette endrer ikke tillatelsene. Lokal filopplasting krever stdio og er utilgjengelig over HTTP. Angi SOSOAPI_OUTPUT_SCHEMAS=1 for å inkludere utdataskjemaer i oppdagelsen. Verktøy returnerer strukturerte resultater med eller uten den innstillingen.

Tillatelser og sideeffekter

Merknader hjelper klienter med å beskrive et verktøy. Hvert kall kontrollerer fortsatt brukerens autentisering, rolle, ressurstilgang og funksjonstillatelser.

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

Inndatafelter

Påkrevd betyr påkrevd i foreldreobjektet og valgt gren. Et påkrevd underfelt gjør ikke en valgfri forelder påkrevd. Reglene og feltnavnene nedenfor er kopiert fra kontrakten.

Inndatafelter
Felt / grenType / påkrevdBegrensninger
$objectPåkrevd i forelder
  • additionalProperties: false
workspace_idstringPåkrevd i forelder
  • format: "uuid"
project_idstringValgfritt / element
  • format: "uuid"
statusstringValgfritt / element
  • enum: ["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]
scheduled_fromstringValgfritt / element
  • 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_tostringValgfritt / element
  • 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)))$"
limitintegerValgfritt / element
  • minimum: 1
  • maximum: 200
cursorobjectValgfritt / element
  • additionalProperties: false
cursor.scheduled_atstringPåkrevd i forelder
  • 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.idstringPåkrevd i forelder
  • 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}$"
Fullstendig JSON Schema
{
  "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
}

Strukturert utdata

Dette skjemaet beskriver structuredContent i et vellykket verktøyresultat. MCP-svaret inkluderer også content og kan sette isError når et kall mislykkes. Ved publisering, les innleggets endelige resultat i stedet for å regne en akseptert forespørsel eller et tekstsvar som bekreftelse. Den lenkede API-operasjonen forklarer tillatelser og regler for nye forsøk.

Påkrevd betyr påkrevd i foreldreobjektet og valgt gren. Et påkrevd underfelt gjør ikke en valgfri forelder påkrevd. Reglene og feltnavnene nedenfor er kopiert fra kontrakten.

Strukturert utdata
Felt / grenType / påkrevdBegrensninger
$objectPåkrevd i forelder
  • additionalProperties: false
postsarrayPåkrevd i forelder—
posts[]objectValgfritt / element
  • additionalProperties: false
posts[].idstringPåkrevd i forelder
  • 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_idstringPåkrevd i forelder
  • format: "uuid"
posts[].social_account_idstring | nullPåkrevd i forelder—
posts[].social_account_idanyOf 1stringPåkrevd i forelder
  • format: "uuid"
posts[].social_account_idanyOf 2nullPåkrevd i forelder—
posts[].platformstringPåkrevd i forelder
  • enum: ["instagram","threads","facebook","youtube","x"]
posts[].destinationobjectPåkrevd i forelder
  • additionalProperties: false
posts[].destination.social_account_idstring | nullPåkrevd i forelder—
posts[].destination.social_account_idanyOf 1stringPåkrevd i forelder
  • format: "uuid"
posts[].destination.social_account_idanyOf 2nullPåkrevd i forelder—
posts[].destination.platformstringPåkrevd i forelder
  • enum: ["instagram","threads","facebook","youtube","x"]
posts[].destination.platform_user_idstring | nullPåkrevd i forelder—
posts[].destination.platform_user_idanyOf 1stringPåkrevd i forelder—
posts[].destination.platform_user_idanyOf 2nullPåkrevd i forelder—
posts[].destination.account_labelstring | nullPåkrevd i forelder—
posts[].destination.account_labelanyOf 1stringPåkrevd i forelder—
posts[].destination.account_labelanyOf 2nullPåkrevd i forelder—
posts[].captionstring | nullPåkrevd i forelder—
posts[].captionanyOf 1stringPåkrevd i forelder—
posts[].captionanyOf 2nullPåkrevd i forelder—
posts[].hashtagsarrayPåkrevd i forelder—
posts[].hashtags[]stringValgfritt / element—
posts[].mediaarrayPåkrevd i forelder—
posts[].media[]objectValgfritt / element
  • additionalProperties: false
posts[].media[].kindstringPåkrevd i forelder
  • enum: ["image","video"]
posts[].media[].urlstringPåkrevd i forelder
  • format: "uri"
posts[].media[].cover_urlstring | nullValgfritt / element—
posts[].media[].cover_urlanyOf 1stringValgfritt / element
  • format: "uri"
posts[].media[].cover_urlanyOf 2nullValgfritt / element—
posts[].media[].cover_asset_idinteger | nullValgfritt / element—
posts[].media[].cover_asset_idanyOf 1integerValgfritt / element
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
posts[].media[].cover_asset_idanyOf 2nullValgfritt / element—
posts[].media[].asset_idinteger | nullValgfritt / element—
posts[].media[].asset_idanyOf 1integerValgfritt / element
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
posts[].media[].asset_idanyOf 2nullValgfritt / element—
posts[].media[].mime_typestring | nullValgfritt / element—
posts[].media[].mime_typeanyOf 1stringValgfritt / element
  • minLength: 1
  • maxLength: 160
posts[].media[].mime_typeanyOf 2nullValgfritt / element—
posts[].media[].preview_urlstring | nullValgfritt / element

Midlertidig autorisert lese-URL; behold url som varig medieidentitet for planlagt innlegg.

—
posts[].media[].preview_urlanyOf 1stringValgfritt / element
  • format: "uri"
posts[].media[].preview_urlanyOf 2nullValgfritt / element—
posts[].media[].cover_preview_urlstring | nullValgfritt / element

Midlertidig autorisert lese-URL for forsidebilde; behold cover_url som varig medieidentitet.

—
posts[].media[].cover_preview_urlanyOf 1stringValgfritt / element
  • format: "uri"
posts[].media[].cover_preview_urlanyOf 2nullValgfritt / element—
posts[].media[].preview_expires_atstring | nullValgfritt / element—
posts[].media[].preview_expires_atanyOf 1stringValgfritt / element
  • 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 2nullValgfritt / element—
posts[].link_urlstring | nullValgfritt / element—
posts[].link_urlanyOf 1stringValgfritt / element
  • format: "uri"
posts[].link_urlanyOf 2nullValgfritt / element—
posts[].publish_optionsobjectPåkrevd i forelder
  • additionalProperties: false
posts[].publish_options.post_typestringValgfritt / element
  • enum: ["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]
posts[].publish_options.location_idstringValgfritt / element
  • minLength: 1
posts[].publish_options.share_to_feedbooleanValgfritt / element—
posts[].publish_options.collaboratorsarrayValgfritt / element
  • maxItems: 3
posts[].publish_options.collaborators[]stringValgfritt / element
  • minLength: 1
posts[].publish_options.first_commentstringValgfritt / element
  • minLength: 1
  • maxLength: 2200
posts[].publish_options.topic_tagstringValgfritt / element
  • minLength: 1
posts[].publish_options.thumb_offset_msintegerValgfritt / element
  • minimum: 0
  • maximum: 9007199254740991
posts[].publish_options.titlestringValgfritt / element
  • maxLength: 255
posts[].publish_options.youtube_privacy_statusstringValgfritt / element
  • enum: ["private","unlisted","public"]
posts[].publish_options.youtube_category_idstringValgfritt / element
  • pattern: "^\\d+$"
posts[].publish_options.youtube_contains_synthetic_mediabooleanValgfritt / element—
posts[].publish_options.descriptionstringValgfritt / element
  • maxLength: 5000
posts[].publish_options.category_idstringValgfritt / element
  • pattern: "^\\d+$"
posts[].publish_options.privacy_statusstringValgfritt / element
  • enum: ["private","unlisted","public"]
posts[].publish_options.cancellation_modestringValgfritt / element
  • enum: ["DELETE","UNSCHEDULE_KEEP_PRIVATE"]
posts[].publish_options.tagsarrayValgfritt / element—
posts[].publish_options.tags[]stringValgfritt / element—
posts[].publish_options.default_languagestringValgfritt / element—
posts[].publish_options.localizationsobjectValgfritt / element
  • additionalProperties: {}
posts[].publish_options.localizations.*any JSON valueValgfritt / element—
posts[].publish_options.licensestringValgfritt / element
  • enum: ["youtube","creativeCommon"]
posts[].publish_options.embeddablebooleanValgfritt / element—
posts[].publish_options.public_stats_viewablebooleanValgfritt / element—
posts[].publish_options.self_declared_made_for_kidsbooleanValgfritt / element—
posts[].publish_options.contains_synthetic_mediabooleanValgfritt / element—
posts[].publish_options.has_paid_product_placementbooleanValgfritt / element—
posts[].publish_options.recording_datestringValgfritt / element—
posts[].publish_options.notify_subscribersbooleanValgfritt / element—
posts[].publish_options.thumbnail_asset_idintegerValgfritt / element
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
posts[].publish_options.surface_expectationstringValgfritt / element
  • const: "SHORT"
posts[].publish_options.brand_partnerobjectValgfritt / element
  • additionalProperties: {}
posts[].publish_options.brand_partner.*any JSON valueValgfritt / element—
posts[].publish_options.cover_asset_idintegerValgfritt / element
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
posts[].publish_options.audio_namestringValgfritt / element—
posts[].publish_options.trial_paramsobjectValgfritt / element
  • additionalProperties: {}
posts[].publish_options.trial_params.*any JSON valueValgfritt / element—
posts[].publish_options.is_ai_generatedbooleanValgfritt / element—
posts[].publish_options.branded_content_sponsor_idsarrayValgfritt / element—
posts[].publish_options.branded_content_sponsor_ids[]stringValgfritt / element—
posts[].publish_options.is_paid_partnershipbooleanValgfritt / element—
posts[].publish_options.media_optionsarrayValgfritt / element—
posts[].publish_options.media_options[]objectValgfritt / element
  • additionalProperties: {}
posts[].publish_options.media_options[].*any JSON valueValgfritt / element—
posts[].publish_options.reply_to_idstringValgfritt / element—
posts[].publish_options.quote_post_idstringValgfritt / element—
posts[].publish_options.repost_target_idstringValgfritt / element—
posts[].publish_options.reply_controlstringValgfritt / element—
posts[].publish_options.enable_reply_approvalsbooleanValgfritt / element—
posts[].publish_options.link_attachmentstringValgfritt / element
  • format: "uri"
posts[].publish_options.poll_attachmentobjectValgfritt / element
  • additionalProperties: {}
posts[].publish_options.poll_attachment.*any JSON valueValgfritt / element—
posts[].publish_options.gif_attachmentobjectValgfritt / element
  • additionalProperties: {}
posts[].publish_options.gif_attachment.*any JSON valueValgfritt / element—
posts[].publish_options.text_attachmentobjectValgfritt / element
  • additionalProperties: {}
posts[].publish_options.text_attachment.*any JSON valueValgfritt / element—
posts[].publish_options.text_entitiesarrayValgfritt / element—
posts[].publish_options.text_entities[]objectValgfritt / element
  • additionalProperties: {}
posts[].publish_options.text_entities[].*any JSON valueValgfritt / element—
posts[].publish_options.is_spoiler_mediabooleanValgfritt / element—
posts[].publish_options.is_ghost_postbooleanValgfritt / element—
posts[].publish_options.allowlisted_country_codesarrayValgfritt / element—
posts[].publish_options.allowlisted_country_codes[]stringValgfritt / element—
posts[].publish_options.crossreshare_to_igbooleanValgfritt / element—
posts[].publish_options.crossreshare_to_ig_dark_modebooleanValgfritt / element—
posts[].publish_options.auto_publish_textbooleanValgfritt / element—
posts[].publish_options.publication_modestringValgfritt / element
  • enum: ["PUBLISH","DRAFT"]
posts[].publish_options.backdated_timenumberValgfritt / element—
posts[].publish_options.backdated_time_granularitystringValgfritt / element
  • enum: ["year","month","day","hour","minute"]
posts[].publish_options.placestringValgfritt / element—
posts[].publish_options.feed_targetingobjectValgfritt / element
  • additionalProperties: {}
posts[].publish_options.feed_targeting.*any JSON valueValgfritt / element—
posts[].publish_options.targetingobjectValgfritt / element
  • additionalProperties: {}
posts[].publish_options.targeting.*any JSON valueValgfritt / element—
posts[].publish_options.child_attachmentsarrayValgfritt / element—
posts[].publish_options.child_attachments[]objectValgfritt / element
  • additionalProperties: {}
posts[].publish_options.child_attachments[].*any JSON valueValgfritt / element—
posts[].publish_options.multi_share_end_cardbooleanValgfritt / element—
posts[].publish_options.multi_share_optimizedbooleanValgfritt / element—
posts[].publish_options.unpublished_content_typestringValgfritt / element—
posts[].publish_options.no_storybooleanValgfritt / element—
posts[].publish_options.crossposted_video_idstringValgfritt / element—
posts[].publish_options.sphericalbooleanValgfritt / element—
posts[].scheduled_atstringPåkrevd i forelder—
posts[].display_timezonestringPåkrevd i forelder
  • minLength: 1
  • maxLength: 80
posts[].local_scheduled_atstring | nullValgfritt / element—
posts[].local_scheduled_atanyOf 1stringValgfritt / element
  • pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
posts[].local_scheduled_atanyOf 2nullValgfritt / element—
posts[].schedule_timezonestring | nullValgfritt / element—
posts[].schedule_timezoneanyOf 1stringValgfritt / element
  • minLength: 1
  • maxLength: 80
posts[].schedule_timezoneanyOf 2nullValgfritt / element—
posts[].schedule_dst_disambiguationstring | nullValgfritt / element—
posts[].schedule_dst_disambiguationanyOf 1stringValgfritt / element
  • enum: ["exact","earlier","later"]
posts[].schedule_dst_disambiguationanyOf 2nullValgfritt / element—
posts[].schedule_intent_statestringValgfritt / element
  • enum: ["verified","legacy_unverified"]
posts[].expires_atstring | nullPåkrevd i forelder—
posts[].expires_atanyOf 1stringPåkrevd i forelder—
posts[].expires_atanyOf 2nullPåkrevd i forelder—
posts[].statusstringPåkrevd i forelder
  • enum: ["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]
posts[].versionintegerPåkrevd i forelder
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
posts[].automatic_retry_enabledbooleanPåkrevd i forelder—
posts[].delete_requested_atstring | nullPåkrevd i forelder—
posts[].delete_requested_atanyOf 1stringPåkrevd i forelder—
posts[].delete_requested_atanyOf 2nullPåkrevd i forelder—
posts[].published_atstring | nullPåkrevd i forelder—
posts[].published_atanyOf 1stringPåkrevd i forelder—
posts[].published_atanyOf 2nullPåkrevd i forelder—
posts[].deleted_atstring | nullPåkrevd i forelder—
posts[].deleted_atanyOf 1stringPåkrevd i forelder—
posts[].deleted_atanyOf 2nullPåkrevd i forelder—
posts[].provider_post_idstring | nullPåkrevd i forelder—
posts[].provider_post_idanyOf 1stringPåkrevd i forelder—
posts[].provider_post_idanyOf 2nullPåkrevd i forelder—
posts[].permalinkstring | nullPåkrevd i forelder—
posts[].permalinkanyOf 1stringPåkrevd i forelder
  • format: "uri"
posts[].permalinkanyOf 2nullPåkrevd i forelder—
posts[].created_atstringPåkrevd i forelder—
posts[].updated_atstringPåkrevd i forelder—
posts[].project_idstring | nullPåkrevd i forelder—
posts[].project_idanyOf 1stringPåkrevd i forelder
  • format: "uuid"
posts[].project_idanyOf 2nullPåkrevd i forelder—
posts[].batch_idstring | nullPåkrevd i forelder—
posts[].batch_idanyOf 1stringPåkrevd i forelder
  • format: "uuid"
posts[].batch_idanyOf 2nullPåkrevd i forelder—
posts[].source_refobject | nullPåkrevd i forelder—
posts[].source_refanyOf 1objectPåkrevd i forelder
  • additionalProperties: {}
posts[].source_ref.*anyOf 1any JSON valueValgfritt / element—
posts[].source_refanyOf 2nullPåkrevd i forelder—
next_cursorobject | nullPåkrevd i forelder—
next_cursoranyOf 1objectPåkrevd i forelder
  • additionalProperties: false
next_cursor.scheduled_atanyOf 1stringPåkrevd i forelder
  • 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 1stringPåkrevd i forelder
  • 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 2nullPåkrevd i forelder—
returned_countintegerPåkrevd i forelder
  • minimum: 0
  • maximum: 9007199254740991
Fullstendig JSON 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"
          },
          "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
}

Eksempel på verktøykall

Disse eksemplene bruker fiktive verdier kontrollert mot skjemaene. Erstatt ID-ene med noen du har lov til å bruke, mediene med klare ressurser og datoene med bekreftet publiseringstidspunkt. Kontroller kontoens kvalifikasjon før en skriveoperasjon sendes inn. Siden sender ingen API-forespørsler.

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

structuredContent

{
  "posts": [],
  "next_cursor": null,
  "returned_count": 0
}
Installer eller koble til MCP