Clerk API (unofficial showcase)
DELETE/email_addresses/{email_address_id}

Delete an email address

Deletes an email address by its identifier. Use email_address_id to select the address to remove. The response confirms the deletion and identifies the deleted object.

1 parameter
email_address_idstringrequired
The unique identifier of the email address to delete.

6 status codes
200Returns a deletion result containing the object type and a flag confirming whether the object was deleted; it may also include the object's ID, slug, or external ID.
objectstringrequired
idstringoptional
slugstringoptional
deletedbooleanrequired
external_idstringoptional
400Returned when the request is not successful.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
401Returned when authentication is invalid.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
403Returned when authorization is invalid.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
404Returned when the email address resource is not found.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
409Returned when the request conflicts with the current state.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional

Error handling

An invalid request returns a 400, invalid authentication returns a 401, and invalid authorization returns a 403. The email_address_id path parameter must identify an existing email address; a 404 indicates the resource was not found, and a 409 indicates a conflict with the current state.