Alat MCP
Publikasikan satu gambar dari URL
sosoapi_post_image_urlKirim postingan lengkap dengan URL gambar satu kali, dengan media kosong. Backend menyiapkan dan memublikasikannya meskipun koneksi terputus. Mengembalikan hasil akhir publikasi jika tersedia dalam 35 detik, atau ID postingan persisten; jangan pernah mengirim ulang dengan kunci baru. Memerlukan izin operate dan publish. Kolom waktu lokal/DST harus disertakan bersama. import_id hanya untuk melanjutkan klien versi lama.
Baca sebagai MarkdownProfil dan transport
Profil: core, full · Transport: stdio, http
Pilih core atau full untuk mengatur alat yang terlihat oleh klien; ini tidak mengubah izinnya. Unggahan file lokal memerlukan stdio dan tidak tersedia melalui HTTP. Atur SOSOAPI_OUTPUT_SCHEMAS=1 untuk menyertakan skema output saat penemuan. Alat mengembalikan hasil terstruktur dengan atau tanpa pengaturan itu.
Izin dan efek samping
Anotasi membantu klien menjelaskan alat. Setiap panggilan tetap memeriksa autentikasi pengguna, peran, akses sumber daya, dan izin kemampuan.
{
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": true
}- /studio-api/scheduled-posts/create-image-url: agent:publish · hasil akhir publikasi
Kolom input
Wajib berarti wajib dalam objek induk dan cabang yang dipilih. Anak wajib tidak membuat induk opsional menjadi wajib. Aturan dan nama kolom di bawah disalin dari kontrak.
| Kolom / cabang | Jenis / wajib | Batasan |
|---|---|---|
$ | objectWajib dalam induk |
|
source_url | stringWajib dalam induk |
|
post | objectWajib dalam induk |
|
post.workspace_id | stringWajib dalam induk |
|
post.project_id | string | nullOpsional / item | — |
post.project_idanyOf 1 | stringOpsional / item |
|
post.project_idanyOf 2 | nullOpsional / item | — |
post.social_account_id | stringWajib dalam induk |
|
post.caption | string | nullOpsional / item | — |
post.captionanyOf 1 | stringOpsional / item |
|
post.captionanyOf 2 | nullOpsional / item | — |
post.hashtags | arrayOpsional / item |
|
post.hashtags[] | stringOpsional / item |
|
post.media | arrayOpsional / item |
|
post.media[] | objectOpsional / item |
|
post.media[].kind | stringWajib dalam induk |
|
post.media[].url | stringWajib dalam induk |
|
post.media[].cover_url | string | nullOpsional / item | — |
post.media[].cover_urlanyOf 1 | stringOpsional / item |
|
post.media[].cover_urlanyOf 2 | nullOpsional / item | — |
post.media[].cover_asset_id | integer | nullOpsional / item | — |
post.media[].cover_asset_idanyOf 1 | integerOpsional / item |
|
post.media[].cover_asset_idanyOf 2 | nullOpsional / item | — |
post.media[].asset_id | integer | nullOpsional / item | — |
post.media[].asset_idanyOf 1 | integerOpsional / item |
|
post.media[].asset_idanyOf 2 | nullOpsional / item | — |
post.media[].mime_type | string | nullOpsional / item | — |
post.media[].mime_typeanyOf 1 | stringOpsional / item |
|
post.media[].mime_typeanyOf 2 | nullOpsional / item | — |
post.link_url | string | nullOpsional / item | — |
post.link_urlanyOf 1 | stringOpsional / item |
|
post.link_urlanyOf 2 | nullOpsional / item | — |
post.provider_payload | objectWajib dalam induk |
|
post.provider_payload.platform | stringWajib dalam induk |
|
post.provider_payload.publish_options | objectWajib dalam induk |
|
post.provider_payload.publish_options.post_type | stringWajib dalam induk |
|
post.provider_payload.publish_options.* | any JSON valueOpsional / item | — |
post.scheduled_at | stringWajib dalam induk |
|
post.display_timezone | stringOpsional / item |
|
post.local_scheduled_at | stringOpsional / item |
|
post.schedule_dst_disambiguation | stringOpsional / item |
|
post.expires_at | string | nullOpsional / item | — |
post.expires_atanyOf 1 | stringOpsional / item |
|
post.expires_atanyOf 2 | nullOpsional / item | — |
post.source_ref | object | nullOpsional / item | — |
post.source_refanyOf 1 | objectOpsional / item |
|
post.source_ref.*anyOf 1 | any JSON valueOpsional / item | — |
post.source_refanyOf 2 | nullOpsional / item | — |
post.automatic_retry_enabled | booleanOpsional / item | — |
post.idempotency_key | stringWajib dalam induk |
|
import_id | stringOpsional / item | Gunakan hanya import_id yang dikembalikan untuk URL, ruang kerja, dan maksud pengguna yang sama ini.
|
JSON Schema lengkap
{
"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
}Output terstruktur
Skema ini menjelaskan structuredContent dalam hasil alat yang berhasil. Respons MCP juga menyertakan content dan dapat menetapkan isError saat panggilan gagal. Untuk publikasi, baca hasil akhir postingan alih-alih menganggap permintaan diterima atau respons teks sebagai konfirmasi. Operasi API yang ditautkan menjelaskan izin dan aturan percobaan ulang.
Wajib berarti wajib dalam objek induk dan cabang yang dipilih. Anak wajib tidak membuat induk opsional menjadi wajib. Aturan dan nama kolom di bawah disalin dari kontrak.
| Kolom / cabang | Jenis / wajib | Batasan |
|---|---|---|
$ | objectWajib dalam induk |
|
stage | stringWajib dalam induk |
|
import_id | stringWajib dalam induk |
|
completion | stringOpsional / item |
|
scheduled_post | object | nullWajib dalam induk | — |
scheduled_postanyOf 1 | objectWajib dalam induk |
|
scheduled_post.postanyOf 1 | objectWajib dalam induk |
|
scheduled_post.post.idanyOf 1 | stringWajib dalam induk |
|
scheduled_post.post.workspace_idanyOf 1 | stringWajib dalam induk |
|
scheduled_post.post.social_account_idanyOf 1 | string | nullWajib dalam induk | — |
scheduled_post.post.social_account_idanyOf 1 / anyOf 1 | stringWajib dalam induk |
|
scheduled_post.post.social_account_idanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
scheduled_post.post.platformanyOf 1 | stringWajib dalam induk |
|
scheduled_post.post.destinationanyOf 1 | objectWajib dalam induk |
|
scheduled_post.post.destination.social_account_idanyOf 1 | string | nullWajib dalam induk | — |
scheduled_post.post.destination.social_account_idanyOf 1 / anyOf 1 | stringWajib dalam induk |
|
scheduled_post.post.destination.social_account_idanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
scheduled_post.post.destination.platformanyOf 1 | stringWajib dalam induk |
|
scheduled_post.post.destination.platform_user_idanyOf 1 | string | nullWajib dalam induk | — |
scheduled_post.post.destination.platform_user_idanyOf 1 / anyOf 1 | stringWajib dalam induk | — |
scheduled_post.post.destination.platform_user_idanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
scheduled_post.post.destination.account_labelanyOf 1 | string | nullWajib dalam induk | — |
scheduled_post.post.destination.account_labelanyOf 1 / anyOf 1 | stringWajib dalam induk | — |
scheduled_post.post.destination.account_labelanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
scheduled_post.post.captionanyOf 1 | string | nullWajib dalam induk | — |
scheduled_post.post.captionanyOf 1 / anyOf 1 | stringWajib dalam induk | — |
scheduled_post.post.captionanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
scheduled_post.post.hashtagsanyOf 1 | arrayWajib dalam induk | — |
scheduled_post.post.hashtags[]anyOf 1 | stringOpsional / item | — |
scheduled_post.post.mediaanyOf 1 | arrayWajib dalam induk | — |
scheduled_post.post.media[]anyOf 1 | objectOpsional / item |
|
scheduled_post.post.media[].kindanyOf 1 | stringWajib dalam induk |
|
scheduled_post.post.media[].urlanyOf 1 | stringWajib dalam induk |
|
scheduled_post.post.media[].cover_urlanyOf 1 | string | nullOpsional / item | — |
scheduled_post.post.media[].cover_urlanyOf 1 / anyOf 1 | stringOpsional / item |
|
scheduled_post.post.media[].cover_urlanyOf 1 / anyOf 2 | nullOpsional / item | — |
scheduled_post.post.media[].cover_asset_idanyOf 1 | integer | nullOpsional / item | — |
scheduled_post.post.media[].cover_asset_idanyOf 1 / anyOf 1 | integerOpsional / item |
|
scheduled_post.post.media[].cover_asset_idanyOf 1 / anyOf 2 | nullOpsional / item | — |
scheduled_post.post.media[].asset_idanyOf 1 | integer | nullOpsional / item | — |
scheduled_post.post.media[].asset_idanyOf 1 / anyOf 1 | integerOpsional / item |
|
scheduled_post.post.media[].asset_idanyOf 1 / anyOf 2 | nullOpsional / item | — |
scheduled_post.post.media[].mime_typeanyOf 1 | string | nullOpsional / item | — |
scheduled_post.post.media[].mime_typeanyOf 1 / anyOf 1 | stringOpsional / item |
|
scheduled_post.post.media[].mime_typeanyOf 1 / anyOf 2 | nullOpsional / item | — |
scheduled_post.post.media[].preview_urlanyOf 1 | string | nullOpsional / item | URL baca sementara yang diizinkan; pertahankan url sebagai identitas media Scheduled Post persisten. — |
scheduled_post.post.media[].preview_urlanyOf 1 / anyOf 1 | stringOpsional / item |
|
scheduled_post.post.media[].preview_urlanyOf 1 / anyOf 2 | nullOpsional / item | — |
scheduled_post.post.media[].cover_preview_urlanyOf 1 | string | nullOpsional / item | URL baca sampul sementara yang diizinkan; pertahankan cover_url sebagai identitas media persisten. — |
scheduled_post.post.media[].cover_preview_urlanyOf 1 / anyOf 1 | stringOpsional / item |
|
scheduled_post.post.media[].cover_preview_urlanyOf 1 / anyOf 2 | nullOpsional / item | — |
scheduled_post.post.media[].preview_expires_atanyOf 1 | string | nullOpsional / item | — |
scheduled_post.post.media[].preview_expires_atanyOf 1 / anyOf 1 | stringOpsional / item |
|
scheduled_post.post.media[].preview_expires_atanyOf 1 / anyOf 2 | nullOpsional / item | — |
scheduled_post.post.link_urlanyOf 1 | string | nullOpsional / item | — |
scheduled_post.post.link_urlanyOf 1 / anyOf 1 | stringOpsional / item |
|
scheduled_post.post.link_urlanyOf 1 / anyOf 2 | nullOpsional / item | — |
scheduled_post.post.publish_optionsanyOf 1 | objectWajib dalam induk |
|
scheduled_post.post.publish_options.post_typeanyOf 1 | stringOpsional / item |
|
scheduled_post.post.publish_options.location_idanyOf 1 | stringOpsional / item |
|
scheduled_post.post.publish_options.share_to_feedanyOf 1 | booleanOpsional / item | — |
scheduled_post.post.publish_options.collaboratorsanyOf 1 | arrayOpsional / item |
|
scheduled_post.post.publish_options.collaborators[]anyOf 1 | stringOpsional / item |
|
scheduled_post.post.publish_options.first_commentanyOf 1 | stringOpsional / item |
|
scheduled_post.post.publish_options.topic_taganyOf 1 | stringOpsional / item |
|
scheduled_post.post.publish_options.thumb_offset_msanyOf 1 | integerOpsional / item |
|
scheduled_post.post.publish_options.titleanyOf 1 | stringOpsional / item |
|
scheduled_post.post.publish_options.youtube_privacy_statusanyOf 1 | stringOpsional / item |
|
scheduled_post.post.publish_options.youtube_category_idanyOf 1 | stringOpsional / item |
|
scheduled_post.post.publish_options.youtube_contains_synthetic_mediaanyOf 1 | booleanOpsional / item | — |
scheduled_post.post.publish_options.descriptionanyOf 1 | stringOpsional / item |
|
scheduled_post.post.publish_options.category_idanyOf 1 | stringOpsional / item |
|
scheduled_post.post.publish_options.privacy_statusanyOf 1 | stringOpsional / item |
|
scheduled_post.post.publish_options.cancellation_modeanyOf 1 | stringOpsional / item |
|
scheduled_post.post.publish_options.tagsanyOf 1 | arrayOpsional / item | — |
scheduled_post.post.publish_options.tags[]anyOf 1 | stringOpsional / item | — |
scheduled_post.post.publish_options.default_languageanyOf 1 | stringOpsional / item | — |
scheduled_post.post.publish_options.localizationsanyOf 1 | objectOpsional / item |
|
scheduled_post.post.publish_options.localizations.*anyOf 1 | any JSON valueOpsional / item | — |
scheduled_post.post.publish_options.licenseanyOf 1 | stringOpsional / item |
|
scheduled_post.post.publish_options.embeddableanyOf 1 | booleanOpsional / item | — |
scheduled_post.post.publish_options.public_stats_viewableanyOf 1 | booleanOpsional / item | — |
scheduled_post.post.publish_options.self_declared_made_for_kidsanyOf 1 | booleanOpsional / item | — |
scheduled_post.post.publish_options.contains_synthetic_mediaanyOf 1 | booleanOpsional / item | — |
scheduled_post.post.publish_options.has_paid_product_placementanyOf 1 | booleanOpsional / item | — |
scheduled_post.post.publish_options.recording_dateanyOf 1 | stringOpsional / item | — |
scheduled_post.post.publish_options.notify_subscribersanyOf 1 | booleanOpsional / item | — |
scheduled_post.post.publish_options.thumbnail_asset_idanyOf 1 | integerOpsional / item |
|
scheduled_post.post.publish_options.surface_expectationanyOf 1 | stringOpsional / item |
|
scheduled_post.post.publish_options.brand_partneranyOf 1 | objectOpsional / item |
|
scheduled_post.post.publish_options.brand_partner.*anyOf 1 | any JSON valueOpsional / item | — |
scheduled_post.post.publish_options.cover_asset_idanyOf 1 | integerOpsional / item |
|
scheduled_post.post.publish_options.audio_nameanyOf 1 | stringOpsional / item | — |
scheduled_post.post.publish_options.trial_paramsanyOf 1 | objectOpsional / item |
|
scheduled_post.post.publish_options.trial_params.*anyOf 1 | any JSON valueOpsional / item | — |
scheduled_post.post.publish_options.is_ai_generatedanyOf 1 | booleanOpsional / item | — |
scheduled_post.post.publish_options.branded_content_sponsor_idsanyOf 1 | arrayOpsional / item | — |
scheduled_post.post.publish_options.branded_content_sponsor_ids[]anyOf 1 | stringOpsional / item | — |
scheduled_post.post.publish_options.is_paid_partnershipanyOf 1 | booleanOpsional / item | — |
scheduled_post.post.publish_options.media_optionsanyOf 1 | arrayOpsional / item | — |
scheduled_post.post.publish_options.media_options[]anyOf 1 | objectOpsional / item |
|
scheduled_post.post.publish_options.media_options[].*anyOf 1 | any JSON valueOpsional / item | — |
scheduled_post.post.publish_options.reply_to_idanyOf 1 | stringOpsional / item | — |
scheduled_post.post.publish_options.quote_post_idanyOf 1 | stringOpsional / item | — |
scheduled_post.post.publish_options.repost_target_idanyOf 1 | stringOpsional / item | — |
scheduled_post.post.publish_options.reply_controlanyOf 1 | stringOpsional / item | — |
scheduled_post.post.publish_options.enable_reply_approvalsanyOf 1 | booleanOpsional / item | — |
scheduled_post.post.publish_options.link_attachmentanyOf 1 | stringOpsional / item |
|
scheduled_post.post.publish_options.poll_attachmentanyOf 1 | objectOpsional / item |
|
scheduled_post.post.publish_options.poll_attachment.*anyOf 1 | any JSON valueOpsional / item | — |
scheduled_post.post.publish_options.gif_attachmentanyOf 1 | objectOpsional / item |
|
scheduled_post.post.publish_options.gif_attachment.*anyOf 1 | any JSON valueOpsional / item | — |
scheduled_post.post.publish_options.text_attachmentanyOf 1 | objectOpsional / item |
|
scheduled_post.post.publish_options.text_attachment.*anyOf 1 | any JSON valueOpsional / item | — |
scheduled_post.post.publish_options.text_entitiesanyOf 1 | arrayOpsional / item | — |
scheduled_post.post.publish_options.text_entities[]anyOf 1 | objectOpsional / item |
|
scheduled_post.post.publish_options.text_entities[].*anyOf 1 | any JSON valueOpsional / item | — |
scheduled_post.post.publish_options.is_spoiler_mediaanyOf 1 | booleanOpsional / item | — |
scheduled_post.post.publish_options.is_ghost_postanyOf 1 | booleanOpsional / item | — |
scheduled_post.post.publish_options.allowlisted_country_codesanyOf 1 | arrayOpsional / item | — |
scheduled_post.post.publish_options.allowlisted_country_codes[]anyOf 1 | stringOpsional / item | — |
scheduled_post.post.publish_options.crossreshare_to_iganyOf 1 | booleanOpsional / item | — |
scheduled_post.post.publish_options.crossreshare_to_ig_dark_modeanyOf 1 | booleanOpsional / item | — |
scheduled_post.post.publish_options.auto_publish_textanyOf 1 | booleanOpsional / item | — |
scheduled_post.post.publish_options.publication_modeanyOf 1 | stringOpsional / item |
|
scheduled_post.post.publish_options.backdated_timeanyOf 1 | numberOpsional / item | — |
scheduled_post.post.publish_options.backdated_time_granularityanyOf 1 | stringOpsional / item |
|
scheduled_post.post.publish_options.placeanyOf 1 | stringOpsional / item | — |
scheduled_post.post.publish_options.feed_targetinganyOf 1 | objectOpsional / item |
|
scheduled_post.post.publish_options.feed_targeting.*anyOf 1 | any JSON valueOpsional / item | — |
scheduled_post.post.publish_options.targetinganyOf 1 | objectOpsional / item |
|
scheduled_post.post.publish_options.targeting.*anyOf 1 | any JSON valueOpsional / item | — |
scheduled_post.post.publish_options.child_attachmentsanyOf 1 | arrayOpsional / item | — |
scheduled_post.post.publish_options.child_attachments[]anyOf 1 | objectOpsional / item |
|
scheduled_post.post.publish_options.child_attachments[].*anyOf 1 | any JSON valueOpsional / item | — |
scheduled_post.post.publish_options.multi_share_end_cardanyOf 1 | booleanOpsional / item | — |
scheduled_post.post.publish_options.multi_share_optimizedanyOf 1 | booleanOpsional / item | — |
scheduled_post.post.publish_options.unpublished_content_typeanyOf 1 | stringOpsional / item | — |
scheduled_post.post.publish_options.no_storyanyOf 1 | booleanOpsional / item | — |
scheduled_post.post.publish_options.crossposted_video_idanyOf 1 | stringOpsional / item | — |
scheduled_post.post.publish_options.sphericalanyOf 1 | booleanOpsional / item | — |
scheduled_post.post.scheduled_atanyOf 1 | stringWajib dalam induk | — |
scheduled_post.post.display_timezoneanyOf 1 | stringWajib dalam induk |
|
scheduled_post.post.local_scheduled_atanyOf 1 | string | nullOpsional / item | — |
scheduled_post.post.local_scheduled_atanyOf 1 / anyOf 1 | stringOpsional / item |
|
scheduled_post.post.local_scheduled_atanyOf 1 / anyOf 2 | nullOpsional / item | — |
scheduled_post.post.schedule_timezoneanyOf 1 | string | nullOpsional / item | — |
scheduled_post.post.schedule_timezoneanyOf 1 / anyOf 1 | stringOpsional / item |
|
scheduled_post.post.schedule_timezoneanyOf 1 / anyOf 2 | nullOpsional / item | — |
scheduled_post.post.schedule_dst_disambiguationanyOf 1 | string | nullOpsional / item | — |
scheduled_post.post.schedule_dst_disambiguationanyOf 1 / anyOf 1 | stringOpsional / item |
|
scheduled_post.post.schedule_dst_disambiguationanyOf 1 / anyOf 2 | nullOpsional / item | — |
scheduled_post.post.schedule_intent_stateanyOf 1 | stringOpsional / item |
|
scheduled_post.post.expires_atanyOf 1 | string | nullWajib dalam induk | — |
scheduled_post.post.expires_atanyOf 1 / anyOf 1 | stringWajib dalam induk | — |
scheduled_post.post.expires_atanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
scheduled_post.post.statusanyOf 1 | stringWajib dalam induk |
|
scheduled_post.post.versionanyOf 1 | integerWajib dalam induk |
|
scheduled_post.post.automatic_retry_enabledanyOf 1 | booleanWajib dalam induk | — |
scheduled_post.post.delete_requested_atanyOf 1 | string | nullWajib dalam induk | — |
scheduled_post.post.delete_requested_atanyOf 1 / anyOf 1 | stringWajib dalam induk | — |
scheduled_post.post.delete_requested_atanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
scheduled_post.post.published_atanyOf 1 | string | nullWajib dalam induk | — |
scheduled_post.post.published_atanyOf 1 / anyOf 1 | stringWajib dalam induk | — |
scheduled_post.post.published_atanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
scheduled_post.post.deleted_atanyOf 1 | string | nullWajib dalam induk | — |
scheduled_post.post.deleted_atanyOf 1 / anyOf 1 | stringWajib dalam induk | — |
scheduled_post.post.deleted_atanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
scheduled_post.post.provider_post_idanyOf 1 | string | nullWajib dalam induk | — |
scheduled_post.post.provider_post_idanyOf 1 / anyOf 1 | stringWajib dalam induk | — |
scheduled_post.post.provider_post_idanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
scheduled_post.post.permalinkanyOf 1 | string | nullWajib dalam induk | — |
scheduled_post.post.permalinkanyOf 1 / anyOf 1 | stringWajib dalam induk |
|
scheduled_post.post.permalinkanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
scheduled_post.post.created_atanyOf 1 | stringWajib dalam induk | — |
scheduled_post.post.updated_atanyOf 1 | stringWajib dalam induk | — |
scheduled_post.post.project_idanyOf 1 | string | nullWajib dalam induk | — |
scheduled_post.post.project_idanyOf 1 / anyOf 1 | stringWajib dalam induk |
|
scheduled_post.post.project_idanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
scheduled_post.post.batch_idanyOf 1 | string | nullWajib dalam induk | — |
scheduled_post.post.batch_idanyOf 1 / anyOf 1 | stringWajib dalam induk |
|
scheduled_post.post.batch_idanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
scheduled_post.post.source_refanyOf 1 | object | nullWajib dalam induk | — |
scheduled_post.post.source_refanyOf 1 / anyOf 1 | objectWajib dalam induk |
|
scheduled_post.post.source_ref.*anyOf 1 / anyOf 1 | any JSON valueOpsional / item | — |
scheduled_post.post.source_refanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
scheduled_post.dedupedanyOf 1 | booleanWajib dalam induk | — |
scheduled_postanyOf 2 | nullWajib dalam induk | — |
retry_after_seconds | integerOpsional / item |
|
resume_arguments | objectOpsional / item |
|
resume_arguments.* | any JSON valueOpsional / item | — |
JSON Schema lengkap
{
"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
}Contoh panggilan alat
Contoh ini menggunakan nilai fiktif yang diperiksa terhadap skema. Ganti ID dengan yang diizinkan bagi Anda, media dengan aset siap, dan tanggal dengan waktu publikasi yang dikonfirmasi. Periksa kelayakan akun sebelum mengirim penulisan. Halaman ini tidak mengirim permintaan API.
{
"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
}