Organization

최종 수정: 2026년 6월 22일

Organization은 Space들을 담는 최상위 그릇입니다. 회사나 팀 단위가 하나의 Organization에 해당하며, 그 아래에 여러 Space를 둡니다. 구독 플랜(plan)과 멤버십이 Organization 수준에서 관리되므로, 결제와 구성원 권한은 Space가 아니라 이 Organization을 기준으로 적용됩니다.

내가 속한 Organization 목록은 GET /me/organization-memberships로 조회합니다. 이 리소스에는 전체 목록을 반환하는 엔드포인트가 없습니다.

리소스 구조

다음은 Organization "데일리웨어 컴퍼니"의 단일 조회 응답입니다. sys(시스템 속성)와 본문 속성 name·description을 가집니다.

{
  "sys": {
    "id": "ilLRJxDp",
    "type": "Organization",
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-05-11T10:51:16.832Z",
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "updatedAt": "2026-05-11T10:51:16.832Z",
    "version": 1,
    "isOfficial": false,
    "plan": { "sys": { "id": "free", "type": "Refer", "targetType": "Plan" } }
  },
  "name": "데일리웨어 컴퍼니",
  "description": "옷·잡화 온라인 쇼핑몰 운영사"
}

주요 키:

  • name: Organization의 이름입니다(1~64자). 회사나 팀의 표시 이름입니다.
  • description: Organization에 대한 설명입니다(1~128자, 선택).
  • plan: 이 Organization의 구독 플랜을 가리키는 Refer<Plan>입니다(예: free). 결제 플랜이 여기에 매여 있습니다.
  • isOfficial: 공식 Organization인지 여부(boolean)입니다.

시스템 속성 (sys)와 본문

모든 Organization은 공통 시스템 속성을 sys 객체에 담습니다. createdBy·updatedBy는 Refer 모양({ "sys": { "id", "type": "Refer", "targetType" } })으로 들어가고, plan은 Refer<Plan>입니다.

속성타입설명
idstring리소스 고유 식별자.
typestring리소스 종류. Organization은 항상 "Organization".
createdByRefer<User>생성한 사용자.
createdAtstring (date-time)생성 시각.
updatedByRefer<User>마지막으로 수정한 사용자.
updatedAtstring (date-time)마지막 수정 시각.
versioninteger (≥1)리소스 버전. 수정할 때마다 1씩 올라갑니다.
isOfficialboolean공식 Organization 여부.
planRefer<Plan>구독 플랜. 예: free.

본문 속성:

속성타입설명
namestring (1~64)Organization 이름. 생성·수정 시 지정합니다.
descriptionstring (1~128)Organization 설명. 선택 항목입니다.
iconstring (읽기) / object (쓰기)Organization 아이콘. 응답에서는 이미지 URL 문자열입니다. 수정 요청에서는 업로드한 파일을 가리키는 객체 { "upload": { "sys": { ..., "targetType": "Upload" } } }로 보냅니다(Upload API로 받은 Upload 참조).

Organization은 발행 개념이 없는 설정 리소스입니다. 그래서 Content·Media와 달리 sys에 publish·archive·status가 없고, version만 가집니다. version은 Organization을 수정할 때마다 오릅니다.

API

아래 모든 엔드포인트의 기준 URL은 https://cma.weegloo.com/v1이며, Authorization 헤더에 CMA를 인증하는 Bearer 토큰이 필요합니다. 수정·부분 수정에는 낙관적 동시성 제어를 위해 X-Weegloo-Version 헤더(현재 리소스의 sys.version)를 함께 보내야 합니다. 생성과 삭제에는 이 헤더가 없습니다.