> ## Documentation Index
> Fetch the complete documentation index at: https://auth0.generaltranslation.app/llms.txt
> Use this file to discover all available pages before exploring further.

> Learn how to create or delete Organization Discovery Domains using the Auth0 Dashboard and Management API.

# Delete Organization Domains

<Warning>
  Organizations Discovery Domain is currently available in [Early Access](/docs/troubleshoot/product-lifecycle/product-release-stages). By using this feature, you agree to the applicable Free Trial terms in Okta’s [Master Subscription Agreement](https://www.okta.com/legal/).
</Warning>

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

<Warning>
  Once you confirm a Discovery Domain for deletion, this operation cannot be undone.
</Warning>

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

<Tabs>
  <Tab title="Auth0 Dashboard">
    To delete an organization domain in the Auth0 Dashboard:

    1. Navigate to Navigate to [Auth0 Dashboard > Organizations](https://manage.auth0.com/#/organizations).
    2. Select the **Domains** tab.
    3. Choose **Add Domain**.
    4. Locate the domain you want to remove.
    5. Open the actions menu (⋮) next to the domain and select **Delete**.
    6. Confirm the deletion.
  </Tab>

  <Tab title="Management API">
    <Callout icon="file-lines" color="#0EA5E9" iconType="regular">
      <b>Find your Auth0 domain</b>

      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](/docs/customize/custom-domains).
    </Callout>

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

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

    | <b>Value</b>             | <b>Description</b>                                                                                                 |
    | ------------------------ | ------------------------------------------------------------------------------------------------------------------ |
    | `MGMT_API_ACCESS_TOKEN`  | [Access Token for Management API](/docs/tokens/management-api-access-tokens) 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`).             |

    | <b> Status code </b> | <b> Error description </b> | <b>Message</b>                                                                                              | <b>Cause</b>                                                                       |
    | -------------------- | -------------------------- | ----------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
    | `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. |                                                                                    |
  </Tab>
</Tabs>