Organization Membership

An Organization Membership is a record of which Organization a person belongs to and with what permission level (role). One person can belong to several Organizations, and the permission may differ per Organization, so each combination of a person, an organization, and a permission corresponds to one Organization Membership. You add a new member by inviting them by email (the invite (create) endpoint below). When you create an invitation, the person at that email joins the Organization with that role.

You read the list of Organizations you belong to with GET /me/organization-memberships. If you also send include=1, the details of the Organization it points to are included in the response.

Resource structure

The following is the single-read response for one Organization Membership. sys (system properties) holds the person (user) and organization (organization) this membership points to, and it has the body property 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"
}

Key properties:

• organization: A Refer<Organization> that points to the Organization this membership belongs to.
• user: A Refer<User> that points to the person of this membership. When the invited person joins, that user is bound here.
• role: The permission level this person has in the Organization. One of OWNER, ADMIN, or MEMBER.

System properties (sys) and body

Every Organization Membership carries common system properties in the sys object. organization, user, createdBy, and updatedBy are in the Refer shape ({ "sys": { "id", "type": "Refer", "targetType" } }).

Body properties:

The three values of role mean the following.

• OWNER: The owner level of the Organization.
• ADMIN: The administrator level of the Organization.
• MEMBER: The regular member level of the Organization.

An Organization Membership is a settings resource with no publishing concept. So unlike Content and Media, its sys has no publish, archive, or status, only version. The version increases each time you update the membership.

API

The base URL for all endpoints below is https://cma.weegloo.com/v1, and a Bearer token that authenticates against CMA is required in the Authorization header. Role updates (PUT, PATCH) must also send the X-Weegloo-Version header (the current resource's sys.version) for optimistic concurrency control. Invite (create) and delete do not have this header.

Related documents

• Organization: The Organization this membership points to.
• Space Membership: Members and roles at the Space level.