Delete RBAC Client

DELETE /v1/endpoints/{id}/rbac/clients/{client_id}

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

id string (uuid) Req
Endpoint UUID.
client_id int64 Req
Client ID to delete.

Response (200 OK)

deleted_client_id int64
The deleted client's ID. (This call returns 200 with a JSON body, not 204.)

Errors

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/clients/11" \ -H "X-API-KEY: <your_api_key>"
Python
from ngris import Ngris client = Ngris(api_key="<your_api_key>") client.endpoint_rbac.delete_client("<endpoint_uuid>", "11")
Response — 200 OK
{ "deleted_client_id": 11 }
On this page
Delete RBAC Client
Iris