सदस्य की भूमिका बदलें
केवल भूमिका और कुछ नहीं। पते दूसरा अक्ष हैं और उनकी अपनी कॉल हैं।
असली कॉल आपकी अपनी कुंजी से आपके वर्कस्पेस पर चलाता है।
PATCH /members/{userId}
केवल भूमिका और कुछ नहीं। पते दूसरा अक्ष हैं और उनकी अपनी कॉल हैं।
उदाहरण
members:write चाहिए। roleId इकलौता फ़ील्ड है, और वह आवश्यक है। यह कॉल लागू किए जाने वाले बदलाव के बजाय वांछित स्थिति बताती है, इसलिए इसे दो बार भेजने पर वही व्यक्ति वही भूमिका लिए रहता है।
curl -X PATCH "$OE/members/7fQ2mN8vBz1aRd4tYwKx7fQ2mN8vBz1a" -H "$AUTH" \ -H "Content-Type: application/json" \ -d '{ "roleId": "role_2b81de079c1f0a4b7e05d386" }'{ "object": "member", "userId": "7fQ2mN8vBz1aRd4tYwKx7fQ2mN8vBz1a", "email": "[email protected]", "name": null, "image": null, "role": { "id": "role_2b81de079c1f0a4b7e05d386", "name": "Support", "builtin": null }, "implied": false, "permissions": [ "emails:send", "emails:read", "threads:read", "threads:write", "labels:read", "labels:write", "contacts:read" ], "addresses": [ { "addressId": "c40a95f2-1cc6-4d31-82a8-9e075d31c2a8", "address": "[email protected]", "access": "viewer" } ], "createdAt": "2026-08-30T15:44:02.000Z"}पते यहाँ से patch नहीं किए जा सकते, और यह चूक जानबूझकर है: वे प्रति-तत्व एक्सेस स्तर वाला समुच्चय हैं, और array लिए हुए PATCH का मतलब पूरा-बदलो होता, जो हर बार क्लाइंट के पुरानी सूची भेजने पर चुपचाप सामूहिक निरस्तीकरण बन जाता। दोनों पता-कॉल एक बार में एक ही जोड़ती और हटाती हैं, इसलिए जो हुआ वह हमेशा वही होता है जो माँगा गया था।
पुराने ग्रांट-धारक का implied होना इसी तरह खत्म होता है: उनकी कोई सदस्य-row नहीं होती, यह एक बना देता है, और उसके बाद उनकी अनुमतियाँ वही होती हैं जो किसी ने चुनीं, न कि वे जो उनके पता-एक्सेस से अनुमानित हुईं। ऊपर के रिस्पॉन्स में implied का false होना और createdAt का प्रकट होना देखें। उनके पतों में कुछ नहीं बदलता।
मालिक की भूमिका किसी को नहीं दी जा सकती (role_immutable, एक 409), चाहे कॉल करने वाला कुछ भी रखता हो। किसी को मालिक बनाना वर्कस्पेस हस्तांतरण है, जिसके परिणाम अलग हैं और जो इस API पर मौजूद नहीं है।
उनकी नई भूमिका उनके अगले अनुरोध पर प्रभावी होती है, और उससे सीमित हर API कुंजी के अगले अनुरोध पर भी।