Remove Role Membership

DELETE /v1/endpoints/{uuid}/rbac/memberships

Revoke a specific (client_uuid, role_uuid) assignment. The pair is passed in the request body rather than the URL — a membership has no public id of its own, and using the body keeps the API symmetric with create.

Effect is immediate: the next request from this client no longer carries this role's permissions. If that was their only role, they retain authentication ability but get no permission grants — your upstream service should treat them as "logged in but unauthorised".

Path parameters

uuid string (uuid) Req
The endpoint's uuid from /endpoints.

Request body

client_uuid string (uuid) Req
The uuid of the RBAC client whose membership to remove. Resolved under this endpoint only.
role_uuid string (uuid) Req
The uuid of the role to revoke. Resolved under this endpoint only.

Deprecated: client_id and role_id (integers) are still accepted until the sunset. Send client_uuid and role_uuid; sending both forms for different objects is a 400 id_uuid_mismatch.

Response (200 OK)

Returns the full updated memberships array for the endpoint (same shape as List Role Memberships), not 204. Removing a non-existent pairing still returns 200 with the unchanged list.

Deprecated: until the sunset this response also carries the legacy integer id, client_id, role_id and assigned_by fields. Don't use them; read the *_uuid fields.

Errors

400 Bad Request
Missing client_uuid or role_uuid (client_uuid and role_uuid are required), a malformed uuid (client_uuid must be a uuid), both forms naming different objects (id_uuid_mismatch), an integer after the sunset (integer_id_unsupported), unknown fields, or invalid JSON.
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 client / role isn't one of this endpoint's (client_uuid not found / role_uuid not found).
Request
curl -X DELETE "https://api.ngris.com/v1/endpoints/019bb1e4-e785-77d2-9966-c3cff31d0a0e/rbac/memberships" \ -H "X-API-KEY: <your_api_key>" \ -H "Content-Type: application/json" \ -d '{"client_uuid": "019b4b9d-d300-736b-8601-153b3d9f70ee", "role_uuid": "019b6243-8510-7cbb-a69c-6e29c89b0d65"}'
Python
from ngris import Ngris client = Ngris(api_key="<your_api_key>") client.endpoint_rbac.delete_membership("019bb1e4-e785-77d2-9966-c3cff31d0a0e", { "client_uuid": "019b4b9d-d300-736b-8601-153b3d9f70ee", "role_uuid": "019b6243-8510-7cbb-a69c-6e29c89b0d65", })
Response — 200 OK
[ {"client_uuid": "019b4b9d-d300-736b-8601-153b3d9f70ee", "role_uuid": "019b5fc1-0eb5-7dd8-a0e9-a575428f890d", "assigned_by_uuid": "019a52c2-ca1e-78ba-ab5c-50362cc29134", "created_at": "2026-04-01T00:00:00Z", "updated_at": "2026-04-01T00:00:00Z"} ]
Was this helpful?
On this page
Remove Role Membership
Was this helpful?