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
uuid string (uuid) Req
The endpoint's
uuid from /endpoints.role_uuid string (uuid) Req
The role's
uuid from /rbac/roles. Resolved under this endpoint only.Deprecated: the legacy integer id is still accepted in the path until the sunset, answered with Deprecation and Sunset headers. Use the uuid.
Response (200 OK)
deleted_role_uuid string (uuid)
The deleted role's
uuid. (This call returns 200 with a JSON body, not 204.)Deprecated: until the sunset this response also carries the legacy integer id and *_id fields. Don't use them; read uuid and the *_uuid fields.
Errors
400 Bad Request
An integer role id after the sunset (
integer_id_unsupported).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, or the role isn't one of this endpoint's (
role not found).Request
curl -X DELETE "https://api.ngris.com/v1/endpoints/019bb1e4-e785-77d2-9966-c3cff31d0a0e/rbac/roles/019b6243-8510-7cbb-a69c-6e29c89b0d65" \
-H "X-API-KEY: <your_api_key>"
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
client.endpoint_rbac.delete_role("019bb1e4-e785-77d2-9966-c3cff31d0a0e", "019b6243-8510-7cbb-a69c-6e29c89b0d65")
Response — 200 OK
{
"deleted_role_uuid": "019b6243-8510-7cbb-a69c-6e29c89b0d65"
}
Was this helpful?