Update member role

PATCH/organizations/{organization_id}/members/{member_id}

Needs org:member:manage. The caller must outrank the role assigned and be the member, an owner, or outrank the member's current role (403 otherwise); the organization's last owner is never demoted (409 last_owner).

Path parameters

organization_idstring

Organization ID

member_idstring

Member ID

Headers

Authorizationstring

Bearer <token>.

Body parameters

Role

roleoptional string

Returns

200OKOrganizationMember

created_atoptional string

deleted_atoptional string

idoptional string

invited_by_user_idoptional string

joined_atoptional string

left_atoptional string

organization_idoptional string

roleoptional string

OWNER, ADMIN, MEMBER, VIEWER

statusoptional string

ACTIVE, INACTIVE, SUSPENDED

updated_atoptional string

user_idoptional string

Errors

400Bad Request
403Forbidden
404Not Found
409Conflict

curl --request PATCH \ --url 'https://api.hexelstudio.com/v1/organizations/{organization_id}/members/{member_id}' \ --header "Authorization: Bearer $ACCESS_TOKEN" \ --header 'Content-Type: application/json' \ --data '{ "role": "string" }'

const res = await fetch("https://api.hexelstudio.com/v1/organizations/{organization_id}/members/{member_id}", { method: "PATCH", headers: { Authorization: `Bearer ${process.env.ACCESS_TOKEN}`, "Content-Type": "application/json", }, body: JSON.stringify({ "role": "string" }), }) const data = await res.json()

import os import requests res = requests.patch( "https://api.hexelstudio.com/v1/organizations/{organization_id}/members/{member_id}", headers={"Authorization": f"Bearer {os.environ['ACCESS_TOKEN']}"}, json={ "role": "string", }, ) data = res.json()

{ "created_at": "2026-01-01T00:00:00Z", "deleted_at": "2026-01-01T00:00:00Z", "id": "string", "invited_by_user_id": "string", "joined_at": "2026-01-01T00:00:00Z", "left_at": "2026-01-01T00:00:00Z", "organization_id": "string", "role": "string", "status": "string", "updated_at": "2026-01-01T00:00:00Z", "user_id": "string" }