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

يُحمّل البحث عند استخدامه فقط. تصفّح جميع الفئات أدناه.

أداة MCP

استئناف سلسلة X مرتبة

sosoapi_resume_x_post_thread

استأنف فقط الجزء المتبقي غير المكتمل والآمن لإعادة المحاولة من سلسلة X موجودة باستخدام أحدث الإجراءات المسموح بها وجميع قيم expected_versions. لا تعِد إنشاء الجزء المنشور أبدًا.

اقرأ بصيغة Markdown

الملفات التعريفية ووسائل النقل

الملفات التعريفية: full · وسائل النقل: stdio, http

اختر core أو full للأدوات التي يراها عميلك؛ لا يغيّر ذلك أذوناته. يحتاج رفع الملفات المحلية stdio ولا يتاح بـ HTTP. اضبط SOSOAPI_OUTPUT_SCHEMAS=1 لمخططات المخرجات بالاكتشاف. النتائج منظّمة بهذا الإعداد أوبدونه.

الأذونات والآثار الجانبية

تساعد الشروح العملاء على وصف الأداة. يظل كل استدعاء يفحص مصادقة المستخدم ودوره ووصوله إلى المورد وتفويض الإمكانات.

{
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}
  • /studio-api/x-post-threads/resume: agent:publish · canonical per-Post terminal publication outcomes; نتائج النشر النهائية المعتمدة لكل Post؛ قبول السلسلة لا يعني نشرها

حقول الإدخال

تعني «مطلوب» داخل الكائن الأب والفرع المختار. الحقل الابن المطلوب لا يجعل الأب الاختياري مطلوباً. نُسخت القواعد وأسماء الحقول أدناه من العقد.

حقول الإدخال
الحقل / الفرعالنوع / مطلوبالقيود
$objectمطلوب في العنصر الأب
  • additionalProperties: false
workspace_idstringمطلوب في العنصر الأب
  • format: "uuid"
idstringمطلوب في العنصر الأب
  • format: "uuid"
expected_versionsobjectمطلوب في العنصر الأب
  • additionalProperties: {"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}
expected_versions.*integerاختياري / عنصر
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
scheduled_atstringاختياري / عنصر
  • 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)))$"
مخطط JSON Schema الكامل
{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "id": {
      "type": "string",
      "format": "uuid"
    },
    "expected_versions": {
      "type": "object",
      "additionalProperties": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "scheduled_at": {
      "type": "string",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      "format": "date-time"
    }
  },
  "required": [
    "workspace_id",
    "id",
    "expected_versions"
  ],
  "additionalProperties": false
}

مخرجات منظّمة

يصف المخطط structuredContent في نتيجة أداة ناجحة. تشمل استجابة MCP أيضاً content وقد تضبط isError عند الفشل. للنشر، اقرأ النتيجة النهائية بدلاً من اعتبار القبول أوالنص تأكيداً. تشرح عملية API المرتبطة الأذونات وقواعد المحاولة.

تعني «مطلوب» داخل الكائن الأب والفرع المختار. الحقل الابن المطلوب لا يجعل الأب الاختياري مطلوباً. نُسخت القواعد وأسماء الحقول أدناه من العقد.

مخرجات منظّمة
الحقل / الفرعالنوع / مطلوبالقيود
$objectمطلوب في العنصر الأب
  • additionalProperties: false
threadobjectمطلوب في العنصر الأب
  • additionalProperties: false
thread.idstringمطلوب في العنصر الأب
  • format: "uuid"
thread.workspace_idstringمطلوب في العنصر الأب
  • format: "uuid"
thread.social_account_idstringمطلوب في العنصر الأب
  • format: "uuid"
thread.idempotency_keystringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 128
thread.item_countintegerمطلوب في العنصر الأب
  • minimum: 2
  • maximum: 25
thread.created_atstringمطلوب في العنصر الأب—
thread.itemsarrayمطلوب في العنصر الأب
  • minItems: 2
  • maxItems: 25
thread.items[]objectاختياري / عنصر
  • additionalProperties: false
thread.items[].item_idstringمطلوب في العنصر الأب
  • format: "uuid"
thread.items[].ordinalintegerمطلوب في العنصر الأب
  • minimum: 1
  • maximum: 25
thread.items[].predecessor_post_idstring | nullمطلوب في العنصر الأب—
thread.items[].predecessor_post_idanyOf 1stringمطلوب في العنصر الأب
  • 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}$"
thread.items[].predecessor_post_idanyOf 2nullمطلوب في العنصر الأب—
thread.items[].postobjectمطلوب في العنصر الأب
  • additionalProperties: false
thread.items[].post.idstringمطلوب في العنصر الأب
  • 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}$"
thread.items[].post.workspace_idstringمطلوب في العنصر الأب
  • format: "uuid"
thread.items[].post.social_account_idstring | nullمطلوب في العنصر الأب—
thread.items[].post.social_account_idanyOf 1stringمطلوب في العنصر الأب
  • format: "uuid"
thread.items[].post.social_account_idanyOf 2nullمطلوب في العنصر الأب—
thread.items[].post.platformstringمطلوب في العنصر الأب
  • enum: ["instagram","threads","facebook","youtube","x"]
thread.items[].post.destinationobjectمطلوب في العنصر الأب
  • additionalProperties: false
thread.items[].post.destination.social_account_idstring | nullمطلوب في العنصر الأب—
thread.items[].post.destination.social_account_idanyOf 1stringمطلوب في العنصر الأب
  • format: "uuid"
thread.items[].post.destination.social_account_idanyOf 2nullمطلوب في العنصر الأب—
thread.items[].post.destination.platformstringمطلوب في العنصر الأب
  • enum: ["instagram","threads","facebook","youtube","x"]
thread.items[].post.destination.platform_user_idstring | nullمطلوب في العنصر الأب—
thread.items[].post.destination.account_labelstring | nullمطلوب في العنصر الأب—
thread.items[].post.captionstring | nullمطلوب في العنصر الأب—
thread.items[].post.hashtagsarrayمطلوب في العنصر الأب—
thread.items[].post.hashtags[]stringاختياري / عنصر—
thread.items[].post.mediaarrayمطلوب في العنصر الأب—
thread.items[].post.media[]objectاختياري / عنصر
  • additionalProperties: false
thread.items[].post.media[].kindstringمطلوب في العنصر الأب
  • enum: ["image","video"]
thread.items[].post.media[].urlstringمطلوب في العنصر الأب
  • format: "uri"
thread.items[].post.media[].cover_urlstring | nullاختياري / عنصر—
thread.items[].post.media[].cover_urlanyOf 1stringاختياري / عنصر
  • format: "uri"
thread.items[].post.media[].cover_urlanyOf 2nullاختياري / عنصر—
thread.items[].post.media[].cover_asset_idinteger | nullاختياري / عنصر—
thread.items[].post.media[].cover_asset_idanyOf 1integerاختياري / عنصر
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
thread.items[].post.media[].cover_asset_idanyOf 2nullاختياري / عنصر—
thread.items[].post.media[].asset_idinteger | nullاختياري / عنصر—
thread.items[].post.media[].asset_idanyOf 1integerاختياري / عنصر
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
thread.items[].post.media[].asset_idanyOf 2nullاختياري / عنصر—
thread.items[].post.media[].mime_typestring | nullاختياري / عنصر—
thread.items[].post.media[].mime_typeanyOf 1stringاختياري / عنصر
  • minLength: 1
  • maxLength: 160
thread.items[].post.media[].mime_typeanyOf 2nullاختياري / عنصر—
thread.items[].post.media[].preview_urlstring | nullاختياري / عنصر

URL قراءة مؤقت ومفوّض؛ احتفظ بـ url بوصفه هوية وسائط Scheduled Post المخزّنة.

—
thread.items[].post.media[].preview_urlanyOf 1stringاختياري / عنصر
  • format: "uri"
thread.items[].post.media[].preview_urlanyOf 2nullاختياري / عنصر—
thread.items[].post.media[].cover_preview_urlstring | nullاختياري / عنصر

URL قراءة مؤقت ومفوّض للغلاف؛ احتفظ بـ cover_url بوصفه هوية الوسائط المخزّنة.

—
thread.items[].post.media[].cover_preview_urlanyOf 1stringاختياري / عنصر
  • format: "uri"
thread.items[].post.media[].cover_preview_urlanyOf 2nullاختياري / عنصر—
thread.items[].post.media[].preview_expires_atstring | nullاختياري / عنصر—
thread.items[].post.media[].preview_expires_atanyOf 1stringاختياري / عنصر
  • 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))$"
thread.items[].post.media[].preview_expires_atanyOf 2nullاختياري / عنصر—
thread.items[].post.link_urlstring | nullاختياري / عنصر—
thread.items[].post.link_urlanyOf 1stringاختياري / عنصر
  • format: "uri"
thread.items[].post.link_urlanyOf 2nullاختياري / عنصر—
thread.items[].post.publish_optionsobjectمطلوب في العنصر الأب
  • additionalProperties: false
thread.items[].post.publish_options.post_typestringاختياري / عنصر
  • enum: ["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]
thread.items[].post.publish_options.location_idstringاختياري / عنصر
  • minLength: 1
thread.items[].post.publish_options.share_to_feedbooleanاختياري / عنصر—
thread.items[].post.publish_options.collaboratorsarrayاختياري / عنصر
  • maxItems: 3
thread.items[].post.publish_options.collaborators[]stringاختياري / عنصر
  • minLength: 1
thread.items[].post.publish_options.first_commentstringاختياري / عنصر
  • minLength: 1
  • maxLength: 2200
thread.items[].post.publish_options.topic_tagstringاختياري / عنصر
  • minLength: 1
thread.items[].post.publish_options.thumb_offset_msintegerاختياري / عنصر
  • minimum: 0
  • maximum: 9007199254740991
thread.items[].post.publish_options.titlestringاختياري / عنصر
  • maxLength: 255
thread.items[].post.publish_options.youtube_privacy_statusstringاختياري / عنصر
  • enum: ["private","unlisted","public"]
thread.items[].post.publish_options.youtube_category_idstringاختياري / عنصر
  • pattern: "^\\d+$"
thread.items[].post.publish_options.youtube_contains_synthetic_mediabooleanاختياري / عنصر—
thread.items[].post.publish_options.descriptionstringاختياري / عنصر
  • maxLength: 5000
thread.items[].post.publish_options.category_idstringاختياري / عنصر
  • pattern: "^\\d+$"
thread.items[].post.publish_options.privacy_statusstringاختياري / عنصر
  • enum: ["private","unlisted","public"]
thread.items[].post.publish_options.cancellation_modestringاختياري / عنصر
  • enum: ["DELETE","UNSCHEDULE_KEEP_PRIVATE"]
thread.items[].post.publish_options.tagsarrayاختياري / عنصر—
thread.items[].post.publish_options.tags[]stringاختياري / عنصر—
thread.items[].post.publish_options.default_languagestringاختياري / عنصر—
thread.items[].post.publish_options.localizationsobjectاختياري / عنصر
  • additionalProperties: {}
thread.items[].post.publish_options.localizations.*any JSON valueاختياري / عنصر—
thread.items[].post.publish_options.licensestringاختياري / عنصر
  • enum: ["youtube","creativeCommon"]
thread.items[].post.publish_options.embeddablebooleanاختياري / عنصر—
thread.items[].post.publish_options.public_stats_viewablebooleanاختياري / عنصر—
thread.items[].post.publish_options.self_declared_made_for_kidsbooleanاختياري / عنصر—
thread.items[].post.publish_options.contains_synthetic_mediabooleanاختياري / عنصر—
thread.items[].post.publish_options.has_paid_product_placementbooleanاختياري / عنصر—
thread.items[].post.publish_options.recording_datestringاختياري / عنصر—
thread.items[].post.publish_options.notify_subscribersbooleanاختياري / عنصر—
thread.items[].post.publish_options.thumbnail_asset_idintegerاختياري / عنصر
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
thread.items[].post.publish_options.surface_expectationstringاختياري / عنصر
  • const: "SHORT"
thread.items[].post.publish_options.brand_partnerobjectاختياري / عنصر
  • additionalProperties: {}
thread.items[].post.publish_options.brand_partner.*any JSON valueاختياري / عنصر—
thread.items[].post.publish_options.cover_asset_idintegerاختياري / عنصر
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
thread.items[].post.publish_options.audio_namestringاختياري / عنصر—
thread.items[].post.publish_options.trial_paramsobjectاختياري / عنصر
  • additionalProperties: {}
thread.items[].post.publish_options.trial_params.*any JSON valueاختياري / عنصر—
thread.items[].post.publish_options.is_ai_generatedbooleanاختياري / عنصر—
thread.items[].post.publish_options.branded_content_sponsor_idsarrayاختياري / عنصر—
thread.items[].post.publish_options.branded_content_sponsor_ids[]stringاختياري / عنصر—
thread.items[].post.publish_options.is_paid_partnershipbooleanاختياري / عنصر—
thread.items[].post.publish_options.media_optionsarrayاختياري / عنصر—
thread.items[].post.publish_options.media_options[]objectاختياري / عنصر
  • additionalProperties: {}
thread.items[].post.publish_options.media_options[].*any JSON valueاختياري / عنصر—
thread.items[].post.publish_options.reply_to_idstringاختياري / عنصر—
thread.items[].post.publish_options.quote_post_idstringاختياري / عنصر—
thread.items[].post.publish_options.repost_target_idstringاختياري / عنصر—
thread.items[].post.publish_options.reply_controlstringاختياري / عنصر—
thread.items[].post.publish_options.enable_reply_approvalsbooleanاختياري / عنصر—
thread.items[].post.publish_options.link_attachmentstringاختياري / عنصر
  • format: "uri"
thread.items[].post.publish_options.poll_attachmentobjectاختياري / عنصر
  • additionalProperties: {}
thread.items[].post.publish_options.poll_attachment.*any JSON valueاختياري / عنصر—
thread.items[].post.publish_options.gif_attachmentobjectاختياري / عنصر
  • additionalProperties: {}
thread.items[].post.publish_options.gif_attachment.*any JSON valueاختياري / عنصر—
thread.items[].post.publish_options.text_attachmentobjectاختياري / عنصر
  • additionalProperties: {}
thread.items[].post.publish_options.text_attachment.*any JSON valueاختياري / عنصر—
thread.items[].post.publish_options.text_entitiesarrayاختياري / عنصر—
thread.items[].post.publish_options.text_entities[]objectاختياري / عنصر
  • additionalProperties: {}
thread.items[].post.publish_options.text_entities[].*any JSON valueاختياري / عنصر—
thread.items[].post.publish_options.is_spoiler_mediabooleanاختياري / عنصر—
thread.items[].post.publish_options.is_ghost_postbooleanاختياري / عنصر—
thread.items[].post.publish_options.allowlisted_country_codesarrayاختياري / عنصر—
thread.items[].post.publish_options.allowlisted_country_codes[]stringاختياري / عنصر—
thread.items[].post.publish_options.crossreshare_to_igbooleanاختياري / عنصر—
thread.items[].post.publish_options.crossreshare_to_ig_dark_modebooleanاختياري / عنصر—
thread.items[].post.publish_options.auto_publish_textbooleanاختياري / عنصر—
thread.items[].post.publish_options.publication_modestringاختياري / عنصر
  • enum: ["PUBLISH","DRAFT"]
thread.items[].post.publish_options.backdated_timenumberاختياري / عنصر—
thread.items[].post.publish_options.backdated_time_granularitystringاختياري / عنصر
  • enum: ["year","month","day","hour","minute"]
thread.items[].post.publish_options.placestringاختياري / عنصر—
thread.items[].post.publish_options.feed_targetingobjectاختياري / عنصر
  • additionalProperties: {}
thread.items[].post.publish_options.feed_targeting.*any JSON valueاختياري / عنصر—
thread.items[].post.publish_options.targetingobjectاختياري / عنصر
  • additionalProperties: {}
thread.items[].post.publish_options.targeting.*any JSON valueاختياري / عنصر—
thread.items[].post.publish_options.child_attachmentsarrayاختياري / عنصر—
thread.items[].post.publish_options.child_attachments[]objectاختياري / عنصر
  • additionalProperties: {}
thread.items[].post.publish_options.child_attachments[].*any JSON valueاختياري / عنصر—
thread.items[].post.publish_options.multi_share_end_cardbooleanاختياري / عنصر—
thread.items[].post.publish_options.multi_share_optimizedbooleanاختياري / عنصر—
thread.items[].post.publish_options.unpublished_content_typestringاختياري / عنصر—
thread.items[].post.publish_options.no_storybooleanاختياري / عنصر—
thread.items[].post.publish_options.crossposted_video_idstringاختياري / عنصر—
thread.items[].post.publish_options.sphericalbooleanاختياري / عنصر—
thread.items[].post.scheduled_atstringمطلوب في العنصر الأب—
thread.items[].post.display_timezonestringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 80
thread.items[].post.local_scheduled_atstring | nullاختياري / عنصر—
thread.items[].post.local_scheduled_atanyOf 1stringاختياري / عنصر
  • pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
thread.items[].post.local_scheduled_atanyOf 2nullاختياري / عنصر—
thread.items[].post.schedule_timezonestring | nullاختياري / عنصر—
thread.items[].post.schedule_timezoneanyOf 1stringاختياري / عنصر
  • minLength: 1
  • maxLength: 80
thread.items[].post.schedule_timezoneanyOf 2nullاختياري / عنصر—
thread.items[].post.schedule_dst_disambiguationstring | nullاختياري / عنصر—
thread.items[].post.schedule_dst_disambiguationanyOf 1stringاختياري / عنصر
  • enum: ["exact","earlier","later"]
thread.items[].post.schedule_dst_disambiguationanyOf 2nullاختياري / عنصر—
thread.items[].post.schedule_intent_statestringاختياري / عنصر
  • enum: ["verified","legacy_unverified"]
thread.items[].post.expires_atstring | nullمطلوب في العنصر الأب—
thread.items[].post.statusstringمطلوب في العنصر الأب
  • enum: ["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]
thread.items[].post.versionintegerمطلوب في العنصر الأب
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
thread.items[].post.automatic_retry_enabledbooleanمطلوب في العنصر الأب—
thread.items[].post.delete_requested_atstring | nullمطلوب في العنصر الأب—
thread.items[].post.published_atstring | nullمطلوب في العنصر الأب—
thread.items[].post.deleted_atstring | nullمطلوب في العنصر الأب—
thread.items[].post.provider_post_idstring | nullمطلوب في العنصر الأب—
thread.items[].post.permalinkstring | nullمطلوب في العنصر الأب—
thread.items[].post.permalinkanyOf 1stringمطلوب في العنصر الأب
  • format: "uri"
thread.items[].post.permalinkanyOf 2nullمطلوب في العنصر الأب—
thread.items[].post.created_atstringمطلوب في العنصر الأب—
thread.items[].post.updated_atstringمطلوب في العنصر الأب—
thread.items[].post.project_idstring | nullمطلوب في العنصر الأب—
thread.items[].post.project_idanyOf 1stringمطلوب في العنصر الأب
  • format: "uuid"
thread.items[].post.project_idanyOf 2nullمطلوب في العنصر الأب—
thread.items[].post.batch_idstring | nullمطلوب في العنصر الأب—
thread.items[].post.batch_idanyOf 1stringمطلوب في العنصر الأب
  • format: "uuid"
thread.items[].post.batch_idanyOf 2nullمطلوب في العنصر الأب—
thread.items[].post.source_refobject | nullمطلوب في العنصر الأب—
thread.items[].post.source_refanyOf 1objectمطلوب في العنصر الأب
  • additionalProperties: {}
thread.items[].post.source_ref.*anyOf 1any JSON valueاختياري / عنصر—
thread.items[].post.source_refanyOf 2nullمطلوب في العنصر الأب—
thread.items[].retry_allowedbooleanمطلوب في العنصر الأب—
thread.expected_versionsobjectمطلوب في العنصر الأب
  • additionalProperties: {"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}
thread.expected_versions.*integerاختياري / عنصر
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
thread.actionsarrayمطلوب في العنصر الأب
  • minItems: 2
  • maxItems: 2
thread.actions[]objectاختياري / عنصر
  • additionalProperties: false
thread.actions[].actionstringمطلوب في العنصر الأب
  • enum: ["resume","cancel"]
thread.actions[].allowedbooleanمطلوب في العنصر الأب—
thread.actions[].reason_codestringمطلوب في العنصر الأب
  • enum: ["allowed","no_failed_items","resolution_required","retry_unavailable","terminal_state"]
thread.actions[].messagestringمطلوب في العنصر الأب—
dedupedbooleanاختياري / عنصر—
مخطط JSON Schema الكامل
{
  "type": "object",
  "properties": {
    "thread": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "workspace_id": {
          "type": "string",
          "format": "uuid"
        },
        "social_account_id": {
          "type": "string",
          "format": "uuid"
        },
        "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"
              },
              "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"
                  },
                  "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": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "account_label": {
                        "type": [
                          "string",
                          "null"
                        ]
                      }
                    },
                    "required": [
                      "social_account_id",
                      "platform",
                      "platform_user_id",
                      "account_label"
                    ],
                    "additionalProperties": false
                  },
                  "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"
                      ],
                      "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": {
                    "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"
                      },
                      {
                        "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
              },
              "retry_allowed": {
                "type": "boolean"
              }
            },
            "required": [
              "item_id",
              "ordinal",
              "predecessor_post_id",
              "post",
              "retry_allowed"
            ],
            "additionalProperties": false
          }
        },
        "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"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "id",
        "workspace_id",
        "social_account_id",
        "idempotency_key",
        "item_count",
        "created_at",
        "items",
        "expected_versions",
        "actions"
      ],
      "additionalProperties": false
    },
    "deduped": {
      "type": "boolean"
    }
  },
  "required": [
    "thread"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

مثال لاستدعاء أداة

تستخدم الأمثلة قيماً خيالية مفحوصة بالمخططات. استبدل المعرّفات بالمفوّض لك، والوسائط بأصول جاهزة، والتواريخ بوقت نشر مؤكد. افحص أهلية الحساب قبل الكتابة. لا تُرسل الصفحة طلبات API.

{
  "name": "sosoapi_resume_x_post_thread",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "id": "88888888-8888-4888-8888-888888888888",
    "expected_versions": {
      "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaa1": 2,
      "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaa2": 2
    },
    "scheduled_at": "2099-01-16T09:00:00Z"
  }
}

structuredContent

{
  "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": false,
        "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-16T09:00:00Z",
          "display_timezone": "UTC",
          "expires_at": null,
          "status": "scheduled",
          "version": 3,
          "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": false,
        "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-16T09:00:00Z",
          "display_timezone": "UTC",
          "expires_at": null,
          "status": "scheduled",
          "version": 3,
          "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": 3,
      "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaa2": 3
    },
    "actions": [
      {
        "action": "resume",
        "allowed": false,
        "reason_code": "no_failed_items",
        "message": "This example has no retryable failed items."
      },
      {
        "action": "cancel",
        "allowed": true,
        "reason_code": "allowed",
        "message": "Cancel the unpublished items in this fictional thread."
      }
    ]
  }
}
تثبيت MCP أو ربطه