Organization Membership

Organization Membership ist ein Datensatz, der angibt, mit welcher Berechtigung (role) eine Person zu welcher Organization gehört. Eine Person kann mehreren Organizations angehören, und die Berechtigung kann sich je Organization unterscheiden. Daher entspricht jede Kombination aus Person, Organisation und Berechtigung genau einer Organization Membership. Neue Mitglieder werden per E-Mail-Einladung hinzugefügt (siehe den Endpunkt Einladen (Erstellen) weiter unten). Sobald eine Einladung erstellt wird, tritt die Person mit der jeweiligen E-Mail-Adresse mit dieser role der Organization bei.

Die Liste der Organizations, denen Sie angehören, rufen Sie über GET /me/organization-memberships ab. Wenn Sie zusätzlich include=1 senden, enthält die Antwort auch die Details der referenzierten Organization.

Ressourcenstruktur

Im Folgenden sehen Sie die Antwort einer Einzelabfrage für eine Organization Membership. In sys (Systemattribute) sind die von dieser Mitgliedschaft referenzierte Person (user) und Organisation (organization) enthalten, und als Hauptkörperattribut die Berechtigung (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"
}

Wichtigste Schlüssel:

• organization: ein Refer<Organization>, das auf die Organization verweist, zu der diese Mitgliedschaft gehört.
• user: ein Refer<User>, das auf die Person dieser Mitgliedschaft verweist. Sobald die eingeladene Person beitritt, wird dieser Benutzer hier eingetragen.
• role: die Berechtigungsstufe, die diese Person in der Organization besitzt. Einer der Werte OWNER, ADMIN oder MEMBER.

Systemattribute (sys) und Hauptkörper

Jede Organization Membership führt gemeinsame Systemattribute im Objekt sys. organization, user, createdBy und updatedBy werden in der Refer-Form ({ "sys": { "id", "type": "Refer", "targetType" } }) abgelegt.

Hauptkörperattribute:

Die drei Werte von role bedeuten Folgendes:

• OWNER: die Eigentümerstufe der Organization.
• ADMIN: die Administratorstufe der Organization.
• MEMBER: die Stufe eines regulären Mitglieds der Organization.

Organization Membership ist eine Konfigurationsressource ohne Veröffentlichungskonzept. Anders als Content und Media besitzt sie deshalb in sys weder publish noch archive oder status, sondern nur version. version erhöht sich bei jeder Änderung der Mitgliedschaft.

API

Die Basis-URL aller folgenden Endpunkte ist https://cma.weegloo.com/v1, und im Header Authorization ist ein Bearer-Token zur CMA-Authentifizierung erforderlich. Für die Rollenänderung (PUT, PATCH) muss zur optimistischen Nebenläufigkeitskontrolle zusätzlich der Header X-Weegloo-Version (die sys.version der aktuellen Ressource) gesendet werden. Beim Einladen (Erstellen) und beim Löschen entfällt dieser Header.

Verwandte Dokumente

• Organization: die von dieser Mitgliedschaft referenzierte Organization.
• Space Membership: Mitglieder und Rollen auf Space-Ebene.