Remove a Member
Remove a member from your active account. The member immediately loses access to the account and all of its resources. Their personal user record is not deleted — only their membership in this account.
The account owner cannot be removed. There is always exactly one owner, and ownership can only be handed to another member via /account/transfer-owner. You also cannot remove yourself with this endpoint — to leave an account yourself, use POST /v1/account/leave (an owner transfers ownership first).
Permission required
Calling this endpoint requires the members:delete permission on the active account.
Path parameters
user_uuid string (uuid) Req
The
user_uuid of the member to remove. Look this up via /account/members.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)
success boolean
true when the member was removed.Errors
400 Bad Request
An attempt to remove yourself, an attempt to remove the account owner, or an integer id after the sunset (
integer_id_unsupported).401 Unauthorized
Missing or invalid auth.
403 Forbidden
No active account selected, or the caller lacks
members:delete.404 Not Found
Member not found — the uuid is not a member of the active account.Request
curl -X DELETE "https://api.ngris.com/v1/account/members/019a5f28-be41-7264-9ed2-2e6aceae8290" \
-H "X-API-KEY: <your_api_key>"
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
client._delete_void("/account/members/019a5f28-be41-7264-9ed2-2e6aceae8290")
Response — 200 OK
{
"success": true
}
Was this helpful?