MCP tool
Preview Threads content queue
sosoapi_preview_threads_content_queuePreview the next Draft and weekly slot; return blockers or a digest for explicit allocation.
Read as MarkdownProfiles and transports
Profiles: full · Transports: stdio, http
Choose core or full to control which tools your client sees; this does not change its permissions. Local file upload requires stdio and is unavailable over HTTP. Set SOSOAPI_OUTPUT_SCHEMAS=1 to include output schemas in discovery. Tools return structured results with or without that setting.
Permissions and side effects
Annotations help clients describe a tool. Each call still checks the user’s authentication, role, resource access and capability grants.
{
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": true
}- /studio-api/threads-content-queues/preview: agent:operate · versioned queue configuration/pending references; pause and deletion preserve all accepted schedules and receipts
Input fields
Required means required inside its parent object and selected branch. A required child does not make an optional parent required. Rules and field names below are copied from the contract.
| Field / branch | Type / required | Constraints |
|---|---|---|
$ | objectRequired in parent |
|
workspace_id | stringRequired in parent |
|
id | stringRequired in parent |
|
expected_version | integerRequired in parent |
|
Complete JSON Schema
{
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid"
},
"id": {
"type": "string",
"format": "uuid"
},
"expected_version": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"workspace_id",
"id",
"expected_version"
],
"additionalProperties": false
}Structured output
This schema describes structuredContent in a successful tool result. The MCP response also includes content and may set isError when a call fails. For publishing, read the post’s final result rather than treating an accepted request or text response as confirmation. The linked API operation explains permissions and retry rules.
Required means required inside its parent object and selected branch. A required child does not make an optional parent required. Rules and field names below are copied from the contract.
| Field / branch | Type / required | Constraints |
|---|---|---|
$ | objectRequired in parent |
|
queue | objectRequired in parent |
|
queue.id | stringRequired in parent |
|
queue.workspace_id | stringRequired in parent |
|
queue.social_account_id | stringRequired in parent |
|
queue.name | stringRequired in parent |
|
queue.display_timezone | stringRequired in parent |
|
queue.weekly_slots | arrayRequired in parent |
|
queue.weekly_slots[] | objectOptional / item |
|
queue.weekly_slots[].weekday | integerRequired in parent |
|
queue.weekly_slots[].local_time | stringRequired in parent |
|
queue.paused | booleanRequired in parent | — |
queue.deleted | booleanRequired in parent | — |
queue.version | integerRequired in parent |
|
queue.created_at | stringRequired in parent |
|
queue.updated_at | stringRequired in parent |
|
queue.pending_items | arrayRequired in parent |
|
queue.pending_items[] | objectOptional / item |
|
queue.pending_items[].item_id | stringRequired in parent |
|
queue.pending_items[].draft_id | stringRequired in parent |
|
queue.pending_items[].draft_revision | integerRequired in parent |
|
queue.pending_items[].current_revision | integer | nullRequired in parent | — |
queue.pending_items[].current_revisionanyOf 1 | integerRequired in parent |
|
queue.pending_items[].current_revisionanyOf 2 | nullRequired in parent | — |
queue.pending_items[].draft_state | string | nullRequired in parent | — |
queue.pending_items[].draft_stateanyOf 1 | stringRequired in parent |
|
queue.pending_items[].draft_stateanyOf 2 | nullRequired in parent | — |
queue.pending_items[].caption_preview | stringRequired in parent |
|
queue.allocations | arrayRequired in parent |
|
queue.allocations[] | objectOptional / item |
|
queue.allocations[].id | stringRequired in parent |
|
queue.allocations[].item_id | stringRequired in parent |
|
queue.allocations[].draft_id | stringRequired in parent |
|
queue.allocations[].draft_revision | integerRequired in parent |
|
queue.allocations[].mutation_id | stringRequired in parent |
|
queue.allocations[].slot | objectRequired in parent |
|
queue.allocations[].slot.scheduled_at | stringRequired in parent |
|
queue.allocations[].slot.local_date | stringRequired in parent |
|
queue.allocations[].slot.local_time | stringRequired in parent |
|
queue.allocations[].slot.utc_offset_minutes | integerRequired in parent |
|
queue.allocations[].slot.display_timezone | stringRequired in parent |
|
queue.allocations[].post_id | stringRequired in parent |
|
queue.allocations[].accepted_at | stringRequired in parent |
|
status | stringRequired in parent |
|
item | object | nullRequired in parent | — |
itemanyOf 1 | objectRequired in parent |
|
item.item_idanyOf 1 | stringRequired in parent |
|
item.draft_idanyOf 1 | stringRequired in parent |
|
item.draft_revisionanyOf 1 | integerRequired in parent |
|
item.current_revisionanyOf 1 | integer | nullRequired in parent | — |
item.current_revisionanyOf 1 / anyOf 1 | integerRequired in parent |
|
item.current_revisionanyOf 1 / anyOf 2 | nullRequired in parent | — |
item.draft_stateanyOf 1 | string | nullRequired in parent | — |
item.draft_stateanyOf 1 / anyOf 1 | stringRequired in parent |
|
item.draft_stateanyOf 1 / anyOf 2 | nullRequired in parent | — |
item.caption_previewanyOf 1 | stringRequired in parent |
|
itemanyOf 2 | nullRequired in parent | — |
draft | object | nullRequired in parent | — |
draftanyOf 1 | objectRequired in parent |
|
draft.idanyOf 1 | stringRequired in parent |
|
draft.workspace_idanyOf 1 | stringRequired in parent |
|
draft.revisionanyOf 1 | integerRequired in parent |
|
draft.stateanyOf 1 | stringRequired in parent |
|
draft.contentanyOf 1 | objectRequired in parent |
|
draft.content.schemaVersionanyOf 1 | numberRequired in parent |
|
draft.content.accountIdsanyOf 1 | arrayRequired in parent |
|
draft.content.accountIds[]anyOf 1 | stringOptional / item |
|
draft.content.captionanyOf 1 | stringRequired in parent |
|
draft.content.hashtagsanyOf 1 | stringRequired in parent |
|
draft.content.assetIdsanyOf 1 | arrayRequired in parent |
|
draft.content.assetIds[]anyOf 1 | stringOptional / item |
|
draft.content.threadsTextOnlyanyOf 1 | booleanRequired in parent |
|
draft.content.threadsOptionsanyOf 1 | objectOptional / item |
|
draft.content.threadsOptions.post_typeanyOf 1 | stringOptional / item |
|
draft.content.threadsOptions.reply_to_idanyOf 1 | stringOptional / item |
|
draft.content.threadsOptions.quote_post_idanyOf 1 | stringOptional / item |
|
draft.content.threadsOptions.repost_target_idanyOf 1 | stringOptional / item |
|
draft.content.threadsOptions.reply_controlanyOf 1 | stringOptional / item |
|
draft.content.threadsOptions.enable_reply_approvalsanyOf 1 | booleanOptional / item | — |
draft.content.threadsOptions.link_attachmentanyOf 1 | stringOptional / item |
|
draft.content.threadsOptions.poll_attachmentanyOf 1 | objectOptional / item |
|
draft.content.threadsOptions.poll_attachment.option_aanyOf 1 | stringRequired in parent |
|
draft.content.threadsOptions.poll_attachment.option_banyOf 1 | stringRequired in parent |
|
draft.content.threadsOptions.poll_attachment.option_canyOf 1 | stringOptional / item |
|
draft.content.threadsOptions.poll_attachment.option_danyOf 1 | stringOptional / item |
|
draft.content.threadsOptions.gif_attachmentanyOf 1 | objectOptional / item |
|
draft.content.threadsOptions.gif_attachment.gif_idanyOf 1 | stringRequired in parent |
|
draft.content.threadsOptions.gif_attachment.provideranyOf 1 | stringRequired in parent |
|
draft.content.threadsOptions.text_attachmentanyOf 1 | objectOptional / item |
|
draft.content.threadsOptions.text_attachment.plaintextanyOf 1 | stringRequired in parent |
|
draft.content.threadsOptions.text_attachment.link_attachment_urlanyOf 1 | stringOptional / item |
|
draft.content.threadsOptions.text_attachment.text_with_styling_infoanyOf 1 | arrayOptional / item |
|
draft.content.threadsOptions.text_attachment.text_with_styling_info[]anyOf 1 | objectOptional / item |
|
draft.content.threadsOptions.text_attachment.text_with_styling_info[].offsetanyOf 1 | integerRequired in parent |
|
draft.content.threadsOptions.text_attachment.text_with_styling_info[].lengthanyOf 1 | integerRequired in parent |
|
draft.content.threadsOptions.text_attachment.text_with_styling_info[].styling_infoanyOf 1 | arrayRequired in parent |
|
draft.content.threadsOptions.text_attachment.text_with_styling_info[].styling_info[]anyOf 1 | stringOptional / item |
|
draft.content.threadsOptions.topic_taganyOf 1 | stringOptional / item |
|
draft.content.threadsOptions.text_entitiesanyOf 1 | arrayOptional / item |
|
draft.content.threadsOptions.text_entities[]anyOf 1 | objectOptional / item |
|
draft.content.threadsOptions.text_entities[].entity_typeanyOf 1 | stringRequired in parent |
|
draft.content.threadsOptions.text_entities[].offsetanyOf 1 | integerRequired in parent |
|
draft.content.threadsOptions.text_entities[].lengthanyOf 1 | integerRequired in parent |
|
draft.content.threadsOptions.is_spoiler_mediaanyOf 1 | booleanOptional / item | — |
draft.content.threadsOptions.is_ghost_postanyOf 1 | booleanOptional / item | — |
draft.content.threadsOptions.location_idanyOf 1 | stringOptional / item |
|
draft.content.threadsOptions.allowlisted_country_codesanyOf 1 | arrayOptional / item |
|
draft.content.threadsOptions.allowlisted_country_codes[]anyOf 1 | stringOptional / item |
|
draft.content.threadsOptions.crossreshare_to_iganyOf 1 | booleanOptional / item | — |
draft.content.threadsOptions.crossreshare_to_ig_dark_modeanyOf 1 | booleanOptional / item | — |
draft.content.threadsOptions.auto_publish_textanyOf 1 | booleanOptional / item | — |
draft.content.threadsOptions.media_optionsanyOf 1 | arrayOptional / item |
|
draft.content.threadsOptions.media_options[]anyOf 1 | objectOptional / item |
|
draft.content.threadsOptions.media_options[].asset_idanyOf 1 | integerRequired in parent |
|
draft.content.threadsOptions.media_options[].alt_textanyOf 1 | stringOptional / item |
|
draft.content.threadsOptions.media_options[].is_spoiler_mediaanyOf 1 | booleanOptional / item | — |
draft.content.instagramModeanyOf 1 | stringRequired in parent |
|
draft.content.youtubeTitleanyOf 1 | stringRequired in parent |
|
draft.content.youtubePrivacyanyOf 1 | stringRequired in parent |
|
draft.content.youtubeSyntheticanyOf 1 | booleanRequired in parent |
|
draft.content.youtubeCategoryIdanyOf 1 | stringRequired in parent |
|
draft.content.youtubeShortanyOf 1 | booleanRequired in parent |
|
draft.content.linkUrlanyOf 1 | stringRequired in parent |
|
draft.content.scheduledAtanyOf 1 | stringRequired in parent |
|
draft.content.displayTimezoneanyOf 1 | stringRequired in parent |
|
draft.content.publishNowanyOf 1 | booleanRequired in parent |
|
draft.content.destinationOverridesanyOf 1 | objectRequired in parent |
|
draft.content.destinationOverrides.*anyOf 1 | objectOptional / item |
|
draft.content.destinationOverrides.*.captionanyOf 1 | stringOptional / item |
|
draft.content.destinationOverrides.*.scheduledAtanyOf 1 | stringOptional / item |
|
draft.content.expiresAtanyOf 1 | stringRequired in parent |
|
draft.created_byanyOf 1 | string | nullRequired in parent | — |
draft.created_byanyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.created_byanyOf 1 / anyOf 2 | nullRequired in parent | — |
draft.updated_byanyOf 1 | string | nullRequired in parent | — |
draft.updated_byanyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.updated_byanyOf 1 / anyOf 2 | nullRequired in parent | — |
draft.created_atanyOf 1 | stringRequired in parent |
|
draft.updated_atanyOf 1 | stringRequired in parent |
|
draft.submissionanyOf 1 | object | nullRequired in parent | — |
draft.submissionanyOf 1 / anyOf 1 | objectRequired in parent |
|
draft.submission.idanyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.submission.expected_revisionanyOf 1 / anyOf 1 | integerRequired in parent |
|
draft.submission.started_atanyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.submission.receiptanyOf 1 / anyOf 1 | object | nullRequired in parent | — |
draft.submission.receiptanyOf 1 / anyOf 1 / anyOf 1 | objectRequired in parent |
|
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 / anyOf 1 | string | nullRequired in parent | — |
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 / anyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.submission.receipt.batch_idanyOf 1 / anyOf 1 / anyOf 1 / anyOf 2 | nullRequired in parent | — |
draft.submission.receipt.successesanyOf 1 / anyOf 1 / anyOf 1 | arrayRequired in parent |
|
draft.submission.receipt.successes[]anyOf 1 / anyOf 1 / anyOf 1 | objectOptional / item |
|
draft.submission.receipt.successes[].social_account_idanyOf 1 / anyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.submission.receipt.successes[].post_idanyOf 1 / anyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.submission.receipt.failuresanyOf 1 / anyOf 1 / anyOf 1 | arrayRequired in parent |
|
draft.submission.receipt.failures[]anyOf 1 / anyOf 1 / anyOf 1 | objectOptional / item |
|
draft.submission.receipt.failures[].social_account_idanyOf 1 / anyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.submission.receipt.failures[].codeanyOf 1 / anyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.submission.receipt.failures[].messageanyOf 1 / anyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.submission.receiptanyOf 1 / anyOf 1 / anyOf 2 | nullRequired in parent | — |
draft.submissionanyOf 1 / anyOf 2 | nullRequired in parent | — |
draft.brand_contextanyOf 1 | object | nullOptional / item | — |
draft.brand_contextanyOf 1 / anyOf 1 | objectOptional / item |
|
draft.brand_context.workspace_idanyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.brand_context.selectionanyOf 1 / anyOf 1 | objectRequired in parent |
|
draft.brand_context.selection.profile_idanyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.brand_context.selection.version_idanyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.brand_context.selection.revisionanyOf 1 / anyOf 1 | integerRequired in parent |
|
draft.brand_context.selection.content_digestanyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.brand_context.selection.context_digestanyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.brand_context.availabilityanyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.brand_context.profile_stateanyOf 1 / anyOf 1 | string | nullRequired in parent | — |
draft.brand_context.profile_stateanyOf 1 / anyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.brand_context.profile_stateanyOf 1 / anyOf 1 / anyOf 2 | nullRequired in parent | — |
draft.brand_context.contentanyOf 1 / anyOf 1 | object | nullRequired in parent | — |
draft.brand_context.contentanyOf 1 / anyOf 1 / anyOf 1 | objectRequired in parent |
|
draft.brand_context.content.nameanyOf 1 / anyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.brand_context.content.audienceanyOf 1 / anyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.brand_context.content.voiceanyOf 1 / anyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.brand_context.content.languageanyOf 1 / anyOf 1 / anyOf 1 | string | nullRequired in parent | — |
draft.brand_context.content.languageanyOf 1 / anyOf 1 / anyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.brand_context.content.languageanyOf 1 / anyOf 1 / anyOf 1 / anyOf 2 | nullRequired in parent | — |
draft.brand_context.content.preferred_termsanyOf 1 / anyOf 1 / anyOf 1 | arrayRequired in parent |
|
draft.brand_context.content.preferred_terms[]anyOf 1 / anyOf 1 / anyOf 1 | stringOptional / item |
|
draft.brand_context.content.prohibited_termsanyOf 1 / anyOf 1 / anyOf 1 | arrayRequired in parent |
|
draft.brand_context.content.prohibited_terms[]anyOf 1 / anyOf 1 / anyOf 1 | stringOptional / item |
|
draft.brand_context.content.locked_factsanyOf 1 / anyOf 1 / anyOf 1 | arrayRequired in parent |
|
draft.brand_context.content.locked_facts[]anyOf 1 / anyOf 1 / anyOf 1 | stringOptional / item |
|
draft.brand_context.content.call_to_actionanyOf 1 / anyOf 1 / anyOf 1 | string | nullRequired in parent | — |
draft.brand_context.content.call_to_actionanyOf 1 / anyOf 1 / anyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.brand_context.content.call_to_actionanyOf 1 / anyOf 1 / anyOf 1 / anyOf 2 | nullRequired in parent | — |
draft.brand_context.contentanyOf 1 / anyOf 1 / anyOf 2 | nullRequired in parent | — |
draft.brand_context.sourcesanyOf 1 / anyOf 1 | objectRequired in parent |
|
draft.brand_context.sources.websiteanyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.brand_context.sources.logoanyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.brand_context.sources.own_postsanyOf 1 / anyOf 1 | objectRequired in parent |
|
draft.brand_context.sources.own_posts.selectedanyOf 1 / anyOf 1 | integerRequired in parent |
|
draft.brand_context.sources.own_posts.availableanyOf 1 / anyOf 1 | integerRequired in parent |
|
draft.brand_context.sources.own_posts.unavailableanyOf 1 / anyOf 1 | integerRequired in parent |
|
draft.brand_context.sources.own_posts.erasedanyOf 1 / anyOf 1 | integerRequired in parent |
|
draft.brand_contextanyOf 1 / anyOf 2 | nullOptional / item | — |
draft.brand_reviewanyOf 1 | object | nullOptional / item | — |
draft.brand_reviewanyOf 1 / anyOf 1 | objectOptional / item |
|
draft.brand_review.rule_versionanyOf 1 / anyOf 1 | numberRequired in parent |
|
draft.brand_review.context_digestanyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.brand_review.content_digestanyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.brand_review.statusanyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.brand_review.issuesanyOf 1 / anyOf 1 | arrayRequired in parent |
|
draft.brand_review.issues[]anyOf 1 / anyOf 1 | objectOptional / item |
|
draft.brand_review.issues[].codeanyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.brand_review.issues[].targetanyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.brand_review.issues[].rule_indexanyOf 1 / anyOf 1 | integer | nullRequired in parent | — |
draft.brand_review.issues[].rule_indexanyOf 1 / anyOf 1 / anyOf 1 | integerRequired in parent |
|
draft.brand_review.issues[].rule_indexanyOf 1 / anyOf 1 / anyOf 2 | nullRequired in parent | — |
draft.brand_review.issues[].messageanyOf 1 / anyOf 1 | stringRequired in parent |
|
draft.brand_reviewanyOf 1 / anyOf 2 | nullOptional / item | — |
draftanyOf 2 | nullRequired in parent | — |
slot | object | nullRequired in parent | — |
slotanyOf 1 | objectRequired in parent |
|
slot.scheduled_atanyOf 1 | stringRequired in parent |
|
slot.local_dateanyOf 1 | stringRequired in parent |
|
slot.local_timeanyOf 1 | stringRequired in parent |
|
slot.utc_offset_minutesanyOf 1 | integerRequired in parent |
|
slot.display_timezoneanyOf 1 | stringRequired in parent |
|
slotanyOf 2 | nullRequired in parent | — |
preview_digest | string | nullRequired in parent | — |
preview_digestanyOf 1 | stringRequired in parent |
|
preview_digestanyOf 2 | nullRequired in parent | — |
blockers | arrayRequired in parent |
|
blockers[] | objectOptional / item |
|
blockers[].code | stringRequired in parent |
|
blockers[].message | stringRequired in parent |
|
Complete JSON Schema
{
"type": "object",
"properties": {
"queue": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"social_account_id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"display_timezone": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"weekly_slots": {
"minItems": 1,
"maxItems": 49,
"type": "array",
"items": {
"type": "object",
"properties": {
"weekday": {
"type": "integer",
"minimum": 0,
"maximum": 6
},
"local_time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
}
},
"required": [
"weekday",
"local_time"
],
"additionalProperties": false
}
},
"paused": {
"type": "boolean"
},
"deleted": {
"type": "boolean"
},
"version": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"created_at": {
"type": "string",
"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)))$",
"format": "date-time"
},
"updated_at": {
"type": "string",
"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)))$",
"format": "date-time"
},
"pending_items": {
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"item_id": {
"type": "string",
"format": "uuid"
},
"draft_id": {
"type": "string",
"format": "uuid"
},
"draft_revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"current_revision": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"draft_state": {
"anyOf": [
{
"type": "string",
"enum": [
"draft",
"submitting",
"submitted"
]
},
{
"type": "null"
}
]
},
"caption_preview": {
"type": "string",
"maxLength": 500
}
},
"required": [
"item_id",
"draft_id",
"draft_revision",
"current_revision",
"draft_state",
"caption_preview"
],
"additionalProperties": false
}
},
"allocations": {
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"item_id": {
"type": "string",
"format": "uuid"
},
"draft_id": {
"type": "string",
"format": "uuid"
},
"draft_revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"mutation_id": {
"type": "string",
"format": "uuid"
},
"slot": {
"type": "object",
"properties": {
"scheduled_at": {
"type": "string",
"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)))$",
"format": "date-time"
},
"local_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"local_time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
},
"utc_offset_minutes": {
"type": "integer",
"minimum": -840,
"maximum": 840
},
"display_timezone": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"required": [
"scheduled_at",
"local_date",
"local_time",
"utc_offset_minutes",
"display_timezone"
],
"additionalProperties": false
},
"post_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
},
"accepted_at": {
"type": "string",
"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)))$",
"format": "date-time"
}
},
"required": [
"id",
"item_id",
"draft_id",
"draft_revision",
"mutation_id",
"slot",
"post_id",
"accepted_at"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"workspace_id",
"social_account_id",
"name",
"display_timezone",
"weekly_slots",
"paused",
"deleted",
"version",
"created_at",
"updated_at",
"pending_items",
"allocations"
],
"additionalProperties": false
},
"status": {
"type": "string",
"enum": [
"ready",
"blocked"
]
},
"item": {
"anyOf": [
{
"type": "object",
"properties": {
"item_id": {
"type": "string",
"format": "uuid"
},
"draft_id": {
"type": "string",
"format": "uuid"
},
"draft_revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"current_revision": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"draft_state": {
"anyOf": [
{
"type": "string",
"enum": [
"draft",
"submitting",
"submitted"
]
},
{
"type": "null"
}
]
},
"caption_preview": {
"type": "string",
"maxLength": 500
}
},
"required": [
"item_id",
"draft_id",
"draft_revision",
"current_revision",
"draft_state",
"caption_preview"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"draft": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"state": {
"type": "string",
"enum": [
"draft",
"submitting",
"submitted"
]
},
"content": {
"type": "object",
"properties": {
"schemaVersion": {
"default": 1,
"type": "number",
"const": 1
},
"accountIds": {
"default": [],
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"format": "uuid"
}
},
"caption": {
"default": "",
"type": "string",
"maxLength": 5000
},
"hashtags": {
"default": "",
"type": "string",
"maxLength": 5000
},
"assetIds": {
"default": [],
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"maxLength": 16,
"pattern": "^[1-9][0-9]*$"
}
},
"threadsTextOnly": {
"default": false,
"type": "boolean"
},
"threadsOptions": {
"type": "object",
"properties": {
"post_type": {
"type": "string",
"enum": [
"TEXT",
"IMAGE",
"VIDEO",
"CAROUSEL",
"REPOST"
]
},
"reply_to_id": {
"type": "string",
"maxLength": 128
},
"quote_post_id": {
"type": "string",
"maxLength": 128
},
"repost_target_id": {
"type": "string",
"maxLength": 128
},
"reply_control": {
"type": "string",
"enum": [
"everyone",
"accounts_you_follow",
"mentioned_only",
"parent_post_author_only",
"followers_only"
]
},
"enable_reply_approvals": {
"type": "boolean"
},
"link_attachment": {
"type": "string",
"maxLength": 2048
},
"poll_attachment": {
"type": "object",
"properties": {
"option_a": {
"type": "string",
"maxLength": 25
},
"option_b": {
"type": "string",
"maxLength": 25
},
"option_c": {
"type": "string",
"maxLength": 25
},
"option_d": {
"type": "string",
"maxLength": 25
}
},
"required": [
"option_a",
"option_b"
],
"additionalProperties": false
},
"gif_attachment": {
"type": "object",
"properties": {
"gif_id": {
"type": "string",
"maxLength": 128
},
"provider": {
"type": "string",
"const": "GIPHY"
}
},
"required": [
"gif_id",
"provider"
],
"additionalProperties": false
},
"text_attachment": {
"type": "object",
"properties": {
"plaintext": {
"type": "string",
"maxLength": 10000
},
"link_attachment_url": {
"type": "string",
"maxLength": 2048
},
"text_with_styling_info": {
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"length": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"styling_info": {
"minItems": 1,
"type": "array",
"items": {
"type": "string",
"enum": [
"bold",
"italic",
"highlight",
"underline",
"strikethrough"
]
}
}
},
"required": [
"offset",
"length",
"styling_info"
],
"additionalProperties": false
}
}
},
"required": [
"plaintext"
],
"additionalProperties": false
},
"topic_tag": {
"type": "string",
"maxLength": 50
},
"text_entities": {
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"entity_type": {
"type": "string",
"enum": [
"SPOILER",
"spoiler"
]
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"length": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"entity_type",
"offset",
"length"
],
"additionalProperties": false
}
},
"is_spoiler_media": {
"type": "boolean"
},
"is_ghost_post": {
"type": "boolean"
},
"location_id": {
"type": "string",
"maxLength": 128
},
"allowlisted_country_codes": {
"minItems": 1,
"maxItems": 249,
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Z]{2}$"
}
},
"crossreshare_to_ig": {
"type": "boolean"
},
"crossreshare_to_ig_dark_mode": {
"type": "boolean"
},
"auto_publish_text": {
"type": "boolean"
},
"media_options": {
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"asset_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"alt_text": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"is_spoiler_media": {
"type": "boolean"
}
},
"required": [
"asset_id"
],
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"instagramMode": {
"default": "REELS",
"type": "string",
"enum": [
"IMAGE",
"REELS",
"CAROUSEL",
"STORY_IMAGE",
"STORY_VIDEO"
]
},
"youtubeTitle": {
"default": "",
"type": "string",
"maxLength": 100
},
"youtubePrivacy": {
"default": "private",
"type": "string",
"enum": [
"private",
"unlisted",
"public"
]
},
"youtubeSynthetic": {
"default": false,
"type": "boolean"
},
"youtubeCategoryId": {
"default": "",
"type": "string",
"maxLength": 32
},
"youtubeShort": {
"default": false,
"type": "boolean"
},
"linkUrl": {
"default": "",
"type": "string",
"maxLength": 2048
},
"scheduledAt": {
"default": "",
"type": "string",
"maxLength": 64
},
"displayTimezone": {
"default": "UTC",
"type": "string",
"minLength": 1,
"maxLength": 128
},
"publishNow": {
"default": false,
"type": "boolean"
},
"destinationOverrides": {
"default": {},
"type": "object",
"propertyNames": {
"type": "string",
"format": "uuid"
},
"additionalProperties": {
"type": "object",
"properties": {
"caption": {
"type": "string",
"maxLength": 5000
},
"scheduledAt": {
"type": "string",
"maxLength": 64
}
},
"additionalProperties": false
}
},
"expiresAt": {
"default": "",
"type": "string",
"maxLength": 64
}
},
"required": [
"schemaVersion",
"accountIds",
"caption",
"hashtags",
"assetIds",
"threadsTextOnly",
"instagramMode",
"youtubeTitle",
"youtubePrivacy",
"youtubeSynthetic",
"youtubeCategoryId",
"youtubeShort",
"linkUrl",
"scheduledAt",
"displayTimezone",
"publishNow",
"destinationOverrides",
"expiresAt"
],
"additionalProperties": false
},
"created_by": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
]
},
"updated_by": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
]
},
"created_at": {
"type": "string",
"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)))$",
"format": "date-time"
},
"updated_at": {
"type": "string",
"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)))$",
"format": "date-time"
},
"submission": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"expected_revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"started_at": {
"type": "string",
"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)))$",
"format": "date-time"
},
"receipt": {
"anyOf": [
{
"type": "object",
"properties": {
"batch_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
]
},
"successes": {
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"social_account_id": {
"type": "string",
"format": "uuid"
},
"post_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
}
},
"required": [
"social_account_id",
"post_id"
],
"additionalProperties": false
}
},
"failures": {
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"social_account_id": {
"type": "string",
"format": "uuid"
},
"code": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"message": {
"type": "string",
"maxLength": 2000
}
},
"required": [
"social_account_id",
"code",
"message"
],
"additionalProperties": false
}
}
},
"required": [
"batch_id",
"successes",
"failures"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"expected_revision",
"started_at",
"receipt"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"brand_context": {
"anyOf": [
{
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid"
},
"selection": {
"type": "object",
"properties": {
"profile_id": {
"type": "string",
"format": "uuid"
},
"version_id": {
"type": "string",
"format": "uuid"
},
"revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"content_digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"context_digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"required": [
"profile_id",
"version_id",
"revision",
"content_digest",
"context_digest"
],
"additionalProperties": false
},
"availability": {
"type": "string",
"enum": [
"available",
"missing"
]
},
"profile_state": {
"anyOf": [
{
"type": "string",
"enum": [
"active",
"archived"
]
},
{
"type": "null"
}
]
},
"content": {
"anyOf": [
{
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"audience": {
"type": "string",
"maxLength": 2000
},
"voice": {
"type": "string",
"maxLength": 2000
},
"language": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "null"
}
]
},
"preferred_terms": {
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"prohibited_terms": {
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"locked_facts": {
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"call_to_action": {
"anyOf": [
{
"type": "string",
"maxLength": 1000
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"audience",
"voice",
"language",
"preferred_terms",
"prohibited_terms",
"locked_facts",
"call_to_action"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"sources": {
"type": "object",
"properties": {
"website": {
"type": "string",
"enum": [
"available",
"not_available"
]
},
"logo": {
"type": "string",
"enum": [
"none",
"present",
"missing"
]
},
"own_posts": {
"type": "object",
"properties": {
"selected": {
"type": "integer",
"minimum": 0,
"maximum": 10
},
"available": {
"type": "integer",
"minimum": 0,
"maximum": 10
},
"unavailable": {
"type": "integer",
"minimum": 0,
"maximum": 10
},
"erased": {
"type": "integer",
"minimum": 0,
"maximum": 10
}
},
"required": [
"selected",
"available",
"unavailable",
"erased"
],
"additionalProperties": false
}
},
"required": [
"website",
"logo",
"own_posts"
],
"additionalProperties": false
}
},
"required": [
"workspace_id",
"selection",
"availability",
"profile_state",
"content",
"sources"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"brand_review": {
"anyOf": [
{
"type": "object",
"properties": {
"rule_version": {
"type": "number",
"const": 1
},
"context_digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"content_digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"status": {
"type": "string",
"enum": [
"clear",
"attention",
"unavailable"
]
},
"issues": {
"maxItems": 5151,
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string",
"enum": [
"prohibited_term",
"locked_fact_missing",
"conflicting_rule",
"context_unavailable"
]
},
"target": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"rule_index": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 49
},
{
"type": "null"
}
]
},
"message": {
"type": "string",
"minLength": 1,
"maxLength": 240
}
},
"required": [
"code",
"target",
"rule_index",
"message"
],
"additionalProperties": false
}
}
},
"required": [
"rule_version",
"context_digest",
"content_digest",
"status",
"issues"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"workspace_id",
"revision",
"state",
"content",
"created_by",
"updated_by",
"created_at",
"updated_at",
"submission"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"slot": {
"anyOf": [
{
"type": "object",
"properties": {
"scheduled_at": {
"type": "string",
"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)))$",
"format": "date-time"
},
"local_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"local_time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
},
"utc_offset_minutes": {
"type": "integer",
"minimum": -840,
"maximum": 840
},
"display_timezone": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"required": [
"scheduled_at",
"local_date",
"local_time",
"utc_offset_minutes",
"display_timezone"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"preview_digest": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
{
"type": "null"
}
]
},
"blockers": {
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"message": {
"type": "string",
"minLength": 1,
"maxLength": 1000
}
},
"required": [
"code",
"message"
],
"additionalProperties": false
}
}
},
"required": [
"queue",
"status",
"item",
"draft",
"slot",
"preview_digest",
"blockers"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Example tool call
These examples use fictional values checked against the schemas. Replace the IDs with ones you are authorized to use, the media with ready assets and the dates with your confirmed publishing time. Check the account’s eligibility before submitting a write. This page sends no API requests.
{
"name": "sosoapi_preview_threads_content_queue",
"arguments": {
"workspace_id": "11111111-1111-4111-8111-111111111111",
"id": "44444444-4444-4444-8444-444444444444",
"expected_version": 1
}
}structuredContent
{
"queue": {
"id": "44444444-4444-4444-8444-444444444444",
"workspace_id": "11111111-1111-4111-8111-111111111111",
"social_account_id": "22222222-2222-4222-8222-222222222222",
"name": "Fictional weekly ideas",
"display_timezone": "UTC",
"weekly_slots": [
{
"weekday": 4,
"local_time": "09:00"
}
],
"paused": false,
"deleted": false,
"version": 1,
"created_at": "2099-01-14T09:00:00Z",
"updated_at": "2099-01-14T09:00:00Z",
"pending_items": [
{
"item_id": "80000000-0000-4000-8000-000000000003",
"draft_id": "70000000-0000-4000-8000-000000000003",
"draft_revision": 1,
"current_revision": 1,
"draft_state": "draft",
"caption_preview": "A fictional announcement."
}
],
"allocations": []
},
"status": "blocked",
"item": {
"item_id": "80000000-0000-4000-8000-000000000003",
"draft_id": "70000000-0000-4000-8000-000000000003",
"draft_revision": 1,
"current_revision": 1,
"draft_state": "draft",
"caption_preview": "A fictional announcement."
},
"draft": {
"id": "70000000-0000-4000-8000-000000000003",
"workspace_id": "11111111-1111-4111-8111-111111111111",
"revision": 1,
"state": "draft",
"content": {
"schemaVersion": 1,
"accountIds": [
"22222222-2222-4222-8222-222222222222"
],
"caption": "A fictional announcement.",
"hashtags": "",
"assetIds": [],
"threadsTextOnly": false,
"threadsOptions": {
"post_type": "TEXT"
},
"instagramMode": "REELS",
"youtubeTitle": "",
"youtubePrivacy": "private",
"youtubeSynthetic": false,
"youtubeCategoryId": "",
"youtubeShort": false,
"linkUrl": "",
"scheduledAt": "2099-01-15T09:00:00Z",
"displayTimezone": "UTC",
"publishNow": false,
"destinationOverrides": {},
"expiresAt": ""
},
"created_by": null,
"updated_by": null,
"created_at": "2099-01-14T09:00:00Z",
"updated_at": "2099-01-14T09:00:00Z",
"submission": null
},
"slot": null,
"preview_digest": null,
"blockers": [
{
"code": "capability_unknown",
"message": "Fictional account: publishing capability has not been verified. No allocation is authorized."
}
]
}