domain: promote
Article
03/02/2023
3 contributors
Feedback
In this article
Namespace: microsoft.graph
Promote a verified subdomain to the root domain. A verified domain has its isVerified property set to true
.
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
Delegated (work or school account)
Domain.ReadWrite.All
Delegated (personal Microsoft account)
Not supported.
Application
Domain.ReadWrite.All
The work or school account needs to belong to one of the following roles:
Global Administrator
Domain Name Administrator
Partner Tier2 Support
HTTP request
POST /domains/{id}/promote
For {id}, specify the domain with its fully qualified domain name.
Name
Description
Authorization
Bearer {token}. Required.
Content-Type
application/json
Request body
Response
If successful, this call returns a 200 OK
response and a Boolean value that specifies the publishing status of the content type.
Example
Request
POST https://graph.microsoft.com/v1.0/domains/contoso.com/promote
// Code snippets are only available for the latest version. Current version is 5.x
var graphClient = new GraphServiceClient(requestAdapter);
var result = await graphClient.Domains["{domain-id}"].Promote.PostAsync();
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation .
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
//other-imports
)
graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)
result, err := graphClient.Domains().ByDomainId("domain-id").Promote().Post(context.Background(), nil)
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation .
GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();
graphClient.domains("contoso.com")
.promote()
.buildRequest()
.post();
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation .
<?php
// THIS SNIPPET IS A PREVIEW FOR THE KIOTA BASED SDK. NON-PRODUCTION USE ONLY
$graphServiceClient = new GraphServiceClient($requestAdapter);
$result = $graphServiceClient->domains()->byDomainId('domain-id')->promote()->post();
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation .
Response
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Edm.Boolean",
"value": true
}