Space Membership

Space Membership ist ein Datensatz, der angibt, mit welchen SpaceRoles ein Benutzer zu welchem Space gehört. Da ein Benutzer mehreren Spaces angehören und in jedem Space unterschiedliche Berechtigungen haben kann, entspricht jede Kombination aus Benutzer, Space und Berechtigung genau einer Space Membership. Anders als Organization Membership, das neue Personen per E-Mail-Einladung aufnimmt, fügt Space Membership einen bereits vorhandenen Benutzer über eine user-Referenz hinzu und vergibt Berechtigungen über roles (ein Array von SpaceRole-Referenzen). Es handelt sich nicht um eine E-Mail-Einladung.

Die Liste der Spaces, denen Sie angehören, fragen Sie über GET /me/space-memberships ab. Wenn Sie zusätzlich include=1 senden, enthält die Antwort auch die Details des referenzierten Space.

Ressourcenstruktur

Im Folgenden sehen Sie die Antwort einer Einzelabfrage für eine Space Membership. In sys (Systemeigenschaften) stehen der Benutzer (user) und der Space (space), auf die diese Membership verweist; als Body-Eigenschaft enthält sie das Berechtigungsbündel (roles).

{
  "sys": {
    "id": "3trmXRLdJF4GBlAjtcuoWfVunfJ8uV",
    "type": "SpaceMembership",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "user": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-06-14T14:56:04.737Z",
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "updatedAt": "2026-06-14T14:56:04.737Z",
    "version": 1
  },
  "roles": [
    { "sys": { "id": "3trmXRLdJF4GBlAjtcuoWfVubsasp4", "type": "Refer", "targetType": "SpaceRole" } }
  ]
}

Wichtige Schlüssel:

• space: Ein Refer<Space>, der auf den Space verweist, zu dem diese Membership gehört.
• user: Ein Refer<User>, der auf den Benutzer dieser Membership verweist. Der als Mitglied hinzugefügte Benutzer ist hier verknüpft.
• roles: Das Berechtigungsbündel, das dieser Benutzer im Space besitzt. Es handelt sich um ein Array von Refer<SpaceRole>, das auf SpaceRoles verweist; ein Mitglied kann mehrere SpaceRoles gleichzeitig besitzen.

Systemeigenschaften (sys) und Body

Jede Space Membership enthält die gemeinsamen Systemeigenschaften im sys-Objekt. space, user, createdBy und updatedBy liegen in der Refer-Form vor ({ "sys": { "id", "type": "Refer", "targetType" } }).

Body-Eigenschaften:

Space Membership ist eine Konfigurationsressource ohne Veröffentlichungskonzept. Daher hat sie, anders als Content und Media, in sys weder publish noch archive oder status, sondern nur version. version steigt bei jeder Änderung der Membership.

API

Die Basis-URL aller folgenden Endpunkte ist https://cma.weegloo.com/v1, und im Authorization-Header wird ein Bearer-Token zur CMA-Authentifizierung benötigt. Beim Ändern von Rollen (PUT, PATCH) muss zur optimistischen Nebenläufigkeitskontrolle zusätzlich der Header X-Weegloo-Version (die aktuelle sys.version der Ressource) gesendet werden. Beim Hinzufügen eines Mitglieds (Erstellen) und beim Löschen entfällt dieser Header.

Verwandte Dokumente

• SpaceRole: Definition der SpaceRole (Berechtigungsbündel), die in roles eingetragen wird.
• Space: Der Space, zu dem diese Membership gehört.
• Organization Membership: Mitglieder und Rollen auf Organization-Ebene.