Skip to main content
PUT
Change a member role
Requires Owner. Send viewer, editor, admin, or owner. The last remaining owner cannot be demoted (409). Invalid roles return 400; a missing membership returns 404. Role changes also change the member’s API-key access to this workspace.

Authorizations

Authorization
string
header
required

Bandwidth Labs OAuth access token. Uses the user's selected workspace; the workspace header is not required. Do not also send an API key. Bearer-only operations may additionally require the Labs super_user role.

Headers

X-VOAI-ORGANIZATION-ID
string | null

Required with X-BW-LABS-AGENTS-API-KEY: the positive local workspace ID to access. The key owner must be a current member. Missing or invalid IDs return 400; non-member workspaces return 403. Not required for bearer authentication, which uses the user's selected workspace.

Path Parameters

member_id
integer
required

Body

application/json
role
string
required

Response

Successful Response

id
integer
required
role
string
required
user_id
integer
required
avatar_url
string | null
email
string | null
first_name
string | null
is_self
boolean
default:false
joined_at
string<date-time> | null
last_active_at
string<date-time> | null
last_name
string | null
name
string | null