Organization Membership

Organization Membership 是一条记录，表示某个人以何种权限（role）归属于某个 Organization。一个人可以归属于多个 Organization，且在每个 Organization 中的权限可以不同，因此人、组织与权限的每一种组合都对应一条 Organization Membership。通过邮箱邀请来添加新成员（参见下方的邀请（创建）端点）。创建邀请后，该邮箱对应的人便以该 role 加入 Organization。

我所属的 Organization 列表通过 GET /me/organization-memberships 查询。同时传入 include=1 时，所指向的 Organization 详情也会包含在响应中。

资源结构

以下是单条 Organization Membership 的单条查询响应。sys（系统属性）中包含此成员关系所指向的人（user）和组织（organization），并以本体属性持有权限（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"
}

主要键：

• organization：指向此成员关系所属 Organization 的 Refer<Organization>。
• user：指向此成员关系中的人的 Refer<User>。被邀请者加入后，该用户便绑定到这里。
• role：此人在 Organization 中拥有的权限等级。为 OWNER、ADMIN、MEMBER 之一。

系统属性（sys）与本体

每一条 Organization Membership 都将公共系统属性放在 sys 对象中。organization、user、createdBy、updatedBy 以 Refer 形态（{ "sys": { "id", "type": "Refer", "targetType" } }）存入。

本体属性：

role 的三个值含义如下：

• OWNER：Organization 的所有者等级。
• ADMIN：Organization 的管理员等级。
• MEMBER：Organization 的普通成员等级。

Organization Membership 是没有发布概念的配置类资源。因此与 Content、Media 不同，它的 sys 中没有 publish、archive、status，只有 version。version 会在每次修改成员关系时递增。

API

以下所有端点的基准 URL 均为 https://cma.weegloo.com/v1，且 Authorization 头中需要用于向 CMA 认证的 Bearer 令牌。修改角色（PUT、PATCH）时为实现乐观并发控制，还须一并传入 X-Weegloo-Version 头（当前资源的 sys.version）。邀请（创建）和删除不需要此头。

相关文档

• Organization：此成员关系所指向的 Organization。
• Space Membership：Space 级别的成员与角色。