DELETE user/…/email-address/…

Removes an email address from the collection of email addresses of a user account.

Note that the primary email address cannot be removed. In order to remove the primary email address, first add another email address to the account and make that the primary email address.

An email address may be removed by the account holder, or by an administrator (staff user) with MANAGE_USERS permissions in the case the account is managed by the same organization.

Resource URL

https://www.drillster.com/api/2.1.1/user/{user_id}/email-address/{email}

Parameters

Field	Description
`user_id` required	The user ID of the user to retrieve details for. To retrieve the details of the own user account, the value `self` may be used as well. Example value: `7OuHq-RcQO_snGWR58TnBw`
`email` required	The email address to be removed. The email address must be linked to the given user account. Example value: `john%40example.com`

Response

An HTTP 204 (No content) response indicating that the email address was deleted from the user account.

Error responses

The following error situations are possible:

ID	Response code	Description
`not_authenticated`	401 (Unauthorized)	Caller is not authenticated
`no_access`	403 (Forbidden)	Caller has no access to the account
`missing_input`	400 (Bad request)	An email address is required
`cannot_remove_primary_email`	400 (Bad request)	The primary email address cannot be removed from the account. In order to remove it, another linked email address needs to be made primary first.
`not_owner`	400 (Bad request)	The given email address is not linked to this account
`invalid_email_address`	400 (Bad request)	The given email address is not valid

Last updated on 2025-04-18