Remove a custom domain

DELETE

/status-pages/{id}/domains/{domain_id}

const url = 'https://api.perstat.io/status-pages/example/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.perstat.io/status-pages/example/domains/example \
  --header 'Authorization: Bearer <token>'

Removes a custom domain from the status page and deactivates serving for it. Returns 204 on success; if deactivating a verified domain fails upstream, the call returns 502 and the domain is kept so the call can be retried. Requires project management rights. Accepts API keys with the status-pages:write scope, subject to current role and resource grants.

Authorizations

bearer

Parameters

Path Parameters

required

string

domain_id

required

string

Responses

204

Request succeeded. The response has no body.

401

Authentication is missing or invalid.

403

The authenticated caller does not have permission to perform this operation.

404

No accessible resource matches the supplied identifier.

502

An upstream service could not complete the request.