Remove custom domain

DELETE /app/dashboards/{id}/domains/custom-domain

Removes the custom domain from a dashboard. Requires admin role.

This endpoint works in any customDomainStatus, including awaiting_dns. Removal is always asynchronous: a cleanup job is queued and customDomainStatus is set to removing until custom domain fields are cleared. The response is 204 No Content immediately; poll Get dashboard domains until customDomain is absent.

Calling DELETE again while status is removing returns 204 and re-queues cleanup (safe if a prior cleanup enqueue failed).

After removal completes, you can set a new custom domain via Update dashboard domains.

Path parameters

Request

See API Basics for required headers.

This endpoint takes no request body.

Sample request

curl -X DELETE https://api.statusdashboard.com/app/dashboards/a1b2c3d4-e5f6-7890-abcd-ef1234567890/domains/custom-domain \
  -H "Authorization: Bearer bcf847abf5c6:def456"

Sample response

Status: 204 No Content

No response body. Poll Get dashboard domains until customDomain is absent. While cleanup runs, customDomainStatus is removing.

Error responses