Update Member Role

PATCH

/api/v1/workspaces/:ws_id/members/:member_id

Change a workspace member’s role. Admin only.

Updates the role of an active member to admin, editor, or viewer. The operation is idempotent — setting a member to their current role succeeds silently (no error, no duplicate email notification).

Two protections prevent accidental lockouts:

The workspace owner’s role cannot be changed.
The last remaining admin cannot be demoted (returns 409).

When the role actually changes, the affected member receives an email notification describing their new permissions.

Change a workspace member's role. Admin only. Updates the role of an active member to `admin`, `editor`, or `viewer`. The operation is idempotent — setting a member to their current role succeeds silently (no error, no duplicate email notification). Two protections prevent accidental lockouts: - The workspace owner's role cannot be changed. - The last remaining admin cannot be demoted (returns 409). When the role actually changes, the affected member receives an email notification describing their new permissions.

Authentication

AuthorizationBearer

Clerk JWT token

Path parameters

ws_idstringRequiredformat: "uuid"

member_idstringRequiredformat: "uuid"

Request

This endpoint expects an object.

roleenumRequired

New role to assign: admin, editor, or viewer.

Response

Successful Response

datamap from strings to any

metaobject

Errors

422

Unprocessable Entity Error

$	curl -X PATCH https://api.onepin.ai/api/v1/workspaces/ws_id/members/member_id \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"role": "editor"
>	}'

1	{
2	"data": {},
3	"meta": {
4	"request_id": "a3f47b9e-8c2d-4f1a-9b7e-2d5f6c8a9e12",
5	"timestamp": "2024-01-15T09:30:00Z"
6	}
7	}