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
user_uuid string (uuid) Req
The
user_uuid of the member whose role you are changing. Look this up via /account/members.Deprecated: the legacy integer id is still accepted in the path until the sunset, answered with Deprecation and Sunset headers. Use the uuid.
Request body
role_uuid string (uuid) Req
The
uuid of the role to assign (from /account/roles). Must be a role that belongs to this account.Deprecated: role_id (integer) is still accepted until the sunset. Send role_uuid; sending both for different objects is a 400 id_uuid_mismatch.
Response (200 OK)
success boolean
true when the member's role was updated.Errors
400 Bad Request
Missing
role_uuid or not a uuid, role_id and role_uuid naming different roles (id_uuid_mismatch), or an integer id after the sunset (integer_id_unsupported).401 Unauthorized
Missing or invalid auth.
403 Forbidden
No active account selected, the caller lacks
members:update, or the role grants a permission the caller does not hold.404 Not Found
Member not found (the uuid is not a member of the active account), or role_uuid is not a role of this account.Request
curl -X PUT "https://api.ngris.com/v1/account/members/019a5f28-be41-7264-9ed2-2e6aceae8290/role" \
-H "X-API-KEY: <your_api_key>" \
-H "Content-Type: application/json" \
-d '{"role_uuid": "019a9625-4dd4-7506-aa4b-97bbf9a69640"}'
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
client._put_raw(
"/account/members/019a5f28-be41-7264-9ed2-2e6aceae8290/role",
{"role_uuid": "019a9625-4dd4-7506-aa4b-97bbf9a69640"},
)
Response — 200 OK
{
"success": true
}
Was this helpful?