Delete Organization Domains
Organizations Discovery Domain is currently in Early Access. By using this feature, you agree to the applicable Free Trial terms in Okta’s Master Subscription Agreement. To learn more, read Product Release Stages.
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 Organization domains
Delete an Organization domains in the Auth0 Dashboard or the 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 domain name
Your 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}'Was this helpful?
| Placeholder | 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. |