Name: Serveka
Author: Serveka

DocsAPI ReferenceChange a member's role

PATCH/api/v1/workspaces/{workspace_id}/members/{target_user_id}

Updates the role of an existing workspace member. Only the workspace `owner` can change member roles.

Path Parameters

workspace_idstringrequirede.g. "aaaaaaaa-0000-0000-0000-000000000001"

Workspace UUID.

target_user_idintegerrequirede.g. 2

Integer user ID of the member to update.

Headers

X-API-Keystringrequired

Your workspace API key (owner role required).

Content-Typestringrequired

Must be `application/json`.

Request Body

application/json

rolestringrequired

New role. One of: `owner`, `admin`, `member`.

Example: "admin"

Responses

200Updated member record.

400Invalid role value.

403Caller is not `owner`.

404Member not found.

Try it live

API Configurationglobal · all endpoints

Base URL

API Key

PATCHhttps://api.serveka.com/api/v1/workspaces/aaaaaaaa-0000-0000-0000-000000000001/members/2

Path Parameters

workspace_id

target_user_id

Request Body

curl -X PATCH 'https://api.serveka.com/api/v1/workspaces/aaaaaaaa-0000-0000-0000-000000000001/members/2' \
  -H "Content-Type: application/json"\
  -d '{
  "role": "admin"
}'