Organization Membership
최종 수정: 2026년 6월 22일
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" } })으로 들어갑니다.
| 속성 | 타입 | 설명 |
|---|---|---|
id | string | 리소스 고유 식별자. |
type | string | 리소스 종류. Organization Membership은 항상 "OrganizationMembership". |
organization | Refer<Organization> | 이 멤버십이 속한 Organization. |
user | Refer<User> | 이 멤버십의 사람. |
createdBy | Refer<User> | 생성한 사용자. |
createdAt | string (date-time) | 생성 시각. |
updatedBy | Refer<User> | 마지막으로 수정한 사용자. |
updatedAt | string (date-time) | 마지막 수정 시각. |
version | integer (≥1) | 리소스 버전. 수정할 때마다 1씩 올라갑니다. |
본문 속성:
| 속성 | 타입 | 설명 |
|---|---|---|
role | string (enum) | 구성원의 권한 등급. OWNER·ADMIN·MEMBER 중 하나. |
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 단위 구성원과 역할.