Organization Membership

Une Organization Membership est un enregistrement qui indique à quelle Organization une personne appartient et avec quelle permission (role). Une même personne peut appartenir à plusieurs Organization, et sa permission peut différer d'une Organization à l'autre. Ainsi, chaque combinaison de personne, organisation et permission correspond à une Organization Membership. Les nouveaux membres sont ajoutés en les invitant par e-mail (voir l'endpoint Invitation (création) ci-dessous). Lorsqu'une invitation est créée, la personne associée à cet e-mail rejoint l'Organization avec le role indiqué.

La liste des Organization auxquelles vous appartenez se consulte via GET /me/organization-memberships. Si vous ajoutez include=1, le détail des Organization référencées est également inclus dans la réponse.

Structure de la ressource

Voici la réponse d'une consultation unitaire d'une Organization Membership. Le sys (propriétés système) contient la personne (user) et l'organisation (organization) que cette membership référence, et la propriété de corps porte la permission (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"
}

Clés principales :

• organization : un Refer<Organization> qui pointe vers l'Organization à laquelle cette membership appartient.
• user : un Refer<User> qui pointe vers la personne de cette membership. Lorsque la personne invitée rejoint, c'est cet utilisateur qui est lié ici.
• role : le niveau de permission de cette personne au sein de l'Organization. L'une des valeurs OWNER, ADMIN ou MEMBER.

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

Toute Organization Membership place ses propriétés système communes dans l'objet sys. Les propriétés organization, user, createdBy et updatedBy se présentent sous la forme Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

Propriété de corps :

Les trois valeurs de role signifient ce qui suit :

• OWNER : le niveau de propriétaire de l'Organization.
• ADMIN : le niveau d'administrateur de l'Organization.
• MEMBER : le niveau de membre ordinaire de l'Organization.

Une Organization Membership est une ressource de configuration, sans notion de publication. C'est pourquoi, contrairement à Content et Media, son sys ne possède pas publish, archive ni status ; il ne possède que version. La version augmente à chaque modification de la membership.

API

L'URL de base de tous les endpoints ci-dessous est https://cma.weegloo.com/v1, et un token Bearer authentifiant CMA est requis dans l'en-tête Authorization. La modification du rôle (PUT, PATCH) requiert aussi l'en-tête X-Weegloo-Version (le sys.version actuel de la ressource), pour le contrôle de concurrence optimiste. L'invitation (création) et la suppression ne comportent pas cet en-tête.

Documents associés

• Organization : l'Organization référencée par cette membership.
• Space Membership : les membres et rôles à l'échelle d'une Space.