الانتقال إلى المحتوى الرئيسي
POST
إضافة أعضاء إلى مساحة العمل
تتطلب نقطة النهاية هذه مفتاح API للإدارة يتضمن workspaces:write ودور مالك أو مسؤول.
ينضم الأشخاص إلى مساحة العمل عبر دعوة: يقبلونها، فيُنشأ طلب انضمام، وتوافق نقطة النهاية هذه عليه. يجب أن يكون لكل مستخدم في user_ids طلب انضمام معلّق في مساحة العمل. يُرفض المستخدمون الآخرون، لذا أرسل إليهم دعوة أولًا. يحتفظ الأعضاء الحاليون بأدوارهم. يمكن أن يكون الدور admin أو member. إذا لم يُحدَّد دور، يحصل كل شخص على الدور الذي أُنشئت به دعوته. وحده مالك مساحة العمل يمكنه إضافة مسؤولين، ولا يمكن تعيين ملكية مساحة العمل من خلال نقطة النهاية هذه. تتم الموافقة على كل شخص على حدة. إذا فشلت إحدى الموافقات، يبقى من تمت الموافقة عليهم قبلها في مساحة العمل، ولا تتم محاولة الباقين. تكون الاستجابة عندها 409، وتوضح قوائم approved وfailed وnot_attempted فيها أين توقفت العملية، لتتمكن من إصلاح المشكلة وإرسال المستخدمين المتبقين مجددًا.

التفويضات

Authorization
string
header
مطلوب

المصادقة باستخدام رمز Bearer

معلمات المسار

id
string
مطلوب

UUID أو slug مساحة العمل.

الجسم

application/json
user_ids
string[]
مطلوب
Required array length: 1 - 100 elements
role
enum<string>
الخيارات المتاحة:
admin,
member

الاستجابة

تمت إضافة الأعضاء

added_count
integer
مطلوب
النطاق المطلوب: x >= 0
approved
string[]
مطلوب

المستخدمون الذين أضافهم هذا الطلب، بترتيب الموافقة عليهم.

failed
object[]
مطلوب

المستخدم الذي فشلت الموافقة عليه، مع السبب. لا تتم محاولة المستخدمين الذين يلونه.

not_attempted
string[]
مطلوب

المستخدمون الذين لم تتم محاولتهم لأن موافقة سابقة فشلت. تبقى طلبات انضمامهم معلّقة.

error
string
message
string
data
object[]

تفاصيل الأعضاء المضافين. تُحذف إذا تعذّرت قراءتها بعد الموافقات؛ ويظل approved يسرد من أُضيف.

آخر تعديل في ١٦ نوفمبر ٢٠٢٦