Organization Membership
Terakhir diperbarui: 22 Juni 2026
Organization Membership adalah catatan yang menunjukkan seseorang termasuk dalam suatu Organization dengan peran (role) apa. Satu orang bisa termasuk dalam beberapa Organization, dan perannya bisa berbeda pada setiap Organization, sehingga satu kombinasi orang, organisasi, dan peran berpadanan dengan satu Organization Membership. Anggota baru ditambahkan dengan mengundang lewat email (lihat endpoint Undang (buat) di bawah). Saat undangan dibuat, orang dengan email tersebut bergabung ke Organization dengan role itu.
Daftar Organization yang Anda ikuti dapat diperoleh lewat GET /me/organization-memberships. Jika Anda mengirim include=1, detail Organization yang dirujuk juga disertakan dalam respons.
Struktur resource
Berikut adalah respons pengambilan tunggal satu Organization Membership. sys (properti sistem) memuat orang (user) dan organisasi (organization) yang dirujuk keanggotaan ini, sedangkan properti bodinya memuat peran (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"
}Kunci utama:
organization:Refer<Organization>yang menunjuk ke Organization tempat keanggotaan ini berada.user:Refer<User>yang menunjuk ke orang dari keanggotaan ini. Saat orang yang diundang bergabung, pengguna itulah yang terikat di sini.role: tingkat peran yang dimiliki orang ini di Organization. Salah satu dariOWNER,ADMIN, atauMEMBER.
Properti sistem (sys) dan bodi
Setiap Organization Membership menyimpan properti sistem bersama dalam objek sys. organization, user, createdBy, dan updatedBy dimuat dalam bentuk Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).
| Properti | Tipe | Keterangan |
|---|---|---|
id | string | Pengidentifikasi unik resource. |
type | string | Jenis resource. Organization Membership selalu "OrganizationMembership". |
organization | Refer<Organization> | Organization tempat keanggotaan ini berada. |
user | Refer<User> | Orang dari keanggotaan ini. |
createdBy | Refer<User> | Pengguna yang membuat. |
createdAt | string (date-time) | Waktu pembuatan. |
updatedBy | Refer<User> | Pengguna yang terakhir mengubah. |
updatedAt | string (date-time) | Waktu perubahan terakhir. |
version | integer (≥1) | Versi resource. Naik 1 setiap kali diubah. |
Properti bodi:
| Properti | Tipe | Keterangan |
|---|---|---|
role | string (enum) | Tingkat peran anggota. Salah satu dari OWNER, ADMIN, atau MEMBER. |
Ketiga nilai role berarti sebagai berikut.
OWNER: tingkat pemilik Organization.ADMIN: tingkat administrator Organization.MEMBER: tingkat anggota umum Organization.
Organization Membership adalah resource pengaturan yang tidak memiliki konsep publikasi. Karena itu, berbeda dengan Content dan Media, sys-nya tidak memiliki publish, archive, atau status, dan hanya memiliki version. version naik setiap kali keanggotaan diubah.
API
Base URL untuk semua endpoint di bawah adalah https://cma.weegloo.com/v1, dan diperlukan Bearer token yang mengautentikasi CMA pada header Authorization. Untuk mengubah peran (PUT, PATCH), Anda harus turut mengirim header X-Weegloo-Version (yaitu sys.version resource saat ini) demi kontrol konkurensi optimistik. Undangan (pembuatan) dan penghapusan tidak memerlukan header ini.
Dokumen terkait
- Organization: Organization yang dirujuk keanggotaan ini.
- Space Membership: anggota dan peran dalam lingkup Space.
