Delete domain
Namespace: microsoft.graph
Deletes 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.
Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.
Permission type | Permissions (from least to most privileged) |
---|---|
Delegated (work or school account) | Domain.ReadWrite.All |
Delegated (personal Microsoft account) | Not supported. |
Application | Domain.ReadWrite.All |
HTTP request
DELETE /domains/{id}
For {id}, specify the domain with its fully qualified domain name.
Request headers
Name | Description |
---|---|
Authorization | Bearer {token}. Required. |
Content-Type | application/json |
Request body
Do not supply a request body for this method.
Response
If successful, this method returns 204 No Content
response code. It does not return a response body.
Example
Request
DELETE https://graph.microsoft.com/v1.0/domains/contoso.com
Response
Note: The response object shown here might be shortened for readability.
HTTP/1.1 204 No Content
Feedback
Submit and view feedback for