Skip to main content
역할은 시스템 역할(admin 또는 moderator 등)이거나 대시보드에서 관리하는 custom 역할입니다. Team Members API를 사용하면 계정의 팀 목록을 조회하고, 시스템 역할로 사용자를 팀에 추가하고, 구성원의 역할을 변경하고, 구성원을 제거할 수 있습니다. 아직 수락하지 않은 사용자를 추가하면 대신 초대가 발송됩니다.

엔드포인트

속성

string
필수
팀 구성원 ID입니다. 수락된 구성원의 ID는 ausr_ 또는 mber_로 시작하고, 대기 중인 초대의 ID는 ausri_로 시작합니다. 불투명한 값으로 취급하세요. 팀 구성원 ID를 받는 모든 곳에서 두 구성원 접두사를 모두 허용합니다.
object
필수
이 멤버십이 속한 계정입니다.

속성

string
필수
biz_ 접두사가 붙은 계정 ID입니다.
object
이 상위 계정이 조회 대상 하위 계정에 부과하는 마크업 요율로, 수수료 유형(예: crypto_deposit_markup)을 키로 하며 각각 percentage_fee와 fixed_fee_usd를 갖습니다. 하위 계정 자체의 재정의 값이 플랫폼 기본값보다 우선하도록 결정됩니다.
string | null
필수
계정 로고 이미지 URL입니다.
string
필수
계정의 공개 경로 식별자입니다.
string
필수
계정 표시 이름입니다.
object | null
필수
이 구성원에게 할당된 사용자 정의 역할이며, 구성원이 시스템 역할을 가진 경우 null입니다.

속성

string
필수
aurl_ 접두사가 붙은 사용자 정의 역할 ID입니다.
string
필수
사용자 정의 역할 이름입니다.
string
필수
구성원이 팀에 합류했거나 초대가 발송된 시각으로, ISO 8601 타임스탬프입니다. 먼저 고객이었던 구성원은 역할을 부여받은 날짜를 유지합니다.
integer | null
필수
이 구성원에게 직접 보고하는 팀 구성원 수입니다. 초대의 경우 null입니다.
string | null
필수
구성원의 이메일 주소입니다. 아직 Whop 계정이 없는 이메일로 보낸 초대의 경우 초대한 주소입니다. 그 외에는 호출자가 company:authorized_user:email:read 스코프를 보유하지 않으면 null입니다.
boolean
필수
이 구성원이 사람 팀 구성원이 아닌 에이전트(앱이 제어하는 계정)인지 여부입니다. 초대의 경우 항상 false입니다.
boolean
필수
이 구성원 또는 초대가 직접 또는 이를 기반으로 한 사용자 정의 역할을 통해 보기 전용 Partner 역할을 갖는지 여부입니다. Partner는 계정의 기본 정보만 읽을 수 있습니다.
object[] | null
필수
이 구성원 위의 관리자들로, 가장 가까운 관리자가 먼저 나옵니다. 즉 이 구성원이 보고하는 구성원, 그 구성원의 관리자 순으로 보고 라인의 최상단까지 이어집니다. 구성원이 비즈니스에 직접 보고하는 경우 []입니다. 자신의 보고 라인만 읽을 수 있는 호출자에게는 라인이 자기 자신에서 끝나며, 읽을 수 없는 경우 null입니다. 초대의 경우 null입니다.

속성

string
필수
관리자의 팀 구성원 ID로, ausr_ 또는 mber_로 시작합니다. 불투명한 값으로 취급하세요.
object
필수
관리자의 팀 멤버십에 해당하는 사용자입니다.

속성

string
필수
user_ 접두사가 붙은 사용자 ID입니다.
string | null
필수
표시 이름입니다.
object
필수
아바타 래퍼입니다. url은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.

속성

string
필수
아바타 이미지 URL입니다. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
string
필수
공개 사용자 이름입니다.
string | null
필수
이 구성원이 보고하는 팀 구성원의 ID로, ausr_ 또는 mber_로 시작합니다. 불투명한 값으로 취급하세요. 구성원이 비즈니스에 직접 보고하는 경우와 초대의 경우 null입니다.
string
필수
계정에서 구성원의 역할입니다. custom은 대시보드에서 관리하는 맞춤 역할을 의미하며, API로 읽을 수는 있지만 부여할 수는 없습니다.사용 가능한 옵션: owner, admin, partner, sales_manager, moderator, advertiser, app_manager, support, manager, workforce, custom
string
필수
수락된 구성원은 joined, 초대가 대기 중인 동안은 pending입니다.사용 가능한 옵션: joined, pending
string
필수
멤버십이 마지막으로 업데이트된 시각으로, ISO 8601 타임스탬프입니다.
object | null
필수
이 팀 멤버십에 해당하는 사용자입니다. 아직 Whop 계정이 없는 이메일로 보낸 초대의 경우 null입니다.

속성

string
필수
user_ 접두사가 붙은 사용자 ID입니다.
string | null
필수
표시 이름입니다.
object
필수
아바타 래퍼입니다. url은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.

속성

string
필수
아바타 이미지 URL입니다. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
string
필수
공개 사용자 이름입니다.
TeamMember