Delete a user

A user is deleted through a DELETE call containing the unique, permanent userId of the user. The action also deletes all registered authenticators for this user.

Irreversible Destructive Action

This action is destructive and cannot be reversed.

Send an HTTP request to the users endpoint

For detailed information on the HTTP request parameters and response fields, see the Users endpoint page of the API reference documentation.

Send the DELETE https://{instance}.mauth.nevis.cloud/api/v1/users/{userId} call with your instance ID and the userId of the given user. Your access key must be sent in the Authorization Bearer token header

HTTP request examples

cURL

cURL code sample for deleting a user

# Set $userId
curl "https://$instance.mauth.nevis.cloud/api/v1/users/$userId" \
  -X DELETE \
  -H "Authorization: Bearer $access_key"

Python 3

Python 3 code sample for deleting a user

userId = '7e16ba00-92e2-4fcb-b30e-1af8fdc843aa'
resp = requests.delete(f'https://{instance}.mauth.nevis.cloud/api/v1/users/{userId}',
                       headers = {'authorization': f'Bearer {access_key}'})
print(resp.status_code) # => 204

HTTP response examples

No response body is returned in case of successful deletion.

204 No Content: User and associated authenticators are successfully deleted.

404 Not found: No user with provided userId exists.