Inplannen en publiceren
Geordende X-thread ophalen
Lees een bestaande X-thread, de canonieke Post-uitkomsten, toegestane groepsacties en volledige expected_versions. Deze bewerking plant of publiceert niets.
POST /studio-api/x-post-threads/getContract beoordeeld: · sha256:304f090f3c014931
Overzicht
Lees een bestaande X-thread, de canonieke Post-uitkomsten, toegestane groepsacties en volledige expected_versions. Deze bewerking plant of publiceert niets.
Een geslaagd HTTP-antwoord kan acceptatie betekenen in plaats van voltooiing. Bewaar bij achtergrondwerk de teruggegeven ID en controleer dezelfde bewerking totdat die klaar is. Een ingepland of geaccepteerd bericht is pas gepubliceerd na platformbevestiging; een client-time-out bepaalt het resultaat niet.
Authenticatie en machtigingen
Een token kan alleen rechten van de eigenaar gebruiken. Elk verzoek controleert werkruimtelidmaatschap, resource-eigendom, geselecteerde werkruimten en verleende bevoegdheden. De profielen core en full bepalen welke tools zichtbaar zijn; ze verlenen geen toegang.
Verzoekvelden
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 |
|
workspace_id | stringVerplicht in bovenliggend object |
|
id | stringVerplicht in bovenliggend object |
|
Volledig JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"required": [
"workspace_id",
"id"
],
"additionalProperties": false
}Antwoord en voltooiing
HTTP-statuscodes bij succes: 200. Wanneer de bewerking voltooid is: canonical per-Post terminal publication outcomes; thread acceptance is not publication.
Een geslaagd HTTP-antwoord kan acceptatie betekenen in plaats van voltooiing. Bewaar bij achtergrondwerk de teruggegeven ID en controleer dezelfde bewerking totdat die klaar is. Een ingepland of geaccepteerd bericht is pas gepubliceerd na platformbevestiging; een client-time-out bepaalt het resultaat niet.
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 | — |
thread | objectVerplicht in bovenliggend object | — |
thread.id | stringVerplicht in bovenliggend object |
|
thread.workspace_id | stringVerplicht in bovenliggend object |
|
thread.social_account_id | stringVerplicht in bovenliggend object |
|
thread.idempotency_key | stringVerplicht in bovenliggend object |
|
thread.item_count | integerVerplicht in bovenliggend object |
|
thread.created_at | stringVerplicht in bovenliggend object | — |
thread.items | arrayVerplicht in bovenliggend object |
|
thread.items[] | objectOptioneel / item | — |
thread.items[].item_id | stringVerplicht in bovenliggend object |
|
thread.items[].ordinal | integerVerplicht in bovenliggend object |
|
thread.items[].predecessor_post_id | string | nullVerplicht in bovenliggend object | — |
thread.items[].predecessor_post_idanyOf 1 | stringVerplicht in bovenliggend object |
|
thread.items[].predecessor_post_idanyOf 2 | nullVerplicht in bovenliggend object | — |
thread.items[].post | objectVerplicht in bovenliggend object | — |
thread.items[].post.id | stringVerplicht in bovenliggend object |
|
thread.items[].post.workspace_id | stringVerplicht in bovenliggend object |
|
thread.items[].post.social_account_id | string | nullVerplicht in bovenliggend object | — |
thread.items[].post.social_account_idanyOf 1 | stringVerplicht in bovenliggend object |
|
thread.items[].post.social_account_idanyOf 2 | nullVerplicht in bovenliggend object | — |
thread.items[].post.platform | stringVerplicht in bovenliggend object |
|
thread.items[].post.destination | objectVerplicht in bovenliggend object | — |
thread.items[].post.destination.social_account_id | string | nullVerplicht in bovenliggend object | — |
thread.items[].post.destination.social_account_idanyOf 1 | stringVerplicht in bovenliggend object |
|
thread.items[].post.destination.social_account_idanyOf 2 | nullVerplicht in bovenliggend object | — |
thread.items[].post.destination.platform | stringVerplicht in bovenliggend object |
|
thread.items[].post.destination.platform_user_id | string | nullVerplicht in bovenliggend object | — |
thread.items[].post.destination.account_label | string | nullVerplicht in bovenliggend object | — |
thread.items[].post.caption | string | nullVerplicht in bovenliggend object | — |
thread.items[].post.hashtags | arrayVerplicht in bovenliggend object | — |
thread.items[].post.hashtags[] | stringOptioneel / item | — |
thread.items[].post.media | arrayVerplicht in bovenliggend object | — |
thread.items[].post.media[] | objectOptioneel / item | — |
thread.items[].post.media[].kind | stringVerplicht in bovenliggend object |
|
thread.items[].post.media[].url | stringVerplicht in bovenliggend object |
|
thread.items[].post.media[].cover_url | string | nullOptioneel / item | — |
thread.items[].post.media[].cover_urlanyOf 1 | stringOptioneel / item |
|
thread.items[].post.media[].cover_urlanyOf 2 | nullOptioneel / item | — |
thread.items[].post.media[].cover_asset_id | integer | nullOptioneel / item | — |
thread.items[].post.media[].cover_asset_idanyOf 1 | integerOptioneel / item |
|
thread.items[].post.media[].cover_asset_idanyOf 2 | nullOptioneel / item | — |
thread.items[].post.media[].asset_id | integer | nullOptioneel / item | — |
thread.items[].post.media[].asset_idanyOf 1 | integerOptioneel / item |
|
thread.items[].post.media[].asset_idanyOf 2 | nullOptioneel / item | — |
thread.items[].post.media[].mime_type | string | nullOptioneel / item | — |
thread.items[].post.media[].mime_typeanyOf 1 | stringOptioneel / item |
|
thread.items[].post.media[].mime_typeanyOf 2 | nullOptioneel / item | — |
thread.items[].post.media[].preview_url | string | nullOptioneel / item | Tijdelijke toegestane lees-URL; behoud url als blijvende media-identiteit van de Scheduled Post. — |
thread.items[].post.media[].preview_urlanyOf 1 | stringOptioneel / item |
|
thread.items[].post.media[].preview_urlanyOf 2 | nullOptioneel / item | — |
thread.items[].post.media[].cover_preview_url | string | nullOptioneel / item | Tijdelijke toegestane lees-URL voor omslag; behoud cover_url als blijvende media-identiteit. — |
thread.items[].post.media[].cover_preview_urlanyOf 1 | stringOptioneel / item |
|
thread.items[].post.media[].cover_preview_urlanyOf 2 | nullOptioneel / item | — |
thread.items[].post.media[].preview_expires_at | string | nullOptioneel / item | — |
thread.items[].post.media[].preview_expires_atanyOf 1 | stringOptioneel / item |
|
thread.items[].post.media[].preview_expires_atanyOf 2 | nullOptioneel / item | — |
thread.items[].post.link_url | string | nullOptioneel / item | — |
thread.items[].post.link_urlanyOf 1 | stringOptioneel / item |
|
thread.items[].post.link_urlanyOf 2 | nullOptioneel / item | — |
thread.items[].post.publish_options | objectVerplicht in bovenliggend object | — |
thread.items[].post.publish_options.post_type | stringOptioneel / item |
|
thread.items[].post.publish_options.location_id | stringOptioneel / item |
|
thread.items[].post.publish_options.share_to_feed | booleanOptioneel / item | — |
thread.items[].post.publish_options.collaborators | arrayOptioneel / item |
|
thread.items[].post.publish_options.collaborators[] | stringOptioneel / item |
|
thread.items[].post.publish_options.first_comment | stringOptioneel / item |
|
thread.items[].post.publish_options.topic_tag | stringOptioneel / item |
|
thread.items[].post.publish_options.thumb_offset_ms | integerOptioneel / item |
|
thread.items[].post.publish_options.title | stringOptioneel / item |
|
thread.items[].post.publish_options.youtube_privacy_status | stringOptioneel / item |
|
thread.items[].post.publish_options.youtube_category_id | stringOptioneel / item |
|
thread.items[].post.publish_options.youtube_contains_synthetic_media | booleanOptioneel / item | — |
thread.items[].post.publish_options.description | stringOptioneel / item |
|
thread.items[].post.publish_options.category_id | stringOptioneel / item |
|
thread.items[].post.publish_options.privacy_status | stringOptioneel / item |
|
thread.items[].post.publish_options.cancellation_mode | stringOptioneel / item |
|
thread.items[].post.publish_options.tags | arrayOptioneel / item | — |
thread.items[].post.publish_options.tags[] | stringOptioneel / item | — |
thread.items[].post.publish_options.default_language | stringOptioneel / item | — |
thread.items[].post.publish_options.localizations | objectOptioneel / item |
|
thread.items[].post.publish_options.localizations.* | any JSON valueOptioneel / item | — |
thread.items[].post.publish_options.license | stringOptioneel / item |
|
thread.items[].post.publish_options.embeddable | booleanOptioneel / item | — |
thread.items[].post.publish_options.public_stats_viewable | booleanOptioneel / item | — |
thread.items[].post.publish_options.self_declared_made_for_kids | booleanOptioneel / item | — |
thread.items[].post.publish_options.contains_synthetic_media | booleanOptioneel / item | — |
thread.items[].post.publish_options.has_paid_product_placement | booleanOptioneel / item | — |
thread.items[].post.publish_options.recording_date | stringOptioneel / item | — |
thread.items[].post.publish_options.notify_subscribers | booleanOptioneel / item | — |
thread.items[].post.publish_options.thumbnail_asset_id | integerOptioneel / item |
|
thread.items[].post.publish_options.surface_expectation | stringOptioneel / item |
|
thread.items[].post.publish_options.brand_partner | objectOptioneel / item |
|
thread.items[].post.publish_options.brand_partner.* | any JSON valueOptioneel / item | — |
thread.items[].post.publish_options.cover_asset_id | integerOptioneel / item |
|
thread.items[].post.publish_options.audio_name | stringOptioneel / item | — |
thread.items[].post.publish_options.trial_params | objectOptioneel / item |
|
thread.items[].post.publish_options.trial_params.* | any JSON valueOptioneel / item | — |
thread.items[].post.publish_options.is_ai_generated | booleanOptioneel / item | — |
thread.items[].post.publish_options.branded_content_sponsor_ids | arrayOptioneel / item | — |
thread.items[].post.publish_options.branded_content_sponsor_ids[] | stringOptioneel / item | — |
thread.items[].post.publish_options.is_paid_partnership | booleanOptioneel / item | — |
thread.items[].post.publish_options.media_options | arrayOptioneel / item | — |
thread.items[].post.publish_options.media_options[] | objectOptioneel / item |
|
thread.items[].post.publish_options.media_options[].* | any JSON valueOptioneel / item | — |
thread.items[].post.publish_options.reply_to_id | stringOptioneel / item | — |
thread.items[].post.publish_options.quote_post_id | stringOptioneel / item | — |
thread.items[].post.publish_options.repost_target_id | stringOptioneel / item | — |
thread.items[].post.publish_options.reply_control | stringOptioneel / item | — |
thread.items[].post.publish_options.enable_reply_approvals | booleanOptioneel / item | — |
thread.items[].post.publish_options.link_attachment | stringOptioneel / item |
|
thread.items[].post.publish_options.poll_attachment | objectOptioneel / item |
|
thread.items[].post.publish_options.poll_attachment.* | any JSON valueOptioneel / item | — |
thread.items[].post.publish_options.gif_attachment | objectOptioneel / item |
|
thread.items[].post.publish_options.gif_attachment.* | any JSON valueOptioneel / item | — |
thread.items[].post.publish_options.text_attachment | objectOptioneel / item |
|
thread.items[].post.publish_options.text_attachment.* | any JSON valueOptioneel / item | — |
thread.items[].post.publish_options.text_entities | arrayOptioneel / item | — |
thread.items[].post.publish_options.text_entities[] | objectOptioneel / item |
|
thread.items[].post.publish_options.text_entities[].* | any JSON valueOptioneel / item | — |
thread.items[].post.publish_options.is_spoiler_media | booleanOptioneel / item | — |
thread.items[].post.publish_options.is_ghost_post | booleanOptioneel / item | — |
thread.items[].post.publish_options.allowlisted_country_codes | arrayOptioneel / item | — |
thread.items[].post.publish_options.allowlisted_country_codes[] | stringOptioneel / item | — |
thread.items[].post.publish_options.crossreshare_to_ig | booleanOptioneel / item | — |
thread.items[].post.publish_options.crossreshare_to_ig_dark_mode | booleanOptioneel / item | — |
thread.items[].post.publish_options.auto_publish_text | booleanOptioneel / item | — |
thread.items[].post.publish_options.publication_mode | stringOptioneel / item |
|
thread.items[].post.publish_options.backdated_time | numberOptioneel / item | — |
thread.items[].post.publish_options.backdated_time_granularity | stringOptioneel / item |
|
thread.items[].post.publish_options.place | stringOptioneel / item | — |
thread.items[].post.publish_options.feed_targeting | objectOptioneel / item |
|
thread.items[].post.publish_options.feed_targeting.* | any JSON valueOptioneel / item | — |
thread.items[].post.publish_options.targeting | objectOptioneel / item |
|
thread.items[].post.publish_options.targeting.* | any JSON valueOptioneel / item | — |
thread.items[].post.publish_options.child_attachments | arrayOptioneel / item | — |
thread.items[].post.publish_options.child_attachments[] | objectOptioneel / item |
|
thread.items[].post.publish_options.child_attachments[].* | any JSON valueOptioneel / item | — |
thread.items[].post.publish_options.multi_share_end_card | booleanOptioneel / item | — |
thread.items[].post.publish_options.multi_share_optimized | booleanOptioneel / item | — |
thread.items[].post.publish_options.unpublished_content_type | stringOptioneel / item | — |
thread.items[].post.publish_options.no_story | booleanOptioneel / item | — |
thread.items[].post.publish_options.crossposted_video_id | stringOptioneel / item | — |
thread.items[].post.publish_options.spherical | booleanOptioneel / item | — |
thread.items[].post.scheduled_at | stringVerplicht in bovenliggend object | — |
thread.items[].post.display_timezone | stringVerplicht in bovenliggend object |
|
thread.items[].post.local_scheduled_at | string | nullOptioneel / item | — |
thread.items[].post.local_scheduled_atanyOf 1 | stringOptioneel / item |
|
thread.items[].post.local_scheduled_atanyOf 2 | nullOptioneel / item | — |
thread.items[].post.schedule_timezone | string | nullOptioneel / item | — |
thread.items[].post.schedule_timezoneanyOf 1 | stringOptioneel / item |
|
thread.items[].post.schedule_timezoneanyOf 2 | nullOptioneel / item | — |
thread.items[].post.schedule_dst_disambiguation | string | nullOptioneel / item | — |
thread.items[].post.schedule_dst_disambiguationanyOf 1 | stringOptioneel / item |
|
thread.items[].post.schedule_dst_disambiguationanyOf 2 | nullOptioneel / item | — |
thread.items[].post.schedule_intent_state | stringOptioneel / item |
|
thread.items[].post.expires_at | string | nullVerplicht in bovenliggend object | — |
thread.items[].post.status | stringVerplicht in bovenliggend object |
|
thread.items[].post.version | integerVerplicht in bovenliggend object |
|
thread.items[].post.automatic_retry_enabled | booleanVerplicht in bovenliggend object | — |
thread.items[].post.delete_requested_at | string | nullVerplicht in bovenliggend object | — |
thread.items[].post.published_at | string | nullVerplicht in bovenliggend object | — |
thread.items[].post.deleted_at | string | nullVerplicht in bovenliggend object | — |
thread.items[].post.provider_post_id | string | nullVerplicht in bovenliggend object | — |
thread.items[].post.permalink | string | nullVerplicht in bovenliggend object | — |
thread.items[].post.permalinkanyOf 1 | stringVerplicht in bovenliggend object |
|
thread.items[].post.permalinkanyOf 2 | nullVerplicht in bovenliggend object | — |
thread.items[].post.created_at | stringVerplicht in bovenliggend object | — |
thread.items[].post.updated_at | stringVerplicht in bovenliggend object | — |
thread.items[].post.project_id | string | nullVerplicht in bovenliggend object | — |
thread.items[].post.project_idanyOf 1 | stringVerplicht in bovenliggend object |
|
thread.items[].post.project_idanyOf 2 | nullVerplicht in bovenliggend object | — |
thread.items[].post.batch_id | string | nullVerplicht in bovenliggend object | — |
thread.items[].post.batch_idanyOf 1 | stringVerplicht in bovenliggend object |
|
thread.items[].post.batch_idanyOf 2 | nullVerplicht in bovenliggend object | — |
thread.items[].post.source_ref | object | nullVerplicht in bovenliggend object | — |
thread.items[].post.source_refanyOf 1 | objectVerplicht in bovenliggend object |
|
thread.items[].post.source_ref.*anyOf 1 | any JSON valueOptioneel / item | — |
thread.items[].post.source_refanyOf 2 | nullVerplicht in bovenliggend object | — |
thread.items[].retry_allowed | booleanVerplicht in bovenliggend object | — |
thread.expected_versions | objectVerplicht in bovenliggend object |
|
thread.expected_versions.* | integerOptioneel / item |
|
thread.actions | arrayVerplicht in bovenliggend object |
|
thread.actions[] | objectOptioneel / item | — |
thread.actions[].action | stringVerplicht in bovenliggend object |
|
thread.actions[].allowed | booleanVerplicht in bovenliggend object | — |
thread.actions[].reason_code | stringVerplicht in bovenliggend object |
|
thread.actions[].message | stringVerplicht in bovenliggend object | — |
deduped | booleanOptioneel / item | — |
Volledig JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"thread": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"social_account_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"item_count": {
"type": "integer",
"minimum": 2,
"maximum": 25
},
"created_at": {
"type": "string"
},
"items": {
"minItems": 2,
"maxItems": 25,
"type": "array",
"items": {
"type": "object",
"properties": {
"item_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"ordinal": {
"type": "integer",
"minimum": 1,
"maximum": 25
},
"predecessor_post_id": {
"anyOf": [
{
"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}$"
},
{
"type": "null"
}
]
},
"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",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"social_account_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
]
},
"platform": {
"type": "string",
"enum": [
"instagram",
"threads",
"facebook",
"youtube",
"x"
]
},
"destination": {
"type": "object",
"properties": {
"social_account_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
]
},
"platform": {
"type": "string",
"enum": [
"instagram",
"threads",
"facebook",
"youtube",
"x"
]
},
"platform_user_id": {
"type": [
"string",
"null"
]
},
"account_label": {
"type": [
"string",
"null"
]
}
},
"required": [
"social_account_id",
"platform",
"platform_user_id",
"account_label"
]
},
"caption": {
"type": [
"string",
"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",
"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))$",
"format": "date-time"
},
{
"type": "null"
}
]
}
},
"required": [
"kind",
"url"
]
}
},
"link_url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"publish_options": {
"type": "object",
"properties": {
"post_type": {
"type": "string",
"enum": [
"TEXT",
"LINK",
"IMAGE",
"MULTI_IMAGE",
"VIDEO",
"CAROUSEL",
"REELS",
"STORY_IMAGE",
"STORY_VIDEO",
"REPOST",
"SHORT"
]
},
"location_id": {
"type": "string",
"minLength": 1
},
"share_to_feed": {
"type": "boolean"
},
"collaborators": {
"maxItems": 3,
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"first_comment": {
"type": "string",
"minLength": 1,
"maxLength": 2200
},
"topic_tag": {
"type": "string",
"minLength": 1
},
"thumb_offset_ms": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"title": {
"type": "string",
"maxLength": 255
},
"youtube_privacy_status": {
"type": "string",
"enum": [
"private",
"unlisted",
"public"
]
},
"youtube_category_id": {
"type": "string",
"pattern": "^\\d+$"
},
"youtube_contains_synthetic_media": {
"type": "boolean"
},
"description": {
"type": "string",
"maxLength": 5000
},
"category_id": {
"type": "string",
"pattern": "^\\d+$"
},
"privacy_status": {
"type": "string",
"enum": [
"private",
"unlisted",
"public"
]
},
"cancellation_mode": {
"type": "string",
"enum": [
"DELETE",
"UNSCHEDULE_KEEP_PRIVATE"
]
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"default_language": {
"type": "string"
},
"localizations": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"license": {
"type": "string",
"enum": [
"youtube",
"creativeCommon"
]
},
"embeddable": {
"type": "boolean"
},
"public_stats_viewable": {
"type": "boolean"
},
"self_declared_made_for_kids": {
"type": "boolean"
},
"contains_synthetic_media": {
"type": "boolean"
},
"has_paid_product_placement": {
"type": "boolean"
},
"recording_date": {
"type": "string"
},
"notify_subscribers": {
"type": "boolean"
},
"thumbnail_asset_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"surface_expectation": {
"type": "string",
"const": "SHORT"
},
"brand_partner": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"cover_asset_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"audio_name": {
"type": "string"
},
"trial_params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"is_ai_generated": {
"type": "boolean"
},
"branded_content_sponsor_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"is_paid_partnership": {
"type": "boolean"
},
"media_options": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"reply_to_id": {
"type": "string"
},
"quote_post_id": {
"type": "string"
},
"repost_target_id": {
"type": "string"
},
"reply_control": {
"type": "string"
},
"enable_reply_approvals": {
"type": "boolean"
},
"link_attachment": {
"type": "string",
"format": "uri"
},
"poll_attachment": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"gif_attachment": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"text_attachment": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"text_entities": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"is_spoiler_media": {
"type": "boolean"
},
"is_ghost_post": {
"type": "boolean"
},
"allowlisted_country_codes": {
"type": "array",
"items": {
"type": "string"
}
},
"crossreshare_to_ig": {
"type": "boolean"
},
"crossreshare_to_ig_dark_mode": {
"type": "boolean"
},
"auto_publish_text": {
"type": "boolean"
},
"publication_mode": {
"type": "string",
"enum": [
"PUBLISH",
"DRAFT"
]
},
"backdated_time": {
"type": "number"
},
"backdated_time_granularity": {
"type": "string",
"enum": [
"year",
"month",
"day",
"hour",
"minute"
]
},
"place": {
"type": "string"
},
"feed_targeting": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"targeting": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"child_attachments": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"multi_share_end_card": {
"type": "boolean"
},
"multi_share_optimized": {
"type": "boolean"
},
"unpublished_content_type": {
"type": "string"
},
"no_story": {
"type": "boolean"
},
"crossposted_video_id": {
"type": "string"
},
"spherical": {
"type": "boolean"
}
}
},
"scheduled_at": {
"type": "string"
},
"display_timezone": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"local_scheduled_at": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
},
{
"type": "null"
}
]
},
"schedule_timezone": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 80
},
{
"type": "null"
}
]
},
"schedule_dst_disambiguation": {
"anyOf": [
{
"type": "string",
"enum": [
"exact",
"earlier",
"later"
]
},
{
"type": "null"
}
]
},
"schedule_intent_state": {
"type": "string",
"enum": [
"verified",
"legacy_unverified"
]
},
"expires_at": {
"type": [
"string",
"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": {
"type": [
"string",
"null"
]
},
"published_at": {
"type": [
"string",
"null"
]
},
"deleted_at": {
"type": [
"string",
"null"
]
},
"provider_post_id": {
"type": [
"string",
"null"
]
},
"permalink": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"created_at": {
"type": "string"
},
"updated_at": {
"type": "string"
},
"project_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
]
},
"batch_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
]
},
"source_ref": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"workspace_id",
"social_account_id",
"platform",
"destination",
"caption",
"hashtags",
"media",
"publish_options",
"scheduled_at",
"display_timezone",
"expires_at",
"status",
"version",
"automatic_retry_enabled",
"delete_requested_at",
"published_at",
"deleted_at",
"provider_post_id",
"permalink",
"created_at",
"updated_at",
"project_id",
"batch_id",
"source_ref"
]
},
"retry_allowed": {
"type": "boolean"
}
},
"required": [
"item_id",
"ordinal",
"predecessor_post_id",
"post",
"retry_allowed"
]
}
},
"expected_versions": {
"type": "object",
"propertyNames": {
"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}$"
},
"additionalProperties": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"actions": {
"minItems": 2,
"maxItems": 2,
"type": "array",
"items": {
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"resume",
"cancel"
]
},
"allowed": {
"type": "boolean"
},
"reason_code": {
"type": "string",
"enum": [
"allowed",
"no_failed_items",
"resolution_required",
"retry_unavailable",
"terminal_state"
]
},
"message": {
"type": "string"
}
},
"required": [
"action",
"allowed",
"reason_code",
"message"
]
}
}
},
"required": [
"id",
"workspace_id",
"social_account_id",
"idempotency_key",
"item_count",
"created_at",
"items",
"expected_versions",
"actions"
]
},
"deduped": {
"type": "boolean"
}
},
"required": [
"thread"
]
}Fouten en veilig opnieuw proberen
Controleer de HTTP-status en antwoordinhoud. Een 400-validatiefout kan een ZodError bevatten; afhandelingsfouten gebruiken de velden error, message en code. Bewaar request_id of x-request-id voor diagnose, zonder inloggegevens. Los 401/403-toegangsfouten op voordat je opnieuw probeert en volg Retry-After bij 429. Lees bij een onzekere schrijfhandeling of 5xx eerst het bestaande resultaat. Hergebruik een idempotentiesleutel alleen waar dit wordt ondersteund; het gedrag bij opnieuw proberen verschilt per bewerking en garandeert geen precies eenmalige aflevering.
Handleiding voor probleemoplossingVoorbeelden
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.
Stel SOSOAPI_ACCESS_TOKEN op je server in op inloggegevens die deze bewerking accepteert en houd deze uit browsercode. Gebruik voor een agent sosoapi auth login om via de browser aan te melden en laat de CLI de inloggegevens vernieuwen.
request.json
{
"workspace_id": "11111111-1111-4111-8111-111111111111",
"id": "88888888-8888-4888-8888-888888888888"
}cURL
curl --request POST \
"https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/x-post-threads/get" \
-H "Authorization: Bearer $SOSOAPI_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
--data-binary @request.jsonJavaScript
// Server-side JavaScript. Do not print tokens or credential-bearing responses.
const token = process.env.SOSOAPI_ACCESS_TOKEN;
if (!token) throw new Error("Set an accepted credential for this operation");
const response = await fetch("https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/x-post-threads/get", {
method: "POST",
headers: { "Content-Type": "application/json", Authorization: "Bearer " + token },
body: JSON.stringify({
"workspace_id": "11111111-1111-4111-8111-111111111111",
"id": "88888888-8888-4888-8888-888888888888"
})
});
const result = await response.json();
// Check response.ok, the operation-specific body and completion state before continuing.CLI
npx sosoapi api post /studio-api/x-post-threads/get < request.jsonVoorbeeld van een synthetisch antwoord
{
"thread": {
"workspace_id": "11111111-1111-4111-8111-111111111111",
"id": "88888888-8888-4888-8888-888888888888",
"social_account_id": "22222222-2222-4222-8222-222222222222",
"idempotency_key": "example-x-thread-0001",
"item_count": 2,
"created_at": "2099-01-15T08:00:00Z",
"items": [
{
"item_id": "99999999-9999-4999-8999-999999999991",
"ordinal": 1,
"predecessor_post_id": null,
"retry_allowed": true,
"post": {
"id": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaa1",
"workspace_id": "11111111-1111-4111-8111-111111111111",
"social_account_id": "22222222-2222-4222-8222-222222222222",
"platform": "x",
"destination": {
"social_account_id": "22222222-2222-4222-8222-222222222222",
"platform": "x",
"platform_user_id": "fictional-x-account",
"account_label": "Fictional X account"
},
"caption": "A fictional two-part announcement.",
"hashtags": [],
"media": [],
"publish_options": {
"post_type": "TEXT"
},
"scheduled_at": "2099-01-15T09:00:00Z",
"display_timezone": "UTC",
"expires_at": null,
"status": "failed",
"version": 2,
"automatic_retry_enabled": false,
"delete_requested_at": null,
"published_at": null,
"deleted_at": null,
"provider_post_id": null,
"permalink": null,
"project_id": null,
"batch_id": null,
"source_ref": null,
"created_at": "2099-01-15T08:00:00Z",
"updated_at": "2099-01-15T08:30:00Z"
}
},
{
"item_id": "99999999-9999-4999-8999-999999999992",
"ordinal": 2,
"predecessor_post_id": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaa1",
"retry_allowed": true,
"post": {
"id": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaa2",
"workspace_id": "11111111-1111-4111-8111-111111111111",
"social_account_id": "22222222-2222-4222-8222-222222222222",
"platform": "x",
"destination": {
"social_account_id": "22222222-2222-4222-8222-222222222222",
"platform": "x",
"platform_user_id": "fictional-x-account",
"account_label": "Fictional X account"
},
"caption": "The second part of this fictional announcement.",
"hashtags": [],
"media": [],
"publish_options": {
"post_type": "TEXT"
},
"scheduled_at": "2099-01-15T09:00:00Z",
"display_timezone": "UTC",
"expires_at": null,
"status": "failed",
"version": 2,
"automatic_retry_enabled": false,
"delete_requested_at": null,
"published_at": null,
"deleted_at": null,
"provider_post_id": null,
"permalink": null,
"project_id": null,
"batch_id": null,
"source_ref": null,
"created_at": "2099-01-15T08:00:00Z",
"updated_at": "2099-01-15T08:30:00Z"
}
}
],
"expected_versions": {
"aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaa1": 2,
"aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaa2": 2
},
"actions": [
{
"action": "resume",
"allowed": true,
"reason_code": "allowed",
"message": "This fictional preflight failure is safe to resume."
},
{
"action": "cancel",
"allowed": true,
"reason_code": "allowed",
"message": "Cancel the unpublished items in this fictional thread."
}
]
}
}