Create tenantTag
Namespace: microsoft.graph.managedTenants
Important
APIs under the /beta
version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
Create a new tenantTag object.
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) | ManagedTenants.WriteRead.All |
Delegated (personal Microsoft account) | Not supported. |
Application | Not supported. |
HTTP request
POST /tenantRelationships/managedTenants/tenantTags
Request headers
Name | Description |
---|---|
Authorization | Bearer {token}. Required. |
Content-Type | application/json. Required. |
Request body
In the request body, supply a JSON representation of the tenantTag object.
The following table shows the properties that are required when you create the tenantTag.
Property | Type | Description |
---|---|---|
displayName | String | The display name for the tenant tag. |
description | String | The description for the tenant tag. |
Response
If successful, this method returns a 201 Created
response code and a tenantTag object in the response body.
Examples
Request
POST https://graph.microsoft.com/beta/tenantRelationships/managedTenants/tenantTags
Content-Type: application/json
{
"displayName": "Support",
"description": "Tenants that have purchased extended support"
}
Response
Note: The response object shown here might be shortened for readability.
HTTP/1.1 201 Created
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantTags/$entity",
"id": "11103b2b-0e28-456b-901d-45f98890ab1d",
"displayName": "Support",
"description": "Tenants that have purchased extended support",
"tenantIds": [],
"isDeleted": null,
"createdDateTime": "2021-07-11T19:31:49.807267Z",
"createdByUserId": "cad28f13-0158-43c5-9c59-952f2caa62c0",
"lastActionDateTime": "2021-07-11T19:31:49.8072716Z",
"lastActionByUserId": "cad28f13-0158-43c5-9c59-952f2caa62c0"
}
Feedback
Submit and view feedback for