| title | Delete domain |
|---|---|
| description | Delete a domain from a tenant. |
| author | tafra00 |
| ms.localizationpriority | medium |
| ms.subservice | entra-directory-management |
| doc_type | apiPageType |
| ms.date | 10/25/2024 |
Namespace: microsoft.graph
Delete a domain from a tenant.
Important:
- Deleted domains are not recoverable.
- Attempts to delete will fail if there are any resources or objects still dependent on the domain. You can find all dependent resources by using the List domainNameReferences API.
[!INCLUDE national-cloud-support]
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.
[!INCLUDE permissions-table]
[!INCLUDE rbac-domain-apis-write]
DELETE /domains/{id}For {id}, specify the domain with its fully qualified domain name.
| Name | Description |
|---|---|
| Authorization | Bearer {token}. Required. Learn more about authentication and authorization. |
| Content-Type | application/json |
Don't supply a request body for this method.
If successful, this method returns 204 No Content response code. It does not return a response body.
DELETE https://graph.microsoft.com/v1.0/domains/contoso.com[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
Note: The response object shown here might be shortened for readability.
HTTP/1.1 204 No Content