MCP-tool
Eén afbeelding via een URL publiceren
sosoapi_post_image_urlDien het volledige bericht met afbeeldings-URL één keer in, met lege media. De backend bereidt het voor en publiceert het ook nadat de clientverbinding is verbroken. Geeft het definitieve publicatieresultaat terug als dit binnen 35 seconden beschikbaar is, anders een blijvende bericht-ID; dien het nooit opnieuw in met een nieuwe sleutel. Vereist de machtigingen operate en publish. Velden voor lokale tijd en zomertijd horen samen. import_id dient alleen om oudere clients te hervatten.
Lezen als MarkdownProfielen en transporten
Profielen: core, full · Transporten: stdio, http
Kies core of full om te bepalen welke tools je client ziet; dit verandert geen machtigingen. Lokale bestandsupload vereist stdio en is niet beschikbaar via HTTP. Stel SOSOAPI_OUTPUT_SCHEMAS=1 in om uitvoerschema's bij detectie op te nemen. Tools geven met en zonder die instelling gestructureerde resultaten terug.
Machtigingen en neveneffecten
Annotaties helpen clients een tool te beschrijven. Elke aanroep controleert nog steeds gebruikersauthenticatie, rol, resourcetoegang en verleende bevoegdheden.
{
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": true
}- /studio-api/scheduled-posts/create-image-url: agent:publish · definitief publicatieresultaat
Invoervelden
Verplicht betekent verplicht binnen het bovenliggende object en de gekozen variant. Een verplicht onderliggend veld maakt een optioneel bovenliggend object niet verplicht. Onderstaande regels en veldnamen zijn uit het contract gekopieerd.
| Veld / variant | Type / verplicht | Beperkingen |
|---|---|---|
$ | objectVerplicht in bovenliggend object |
|
source_url | stringVerplicht in bovenliggend object |
|
post | objectVerplicht in bovenliggend object |
|
post.workspace_id | stringVerplicht in bovenliggend object |
|
post.project_id | string | nullOptioneel / item | — |
post.project_idanyOf 1 | stringOptioneel / item |
|
post.project_idanyOf 2 | nullOptioneel / item | — |
post.social_account_id | stringVerplicht in bovenliggend object |
|
post.caption | string | nullOptioneel / item | — |
post.captionanyOf 1 | stringOptioneel / item |
|
post.captionanyOf 2 | nullOptioneel / item | — |
post.hashtags | arrayOptioneel / item |
|
post.hashtags[] | stringOptioneel / item |
|
post.media | arrayOptioneel / item |
|
post.media[] | objectOptioneel / item |
|
post.media[].kind | stringVerplicht in bovenliggend object |
|
post.media[].url | stringVerplicht in bovenliggend object |
|
post.media[].cover_url | string | nullOptioneel / item | — |
post.media[].cover_urlanyOf 1 | stringOptioneel / item |
|
post.media[].cover_urlanyOf 2 | nullOptioneel / item | — |
post.media[].cover_asset_id | integer | nullOptioneel / item | — |
post.media[].cover_asset_idanyOf 1 | integerOptioneel / item |
|
post.media[].cover_asset_idanyOf 2 | nullOptioneel / item | — |
post.media[].asset_id | integer | nullOptioneel / item | — |
post.media[].asset_idanyOf 1 | integerOptioneel / item |
|
post.media[].asset_idanyOf 2 | nullOptioneel / item | — |
post.media[].mime_type | string | nullOptioneel / item | — |
post.media[].mime_typeanyOf 1 | stringOptioneel / item |
|
post.media[].mime_typeanyOf 2 | nullOptioneel / item | — |
post.link_url | string | nullOptioneel / item | — |
post.link_urlanyOf 1 | stringOptioneel / item |
|
post.link_urlanyOf 2 | nullOptioneel / item | — |
post.provider_payload | objectVerplicht in bovenliggend object |
|
post.provider_payload.platform | stringVerplicht in bovenliggend object |
|
post.provider_payload.publish_options | objectVerplicht in bovenliggend object |
|
post.provider_payload.publish_options.post_type | stringVerplicht in bovenliggend object |
|
post.provider_payload.publish_options.* | any JSON valueOptioneel / item | — |
post.scheduled_at | stringVerplicht in bovenliggend object |
|
post.display_timezone | stringOptioneel / item |
|
post.local_scheduled_at | stringOptioneel / item |
|
post.schedule_dst_disambiguation | stringOptioneel / item |
|
post.expires_at | string | nullOptioneel / item | — |
post.expires_atanyOf 1 | stringOptioneel / item |
|
post.expires_atanyOf 2 | nullOptioneel / item | — |
post.source_ref | object | nullOptioneel / item | — |
post.source_refanyOf 1 | objectOptioneel / item |
|
post.source_ref.*anyOf 1 | any JSON valueOptioneel / item | — |
post.source_refanyOf 2 | nullOptioneel / item | — |
post.automatic_retry_enabled | booleanOptioneel / item | — |
post.idempotency_key | stringVerplicht in bovenliggend object |
|
import_id | stringOptioneel / item | Gebruik alleen de import_id die voor dezelfde URL, werkruimte en gebruikersintentie is teruggegeven.
|
Volledig JSON Schema
{
"type": "object",
"properties": {
"source_url": {
"type": "string",
"maxLength": 2048,
"format": "uri"
},
"post": {
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid"
},
"project_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
]
},
"social_account_id": {
"type": "string",
"format": "uuid"
},
"caption": {
"anyOf": [
{
"type": "string",
"maxLength": 5000
},
{
"type": "null"
}
]
},
"hashtags": {
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"maxLength": 100
}
},
"media": {
"maxItems": 0,
"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"
}
]
}
},
"required": [
"kind",
"url"
],
"additionalProperties": false
}
},
"link_url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"provider_payload": {
"type": "object",
"properties": {
"platform": {
"type": "string",
"enum": [
"threads",
"instagram",
"facebook"
]
},
"publish_options": {
"type": "object",
"properties": {
"post_type": {
"type": "string",
"enum": [
"IMAGE",
"STORY_IMAGE"
]
}
},
"required": [
"post_type"
],
"additionalProperties": {}
}
},
"required": [
"platform",
"publish_options"
],
"additionalProperties": false
},
"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)))$"
},
"display_timezone": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"local_scheduled_at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
},
"schedule_dst_disambiguation": {
"type": "string",
"enum": [
"exact",
"earlier",
"later"
]
},
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
{
"type": "null"
}
]
},
"source_ref": {
"anyOf": [
{
"type": "object",
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"automatic_retry_enabled": {
"type": "boolean"
},
"idempotency_key": {
"type": "string",
"minLength": 8,
"maxLength": 160
}
},
"required": [
"workspace_id",
"social_account_id",
"provider_payload",
"scheduled_at",
"idempotency_key"
],
"additionalProperties": false
},
"import_id": {
"description": "Use only the import_id returned for this same URL, Workspace and user intent.",
"type": "string",
"format": "uuid"
}
},
"required": [
"source_url",
"post"
],
"additionalProperties": false
}Gestructureerde uitvoer
Dit schema beschrijft structuredContent in een geslaagd toolresultaat. Het MCP-antwoord bevat ook content en kan isError instellen wanneer een aanroep mislukt. Lees bij publiceren het definitieve berichtresultaat; beschouw een geaccepteerd verzoek of tekstantwoord niet als bevestiging. De gekoppelde API-bewerking beschrijft machtigingen en regels voor opnieuw proberen.
Verplicht betekent verplicht binnen het bovenliggende object en de gekozen variant. Een verplicht onderliggend veld maakt een optioneel bovenliggend object niet verplicht. Onderstaande regels en veldnamen zijn uit het contract gekopieerd.
| Veld / variant | Type / verplicht | Beperkingen |
|---|---|---|
$ | objectVerplicht in bovenliggend object |
|
stage | stringVerplicht in bovenliggend object |
|
import_id | stringVerplicht in bovenliggend object |
|
completion | stringOptioneel / item |
|
scheduled_post | object | nullVerplicht in bovenliggend object | — |
scheduled_postanyOf 1 | objectVerplicht in bovenliggend object |
|
scheduled_post.postanyOf 1 | objectVerplicht in bovenliggend object |
|
scheduled_post.post.idanyOf 1 | stringVerplicht in bovenliggend object |
|
scheduled_post.post.workspace_idanyOf 1 | stringVerplicht in bovenliggend object |
|
scheduled_post.post.social_account_idanyOf 1 | string | nullVerplicht in bovenliggend object | — |
scheduled_post.post.social_account_idanyOf 1 / anyOf 1 | stringVerplicht in bovenliggend object |
|
scheduled_post.post.social_account_idanyOf 1 / anyOf 2 | nullVerplicht in bovenliggend object | — |
scheduled_post.post.platformanyOf 1 | stringVerplicht in bovenliggend object |
|
scheduled_post.post.destinationanyOf 1 | objectVerplicht in bovenliggend object |
|
scheduled_post.post.destination.social_account_idanyOf 1 | string | nullVerplicht in bovenliggend object | — |
scheduled_post.post.destination.social_account_idanyOf 1 / anyOf 1 | stringVerplicht in bovenliggend object |
|
scheduled_post.post.destination.social_account_idanyOf 1 / anyOf 2 | nullVerplicht in bovenliggend object | — |
scheduled_post.post.destination.platformanyOf 1 | stringVerplicht in bovenliggend object |
|
scheduled_post.post.destination.platform_user_idanyOf 1 | string | nullVerplicht in bovenliggend object | — |
scheduled_post.post.destination.platform_user_idanyOf 1 / anyOf 1 | stringVerplicht in bovenliggend object | — |
scheduled_post.post.destination.platform_user_idanyOf 1 / anyOf 2 | nullVerplicht in bovenliggend object | — |
scheduled_post.post.destination.account_labelanyOf 1 | string | nullVerplicht in bovenliggend object | — |
scheduled_post.post.destination.account_labelanyOf 1 / anyOf 1 | stringVerplicht in bovenliggend object | — |
scheduled_post.post.destination.account_labelanyOf 1 / anyOf 2 | nullVerplicht in bovenliggend object | — |
scheduled_post.post.captionanyOf 1 | string | nullVerplicht in bovenliggend object | — |
scheduled_post.post.captionanyOf 1 / anyOf 1 | stringVerplicht in bovenliggend object | — |
scheduled_post.post.captionanyOf 1 / anyOf 2 | nullVerplicht in bovenliggend object | — |
scheduled_post.post.hashtagsanyOf 1 | arrayVerplicht in bovenliggend object | — |
scheduled_post.post.hashtags[]anyOf 1 | stringOptioneel / item | — |
scheduled_post.post.mediaanyOf 1 | arrayVerplicht in bovenliggend object | — |
scheduled_post.post.media[]anyOf 1 | objectOptioneel / item |
|
scheduled_post.post.media[].kindanyOf 1 | stringVerplicht in bovenliggend object |
|
scheduled_post.post.media[].urlanyOf 1 | stringVerplicht in bovenliggend object |
|
scheduled_post.post.media[].cover_urlanyOf 1 | string | nullOptioneel / item | — |
scheduled_post.post.media[].cover_urlanyOf 1 / anyOf 1 | stringOptioneel / item |
|
scheduled_post.post.media[].cover_urlanyOf 1 / anyOf 2 | nullOptioneel / item | — |
scheduled_post.post.media[].cover_asset_idanyOf 1 | integer | nullOptioneel / item | — |
scheduled_post.post.media[].cover_asset_idanyOf 1 / anyOf 1 | integerOptioneel / item |
|
scheduled_post.post.media[].cover_asset_idanyOf 1 / anyOf 2 | nullOptioneel / item | — |
scheduled_post.post.media[].asset_idanyOf 1 | integer | nullOptioneel / item | — |
scheduled_post.post.media[].asset_idanyOf 1 / anyOf 1 | integerOptioneel / item |
|
scheduled_post.post.media[].asset_idanyOf 1 / anyOf 2 | nullOptioneel / item | — |
scheduled_post.post.media[].mime_typeanyOf 1 | string | nullOptioneel / item | — |
scheduled_post.post.media[].mime_typeanyOf 1 / anyOf 1 | stringOptioneel / item |
|
scheduled_post.post.media[].mime_typeanyOf 1 / anyOf 2 | nullOptioneel / item | — |
scheduled_post.post.media[].preview_urlanyOf 1 | string | nullOptioneel / item | Tijdelijke toegestane lees-URL; behoud url als blijvende media-identiteit van de Scheduled Post. — |
scheduled_post.post.media[].preview_urlanyOf 1 / anyOf 1 | stringOptioneel / item |
|
scheduled_post.post.media[].preview_urlanyOf 1 / anyOf 2 | nullOptioneel / item | — |
scheduled_post.post.media[].cover_preview_urlanyOf 1 | string | nullOptioneel / item | Tijdelijke toegestane lees-URL voor omslag; behoud cover_url als blijvende media-identiteit. — |
scheduled_post.post.media[].cover_preview_urlanyOf 1 / anyOf 1 | stringOptioneel / item |
|
scheduled_post.post.media[].cover_preview_urlanyOf 1 / anyOf 2 | nullOptioneel / item | — |
scheduled_post.post.media[].preview_expires_atanyOf 1 | string | nullOptioneel / item | — |
scheduled_post.post.media[].preview_expires_atanyOf 1 / anyOf 1 | stringOptioneel / item |
|
scheduled_post.post.media[].preview_expires_atanyOf 1 / anyOf 2 | nullOptioneel / item | — |
scheduled_post.post.link_urlanyOf 1 | string | nullOptioneel / item | — |
scheduled_post.post.link_urlanyOf 1 / anyOf 1 | stringOptioneel / item |
|
scheduled_post.post.link_urlanyOf 1 / anyOf 2 | nullOptioneel / item | — |
scheduled_post.post.publish_optionsanyOf 1 | objectVerplicht in bovenliggend object |
|
scheduled_post.post.publish_options.post_typeanyOf 1 | stringOptioneel / item |
|
scheduled_post.post.publish_options.location_idanyOf 1 | stringOptioneel / item |
|
scheduled_post.post.publish_options.share_to_feedanyOf 1 | booleanOptioneel / item | — |
scheduled_post.post.publish_options.collaboratorsanyOf 1 | arrayOptioneel / item |
|
scheduled_post.post.publish_options.collaborators[]anyOf 1 | stringOptioneel / item |
|
scheduled_post.post.publish_options.first_commentanyOf 1 | stringOptioneel / item |
|
scheduled_post.post.publish_options.topic_taganyOf 1 | stringOptioneel / item |
|
scheduled_post.post.publish_options.thumb_offset_msanyOf 1 | integerOptioneel / item |
|
scheduled_post.post.publish_options.titleanyOf 1 | stringOptioneel / item |
|
scheduled_post.post.publish_options.youtube_privacy_statusanyOf 1 | stringOptioneel / item |
|
scheduled_post.post.publish_options.youtube_category_idanyOf 1 | stringOptioneel / item |
|
scheduled_post.post.publish_options.youtube_contains_synthetic_mediaanyOf 1 | booleanOptioneel / item | — |
scheduled_post.post.publish_options.descriptionanyOf 1 | stringOptioneel / item |
|
scheduled_post.post.publish_options.category_idanyOf 1 | stringOptioneel / item |
|
scheduled_post.post.publish_options.privacy_statusanyOf 1 | stringOptioneel / item |
|
scheduled_post.post.publish_options.cancellation_modeanyOf 1 | stringOptioneel / item |
|
scheduled_post.post.publish_options.tagsanyOf 1 | arrayOptioneel / item | — |
scheduled_post.post.publish_options.tags[]anyOf 1 | stringOptioneel / item | — |
scheduled_post.post.publish_options.default_languageanyOf 1 | stringOptioneel / item | — |
scheduled_post.post.publish_options.localizationsanyOf 1 | objectOptioneel / item |
|
scheduled_post.post.publish_options.localizations.*anyOf 1 | any JSON valueOptioneel / item | — |
scheduled_post.post.publish_options.licenseanyOf 1 | stringOptioneel / item |
|
scheduled_post.post.publish_options.embeddableanyOf 1 | booleanOptioneel / item | — |
scheduled_post.post.publish_options.public_stats_viewableanyOf 1 | booleanOptioneel / item | — |
scheduled_post.post.publish_options.self_declared_made_for_kidsanyOf 1 | booleanOptioneel / item | — |
scheduled_post.post.publish_options.contains_synthetic_mediaanyOf 1 | booleanOptioneel / item | — |
scheduled_post.post.publish_options.has_paid_product_placementanyOf 1 | booleanOptioneel / item | — |
scheduled_post.post.publish_options.recording_dateanyOf 1 | stringOptioneel / item | — |
scheduled_post.post.publish_options.notify_subscribersanyOf 1 | booleanOptioneel / item | — |
scheduled_post.post.publish_options.thumbnail_asset_idanyOf 1 | integerOptioneel / item |
|
scheduled_post.post.publish_options.surface_expectationanyOf 1 | stringOptioneel / item |
|
scheduled_post.post.publish_options.brand_partneranyOf 1 | objectOptioneel / item |
|
scheduled_post.post.publish_options.brand_partner.*anyOf 1 | any JSON valueOptioneel / item | — |
scheduled_post.post.publish_options.cover_asset_idanyOf 1 | integerOptioneel / item |
|
scheduled_post.post.publish_options.audio_nameanyOf 1 | stringOptioneel / item | — |
scheduled_post.post.publish_options.trial_paramsanyOf 1 | objectOptioneel / item |
|
scheduled_post.post.publish_options.trial_params.*anyOf 1 | any JSON valueOptioneel / item | — |
scheduled_post.post.publish_options.is_ai_generatedanyOf 1 | booleanOptioneel / item | — |
scheduled_post.post.publish_options.branded_content_sponsor_idsanyOf 1 | arrayOptioneel / item | — |
scheduled_post.post.publish_options.branded_content_sponsor_ids[]anyOf 1 | stringOptioneel / item | — |
scheduled_post.post.publish_options.is_paid_partnershipanyOf 1 | booleanOptioneel / item | — |
scheduled_post.post.publish_options.media_optionsanyOf 1 | arrayOptioneel / item | — |
scheduled_post.post.publish_options.media_options[]anyOf 1 | objectOptioneel / item |
|
scheduled_post.post.publish_options.media_options[].*anyOf 1 | any JSON valueOptioneel / item | — |
scheduled_post.post.publish_options.reply_to_idanyOf 1 | stringOptioneel / item | — |
scheduled_post.post.publish_options.quote_post_idanyOf 1 | stringOptioneel / item | — |
scheduled_post.post.publish_options.repost_target_idanyOf 1 | stringOptioneel / item | — |
scheduled_post.post.publish_options.reply_controlanyOf 1 | stringOptioneel / item | — |
scheduled_post.post.publish_options.enable_reply_approvalsanyOf 1 | booleanOptioneel / item | — |
scheduled_post.post.publish_options.link_attachmentanyOf 1 | stringOptioneel / item |
|
scheduled_post.post.publish_options.poll_attachmentanyOf 1 | objectOptioneel / item |
|
scheduled_post.post.publish_options.poll_attachment.*anyOf 1 | any JSON valueOptioneel / item | — |
scheduled_post.post.publish_options.gif_attachmentanyOf 1 | objectOptioneel / item |
|
scheduled_post.post.publish_options.gif_attachment.*anyOf 1 | any JSON valueOptioneel / item | — |
scheduled_post.post.publish_options.text_attachmentanyOf 1 | objectOptioneel / item |
|
scheduled_post.post.publish_options.text_attachment.*anyOf 1 | any JSON valueOptioneel / item | — |
scheduled_post.post.publish_options.text_entitiesanyOf 1 | arrayOptioneel / item | — |
scheduled_post.post.publish_options.text_entities[]anyOf 1 | objectOptioneel / item |
|
scheduled_post.post.publish_options.text_entities[].*anyOf 1 | any JSON valueOptioneel / item | — |
scheduled_post.post.publish_options.is_spoiler_mediaanyOf 1 | booleanOptioneel / item | — |
scheduled_post.post.publish_options.is_ghost_postanyOf 1 | booleanOptioneel / item | — |
scheduled_post.post.publish_options.allowlisted_country_codesanyOf 1 | arrayOptioneel / item | — |
scheduled_post.post.publish_options.allowlisted_country_codes[]anyOf 1 | stringOptioneel / item | — |
scheduled_post.post.publish_options.crossreshare_to_iganyOf 1 | booleanOptioneel / item | — |
scheduled_post.post.publish_options.crossreshare_to_ig_dark_modeanyOf 1 | booleanOptioneel / item | — |
scheduled_post.post.publish_options.auto_publish_textanyOf 1 | booleanOptioneel / item | — |
scheduled_post.post.publish_options.publication_modeanyOf 1 | stringOptioneel / item |
|
scheduled_post.post.publish_options.backdated_timeanyOf 1 | numberOptioneel / item | — |
scheduled_post.post.publish_options.backdated_time_granularityanyOf 1 | stringOptioneel / item |
|
scheduled_post.post.publish_options.placeanyOf 1 | stringOptioneel / item | — |
scheduled_post.post.publish_options.feed_targetinganyOf 1 | objectOptioneel / item |
|
scheduled_post.post.publish_options.feed_targeting.*anyOf 1 | any JSON valueOptioneel / item | — |
scheduled_post.post.publish_options.targetinganyOf 1 | objectOptioneel / item |
|
scheduled_post.post.publish_options.targeting.*anyOf 1 | any JSON valueOptioneel / item | — |
scheduled_post.post.publish_options.child_attachmentsanyOf 1 | arrayOptioneel / item | — |
scheduled_post.post.publish_options.child_attachments[]anyOf 1 | objectOptioneel / item |
|
scheduled_post.post.publish_options.child_attachments[].*anyOf 1 | any JSON valueOptioneel / item | — |
scheduled_post.post.publish_options.multi_share_end_cardanyOf 1 | booleanOptioneel / item | — |
scheduled_post.post.publish_options.multi_share_optimizedanyOf 1 | booleanOptioneel / item | — |
scheduled_post.post.publish_options.unpublished_content_typeanyOf 1 | stringOptioneel / item | — |
scheduled_post.post.publish_options.no_storyanyOf 1 | booleanOptioneel / item | — |
scheduled_post.post.publish_options.crossposted_video_idanyOf 1 | stringOptioneel / item | — |
scheduled_post.post.publish_options.sphericalanyOf 1 | booleanOptioneel / item | — |
scheduled_post.post.scheduled_atanyOf 1 | stringVerplicht in bovenliggend object | — |
scheduled_post.post.display_timezoneanyOf 1 | stringVerplicht in bovenliggend object |
|
scheduled_post.post.local_scheduled_atanyOf 1 | string | nullOptioneel / item | — |
scheduled_post.post.local_scheduled_atanyOf 1 / anyOf 1 | stringOptioneel / item |
|
scheduled_post.post.local_scheduled_atanyOf 1 / anyOf 2 | nullOptioneel / item | — |
scheduled_post.post.schedule_timezoneanyOf 1 | string | nullOptioneel / item | — |
scheduled_post.post.schedule_timezoneanyOf 1 / anyOf 1 | stringOptioneel / item |
|
scheduled_post.post.schedule_timezoneanyOf 1 / anyOf 2 | nullOptioneel / item | — |
scheduled_post.post.schedule_dst_disambiguationanyOf 1 | string | nullOptioneel / item | — |
scheduled_post.post.schedule_dst_disambiguationanyOf 1 / anyOf 1 | stringOptioneel / item |
|
scheduled_post.post.schedule_dst_disambiguationanyOf 1 / anyOf 2 | nullOptioneel / item | — |
scheduled_post.post.schedule_intent_stateanyOf 1 | stringOptioneel / item |
|
scheduled_post.post.expires_atanyOf 1 | string | nullVerplicht in bovenliggend object | — |
scheduled_post.post.expires_atanyOf 1 / anyOf 1 | stringVerplicht in bovenliggend object | — |
scheduled_post.post.expires_atanyOf 1 / anyOf 2 | nullVerplicht in bovenliggend object | — |
scheduled_post.post.statusanyOf 1 | stringVerplicht in bovenliggend object |
|
scheduled_post.post.versionanyOf 1 | integerVerplicht in bovenliggend object |
|
scheduled_post.post.automatic_retry_enabledanyOf 1 | booleanVerplicht in bovenliggend object | — |
scheduled_post.post.delete_requested_atanyOf 1 | string | nullVerplicht in bovenliggend object | — |
scheduled_post.post.delete_requested_atanyOf 1 / anyOf 1 | stringVerplicht in bovenliggend object | — |
scheduled_post.post.delete_requested_atanyOf 1 / anyOf 2 | nullVerplicht in bovenliggend object | — |
scheduled_post.post.published_atanyOf 1 | string | nullVerplicht in bovenliggend object | — |
scheduled_post.post.published_atanyOf 1 / anyOf 1 | stringVerplicht in bovenliggend object | — |
scheduled_post.post.published_atanyOf 1 / anyOf 2 | nullVerplicht in bovenliggend object | — |
scheduled_post.post.deleted_atanyOf 1 | string | nullVerplicht in bovenliggend object | — |
scheduled_post.post.deleted_atanyOf 1 / anyOf 1 | stringVerplicht in bovenliggend object | — |
scheduled_post.post.deleted_atanyOf 1 / anyOf 2 | nullVerplicht in bovenliggend object | — |
scheduled_post.post.provider_post_idanyOf 1 | string | nullVerplicht in bovenliggend object | — |
scheduled_post.post.provider_post_idanyOf 1 / anyOf 1 | stringVerplicht in bovenliggend object | — |
scheduled_post.post.provider_post_idanyOf 1 / anyOf 2 | nullVerplicht in bovenliggend object | — |
scheduled_post.post.permalinkanyOf 1 | string | nullVerplicht in bovenliggend object | — |
scheduled_post.post.permalinkanyOf 1 / anyOf 1 | stringVerplicht in bovenliggend object |
|
scheduled_post.post.permalinkanyOf 1 / anyOf 2 | nullVerplicht in bovenliggend object | — |
scheduled_post.post.created_atanyOf 1 | stringVerplicht in bovenliggend object | — |
scheduled_post.post.updated_atanyOf 1 | stringVerplicht in bovenliggend object | — |
scheduled_post.post.project_idanyOf 1 | string | nullVerplicht in bovenliggend object | — |
scheduled_post.post.project_idanyOf 1 / anyOf 1 | stringVerplicht in bovenliggend object |
|
scheduled_post.post.project_idanyOf 1 / anyOf 2 | nullVerplicht in bovenliggend object | — |
scheduled_post.post.batch_idanyOf 1 | string | nullVerplicht in bovenliggend object | — |
scheduled_post.post.batch_idanyOf 1 / anyOf 1 | stringVerplicht in bovenliggend object |
|
scheduled_post.post.batch_idanyOf 1 / anyOf 2 | nullVerplicht in bovenliggend object | — |
scheduled_post.post.source_refanyOf 1 | object | nullVerplicht in bovenliggend object | — |
scheduled_post.post.source_refanyOf 1 / anyOf 1 | objectVerplicht in bovenliggend object |
|
scheduled_post.post.source_ref.*anyOf 1 / anyOf 1 | any JSON valueOptioneel / item | — |
scheduled_post.post.source_refanyOf 1 / anyOf 2 | nullVerplicht in bovenliggend object | — |
scheduled_post.dedupedanyOf 1 | booleanVerplicht in bovenliggend object | — |
scheduled_postanyOf 2 | nullVerplicht in bovenliggend object | — |
retry_after_seconds | integerOptioneel / item |
|
resume_arguments | objectOptioneel / item |
|
resume_arguments.* | any JSON valueOptioneel / item | — |
Volledig JSON Schema
{
"type": "object",
"properties": {
"stage": {
"type": "string",
"enum": [
"media_pending",
"media_failed",
"scheduled"
]
},
"import_id": {
"type": "string",
"format": "uuid"
},
"completion": {
"type": "string",
"enum": [
"pending",
"terminal"
]
},
"scheduled_post": {
"anyOf": [
{
"type": "object",
"properties": {
"post": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"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
},
"deduped": {
"type": "boolean"
}
},
"required": [
"post",
"deduped"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"retry_after_seconds": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"resume_arguments": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"stage",
"import_id",
"scheduled_post"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Voorbeeld van een toolaanroep
Deze voorbeelden gebruiken fictieve waarden die tegen de schema's zijn gecontroleerd. Vervang IDs door toegestane IDs, media door gereedstaande bestanden en datums door je bevestigde publicatietijd. Controleer accountgeschiktheid vóór een schrijfhandeling. Deze pagina verstuurt geen API-verzoeken.
{
"name": "sosoapi_post_image_url",
"arguments": {
"source_url": "https://example.com/media.png",
"post": {
"workspace_id": "11111111-1111-4111-8111-111111111111",
"social_account_id": "11111111-1111-4111-8111-111111111111",
"provider_payload": {
"platform": "threads",
"publish_options": {
"post_type": "IMAGE"
}
},
"scheduled_at": "2099-01-15T09:00:00Z",
"idempotency_key": "example-intent-0001",
"media": []
}
}
}structuredContent
{
"stage": "media_pending",
"import_id": "11111111-1111-4111-8111-111111111111",
"scheduled_post": null
}