मुख्य सामग्री पर जाएं
POST
वर्कस्पेस में सदस्य जोड़ें
इस एंडपॉइंट के लिए workspaces:write वाली प्रबंधन API कुंजी और मालिक या एडमिन भूमिका आवश्यक है।
लोग आमंत्रण के ज़रिए वर्कस्पेस से जुड़ते हैं: वे उसे स्वीकार करते हैं, जिससे जुड़ने का अनुरोध बनता है, और यह एंडपॉइंट उसे स्वीकृत करता है। 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 में फिर भी बताया जाता है कि किसे जोड़ा गया।

अंतिम संशोधन 16 नवंबर 2026