Delete Organization Domains

Organizations Discovery Domain is currently available in Early Access. By using this feature, you agree to the applicable Free Trial terms in Okta’s Master Subscription Agreement.

When deleting an Organization discovery domain, the association between the domain and the organization will be permanently removed.

Once you confirm a Discovery Domain for deletion, this operation cannot be undone.

Delete an Organization domains in the Auth0 Dashboard or with the Management API.

Auth0 Dashboard
Management API

To delete an organization domain in the Auth0 Dashboard:

Navigate to Navigate to Auth0 Dashboard > Organizations.
Select the Domains tab.
Choose Add Domain.
Locate the domain you want to remove.
Open the actions menu (⋮) next to the domain and select Delete.
Confirm the deletion.

Find your Auth0 domainYour Auth0 domain is your tenant name, your regional subdomain, and auth0.com, unless your tenant was created before June 2020 in the US region.Example: If your tenant name is Travel0 and your region US, then your Auth0 domain is travel0.us.auth0.com. If your tenant was created before June 2020 in the US region, then your domain name would be https://travel0.auth0.com.If you have a custom domains configured and verified in Auth0 Dashboard, your domain is your custom domain name. To learn more, read Custom Domains.

Call the Management API Delete Organization Discovery Domain endpoint. Ensure you replace the placeholder values with the appropriate values from your tenant.

curl --request DELETE \
  --url 'https://{yourDomain}/api/v2/organizations/{ORGANIZATION_ID}/discovery-domains/{ORGANIZATION_DOMAIN_ID}' \
  --header 'authorization: Bearer {MGMT_API_ACCESS_TOKEN}'

Value	Description
`MGMT_API_ACCESS_TOKEN`	Access Token for Management API with the scope `delete:organization`.
`ORGANIZATION_ID`	ID of the organization to which you want to add the discovery domain (for example, `org_abc123`).
`ORGANIZATION_DOMAIN_ID`	Required. Email domain you want to associate for Organization Discovery (for example, `example.com`).

Status code	Error description	Message	Cause
`204`		Discovery domain was deleted.
`400`	`invalid_uri`	Invalid request URI. The message will vary depending on the cause.	The path is not valid.
`401`		Invalid token.
`401`		Invalid signature received for JSON Web Token (JWT) validation.
`403`	`insufficient_scope`	Insufficient scope; expected any of: `delete:organization_discovery_domains`.	Tried to read/write a field that is not allowed with provided bearer token scopes.
`404`		The Organization domain does not exist.
`429`		Too many requests. Check the `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset` headers.

Manage Users

Manage Access

Delete Organization Domains