Skip to content
Dashboard
Theme
Theme

Remove a custom domain

DELETE /v1/custom_domains/{custom_domain}: Remove a custom domain.

View Markdown

DELETE /v1/custom_domains/{custom_domain}

Portal, broker and SCIM hostnames are removed from Cloudflare for SaaS first (a hostname Cloudflare no longer has counts as removed), together with any ACS host aliases bound to them.

Scope
custom_domains:write
Auth
Secret key (sk_…)
Since
1.0
  • custom_domain string Required

  • OhAuthCat-Version string

    Minor version; defaults to the environment’s pin.

  • Idempotency-Key string

    Honoured for 24 h; a replay returns the original response.

    min length 1 · max length 255

Errors share one shape; see the error code catalogue.

curl -X DELETE \
"https://api.ohauthcat.com/v1/custom_domains/cdom_01J9Z3K5V7W8X9Y0Z1A2B3C4D5" \
-H "Authorization: Bearer $OHAUTHCAT_API_KEY"
Response 200
{
"id": "01J9Z3K5V7W8X9Y0Z1A2B3C4D5",
"deleted": true
}