Skip to main content
PUT
/
organizations
/
{id}
/
members
/
{memberId}
/
role
Update member role (owner/admin only)
curl --request PUT \
  --url http://sandbox.mintlify.com/organizations/{id}/members/{memberId}/role \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "role": "admin"
}
'
Updates a member’s role within the organization.

​
Permissions

User must be owner or admin to update roles.

​
Role Hierarchy

  • Owner: Cannot be changed or removed (permanent)
  • Admin: Can manage members and settings
  • Member: Basic organization access

​
Restrictions

  • Owner role cannot be transferred or removed
  • Only one owner per organization
  • Cannot demote yourself if you’re the only admin

​
Example

curl -X PUT http://localhost:3001/api/organizations/550e8400-e29b-41d4-a716-446655440000/members/123/role \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "role": "admin"
  }'

​
Events Published

  • MemberRoleUpdatedEvent - Triggers audit log creation

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required
​
memberId
string
required

Body

application/json
​
role
enum<string>
required

New role for the member

Available options:
admin,
member
Example:

"admin"

Response

Member role updated successfully.