Skip to main content
PATCH
Change a member's role
Authentication: Authorization: Bearer <token> with Dashboard session, Pomerado MCP OAuth token, API key. Permission: team:manage; an API key also needs team:manage. Effect: Write: creates or changes something in your account. Errors: invalid_request (400), unauthorized (401), reauthentication_required (401), forbidden (403), role_change_forbidden (403), team_unavailable (403), not_found (404), last_owner (409), request_too_large (413), internal_error (500), temporarily_unavailable (503). Every error has the same envelope.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

user_id
string
required

a team member ID: the user_id GET /v1/team/members gives: user_ and up to 100 letters or digits

Example:

"user_01K6QZ8V3N4M5P6R7S8T9W0XYZ"

Body

application/json
role
enum<string>
required
Available options:
owner,
admin,
member

Response

The member with their new role

user_id
string
required

The member's WorkOS user ID

email
string
required
name
string | null
required

Null when they gave none

role
enum<string>
required
Available options:
owner,
admin,
member
joined_at
string
required

a string to be decoded into a Date