---
title: "Remove a domain"
method: DELETE
path: "/v1/domains/{id}"
tags: ["Domains"]
---

# Remove a domain

`DELETE /v1/domains/{id}`

## Request

- Base URL: `https://api.volanea.com`
- URL: `https://api.volanea.com/v1/domains/{id}`
- Auth: HTTP bearer

Removes the domain from this project.

The provider identity is torn down **only if no other project still uses the same domain** — SES identities are account-global, so an unconditional delete would revoke another project's DKIM signing along with yours. Domains that were adopted rather than provisioned by Volanea are never torn down at the provider.

Sends from addresses on this domain start failing as soon as the record is gone. Mail already queued is not recalled.

## Path parameters

- `id` string, required

## Response `200`

Deleted.

- object
  - `success` boolean, required

## Other responses

- `401`: Missing or invalid API key.
- `404`: Not found.
- `422`: Request validation failed (code `validation_error`, 422).

---

[API](https://skmtc.dev/volanea/apis/volanea-api.md) · [All operations](https://skmtc.dev/volanea/apis/volanea-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volanea/apis/volanea-api/revisions/9e187ae84fda?raw)