Space Membership

Un Space Membership est un enregistrement qui indique à quel Space un utilisateur appartient et avec quels SpaceRole. Un même utilisateur peut appartenir à plusieurs Space, et ses permissions peuvent différer d'un Space à l'autre. Ainsi, chaque combinaison d'un utilisateur, d'un Space et de permissions correspond à un Space Membership. Contrairement à l'Organization Membership, qui fait entrer une nouvelle personne en l'invitant par e-mail, le Space Membership ajoute un utilisateur déjà existant via une référence user et lui accorde des permissions via roles (un tableau de références SpaceRole). Ce n'est pas une invitation par e-mail.

La liste des Space auxquels vous appartenez se récupère via GET /me/space-memberships. Si vous envoyez include=1, les détails du Space référencé sont aussi inclus dans la réponse.

Structure de la ressource

Voici la réponse d'une consultation unitaire d'un Space Membership. Le champ sys (propriétés système) contient l'utilisateur (user) et le Space (space) que cette adhésion référence, et la ressource possède comme propriété de corps un ensemble de permissions (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" } }
  ]
}

Clés principales :

• space : un Refer<Space> qui référence le Space auquel cette adhésion appartient.
• user : un Refer<User> qui référence l'utilisateur de cette adhésion. L'utilisateur ajouté comme membre est lié ici.
• roles : l'ensemble des permissions de cet utilisateur dans le Space. C'est un tableau de Refer<SpaceRole> référençant des SpaceRole ; un même membre peut détenir plusieurs SpaceRole en même temps.

Propriétés système (sys) et corps

Chaque Space Membership place ses propriétés système communes dans l'objet sys. Les champs space, user, createdBy et updatedBy sont fournis sous la forme Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

Propriétés de corps :

Le Space Membership est une ressource de configuration sans notion de publication. C'est pourquoi, contrairement aux Content et Media, son sys ne possède pas publish, archive ni status, mais seulement version. La version augmente à chaque modification de l'adhésion.

API

L'URL de base de tous les endpoints ci-dessous est https://cma.weegloo.com/v1, et l'en-tête Authorization doit contenir un Bearer token authentifiant auprès de CMA. La modification des rôles (PUT, PATCH) exige aussi l'en-tête X-Weegloo-Version (le sys.version actuel de la ressource) pour le contrôle de concurrence optimiste. L'ajout d'un membre (création) et la suppression n'utilisent pas cet en-tête.

Documents associés

• SpaceRole : définition du SpaceRole (ensemble de permissions) placé dans roles.
• Space : le Space auquel cette adhésion appartient.
• Organization Membership : les membres et rôles au niveau d'une Organization.