domain: verify

Important: APIs under the /beta version in Microsoft Graph are in preview and are subject to change. Use of these APIs in production applications is not supported.

Validates the ownership of the domain.

Important: Only applies to an unverified domain. For an unverified domain, the isVerified property of the domain is false.

Prerequisites

One of the following scopes is required to execute this API: Directory.Read.All or Domain.ReadWrite.All

HTTP request

POST /domains/{id}/verify

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

Response

If successful, this method returns 200, OK response code and domain object in the response body.

Example

Request
POST https://graph.microsoft.com/beta/domains/contoso.com/verify
Response

Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 192

{
  "authenticationType": "authenticationType-value",
  "availabilityStatus": "availabilityStatus-value",
  "isAdminManaged": true,
  "isDefault": true,
  "isInitial": true,
  "isRoot": true,
  "name": "contoso.com"
}