멤버

조직 멤버는 Capgo 조직에 접근 권한이 있는 사용자입니다. 각 멤버는 조직 내에서 권한을 결정하는 특정 역할을 가집니다. 멤버를 효과적으로 관리하는 것은 팀의 보안과 협업을 유지하는 데 필수적입니다.

멤버 역할

일반 역할

• read: 리소스를 볼 수 있지만 변경할 수 없습니다
• upload: 새 bundle을 업로드하고 리소스를 볼 수 있습니다
• write: 리소스를 수정하고 번들을 업로드할 수 있습니다
• admin: 조직 설정과 멤버를 관리할 수 있습니다
• super_admin: 조직에 대한 전체 제어 권한을 가집니다

초대 역할

• invite_read: 읽기 접근 권한을 위한 대기 중인 초대
• 초대 업로드: 업로드 접근 권한을 위한 대기 중인 초대
• invite_write: 쓰기 접근 권한에 대한 대기 중인 초대
• 관리자 초대: 관리자 접근 권한에 대한 대기 중인 초대
• super_admin 초대: 슈퍼 관리자 접근 권한에 대한 대기 중인 초대

모범 사례

1. 역할 지정: 역할 지정 시 최소 권한 원칙을 따르세요
2. 정기 감사: 멤버 접근 권한을 정기적으로 검토하고 사용하지 않는 계정을 제거하세요
3. 온보딩: 신규 멤버 추가 및 역할 할당을 위한 명확한 프로세스를 마련하세요
4. 오프보딩: 조직을 떠나는 멤버의 액세스 권한을 즉시 제거하세요

엔드포인트

POST

https://api.capgo.app/organization/members/

조직에 새 멤버를 추가하거나 기존 멤버의 역할을 업데이트합니다. Capgo 계정이 있는 사용자만 초대할 수 있으니 주의하세요. 이메일 주소는 기존 Capgo 사용자와 일치해야 합니다.

요청 본문

interface MemberCreate {
  orgId: string
  email: string
  role: "read" | "upload" | "write" | "admin" | "super_admin"
}

요청 예시

curl -X POST \
  -H "authorization: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "orgId": "org_123",
    "email": "newmember@example.com",
    "role": "write"
  }' \
  https://api.capgo.app/organization/members/

성공 응답

{
  "status": "OK",
  "data": {
    "uid": "user_789",
    "email": "newmember@example.com",
    "role": "invite_write",
    "image_url": null
  }
}

참고:

• 새 멤버를 추가하면 초대 이메일이 발송됩니다. 초대를 수락하기 전까지 해당 멤버의 역할(role) 앞에는 “invite_” 접두사가 붙습니다.
• 초대하기 전에 사용자가 이미 Capgo 계정을 보유하고 있어야 합니다. 계정이 없다면 먼저 다음 페이지에서 계정을 생성해야 합니다: https://capgo.app/register/

GET

https://api.capgo.app/organization/members/

조직의 모든 멤버를 가져옵니다.

쿼리 파라미터

interface MemberQuery {
  orgId: string
}

응답 타입

interface Member {
  uid: string;
  email: string;
  image_url: string;
  role: "invite_read" | "invite_upload" | "invite_write" | "invite_admin" | "invite_super_admin" | "read" | "upload" | "write" | "admin" | "super_admin";
}

요청 예시

curl -H "authorization: your-api-key" \
  "https://api.capgo.app/organization/members/?orgId=org_123"

응답 예시

{
  "data": [
    {
      "uid": "user_123",
      "email": "john@example.com",
      "image_url": "https://example.com/avatar.png",
      "role": "admin"
    },
    {
      "uid": "user_456",
      "email": "jane@example.com",
      "image_url": "https://example.com/avatar2.png",
      "role": "write"
    },
    {
      "uid": "user_789",
      "email": "bob@example.com",
      "image_url": null,
      "role": "invite_read"
    }
  ]
}

DELETE

https://api.capgo.app/organization/members/

조직에서 멤버를 제거합니다. 이 작업은 해당 멤버의 접근 권한을 즉시 취소합니다.

요청 본문

interface MemberDelete {
  orgId: string
  email: string
}

요청 예시

curl -X DELETE \
  -H "authorization: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "orgId": "org_123",
    "email": "user@example.com"
  }' \
  https://api.capgo.app/organization/members/

성공 응답

{
  "status": "OK"
}

에러 핸들링

모든 에러는 다음에 설명된 표준 에러 형식을 사용합니다 API 개요.

일반적인 에러 시나리오와 응답:

// The API key has no access to the organization
{
  "error": "cannot_access_organization",
  "message": "You can't access this organization",
  "moreInfo": { "orgId": "046a36ac-e03c-4590-9257-bd6c9dba9ee8" }
}

// Unknown role on update
{
  "error": "invalid_role",
  "message": "Invalid role",
  "moreInfo": { "role": "owner" }
}

// Changing the role of the user who owns the API key
{
  "error": "cannot_change_own_role",
  "message": "You cannot change your own role",
  "moreInfo": {}
}

// Removing a user who is not a member (HTTP 404)
{
  "error": "organization_member_not_found",
  "message": "User is not a member of this organization",
  "moreInfo": { "orgId": "046a36ac-e03c-4590-9257-bd6c9dba9ee8", "email": "user@example.com" }
}

// Removing the last super admin
{
  "error": "CANNOT_REMOVE_LAST_SUPER_ADMIN",
  "message": "Cannot remove the last super admin from the organization",
  "moreInfo": { "orgId": "046a36ac-e03c-4590-9257-bd6c9dba9ee8" }
}

주요 사용 사례

1. 팀 확장: 적절한 역할로 새 팀원 추가
2. 접근 제어: 담당 업무 변경에 따라 멤버 권한 관리
3. 보안 감사: 멤버 목록 및 역할 정기 검토
4. 팀 구조 개편: 조직 개편 시 역할 업데이트

Members에서 계속하기

사용 중이라면 멤버 보안 및 컴플라이언스 계획을 세우려면, 다음 항목과 연결하세요: 암호화 암호화 구현 상세 정보: 컴플라이언스 컴플라이언스 구현 상세 정보: Capgo 보안 스캐너 Capgo Security Scanner 제품 워크플로우: Capgo 보안 Capgo Security 제품 워크플로우 및 Capgo 신뢰 센터 Capgo Trust Center 제품 워크플로우: