Skip to main content
PATCH
/
api
/
v1
/
workspaces
/
{workspace_id}
/
members
/
{membership_id}
Update a member's role
curl --request PATCH \
  --url https://api.example.com/api/v1/workspaces/{workspace_id}/members/{membership_id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "role": "owner"
}
'
{
  "id": "<string>",
  "user_id": "<string>",
  "email": "<string>",
  "role": "owner",
  "created_at": "2023-11-07T05:31:56Z",
  "name": "<string>",
  "picture_url": "<string>",
  "status": "active"
}

Path Parameters

workspace_id
string
required
membership_id
string
required

Body

application/json

Request body to update a member's role.

role
enum<string>
required

Workspace membership roles, ordered by privilege level.

Available options:
owner,
admin,
member,
viewer

Response

Successful Response

A workspace member with user details.

id
string
required
user_id
string
required
email
string
required
role
enum<string>
required

Workspace membership roles, ordered by privilege level.

Available options:
owner,
admin,
member,
viewer
created_at
string<date-time>
required
name
string | null
picture_url
string | null
status
string
default:active
Last modified on March 22, 2026