Revoke this key's grant on a domain

DELETE

/v1/domains/{domain}

const url = 'https://api.mailerdash.com/v1/domains/example';
const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request DELETE \
  --url https://api.mailerdash.com/v1/domains/example \
  --header 'Authorization: Bearer <token>'

Revokes THIS key’s grant on the domain and retires its DKIM if no other live owner remains. Requires admin key. Changed in 0.13.28: this used to delete every grant on the domain regardless of which key held it, and without retiring DKIM. A domain can legitimately be granted to more than one key — for example a customer who buys both API sending and mailbox hosting on the same domain — so the delete is now scoped to the authenticating key. Grants held by other keys are left untouched.

Authorizations

BearerAuth

Parameters

Path Parameters

domain

required

string

Responses

204

Removed

401

Unauthorized

403

Admin key required

404

Domain not found