Organization Membership

Organization Membership एक रिकॉर्ड है जो दर्शाता है कि कोई व्यक्ति किसी Organization में किस अधिकार (role) के साथ शामिल है। एक व्यक्ति कई Organization में शामिल हो सकता है, और हर Organization में उसका अधिकार अलग हो सकता है, इसलिए व्यक्ति, संगठन और अधिकार का हर एक संयोजन एक Organization Membership से मेल खाता है। नए सदस्य को ईमेल के ज़रिए आमंत्रित करके जोड़ा जाता है (नीचे दिया गया आमंत्रण (निर्माण) endpoint)। आमंत्रण बनाने पर उस ईमेल का व्यक्ति उस role के साथ Organization में शामिल हो जाता है।

मैं जिन Organization में शामिल हूँ उनकी सूची GET /me/organization-memberships से प्राप्त की जाती है। साथ में include=1 भेजने पर जिस Organization की ओर इशारा किया गया है उसका विवरण भी प्रतिक्रिया में शामिल होता है।

संसाधन संरचना

नीचे एक Organization Membership की एकल पुनर्प्राप्ति प्रतिक्रिया दी गई है। sys (सिस्टम विशेषताएँ) में इस membership द्वारा इंगित व्यक्ति (user) और संगठन (organization) आते हैं, और मुख्य विशेषता के रूप में अधिकार (role) होता है।

{
  "sys": {
    "id": "3trmXRL6dW1QKblBXOc8nXAVz4kPXd",
    "type": "OrganizationMembership",
    "organization": { "sys": { "id": "ilLRJxDp", "type": "Refer", "targetType": "Organization" } },
    "user": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-05-11T10:51:16.841Z",
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "updatedAt": "2026-05-11T10:51:16.841Z",
    "version": 1
  },
  "role": "OWNER"
}

मुख्य keys:

• organization: इस membership से संबंधित Organization की ओर इशारा करने वाला Refer<Organization> है।
• user: इस membership के व्यक्ति की ओर इशारा करने वाला Refer<User> है। आमंत्रित व्यक्ति के शामिल होने पर वही उपयोगकर्ता यहाँ जुड़ जाता है।
• role: इस व्यक्ति का Organization में अधिकार स्तर है। OWNER, ADMIN, MEMBER में से एक होता है।

सिस्टम विशेषताएँ (sys) और मुख्य भाग

हर Organization Membership सामान्य सिस्टम विशेषताओं को sys ऑब्जेक्ट में रखता है। organization, user, createdBy, updatedBy Refer आकार ({ "sys": { "id", "type": "Refer", "targetType" } }) में आते हैं।

मुख्य विशेषता:

role के तीन मानों का अर्थ इस प्रकार है।

• OWNER: Organization का स्वामी स्तर है।
• ADMIN: Organization का प्रशासक स्तर है।
• MEMBER: Organization का सामान्य सदस्य स्तर है।

Organization Membership एक सेटिंग संसाधन है जिसमें प्रकाशन की अवधारणा नहीं होती। इसलिए Content, Media के विपरीत sys में publish, archive, status नहीं होते, केवल version होता है। version membership के हर संशोधन पर बढ़ता है।

API

नीचे दिए गए सभी endpoints का आधार URL https://cma.weegloo.com/v1 है, और Authorization हेडर में CMA को प्रमाणित करने वाला Bearer टोकन आवश्यक है। भूमिका संशोधन (PUT, PATCH) के लिए आशावादी समवर्तीयता नियंत्रण हेतु X-Weegloo-Version हेडर (संसाधन का वर्तमान sys.version) भी भेजना होता है। आमंत्रण (निर्माण) और विलोपन में यह हेडर नहीं होता।

संबंधित दस्तावेज़

• Organization: इस membership द्वारा इंगित Organization।
• Space Membership: Space स्तर के सदस्य और भूमिकाएँ।