Change a user's account role
PATCH/v1/users/:userId/account-role
This route allows you to promote or demote a user's account role in a multi-organization account.
Prerequisites:
- The caller must have the Account admin role.
- The target user must hold the Admin role in at least one organization within the account before being eligible for the Account admin role.
- Machine tokens cannot call this route.
- You cannot change your own role.
- Both the caller and target must belong to the same company.
To learn more about multiple organization membership, check out the documentation.
Request
Responses
- 200
- 401
- 403
- 404
- 409
- 413
- 422
Updated successfully.
Default Response
The caller does not have permission to perform this action
A resource with the provided identifier was not found
The request conflicts with the current state of the resource
Request body is too large (limit is 1MiB)
The json provided does not match the route's schema