Change a Member's Role
Reassign a member to a different role within your active account. The new permissions take effect on the member's next request. Roles define which resources a member can read, create, update, and delete.
The role you assign must be one that belongs to this account. The account owner has no assignable role — to change who the owner is, use /account/transfer-owner instead.
Permission required
Calling this endpoint requires the members:update permission on the active account.
Path parameters
userID int64
The user id of the member whose role you are changing. Look this up via /account/members.
Request body
role_id int64
Required. The id of the role to assign. Must be a role that belongs to this account.
Response (200 OK)
success boolean
true when the member's role was updated.Errors
400 Bad Request
Invalid user id, missing
role_id, or a role_id that does not belong to this account.401 Unauthorized
Missing or invalid auth.
403 Forbidden
No active account selected, or the caller lacks
members:update.Request
curl -X PUT "https://api.ngris.com/v1/account/members/2048/role" \
-H "X-API-KEY: <your_api_key>" \
-H "Content-Type: application/json" \
-d '{"role_id": 7}'
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
client.account.update_member_role(user_id=2048, role_id=7)
Response — 200 OK
{
"success": true
}