> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Team Members API

> Team Member는 계정 팀의 구성원으로, 사용자와 계정을 연결하며 해당 사용자가 할 수 있는 작업을 제어하는 역할을 갖습니다.

역할은 시스템 역할(`admin` 또는 `moderator` 등)이거나 대시보드에서 관리하는 `custom` 역할입니다.

Team Members API를 사용하면 계정의 팀 목록을 조회하고, 시스템 역할로 사용자를 팀에 추가하고, 구성원의 역할을 변경하고, 구성원을 제거할 수 있습니다. 아직 수락하지 않은 사용자를 추가하면 대신 초대가 발송됩니다.

## 엔드포인트

| 엔드포인트 | 요청 |
| - | - |
| [팀 구성원 목록 조회](https://docs.whop.com/ko/api-reference/team-members/list-team-members.md) | GET `/team_members` |
| [팀 구성원 조회](https://docs.whop.com/ko/api-reference/team-members/retrieve-team-member.md) | GET `/team_members/{id}` |
| [팀 구성원 생성](https://docs.whop.com/ko/api-reference/team-members/create-team-member.md) | POST `/team_members` |
| [팀 구성원 업데이트](https://docs.whop.com/ko/api-reference/team-members/update-team-member.md) | PATCH `/team_members/{id}` |
| [팀 구성원 삭제](https://docs.whop.com/ko/api-reference/team-members/delete-team-member.md) | DELETE `/team_members/{id}` |

## 속성

**id** `string` *required*

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

**account** `object` *required*

이 멤버십이 속한 계정입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> `biz_` 접두사가 붙은 계정 ID입니다.
>
> **fees** `object`
>
> 이 상위 계정이 조회 대상 하위 계정에 부과하는 마크업 요율로, 수수료 유형(예:
> `crypto_deposit_markup`)을 키로 하며 각각 `percentage_fee`와
> `fixed_fee_usd`를 갖습니다. 하위 계정 자체의 재정의 값이 플랫폼 기본값보다
> 우선하도록 결정됩니다.
>
> **logo\_url** `string | null` *required*
>
> 계정 로고 이미지 URL입니다.
>
> **route** `string` *required*
>
> 계정의 공개 경로 식별자입니다.
>
> **title** `string` *required*
>
> 계정 표시 이름입니다.

**authorized\_role** `object | null` *required*

이 구성원에게 할당된 사용자 정의 역할이며, 구성원이 시스템 역할을 가진 경우 `null`입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> `aurl_` 접두사가 붙은 사용자 정의 역할 ID입니다.
>
> **name** `string` *required*
>
> 사용자 정의 역할 이름입니다.

**created\_at** `string` *required*

구성원이 팀에 합류했거나 초대가 발송된 시각으로, ISO 8601
타임스탬프입니다. 먼저 고객이었던 구성원은 역할을 부여받은 날짜를
유지합니다.

**direct\_reports\_count** `integer | null` *required*

이 구성원에게 직접 보고하는 팀 구성원 수입니다. 초대의 경우 `null`입니다.

**email** `string | null` *required*

구성원의 이메일 주소입니다. 아직 Whop 계정이 없는 이메일로 보낸 초대의 경우
초대한 주소입니다. 그 외에는 호출자가 `company:authorized_user:email:read`
스코프를 보유하지 않으면 `null`입니다.

**is\_agent** `boolean` *required*

이 구성원이 사람 팀 구성원이 아닌 에이전트(앱이 제어하는 계정)인지
여부입니다. 초대의 경우 항상 `false`입니다.

**is\_partner** `boolean` *required*

이 구성원 또는 초대가 직접 또는 이를 기반으로 한 사용자 정의 역할을 통해
보기 전용 Partner 역할을 갖는지 여부입니다. Partner는 계정의 기본
정보만 읽을 수 있습니다.

**reports\_to\_chain** `object[] | null` *required*

이 구성원 위의 관리자들로, 가장 가까운 관리자가 먼저 나옵니다. 즉 이 구성원이 보고하는 구성원, 그 구성원의 관리자 순으로 보고 라인의 최상단까지 이어집니다. 구성원이 비즈니스에 직접 보고하는 경우 `[]`입니다. 자신의 보고 라인만 읽을 수 있는 호출자에게는 라인이 자기 자신에서 끝나며, 읽을 수 없는 경우 `null`입니다. 초대의 경우 `null`입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> 관리자의 팀 구성원 ID로, `ausr_` 또는 `mber_`로 시작합니다. 불투명한 값으로
> 취급하세요.
>
> **user** `object` *required*
>
> 관리자의 팀 멤버십에 해당하는 사용자입니다.
>
> > [accordion] 속성
> >
> > **id** `string` *required*
> >
> > `user_` 접두사가 붙은 사용자 ID입니다.
> >
> > **name** `string | null` *required*
> >
> > 표시 이름입니다.
> >
> > **profile\_picture** `object` *required*
> >
> > 아바타 래퍼입니다. `url`은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
> >
> > > [accordion] 속성
> > >
> > > **url** `string` *required*
> > >
> > > 아바타 이미지 URL입니다. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
> >
> > **username** `string` *required*
> >
> > 공개 사용자 이름입니다.

**reports\_to\_id** `string | null` *required*

이 구성원이 보고하는 팀 구성원의 ID로, `ausr_` 또는 `mber_`로 시작합니다.
불투명한 값으로 취급하세요. 구성원이 비즈니스에 직접 보고하는 경우와
초대의 경우 `null`입니다.

**role** `string` *required*

계정에서 구성원의 역할입니다. `custom`은 대시보드에서 관리하는 맞춤 역할을 의미하며, API로 읽을 수는 있지만 부여할 수는 없습니다.

사용 가능한 옵션: `owner`, `admin`, `partner`, `sales_manager`, `moderator`, `advertiser`, `app_manager`, `support`, `manager`, `workforce`, `custom`

**status** `string` *required*

수락된 구성원은 `joined`, 초대가 대기 중인 동안은 `pending`입니다.

사용 가능한 옵션: `joined`, `pending`

**updated\_at** `string` *required*

멤버십이 마지막으로 업데이트된 시각으로, ISO 8601 타임스탬프입니다.

**user** `object | null` *required*

이 팀 멤버십에 해당하는 사용자입니다. 아직 Whop 계정이 없는 이메일로 보낸 초대의 경우 `null`입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> `user_` 접두사가 붙은 사용자 ID입니다.
>
> **name** `string | null` *required*
>
> 표시 이름입니다.
>
> **profile\_picture** `object` *required*
>
> 아바타 래퍼입니다. `url`은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
>
> > [accordion] 속성
> >
> > **url** `string` *required*
> >
> > 아바타 이미지 URL입니다. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
>
> **username** `string` *required*
>
> 공개 사용자 이름입니다.

```json TeamMember theme={null}
{
	"id": "ausr_xxxxxxxxxxxxx",
	"status": "joined",
	"role": "admin",
	"authorized_role": null,
	"is_agent": false,
	"is_partner": false,
	"account": {
		"id": "biz_xxxxxxxxxxxxx",
		"title": "Acme Studio",
		"route": "acme-studio",
		"logo_url": "https://cdn.whop.com/logo.png"
	},
	"email": "jane@example.com",
	"created_at": "2026-07-01T00:00:00.000Z",
	"updated_at": "2026-07-01T00:00:00.000Z",
	"reports_to_id": "ausr_xxxxxxxxxxxxy",
	"direct_reports_count": 0,
	"reports_to_chain": [
		{
			"id": "ausr_xxxxxxxxxxxxy",
			"user": {
				"id": "user_xxxxxxxxxxxy",
				"name": "Sam Lee",
				"profile_picture": {
					"url": "https://cdn.whop.com/manager.png"
				},
				"username": "samlee"
			}
		}
	],
	"user": {
		"id": "user_xxxxxxxxxxxx",
		"name": "Jane Doe",
		"profile_picture": {
			"url": "https://cdn.whop.com/user.png"
		},
		"username": "janedoe"
	}
}
```
