Update Team Member
Changes a team member’s system role. Requires a user session — account API keys cannot change member roles. The account owner’s role cannot be changed, and you cannot change your own role.
Authorizations
Only available to a signed-in whop.com session. API keys, access tokens, and OAuth tokens are not accepted.
Headers
Pins the request to a dated API version.
"2026-10-29-8"
Path Parameters
Team member ID. Accepted members have an ID starting with ausr_ or mber_, and pending invites one starting with ausri_. Treat it as opaque.
Body
The system role to grant. Custom roles cannot be granted through the API. The Partner role provides view-only access.
owner, admin, partner, sales_manager, moderator, advertiser, workforce "partner"
Response
Team member updated.
The account this membership belongs to, prefixed biz_.
"biz_xxxxxxxxxxxxxx"
Custom role assigned to this member, or null when the member has a system role.
When the member joined the team or the invite was sent, as an ISO 8601 timestamp. A member who was a customer first keeps the date they were given their role.
"2026-01-01T12:00:00.000Z"
How many team members report directly to this member. null for invites.
0
The member's email address. For an invite sent to an email with no Whop account yet, the invited address; for accepted members and invites to an existing Whop account, null unless the caller holds the company:authorized_user:email:read scope.
"marcus@shinetime.example"
Team member ID. Accepted members have an ID starting with ausr_ or mber_, and pending invites one starting with ausri_. Treat it as opaque: both member prefixes are accepted wherever a team member ID is.
"ausr_xxxxxxxxxxxxxx"
Whether this member is an agent (app-controlled account) rather than a human team member. Always false for invites.
false
The ID of the team member this member reports to, starting with ausr_ or mber_; treat it as opaque. null when the member reports to the business directly, and for invites.
"ausr_xxxxxxxxxxxxxx"
The member's role on the account. custom means a bespoke dashboard-managed role; the API can read but not grant it.
owner, admin, partner, sales_manager, moderator, advertiser, app_manager, support, manager, workforce, custom "admin"
joined for accepted members, pending while the invite is pending.
joined, pending "joined"
When the membership was last updated, as an ISO 8601 timestamp.
"2026-01-01T12:00:00.000Z"
The user behind this team membership. null for an invite sent to an email with no Whop account yet.

