Organization Membership

Organization Membership は、ある人がどの Organization にどの権限（role）で所属しているかを表す記録です。一人が複数の 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 単位のメンバーと役割。