Delete RBAC Role
Remove a role definition. The role and all memberships referencing it are removed. Clients who only had this role lose those grants; clients with multiple roles continue with whatever they have left.
Path parameters
id string (uuid) Req
Endpoint UUID.
role_id int64 Req
Role ID.
Response (200 OK)
deleted_role_id int64
The deleted role's ID. (This call returns 200 with a JSON body, not 204.)
Errors
400 Bad Request
Invalid
role_id, or the delete failed (e.g. constraint violation).401 Unauthorized
Missing auth.
403 Forbidden
Caller lacks the
endpoints:delete permission in the active account.404 Not Found
Endpoint doesn't exist or doesn't belong to the calling account.
Request
curl -X DELETE "https://api.ngris.com/v1/endpoints/<uuid>/rbac/roles/3" \
-H "X-API-KEY: <your_api_key>"
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
client.endpoint_rbac.delete_role("<endpoint_uuid>", "3")
Response — 200 OK
{
"deleted_role_id": 3
}