# جلب سلسلة Threads الرابط الأساسي: https://sosoapi.ai/ar/docs/mcp/get-threads-sequence `sosoapi_get_threads_sequence` إعادة فتح سلسلة Threads بمعرّفها مع مراجعات المسودات ونتائج المنشورات والإجراءات المسموحة. ## الملفات التعريفية ووسائل النقل الملفات التعريفية: full وسائل النقل: stdio, http اختر core أو full للأدوات التي يراها عميلك؛ لا يغيّر ذلك أذوناته. يحتاج رفع الملفات المحلية stdio ولا يتاح بـ HTTP. اضبط SOSOAPI_OUTPUT_SCHEMAS=1 لمخططات المخرجات بالاكتشاف. النتائج منظّمة بهذا الإعداد أوبدونه. ## الأذونات والآثار الجانبية تساعد الشروح العملاء على وصف الأداة. يظل كل استدعاء يفحص مصادقة المستخدم ودوره ووصوله إلى المورد وتفويض الإمكانات. ```json { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } ``` `/studio-api/threads-sequences/get` — agent:operate; مراجعات مسودات تحريرية محفوظة أو معاينة سلسلة للقراءة فقط؛ دون كتابة لدى المزوّد ## حقول الإدخال ```json { "type": "object", "properties": { "workspace_id": { "type": "string", "format": "uuid" }, "id": { "type": "string", "format": "uuid" } }, "required": [ "workspace_id", "id" ], "additionalProperties": false } ``` ## مخرجات منظّمة يصف المخطط structuredContent في نتيجة أداة ناجحة. تشمل استجابة MCP أيضاً content وقد تضبط isError عند الفشل. للنشر، اقرأ النتيجة النهائية بدلاً من اعتبار القبول أوالنص تأكيداً. تشرح عملية API المرتبطة الأذونات وقواعد المحاولة. ```json { "type": "object", "properties": { "sequence": { "type": "object", "properties": { "workspace_id": { "type": "string", "format": "uuid" }, "id": { "type": "string", "format": "uuid" }, "social_account_id": { "type": "string", "format": "uuid" }, "version": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "state": { "type": "string", "enum": [ "draft", "admitted", "cancelled" ] }, "item_count": { "type": "integer", "minimum": 2, "maximum": 25 }, "caption_preview": { "type": "string", "maxLength": 500 }, "created_at": { "type": "string", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "format": "date-time" }, "updated_at": { "type": "string", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "format": "date-time" }, "items": { "minItems": 2, "maxItems": 25, "type": "array", "items": { "type": "object", "properties": { "item_id": { "type": "string", "format": "uuid" }, "ordinal": { "type": "integer", "minimum": 1, "maximum": 25 }, "draft": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "state": { "type": "string", "enum": [ "draft", "submitting", "submitted" ] }, "content": { "type": "object", "properties": { "schemaVersion": { "default": 1, "type": "number", "const": 1 }, "accountIds": { "default": [], "maxItems": 50, "type": "array", "items": { "type": "string", "format": "uuid" } }, "caption": { "default": "", "type": "string", "maxLength": 5000 }, "hashtags": { "default": "", "type": "string", "maxLength": 5000 }, "assetIds": { "default": [], "maxItems": 20, "type": "array", "items": { "type": "string", "maxLength": 16, "pattern": "^[1-9][0-9]*$" } }, "threadsTextOnly": { "default": false, "type": "boolean" }, "threadsOptions": { "type": "object", "properties": { "post_type": { "type": "string", "enum": [ "TEXT", "IMAGE", "VIDEO", "CAROUSEL", "REPOST" ] }, "reply_to_id": { "type": "string", "maxLength": 128 }, "quote_post_id": { "type": "string", "maxLength": 128 }, "repost_target_id": { "type": "string", "maxLength": 128 }, "reply_control": { "type": "string", "enum": [ "everyone", "accounts_you_follow", "mentioned_only", "parent_post_author_only", "followers_only" ] }, "enable_reply_approvals": { "type": "boolean" }, "link_attachment": { "type": "string", "maxLength": 2048 }, "poll_attachment": { "type": "object", "properties": { "option_a": { "type": "string", "maxLength": 25 }, "option_b": { "type": "string", "maxLength": 25 }, "option_c": { "type": "string", "maxLength": 25 }, "option_d": { "type": "string", "maxLength": 25 } }, "required": [ "option_a", "option_b" ], "additionalProperties": false }, "gif_attachment": { "type": "object", "properties": { "gif_id": { "type": "string", "maxLength": 128 }, "provider": { "type": "string", "const": "GIPHY" } }, "required": [ "gif_id", "provider" ], "additionalProperties": false }, "text_attachment": { "type": "object", "properties": { "plaintext": { "type": "string", "maxLength": 10000 }, "link_attachment_url": { "type": "string", "maxLength": 2048 }, "text_with_styling_info": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "offset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "length": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "styling_info": { "minItems": 1, "type": "array", "items": { "type": "string", "enum": [ "bold", "italic", "highlight", "underline", "strikethrough" ] } } }, "required": [ "offset", "length", "styling_info" ], "additionalProperties": false } } }, "required": [ "plaintext" ], "additionalProperties": false }, "topic_tag": { "type": "string", "maxLength": 50 }, "text_entities": { "maxItems": 10, "type": "array", "items": { "type": "object", "properties": { "entity_type": { "type": "string", "enum": [ "SPOILER", "spoiler" ] }, "offset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "length": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "entity_type", "offset", "length" ], "additionalProperties": false } }, "is_spoiler_media": { "type": "boolean" }, "is_ghost_post": { "type": "boolean" }, "location_id": { "type": "string", "maxLength": 128 }, "allowlisted_country_codes": { "minItems": 1, "maxItems": 249, "type": "array", "items": { "type": "string", "pattern": "^[A-Z]{2}$" } }, "crossreshare_to_ig": { "type": "boolean" }, "crossreshare_to_ig_dark_mode": { "type": "boolean" }, "auto_publish_text": { "type": "boolean" }, "media_options": { "maxItems": 20, "type": "array", "items": { "type": "object", "properties": { "asset_id": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "alt_text": { "type": "string", "minLength": 1, "maxLength": 1000 }, "is_spoiler_media": { "type": "boolean" } }, "required": [ "asset_id" ], "additionalProperties": false } } }, "additionalProperties": false }, "instagramMode": { "default": "REELS", "type": "string", "enum": [ "IMAGE", "REELS", "CAROUSEL", "STORY_IMAGE", "STORY_VIDEO" ] }, "youtubeTitle": { "default": "", "type": "string", "maxLength": 100 }, "youtubePrivacy": { "default": "private", "type": "string", "enum": [ "private", "unlisted", "public" ] }, "youtubeSynthetic": { "default": false, "type": "boolean" }, "youtubeCategoryId": { "default": "", "type": "string", "maxLength": 32 }, "youtubeShort": { "default": false, "type": "boolean" }, "linkUrl": { "default": "", "type": "string", "maxLength": 2048 }, "scheduledAt": { "default": "", "type": "string", "maxLength": 64 }, "displayTimezone": { "default": "UTC", "type": "string", "minLength": 1, "maxLength": 128 }, "publishNow": { "default": false, "type": "boolean" }, "destinationOverrides": { "default": {}, "type": "object", "propertyNames": { "type": "string", "format": "uuid" }, "additionalProperties": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 5000 }, "scheduledAt": { "type": "string", "maxLength": 64 } }, "additionalProperties": false } }, "expiresAt": { "default": "", "type": "string", "maxLength": 64 } }, "required": [ "schemaVersion", "accountIds", "caption", "hashtags", "assetIds", "threadsTextOnly", "instagramMode", "youtubeTitle", "youtubePrivacy", "youtubeSynthetic", "youtubeCategoryId", "youtubeShort", "linkUrl", "scheduledAt", "displayTimezone", "publishNow", "destinationOverrides", "expiresAt" ], "additionalProperties": false }, "created_by": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "updated_by": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "created_at": { "type": "string", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "format": "date-time" }, "updated_at": { "type": "string", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "format": "date-time" }, "submission": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "expected_revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "started_at": { "type": "string", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "format": "date-time" }, "receipt": { "anyOf": [ { "type": "object", "properties": { "batch_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "successes": { "maxItems": 50, "type": "array", "items": { "type": "object", "properties": { "social_account_id": { "type": "string", "format": "uuid" }, "post_id": { "type": "string", "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$" } }, "required": [ "social_account_id", "post_id" ], "additionalProperties": false } }, "failures": { "maxItems": 50, "type": "array", "items": { "type": "object", "properties": { "social_account_id": { "type": "string", "format": "uuid" }, "code": { "type": "string", "minLength": 1, "maxLength": 160 }, "message": { "type": "string", "maxLength": 2000 } }, "required": [ "social_account_id", "code", "message" ], "additionalProperties": false } } }, "required": [ "batch_id", "successes", "failures" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "id", "expected_revision", "started_at", "receipt" ], "additionalProperties": false }, { "type": "null" } ] }, "brand_context": { "anyOf": [ { "type": "object", "properties": { "workspace_id": { "type": "string", "format": "uuid" }, "selection": { "type": "object", "properties": { "profile_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "content_digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "context_digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "profile_id", "version_id", "revision", "content_digest", "context_digest" ], "additionalProperties": false }, "availability": { "type": "string", "enum": [ "available", "missing" ] }, "profile_state": { "anyOf": [ { "type": "string", "enum": [ "active", "archived" ] }, { "type": "null" } ] }, "content": { "anyOf": [ { "type": "object", "properties": { "name": { "type": "string", "maxLength": 120 }, "audience": { "type": "string", "maxLength": 2000 }, "voice": { "type": "string", "maxLength": 2000 }, "language": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 64 }, { "type": "null" } ] }, "preferred_terms": { "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 120 } }, "prohibited_terms": { "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 120 } }, "locked_facts": { "maxItems": 50, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 500 } }, "call_to_action": { "anyOf": [ { "type": "string", "maxLength": 1000 }, { "type": "null" } ] } }, "required": [ "name", "audience", "voice", "language", "preferred_terms", "prohibited_terms", "locked_facts", "call_to_action" ], "additionalProperties": false }, { "type": "null" } ] }, "sources": { "type": "object", "properties": { "website": { "type": "string", "enum": [ "available", "not_available" ] }, "logo": { "type": "string", "enum": [ "none", "present", "missing" ] }, "own_posts": { "type": "object", "properties": { "selected": { "type": "integer", "minimum": 0, "maximum": 10 }, "available": { "type": "integer", "minimum": 0, "maximum": 10 }, "unavailable": { "type": "integer", "minimum": 0, "maximum": 10 }, "erased": { "type": "integer", "minimum": 0, "maximum": 10 } }, "required": [ "selected", "available", "unavailable", "erased" ], "additionalProperties": false } }, "required": [ "website", "logo", "own_posts" ], "additionalProperties": false } }, "required": [ "workspace_id", "selection", "availability", "profile_state", "content", "sources" ], "additionalProperties": false }, { "type": "null" } ] }, "brand_review": { "anyOf": [ { "type": "object", "properties": { "rule_version": { "type": "number", "const": 1 }, "context_digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "content_digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "status": { "type": "string", "enum": [ "clear", "attention", "unavailable" ] }, "issues": { "maxItems": 5151, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "prohibited_term", "locked_fact_missing", "conflicting_rule", "context_unavailable" ] }, "target": { "type": "string", "minLength": 1, "maxLength": 80 }, "rule_index": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 49 }, { "type": "null" } ] }, "message": { "type": "string", "minLength": 1, "maxLength": 240 } }, "required": [ "code", "target", "rule_index", "message" ], "additionalProperties": false } } }, "required": [ "rule_version", "context_digest", "content_digest", "status", "issues" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "id", "workspace_id", "revision", "state", "content", "created_by", "updated_by", "created_at", "updated_at", "submission" ], "additionalProperties": false }, "predecessor_post_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "post": { "anyOf": [ { "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" ] }, "deletion": { "type": "object", "properties": { "state": { "type": "string", "enum": [ "pending", "retry_scheduled", "failed", "unconfirmed", "confirmed", "unpublished_cancelled" ] }, "retry_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": [ "state", "retry_at" ], "additionalProperties": false }, "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 }, { "type": "null" } ] }, "retry_allowed": { "type": "boolean" } }, "required": [ "item_id", "ordinal", "draft", "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", "minLength": 1, "maxLength": 80 }, "message": { "type": "string", "maxLength": 1000 } }, "required": [ "action", "allowed", "reason_code", "message" ], "additionalProperties": false } } }, "required": [ "workspace_id", "id", "social_account_id", "version", "state", "item_count", "caption_preview", "created_at", "updated_at", "items", "expected_versions", "actions" ], "additionalProperties": false }, "replayed": { "type": "boolean" } }, "required": [ "sequence" ], "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false } ``` ## مثال لاستدعاء أداة تستخدم الأمثلة قيماً خيالية مفحوصة بالمخططات. استبدل المعرّفات بالمفوّض لك، والوسائط بأصول جاهزة، والتواريخ بوقت نشر مؤكد. افحص أهلية الحساب قبل الكتابة. لا تُرسل الصفحة طلبات API. ```json { "name": "sosoapi_get_threads_sequence", "arguments": { "workspace_id": "11111111-1111-4111-8111-111111111111", "id": "33333333-3333-4333-8333-333333333333" } } ``` structuredContent ```json { "sequence": { "id": "33333333-3333-4333-8333-333333333333", "workspace_id": "11111111-1111-4111-8111-111111111111", "social_account_id": "22222222-2222-4222-8222-222222222222", "version": 2, "state": "admitted", "item_count": 2, "caption_preview": "A fictional announcement.", "created_at": "2099-01-14T09:00:00Z", "updated_at": "2099-01-14T09:00:00Z", "items": [ { "item_id": "80000000-0000-4000-8000-000000000001", "ordinal": 1, "draft": { "id": "70000000-0000-4000-8000-000000000001", "workspace_id": "11111111-1111-4111-8111-111111111111", "revision": 3, "state": "submitted", "content": { "schemaVersion": 1, "accountIds": [ "22222222-2222-4222-8222-222222222222" ], "caption": "A fictional announcement.", "hashtags": "", "assetIds": [], "threadsTextOnly": false, "threadsOptions": { "post_type": "TEXT" }, "instagramMode": "REELS", "youtubeTitle": "", "youtubePrivacy": "private", "youtubeSynthetic": false, "youtubeCategoryId": "", "youtubeShort": false, "linkUrl": "", "scheduledAt": "2099-01-15T09:00:00Z", "displayTimezone": "UTC", "publishNow": false, "destinationOverrides": {}, "expiresAt": "" }, "created_by": null, "updated_by": null, "created_at": "2099-01-14T09:00:00Z", "updated_at": "2099-01-14T09:00:00Z", "submission": { "id": "60000000-0000-4000-8000-000000000031", "expected_revision": 1, "started_at": "2099-01-14T09:00:00Z", "receipt": { "batch_id": "50000000-0000-4000-8000-000000000001", "successes": [ { "social_account_id": "22222222-2222-4222-8222-222222222222", "post_id": "90000000-0000-4000-8000-000000000001" } ], "failures": [] } } }, "predecessor_post_id": null, "post": { "id": "90000000-0000-4000-8000-000000000001", "workspace_id": "11111111-1111-4111-8111-111111111111", "social_account_id": "22222222-2222-4222-8222-222222222222", "platform": "threads", "destination": { "social_account_id": "22222222-2222-4222-8222-222222222222", "platform": "threads", "platform_user_id": "12345", "account_label": "Fictional Threads account" }, "caption": "A 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": "50000000-0000-4000-8000-000000000001", "source_ref": null, "created_at": "2099-01-14T09:00:00Z", "updated_at": "2099-01-14T09:00:00Z" }, "retry_allowed": true }, { "item_id": "80000000-0000-4000-8000-000000000002", "ordinal": 2, "draft": { "id": "70000000-0000-4000-8000-000000000002", "workspace_id": "11111111-1111-4111-8111-111111111111", "revision": 3, "state": "submitted", "content": { "schemaVersion": 1, "accountIds": [ "22222222-2222-4222-8222-222222222222" ], "caption": "A fictional first reply.", "hashtags": "", "assetIds": [], "threadsTextOnly": false, "threadsOptions": { "post_type": "TEXT" }, "instagramMode": "REELS", "youtubeTitle": "", "youtubePrivacy": "private", "youtubeSynthetic": false, "youtubeCategoryId": "", "youtubeShort": false, "linkUrl": "", "scheduledAt": "2099-01-15T09:00:00Z", "displayTimezone": "UTC", "publishNow": false, "destinationOverrides": {}, "expiresAt": "" }, "created_by": null, "updated_by": null, "created_at": "2099-01-14T09:00:00Z", "updated_at": "2099-01-14T09:00:00Z", "submission": { "id": "60000000-0000-4000-8000-000000000032", "expected_revision": 1, "started_at": "2099-01-14T09:00:00Z", "receipt": { "batch_id": "50000000-0000-4000-8000-000000000002", "successes": [ { "social_account_id": "22222222-2222-4222-8222-222222222222", "post_id": "90000000-0000-4000-8000-000000000002" } ], "failures": [] } } }, "predecessor_post_id": "90000000-0000-4000-8000-000000000001", "post": { "id": "90000000-0000-4000-8000-000000000002", "workspace_id": "11111111-1111-4111-8111-111111111111", "social_account_id": "22222222-2222-4222-8222-222222222222", "platform": "threads", "destination": { "social_account_id": "22222222-2222-4222-8222-222222222222", "platform": "threads", "platform_user_id": "12345", "account_label": "Fictional Threads account" }, "caption": "A fictional first reply.", "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": "50000000-0000-4000-8000-000000000002", "source_ref": null, "created_at": "2099-01-14T09:00:00Z", "updated_at": "2099-01-14T09:00:00Z" }, "retry_allowed": true } ], "expected_versions": { "90000000-0000-4000-8000-000000000001": 2, "90000000-0000-4000-8000-000000000002": 2 }, "actions": [ { "action": "resume", "allowed": true, "reason_code": "allowed", "message": "Fictional pre-provider failure; resume requires the current server decision and reply capability." }, { "action": "cancel", "allowed": true, "reason_code": "allowed", "message": "Only unsent items can be cancelled; published content stays in place." } ] }, "replayed": false } ``` ## عمليات API الأساسية - [/studio-api/threads-sequences/get](https://sosoapi.ai/ar/docs/api/studio-api-threads-sequences-get)