Delete Alias

Remove an email alias from a domain.

DELETE /domains/:domain_name/aliases/:alias_id

Example: /domains/example.com/aliases/alias_01k3tgwp77edd8zfk0sv0mrgwg

This endpoint permanently removes an email alias from the domain. Once deleted, the alias cannot be recovered and any emails that would have matched this alias will no longer be processed according to its rules.

The endpoint returns a 204 No Content status on successful deletion, regardless of whether the alias existed or not.

Path Parameters

domain_name string required

The domain name from which to delete the alias.

alias_id string required

The ID of the alias to delete.

Example

curl -X DELETE https://api.mailcast.io/v1/domains/:domain_name/aliases/:alias_id \
     -H "Authorization: Bearer YOUR_API_TOKEN" \
     -H "Content-Type: application/json"

Response 204