# تخصيص قائمة محتوى Threads

الرابط الأساسي: https://sosoapi.ai/ar/docs/mcp/allocate-threads-content-queue

`sosoapi_allocate_threads_content_queue`

قبول مسودة/موعد تمت معاينتهما؛ تُعاد المحاولة بنفس التغيير والمراجعة والبصمة. لا توجد تعبئة تلقائية.

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

الملفات التعريفية: full

وسائل النقل: stdio, http

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

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

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

```json
{
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}
```

`/studio-api/threads-content-queues/allocate` — agent:publish; قبول منشور معياري واحد لمسودة/موعد محددين بدقة؛ تظل نتيجة النشر النهائية المرجع المعتمد

## حقول الإدخال

```json
{
  "type": "object",
  "properties": {
    "workspace_id": {
      "$ref": "#/$defs/s1"
    },
    "id": {
      "$ref": "#/$defs/s1"
    },
    "expected_version": {
      "$ref": "#/$defs/s0"
    },
    "mutation_id": {
      "$ref": "#/$defs/s1"
    },
    "item_id": {
      "$ref": "#/$defs/s1"
    },
    "draft_revision": {
      "$ref": "#/$defs/s0"
    },
    "preview_digest": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$"
    }
  },
  "required": [
    "workspace_id",
    "id",
    "expected_version",
    "mutation_id",
    "item_id",
    "draft_revision",
    "preview_digest"
  ],
  "additionalProperties": false,
  "$defs": {
    "s0": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "s1": {
      "type": "string",
      "format": "uuid"
    }
  }
}
```

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

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

```json
{
  "type": "object",
  "properties": {
    "queue": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "workspace_id": {
          "type": "string",
          "format": "uuid"
        },
        "social_account_id": {
          "type": "string",
          "format": "uuid"
        },
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120
        },
        "display_timezone": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80
        },
        "weekly_slots": {
          "minItems": 1,
          "maxItems": 49,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "weekday": {
                "type": "integer",
                "minimum": 0,
                "maximum": 6
              },
              "local_time": {
                "type": "string",
                "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
              }
            },
            "required": [
              "weekday",
              "local_time"
            ],
            "additionalProperties": false
          }
        },
        "paused": {
          "type": "boolean"
        },
        "deleted": {
          "type": "boolean"
        },
        "version": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        "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"
        },
        "pending_items": {
          "maxItems": 50,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "item_id": {
                "type": "string",
                "format": "uuid"
              },
              "draft_id": {
                "type": "string",
                "format": "uuid"
              },
              "draft_revision": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              "current_revision": {
                "anyOf": [
                  {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "draft_state": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "draft",
                      "submitting",
                      "submitted"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "caption_preview": {
                "type": "string",
                "maxLength": 500
              }
            },
            "required": [
              "item_id",
              "draft_id",
              "draft_revision",
              "current_revision",
              "draft_state",
              "caption_preview"
            ],
            "additionalProperties": false
          }
        },
        "allocations": {
          "maxItems": 50,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "format": "uuid"
              },
              "item_id": {
                "type": "string",
                "format": "uuid"
              },
              "draft_id": {
                "type": "string",
                "format": "uuid"
              },
              "draft_revision": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              "mutation_id": {
                "type": "string",
                "format": "uuid"
              },
              "slot": {
                "type": "object",
                "properties": {
                  "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"
                  },
                  "local_date": {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  "local_time": {
                    "type": "string",
                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
                  },
                  "utc_offset_minutes": {
                    "type": "integer",
                    "minimum": -840,
                    "maximum": 840
                  },
                  "display_timezone": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 80
                  }
                },
                "required": [
                  "scheduled_at",
                  "local_date",
                  "local_time",
                  "utc_offset_minutes",
                  "display_timezone"
                ],
                "additionalProperties": false
              },
              "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}$"
              },
              "accepted_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": [
              "id",
              "item_id",
              "draft_id",
              "draft_revision",
              "mutation_id",
              "slot",
              "post_id",
              "accepted_at"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "id",
        "workspace_id",
        "social_account_id",
        "name",
        "display_timezone",
        "weekly_slots",
        "paused",
        "deleted",
        "version",
        "created_at",
        "updated_at",
        "pending_items",
        "allocations"
      ],
      "additionalProperties": false
    },
    "allocation": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "item_id": {
          "type": "string",
          "format": "uuid"
        },
        "draft_id": {
          "type": "string",
          "format": "uuid"
        },
        "draft_revision": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        "mutation_id": {
          "type": "string",
          "format": "uuid"
        },
        "slot": {
          "type": "object",
          "properties": {
            "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"
            },
            "local_date": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "local_time": {
              "type": "string",
              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
            },
            "utc_offset_minutes": {
              "type": "integer",
              "minimum": -840,
              "maximum": 840
            },
            "display_timezone": {
              "type": "string",
              "minLength": 1,
              "maxLength": 80
            }
          },
          "required": [
            "scheduled_at",
            "local_date",
            "local_time",
            "utc_offset_minutes",
            "display_timezone"
          ],
          "additionalProperties": false
        },
        "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}$"
        },
        "accepted_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": [
        "id",
        "item_id",
        "draft_id",
        "draft_revision",
        "mutation_id",
        "slot",
        "post_id",
        "accepted_at"
      ],
      "additionalProperties": false
    },
    "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"
        }
      ]
    },
    "replayed": {
      "type": "boolean"
    }
  },
  "required": [
    "queue",
    "allocation",
    "post",
    "replayed"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}
```

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

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

```json
{
  "name": "sosoapi_allocate_threads_content_queue",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "id": "44444444-4444-4444-8444-444444444444",
    "expected_version": 1,
    "mutation_id": "60000000-0000-4000-8000-000000000021",
    "item_id": "80000000-0000-4000-8000-000000000003",
    "draft_revision": 1,
    "preview_digest": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}
```

structuredContent

```json
{
  "queue": {
    "id": "44444444-4444-4444-8444-444444444444",
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "social_account_id": "22222222-2222-4222-8222-222222222222",
    "name": "Fictional weekly ideas",
    "display_timezone": "UTC",
    "weekly_slots": [
      {
        "weekday": 4,
        "local_time": "09:00"
      }
    ],
    "paused": false,
    "deleted": false,
    "version": 2,
    "created_at": "2099-01-14T09:00:00Z",
    "updated_at": "2099-01-14T09:00:00Z",
    "pending_items": [],
    "allocations": [
      {
        "id": "60000000-0000-4000-8000-000000000003",
        "item_id": "80000000-0000-4000-8000-000000000003",
        "draft_id": "70000000-0000-4000-8000-000000000003",
        "draft_revision": 1,
        "mutation_id": "60000000-0000-4000-8000-000000000021",
        "slot": {
          "scheduled_at": "2099-01-15T09:00:00Z",
          "local_date": "2099-01-15",
          "local_time": "09:00",
          "utc_offset_minutes": 0,
          "display_timezone": "UTC"
        },
        "post_id": "90000000-0000-4000-8000-000000000003",
        "accepted_at": "2099-01-14T09:00:00Z"
      }
    ]
  },
  "allocation": {
    "id": "60000000-0000-4000-8000-000000000003",
    "item_id": "80000000-0000-4000-8000-000000000003",
    "draft_id": "70000000-0000-4000-8000-000000000003",
    "draft_revision": 1,
    "mutation_id": "60000000-0000-4000-8000-000000000021",
    "slot": {
      "scheduled_at": "2099-01-15T09:00:00Z",
      "local_date": "2099-01-15",
      "local_time": "09:00",
      "utc_offset_minutes": 0,
      "display_timezone": "UTC"
    },
    "post_id": "90000000-0000-4000-8000-000000000003",
    "accepted_at": "2099-01-14T09:00:00Z"
  },
  "post": {
    "id": "90000000-0000-4000-8000-000000000003",
    "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": "scheduled",
    "version": 1,
    "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-000000000003",
    "source_ref": null,
    "created_at": "2099-01-14T09:00:00Z",
    "updated_at": "2099-01-14T09:00:00Z"
  },
  "replayed": false
}
```

## عمليات API الأساسية

- [/studio-api/threads-content-queues/allocate](https://sosoapi.ai/ar/docs/api/studio-api-threads-content-queues-allocate)