Delete RBAC Client
Permanently remove an RBAC client from the endpoint. The client and all its credentials, role memberships, sessions, and login-history rows are deleted in a single transaction. Once deleted: future authentication attempts using this client's credentials are rejected.
To preserve audit history but block future logins, use PUT .../status with status: "disabled" (or "revoked") instead.
Path parameters
uuid string (uuid) Req
The endpoint's
uuid from /endpoints.client_uuid string (uuid) Req
The client's
uuid from /rbac/clients. 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_client_uuid string (uuid)
The deleted client'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 client 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 (
endpoint not found), or the client isn't a client of this endpoint (client not found).Request
curl -X DELETE "https://api.ngris.com/v1/endpoints/019bb1e4-e785-77d2-9966-c3cff31d0a0e/rbac/clients/019b4b9d-d300-736b-8601-153b3d9f70ee" \
-H "X-API-KEY: <your_api_key>"
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
client.endpoint_rbac.delete_client("019bb1e4-e785-77d2-9966-c3cff31d0a0e", "019b4b9d-d300-736b-8601-153b3d9f70ee")
Response — 200 OK
{
"deleted_client_uuid": "019b4b9d-d300-736b-8601-153b3d9f70ee"
}
Was this helpful?