volanea
Start sending

Remove a domain

DELETE/v1/domains/{id}

Secret key — sk_… or sk_test_… · Base URL https://api.volanea.com

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

  • idstringrequired

    Domain id.

Response

Deleted.

  • successbooleanrequired

Errors

Every failure returns the standard envelope — branch on `code`, never on the wording of `error`.

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

Request

curl https://api.volanea.com/v1/domains/id_123 \
  -X DELETE \
  -H "Authorization: Bearer sk_..."

Response

200 · application/json

{
  "success": true,
  "data": {
    "success": true
  }
}

92 endpoints · OpenAPI document