Space Membership

Space Membership は、あるユーザーがどの Space にどの SpaceRole で所属しているかを表す記録です。一人のユーザーが複数の Space に所属でき、Space ごとに権限が異なる場合があるため、ユーザーと Space と権限の組み合わせ一つが Space Membership 一つに対応します。Organization Membership がメールで招待して新しい人を加えるのとは異なり、Space Membership はすでに存在するユーザーを user 参照で追加し、roles(SpaceRole 参照の配列)で権限を付与します。メール招待ではありません。

自分が所属する Space の一覧は GET /me/space-memberships で取得します。include=1 を併せて送ると、参照先の Space の詳細も応答に含まれます。

リソース構造

以下は Space Membership 一つの単一取得応答です。sys(システム属性)にこのメンバーシップが参照するユーザー(user)と Space(space)が入り、本文属性として権限のまとまり(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" } }
  ]
}

主なキー:

• space: このメンバーシップが所属する Space を指す Refer<Space> です。
• user: このメンバーシップのユーザーを指す Refer<User> です。構成員として追加したユーザーがここに結び付きます。
• roles: このユーザーが Space で持つ権限のまとまりです。SpaceRole を指す Refer<SpaceRole> の配列で、一人の構成員が複数の SpaceRole を同時に持つことができます。

システム属性 (sys) と本文

すべての Space Membership は共通のシステム属性を sys オブジェクトに格納します。space・user・createdBy・updatedBy は Refer 形式({ "sys": { "id", "type": "Refer", "targetType" } })で入ります。

本文属性:

Space 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)を併せて送る必要があります。構成員の追加(作成)と削除にはこのヘッダーは不要です。

関連ドキュメント

• SpaceRole: roles に入れる SpaceRole(権限のまとまり)の定義。
• Space: このメンバーシップが所属する Space。
• Organization Membership: Organization 単位の構成員と役割。