<iframe src="https://www.googletagmanager.com/ns.html?id=GTM-M74D8PB" height="0" width="0" style="display:none;visibility:hidden">
Loading
Skip to NavigationSkip to Main Content
System Status
Announcements
Announcements
Search
Search
Select Language

Okta Custom Domain Deletion Option Is Missing After Upgrading to Okta Identity Engine

Okta Identity Engine
Custom URL Domains

Overview

An Okta custom domain deletion option is missing or fails with an HTTP 409 Conflict error after upgrading to Okta Identity Engine (OIE). This occurs because the active OIE Classic Interop bridge enforces safeguards that prevent the deletion of Classic-originated custom domains. To resolve this, Okta Support must enable a specific feature flag to allow the deletion.

Applies To

  • Okta Identity Engine (OIE)
  • Custom Domains
  • Brands

Cause

When an Okta tenant upgrades from Okta Classic Engine to Okta Identity Engine (OIE), Okta automatically enables the OIE Classic Interop bridge to support per-app authentication pipeline routing. During the upgrade, Okta clones and binds pre-existing Classic custom domains and brands together (classicBrandId). While the Classic Interop bridge is active, Okta enforces safeguards that hide the Delete button in the Admin Console and block API deletion with an HTTP 409 Conflict error on Classic-originated custom domains to prevent accidental service disruption.

Solution

How is the custom domain deleted?

Verify that the custom domain is no longer receiving active production authentication traffic, contact Okta Support to enable the required feature flag, and delete the custom domain in the Admin Console.

  1. Audit the tenant to confirm that the custom domain is no longer receiving active production authentication traffic.
  2. Verify that administrators migrated any applications previously using the domain to the OIE pipeline or reconfigured them to use an alternative domain or the default Okta URL.
  3. Open a support case via the Okta Help Center.
  4. Request enablement of the feature flag on the tenant that allows custom domain removal.
  5. Provide the Okta Org URL, the specific custom domain name to remove, and confirmation that the domain is not serving active traffic.
  6. Sign in to the Okta Admin Console as a Super Admin after Okta Support enables the feature flag.
  7. Navigate to Customizations > Domain.
  8. Locate the custom domain and choose Delete. Alternatively, submit the deletion request via the Domains API.
  9. Confirm the deletion.
Loading
Okta Custom Domain Deletion Option Is Missing After Upgrading to Okta Identity Engine | Okta Support