Skip to the page

Change a person's role (admin, member, billing)

PATCH/v1/organisations/{id}/members/{memberId}

Operation organisations.setRole · since 2026-11-05 · stable

Needs a session withwritescopeAnswers200 OK

Path parameters

idstring (uuid)required
The organisation id.
memberIdstringrequired
The membership id.

Body (JSON)

rolestringrequired
"admin", "member" or "billing". Owners change anyone, never the last owner; admins move people between admin and member.

Errors

Every error is { "error", "message", "detail"? } (Errors and references). Besides the codes any route can answer.

PATCH/v1/organisations/{id}/members/{memberId}
curl -X PATCH "https://api.rykloud.com/v1/organisations/$ORG_ID/members/$MEMBER_ID" \
  -H "Authorization: Bearer $RYKLOUD_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "role": "admin"
}'
With the rykloud CLI
rykloud orgs members role ORG MEMBER ROLE

Command reference: rykloud orgs members role