Delete an authenticator

An authenticator is deleted through a DELETE call containing the unique, permanent authenticatorId of the authenticator. After deleting an authenticator, the user can no longer use this authenticator for authentication.

Irreversible Destructive Action

This action is destructive and cannot be reversed.

Send an HTTP request to the authenticators endpoint

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

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

HTTP request examples

cURL

cURL code sample for deleting an authenticator name

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

Python 3

Phyton 3 code sample for deleting an authenticator name

authenticator_id = 'f3ef70fc-9231-48f8-8e81-8eef7826d594'
resp = requests.delete(f'https://{instance}.mauth.nevis.cloud/api/v1/authenticators/{authenticator_id}',
                       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: Authenticator is successfully deleted.

404 Not found: No authenticator with provided authenticatorId exists.