Updates from: 08/25/2021 03:34:01
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Application Post Calls https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-post-calls.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Create [call](../resources/call.md) enables your bot to create a new outgoing peer-to-peer or group call, or join an existing meeting. You will need to [register the calling bot](/microsoftteams/platform/concepts/calls-and-meetings/registering-calling-bot) and go through the list of permissions needed as mentioned below.
+Create [call](../resources/call.md) enables your bot to create a new outgoing peer-to-peer or group call, or join an existing meeting. You will need to [register the calling bot](/microsoftteams/platform/concepts/calls-and-meetings/registering-calling-bot) and go through the list of permissions needed.
## Permissions
One of the following permissions is required to call this API. To learn more, in
|:|:-| | Delegated (work or school account) | Not Supported | | Delegated (personal Microsoft account) | Not Supported |
-| Application | Calls.JoinGroupCallsasGuest.All, Calls.JoinGroupCalls.All, Calls.Initiate.All, Calls.InitiateGroupCalls.All |
+| Application | Calls.JoinGroupCalls.Chat*, Calls.JoinGroupCallsasGuest.All, Calls.JoinGroupCalls.All, Calls.Initiate.All, Calls.InitiateGroupCalls.All |
-> **Note:** For a call with app-hosted media, you need the Calls.AccessMedia.All permission in addition to one of the permissions listed.
+> **Notes:** For a call with app-hosted media, you need the Calls.AccessMedia.All or the Calls.AccessMedia.Chat* permission in addition to one of the permissions listed.
+>
+> Permissions marked with * use [resource-specific consent]( https://aka.ms/teams-rsc).
## HTTP request <!-- { "blockType": "ignored" } -->
If successful, this method returns a `201 Created` response code and a [call](..
> **Note:** This call needs the Calls.Initiate.All permission. ##### Request
-The following example shows the request which makes a peer-to-peer call between the bot and the specified user. In this example, the media is hosted by the service. The values of authorization token, callback URL, application ID, application name, user ID, user name, and tenant ID must be replaced with actual values to make the example work.
+The following example shows a request that makes a peer-to-peer call between the bot and the specified user. In this example, the media is hosted by the service. The values of authorization token, callback URL, application ID, application name, user ID, user name, and tenant ID must be replaced with actual values to make the example work.
# [HTTP](#tab/http)
Content-Type: application/json
> **Note**: This example needs Calls.Initiate.All and Calls.AccessMedia.All permissions. ##### Request
-The following example shows the request which makes a peer-to-peer call between the bot and the specified user. In this example the media is hosted locally by the application. The values of authorization token, callback url, application id, application name, user id, user name and tenant id must be replaced with actual values to make the example work.
+The following example shows a request that makes a peer-to-peer call between the bot and the specified user. In this example, the media is hosted locally by the application. The values of authorization token, callback URL, application ID, application name, user ID, user name, and tenant ID must be replaced with actual values to make the example work.
# [HTTP](#tab/http)
Content-Type: application/json
`<Media Session Configuration>` is the serialized media session configuration which contains the session information of the media stack. Specific information about audio, video, VBSS ssession information should be passed here.
-Sample audio media session blob is shown below
+The following is an example of an audio media session blob.
```json {\"mpUri\":\"net.tcp://bot.contoso.com:18732/MediaProcessor\",\"audioRenderContexts\":[\"14778cc4-f54c-43c7-989f-9092e34ef784\"],\"videoRenderContexts\":[],\"audioSourceContexts\":[\"a5dcfc9b-5a54-48ef-86f5-1fdd8508741a\"],\"videoSourceContexts\":[],\"dataRenderContexts\":null,\"dataSourceContexts\":null,\"supportedAudioFormat\":\"Pcm16K\",\"videoSinkEncodingFormats\":[],\"mpMediaSessionId\":\"2379cf46-acf3-4fef-a914-be9627075320\",\"regionAffinity\":null,\"skypeMediaBotsVersion\":\"1.11.1.0086\",\"mediaStackVersion\":\"2018.53.1.1\",\"mpVersion\":\"7.2.0.3881\",\"callId\":\"1b69b141-7f1a-4033-9c34-202737190a20\"} ```
To join the scheduled meeting we will need to get the thread id, message id, org
This information can be obtained from [Get Online Meetings API](../api/onlinemeeting-get.md). The values of authorization token, callback url, application id, application name, user id, user name and tenant id must be replaced along with the details obtained from [Get Online Meetings API](../api/onlinemeeting-get.md) with actual values to make the example work.
-> **Note:** This example needs the `Calls.JoinGroupCalls.All` permission.
+> **Note:** This example needs the `Calls.JoinGroupCalls.All` permission or the `Calls.JoinGroupCalls.Chat` [resource-specific permission](https://aka.ms/teams-rsc).
##### Request
Content-Type: application/json
>**Note:** For join meeting scenarios apart from call state notifications, we receive roster notifications. ### Example 6: Join scheduled meeting with app hosted media
-To join the meeting with application hosted media update the media config with the [AppHostedMediaConfig](../resources/apphostedmediaconfig.md) as shown below, In the sample provided above.
+To join the meeting with application hosted media, update the media config with the [appHostedMediaConfig](../resources/apphostedmediaconfig.md) as shown in the following example.
+
+>**Note:** This example needs the `Calls.AccessMedia.All` permission or the `Calls.AccessMedia.Chat` [resource-specific permission](https://aka.ms/teams-rsc).
<!-- { "blockType": "example",
v1.0 Contenttype Addcopy https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contenttype-addcopy.md
If successful, this call returns a `201 Created` response code and a [contentTyp
} --> ```http
-POST https://graph.microsoft.com/beta/sites/id/lists/{list-id}/contentTypes/addCopy
+POST https://graph.microsoft.com/beta/sites/{site-id}/lists/{list-id}/contentTypes/addCopy
Content-Type: application/json {
v1.0 Contenttype Associatewithhubsites https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contenttype-associatewithhubsites.md
If successful, this action returns a `204 No Content` response code.
} --> ```http
-POST https://graph.microsoft.com/beta/sites/id/contentTypes/id/associateWithHubSites
+POST https://graph.microsoft.com/beta/sites/{siteId}/contentTypes/{contentTypeId}/associateWithHubSites
Content-Type: application/json {
v1.0 Contenttype Post Columns https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contenttype-post-columns.md
POST https://graph.microsoft.com/beta/sites/{site-id}/contentTypes/{contentType-
Content-Type: application/json {
- "sourceColumn@odata.bind": "https://graph.microsoft.com/beta/sites/root/columns/99ddcf45-e2f7-4f17-82b0-6fba34445103"
+ "sourceColumn@odata.bind":"https://graph.microsoft.com/beta/sites/root/columns/99ddcf45-e2f7-4f17-82b0-6fba34445103"
} ```
Content-type: application/json
"maxLength": 255 } }- ```
v1.0 Contenttype Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/contenttype-update.md
Title: "Update contentType"
-description: "Update a content type"
+description: "Update a content type."
localization_priority: Normal doc_type: apiPageType ms.prod: "sites-and-lists"
PATCH https://graph.microsoft.com/beta/sites/{site-id}/contentTypes/{contentType
Content-Type: application/json {
- "name": "updatedCt",
- "documentSet": {
- "shouldPrefixNameToFile": true,
- "allowedContentTypes": [{
- "id": "0x0101",
- "name": "Document"
- }],
- "defaultContents": [{
- "fileName": "a.txt",
- "contentType": {
- "id": "0x0101"
- }
- },
- {
- "fileName": "b.txt",
- "contentType": {
- "id": "0x0101"
- }
- }
- ],
- "sharedColumns": [{
- "name": "Description",
- "id": "cbb92da4-fd46-4c7d-af6c-3128c2a5576e"
- },
- {
- "name": "Address",
- "id": "fc2e188e-ba91-48c9-9dd3-16431afddd50"
- }
- ],
- "welcomePageColumns": [{
- "name": "Address",
- "id": "fc2e188e-ba91-48c9-9dd3-16431afddd50"
- }]
- }
+ "name":"updatedCt",
+ "documentSet":{
+ "shouldPrefixNameToFile":true,
+ "allowedContentTypes":[
+ {
+ "id":"0x0101",
+ "name":"Document"
+ }
+ ],
+ "defaultContents":[
+ {
+ "fileName":"a.txt",
+ "contentType":{
+ "id":"0x0101"
+ }
+ },
+ {
+ "fileName":"b.txt",
+ "contentType":{
+ "id":"0x0101"
+ }
+ }
+ ],
+ "sharedColumns":[
+ {
+ "name":"Description",
+ "id":"cbb92da4-fd46-4c7d-af6c-3128c2a5576e"
+ },
+ {
+ "name":"Address",
+ "id":"fc2e188e-ba91-48c9-9dd3-16431afddd50"
+ }
+ ],
+ "welcomePageColumns":[
+ {
+ "name":"Address",
+ "id":"fc2e188e-ba91-48c9-9dd3-16431afddd50"
+ }
+ ]
+ }
}- ``` # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/update-contenttype-javascript-snippets.md)]
HTTP/1.1 200 OK
Content-type: application/json {
- "id": "0x0101009B237E76EF94DC49B4E58139041E7C60",
- "description": "",
- "eTag": "\"7\"",
- "group": "Custom Content Types",
- "hidden": false,
- "name": "testdoc",
- "parentId": "0x0101",
- "base": {
- "id": "0x0101",
- "name": "Document"
- }
+ "id":"0x0101009B237E76EF94DC49B4E58139041E7C60",
+ "description":"",
+ "eTag":"\"7\"",
+ "group":"Custom Content Types",
+ "hidden":false,
+ "name":"testdoc",
+ "parentId":"0x0101",
+ "base":{
+ "id":"0x0101",
+ "name":"Document"
+ }
}- ``` [contentType]: ../resources/contentType.md
v1.0 Conversation Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/conversation-delete.md
Do not supply a request body for this method.
If successful, this method returns `204 No Content` response code. It does not return anything in the response body. ## Example
-##### Request
-Here is an example of the request.
+### Request
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
DELETE https://graph.microsoft.com/beta/groups/{id}/conversations/{id}
-##### Response
-Here is an example of the response.
+### Response
+The following is an example of the response.
<!-- { "blockType": "response", "truncated": true
v1.0 Conversation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/conversation-get.md
GET /groups/{id}/conversations/{id}
``` ## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response.
## Request headers | Header | Value | |:|:--|
Do not supply a request body for this method.
If successful, this method returns a `200 OK` response code and [conversation](../resources/conversation.md) object in the response body. ## Example
-##### Request
-Here is an example of the request.
+### Request
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
Here is an example of the request.
"name": "get_conversation" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/groups/{id}/conversations/{id}
+GET https://graph.microsoft.com/beta/groups/4d81ce71-486c-41e9-afc5-e41bf2d0722a/conversations/AAQkAGRhZmRhMWM3LTYwZTktNDZmYy1hNWU1LThhZWU4NzI2YTEyZgAQABKPPJ682apIiV1UFlj7XxY=
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-conversation-csharp-snippets.md)]
GET https://graph.microsoft.com/beta/groups/{id}/conversations/{id}
-##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Here is an example of the response. Note: The response object shown here might b
```http HTTP/1.1 200 OK Content-type: application/json
-Content-length: 201
{
- "topic": "topic-value",
- "hasAttachments": true,
- "lastDeliveredDateTime": "2016-10-19T10:37:00Z",
- "uniqueSenders": [
- "uniqueSenders-value"
- ],
- "preview": "preview-value",
- "id": "id-value"
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#groups('4d81ce71-486c-41e9-afc5-e41bf2d0722a')/conversations/$entity",
+ "id": "AAQkAGRhZmRhMWM3LTYwZTktNDZmYy1hNWU1LThhZWU4NzI2YTEyZgAQABKPPJ682apIiV1UFlj7XxY=",
+ "topic": "The new Ask HR group is ready",
+ "hasAttachments": false,
+ "lastDeliveredDateTime": "2021-08-02T11:42:38Z",
+ "uniqueSenders": [
+ "Ask HR"
+ ],
+ "preview": "Welcome to the Ask HR group.Use the group to share ideas, files, and important dates.Start a conversationRead group conversations or start your own.Add to the team siteStart sharing and collaborating on content in SharePoint.Share filesView,"
} ```
v1.0 Conversation List Threads https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/conversation-list-threads.md
One of the following permissions is required to call this API. To learn more, in
GET /groups/{id}/conversations/{id}/threads ``` ## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response for example, to retrieve the **toRecipients** and **ccRecipients** properties.
+ ## Request headers | Header | Value | |:|:--|
Do not supply a request body for this method.
If successful, this method returns a `200 OK` response code and collection of [conversationThread](../resources/conversationthread.md) objects in the response body. ## Example
-##### Request
-Here is an example of the request.
+### Request
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
Here is an example of the request.
"name": "get_threads" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/groups/{id}/conversations/{id}/threads
+GET https://graph.microsoft.com/beta/groups/4d81ce71-486c-41e9-afc5-e41bf2d0722a/conversations/AAQkAGRhZmRhMWM3LTYwZTktNDZmYy1hNWU1LThhZWU4NzI2YTEyZgAQABKPPJ682apIiV1UFlj7XxY=/threads
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-threads-csharp-snippets.md)]
GET https://graph.microsoft.com/beta/groups/{id}/conversations/{id}/threads
-##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Here is an example of the response. Note: The response object shown here might b
```http HTTP/1.1 200 OK Content-type: application/json
-Content-length: 536
{
- "value": [
- {
- "toRecipients": [
- {
- "emailAddress": {
- "name": "name-value",
- "address": "address-value"
- }
- }
- ],
- "topic": "topic-value",
- "hasAttachments": true,
- "lastDeliveredDateTime": "2016-10-19T10:37:00Z",
- "uniqueSenders": [
- "uniqueSenders-value"
- ],
- "ccRecipients": [
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#groups('4d81ce71-486c-41e9-afc5-e41bf2d0722a')/conversations('AAQkAGRhZmRhMWM3LTYwZTktNDZmYy1hNWU1LThhZWU4NzI2YTEyZgAQABKPPJ682apIiV1UFlj7XxY%3D')/threads",
+ "value": [
{
- "emailAddress": {
- "name": "name-value",
- "address": "address-value"
- }
+ "id": "AAQkAGRhZmRhMWM3LTYwZTktNDZmYy1hNWU1LThhZWU4NzI2YTEyZgMkABAAEo88nrzZqkiJXVQWWPtfFhAAEo88nrzZqkiJXVQWWPtfFg==",
+ "topic": "The new Ask HR group is ready",
+ "hasAttachments": false,
+ "lastDeliveredDateTime": "2021-08-02T11:42:38Z",
+ "uniqueSenders": [
+ "Ask HR"
+ ],
+ "preview": "Welcome to the Ask HR group.Use the group to share ideas, files, and important dates.Start a conversationRead group conversations or start your own.Add to the team siteStart sharing and collaborating on content in SharePoint.Share filesView,",
+ "isLocked": false
}
- ]
- }
- ]
+ ]
} ```
v1.0 Conversation Post Threads https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/conversation-post-threads.md
POST /groups/{id}/conversations/{id}/threads
| Authorization | string | Bearer {token}. Required. | ## Request body
-In the request body, supply a JSON representation of [ConversationThread](../resources/conversationthread.md) object.
+In the request body, supply a JSON representation of the [conversationThread](../resources/conversationthread.md) object.
## Response
-If successful, this method returns `201 Created` response code and [ConversationThread](../resources/conversationthread.md) object in the response body.
+If successful, this method returns `201 Created` response code and a [conversationThread](../resources/conversationthread.md) object in the response body.
## Example
-##### Request
-Here is an example of the request.
+### Request
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
Here is an example of the request.
"name": "create_conversationthread_from_conversation" }--> ```http
-POST https://graph.microsoft.com/beta/groups/{id}/conversations/{id}/threads
+POST https://graph.microsoft.com/beta/groups/4d81ce71-486c-41e9-afc5-e41bf2d0722a/conversations/AAQkAGRhZmRhMWM3LTYwZTktNDZmYy1hNWU1LThhZWU4NzI2YTEyZgAQABKPPJ682apIiV1UFlj7XxY=/threads
Content-type: application/json {
- "topic": "topic-value",
- "posts": [{
- "body": {
- "contentType": "html",
- "content": "this is body content"
- }
- }]
+ "topic": "Take your wellness days and rest",
+ "posts": [
+ {
+ "body": {
+ "contentType": "html",
+ "content": "Waiting for the summer holidays."
+ }
+ }
+ ]
} ``` # [C#](#tab/csharp)
Content-type: application/json
In the request body, supply a JSON representation of [conversationThread](../resources/conversationthread.md) object.
-##### Response
+### Response
If successful, this method returns `201 Created` response code and the `id` of the new thread in the response body.
-Here is an example of the response.
+
+The following is an example of the response.
<!-- { "blockType": "response", "truncated": true,
Here is an example of the response.
```http HTTP/1.1 201 Created Content-type: application/json
-Content-length: 346
{
- "id": "thread-id-value"
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#groups('4d81ce71-486c-41e9-afc5-e41bf2d0722a')/conversations('AAQkAGRhZmRhMWM3LTYwZTktNDZmYy1hNWU1LThhZWU4NzI2YTEyZgAQABKPPJ682apIiV1UFlj7XxY%3D')/threads/$entity",
+ "id": "AAQkAGRhZmRhMWM3LTYwZTktNDZmYy1hNWU1LThhZWU4NzI2YTEyZgMkABAAMgNmxDXX0UO0DI-I807i0hAAMgNmxDXX0UO0DI-I807i0g=="
} ```
v1.0 Conversationthread List Posts https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/conversationthread-list-posts.md
GET /groups/{groupId}/conversations/{conversationId}/threads/{threadId}/posts
``` ## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response. `$expand` is also supported to expand specific relationships and only one relationship can be expanded in a single request.
+ ## Request headers | Header | Value | |:|:--|
v1.0 Directorysetting Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directorysetting-get.md
Do not supply a request body for this method.
## Response If successful, this method returns a `200 OK` response code and [directorySetting](../resources/directorysetting.md) object in the response body.+ ## Example
-##### Request
+### Request
Here is an example of the request. + # [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_directorysetting" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/settings/{id}
+GET https://graph.microsoft.com/beta/settings/f0b2d6f5-097d-4177-91af-a24e530b53cc
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-directorysetting-csharp-snippets.md)]
GET https://graph.microsoft.com/beta/settings/{id}
+ ##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Here is an example of the response. Note: The response object shown here might b
```http HTTP/1.1 200 OK Content-type: application/json
-Content-length: 198
{
- "id": "id-value",
- "displayName": "displayName-value",
- "settingTemplateId": "settingTemplateId-value",
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#settings/$entity",
+ "id": "f0b2d6f5-097d-4177-91af-a24e530b53cc",
+ "displayName": "Group.Unified",
+ "templateId": "62375ab9-6b52-47ed-826b-58e47e0e304b",
"values": [ {
- "name": "name-value",
- "value": "value-value"
+ "name": "EnableMIPLabels",
+ "value": "true"
+ },
+ {
+ "name": "CustomBlockedWordsList",
+ "value": ""
+ },
+ {
+ "name": "EnableMSStandardBlockedWords",
+ "value": "true"
+ },
+ {
+ "name": "ClassificationDescriptions",
+ "value": ""
+ },
+ {
+ "name": "DefaultClassification",
+ "value": ""
+ },
+ {
+ "name": "PrefixSuffixNamingRequirement",
+ "value": "[Contoso-][GroupName]"
+ },
+ {
+ "name": "AllowGuestsToBeGroupOwner",
+ "value": "false"
+ },
+ {
+ "name": "AllowGuestsToAccessGroups",
+ "value": "true"
+ },
+ {
+ "name": "GuestUsageGuidelinesUrl",
+ "value": "https://privacy.contoso.com/privacystatement"
+ },
+ {
+ "name": "GroupCreationAllowedGroupId",
+ "value": ""
+ },
+ {
+ "name": "AllowToAddGuests",
+ "value": "true"
+ },
+ {
+ "name": "UsageGuidelinesUrl",
+ "value": ""
+ },
+ {
+ "name": "ClassificationList",
+ "value": ""
+ },
+ {
+ "name": "EnableGroupCreation",
+ "value": "true"
} ] }
v1.0 Directorysetting List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directorysetting-list.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> List tenant-wide or group settings+ ```http GET /settings GET /groups/{id}/settings ```+ ## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response.
## Request headers | Name |Description|
Do not supply a request body for this method.
## Response If successful, this method returns a `200 OK` response code and collection of [directorySetting](../resources/directorysetting.md) objects in the response body.+ ## Example
-##### Request
+
+### Request
Here is an example of the request. # [HTTP](#tab/http)
GET https://graph.microsoft.com/beta/settings
##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Here is an example of the response. Note: The response object shown here might b
```http HTTP/1.1 200 OK Content-type: application/json
-Content-length: 263
{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#settings",
"value": [ {
- "id": "id-value",
- "displayName": "displayName-value",
- "settingTemplateId": "settingTemplateId-value",
+ "id": "f0b2d6f5-097d-4177-91af-a24e530b53cc",
+ "displayName": "Group.Unified",
+ "templateId": "62375ab9-6b52-47ed-826b-58e47e0e304b",
"values": [ {
- "name": "name-value",
- "value": "value-value"
+ "name": "EnableMIPLabels",
+ "value": "true"
+ },
+ {
+ "name": "CustomBlockedWordsList",
+ "value": ""
+ },
+ {
+ "name": "EnableMSStandardBlockedWords",
+ "value": "true"
+ },
+ {
+ "name": "ClassificationDescriptions",
+ "value": ""
+ },
+ {
+ "name": "DefaultClassification",
+ "value": ""
+ },
+ {
+ "name": "PrefixSuffixNamingRequirement",
+ "value": "[Contoso-][GroupName]"
+ },
+ {
+ "name": "AllowGuestsToBeGroupOwner",
+ "value": "false"
+ },
+ {
+ "name": "AllowGuestsToAccessGroups",
+ "value": "true"
+ },
+ {
+ "name": "GuestUsageGuidelinesUrl",
+ "value": "https://privacy.contoso.com/privacystatement"
+ },
+ {
+ "name": "GroupCreationAllowedGroupId",
+ "value": ""
+ },
+ {
+ "name": "AllowToAddGuests",
+ "value": "true"
+ },
+ {
+ "name": "UsageGuidelinesUrl",
+ "value": ""
+ },
+ {
+ "name": "ClassificationList",
+ "value": ""
+ },
+ {
+ "name": "EnableGroupCreation",
+ "value": "true"
} ] }
v1.0 Directorysetting Post Settings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directorysetting-post-settings.md
In the request body, supply a JSON representation of [directorySetting](../resou
If successful, this method returns `201 Created` response code and [directorySetting](../resources/directorysetting.md) object in the response body.
-## Example
-##### Request
-Here is an example of the request.
+## Example 1: Create a new setting for all Microsoft 365 groups in the tenant
+
+### Request
+The following is an example of the request.
+ # [HTTP](#tab/http) <!-- {
Here is an example of the request.
```http POST https://graph.microsoft.com/beta/settings Content-type: application/json
-Content-length: 222
{
- "templateId": "templateId-value",
+ "displayName": "Group.Unified",
+ "templateId": "62375ab9-6b52-47ed-826b-58e47e0e304b",
"values": [ {
- "name": "name-value",
- "value": "value-value"
+ "name": "GuestUsageGuidelinesUrl",
+ "value": "https://privacy.contoso.com/privacystatement"
+ },
+ {
+ "name": "EnableMSStandardBlockedWords",
+ "value": "true"
+ },
+ {
+ "name": "EnableMIPLabels",
+ "value": "true"
+ },
+ {
+ "name": "PrefixSuffixNamingRequirement",
+ "value": "[Contoso-][GroupName]"
} ] }
Content-length: 222
+ In the request body, supply a JSON representation of [directorySetting](../resources/directorysetting.md) object.
-##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
<!-- { "blockType": "response", "truncated": true,
Here is an example of the response. Note: The response object shown here might b
```http HTTP/1.1 201 Created Content-type: application/json
-Content-length: 244
{
- "@odata.context": "https://graph.microsoft.com/stagingbeta/$metadata#settings/$entity",
- "id": "id-value",
- "displayName": "displayName-value",
- "templateId": "templateId-value",
- "values": [
- {
- "name": "name-value",
- "value": "value-value"
- }
- ]
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#settings/$entity",
+ "id": "f0b2d6f5-097d-4177-91af-a24e530b53cc",
+ "displayName": "Group.Unified",
+ "templateId": "62375ab9-6b52-47ed-826b-58e47e0e304b",
+ "values": [
+ {
+ "name": "GuestUsageGuidelinesUrl",
+ "value": "https://privacy.contoso.com/privacystatement"
+ },
+ {
+ "name": "EnableMSStandardBlockedWords",
+ "value": "true"
+ },
+ {
+ "name": "EnableMIPLabels",
+ "value": "true"
+ },
+ {
+ "name": "PrefixSuffixNamingRequirement",
+ "value": "[Contoso-][GroupName]"
+ }
+ ]
+}
+```
+
+## Example 2: Create a setting to block guests for a specific Microsoft 365 group
+
+### Request
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "create_directorysetting_from_settings_for_guests"
+}-->
+```http
+POST https://graph.microsoft.com/v1.0/groups/055a5d18-a3a9-4338-b9c5-de92559b7ebf/settings
+Content-type: application/json
+
+{
+ "displayName": "Group.Unified.Guest",
+ "templateId": "08d542b9-071f-4e16-94b0-74abb372e3d9",
+ "values": [
+ {
+ "name": "AllowToAddGuests",
+ "value": "false"
+ }
+ ]
+}
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
++++
+In the request body, supply a JSON representation of [directorySetting](../resources/directorysetting.md) object.
+
+### Response
+
+Note: The response object shown here may be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.directorySetting"
+} -->
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#settings/$entity",
+ "id": "a77ad44e-aa2a-4976-91b5-b947787b9577",
+ "displayName": "Group.Unified.Guest",
+ "templateId": "08d542b9-071f-4e16-94b0-74abb372e3d9",
+ "values": [
+ {
+ "name": "AllowToAddGuests",
+ "value": "false"
+ }
+ ]
} ```
Content-length: 244
] } -->--
v1.0 Directorysettingtemplate Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directorysettingtemplate-get.md
Do not supply a request body for this method.
If successful, this method returns a `200 OK` response code and [directorySettingTemplate](../resources/directorysettingtemplate.md) object in the response body. ## Example
-##### Request
+### Request
Here is an example of the request. + # [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_directorysettingtemplate" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/directorySettingTemplates/{id}
+GET https://graph.microsoft.com/beta/directorySettingTemplates/08d542b9-071f-4e16-94b0-74abb372e3d9
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-directorysettingtemplate-csharp-snippets.md)]
GET https://graph.microsoft.com/beta/directorySettingTemplates/{id}
+ ##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Here is an example of the response. Note: The response object shown here might b
```http HTTP/1.1 200 OK Content-type: application/json
-Content-length: 270
{
- "id": "id-value",
- "displayName": "displayName-value",
- "description": "description-value",
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#directorySettingTemplates/$entity",
+ "id": "08d542b9-071f-4e16-94b0-74abb372e3d9",
+ "deletedDateTime": null,
+ "displayName": "Group.Unified.Guest",
+ "description": "Settings for a specific Unified Group",
"values": [ {
- "name": "name-value",
- "type": "type-value",
- "defaultValue": "defaultValue-value",
- "description": "description-value"
+ "name": "AllowToAddGuests",
+ "type": "System.Boolean",
+ "defaultValue": "true",
+ "description": "Flag indicating if guests are allowed in a specific Unified Group."
}
- ],
+ ]
} ```
v1.0 Directorysettingtemplate List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directorysettingtemplate-list.md
One of the following permissions is required to call this API. To learn more, in
GET /directorySettingTemplates ``` ## Optional query parameters
-This method supports the [OData query parameters](/graph/query-parameters) to help customize the response.
+This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response.
## Request headers | Name |Description|
Here is an example of the response. Note: The response object shown here might b
```http HTTP/1.1 200 OK Content-type: application/json
-Content-length: 343
{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#directorySettingTemplates",
"value": [ {
- "id": "id-value",
- "displayName": "displayName-value",
- "description": "description-value",
+ "id": "08d542b9-071f-4e16-94b0-74abb372e3d9",
+ "deletedDateTime": null,
+ "displayName": "Group.Unified.Guest",
+ "description": "Settings for a specific Unified Group",
"values": [ {
- "name": "name-value",
- "type": "type-value",
- "defaultValue": "defaultValue-value",
- "description": "description-value"
+ "name": "AllowToAddGuests",
+ "type": "System.Boolean",
+ "defaultValue": "true",
+ "description": "Flag indicating if guests are allowed in a specific Unified Group."
} ]
- }
+ },
+ {
+ "id": "80661d51-be2f-4d46-9713-98a2fcaec5bc",
+ "deletedDateTime": null,
+ "displayName": "Prohibited Names Settings",
+ "description": "Setting templates define the different settings that can be used for the associated ObjectSettings. This template defines settings that can be used for managing tenant-wide prohibited names settings.",
+ "values": [
+ {
+ "name": "CustomBlockedSubStringsList",
+ "type": "System.String",
+ "defaultValue": "",
+ "description": "A comma delimited list of substring reserved words to block for application display names."
+ },
+ {
+ "name": "CustomBlockedWholeWordsList",
+ "type": "System.String",
+ "defaultValue": "",
+ "description": "A comma delimited list of reserved words to block for application display names."
+ }
+ ]
+ }
] } ```
v1.0 Educationsubmission Post Resources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationsubmission-post-resources.md
Title: "Create educationSubmissionResource"
-description: "Adds a resource to the resources list. This action can only be done by the student to whom this submission is assigned. This action will not succeed if the **allowStudentsToAddResources** flag is not set to true. If the caller wants to create a new file-based resource, the file must be uploaded to the resources folder that is associated with the submission. If the file does not exist or is not in that folder, the POST request will fail. "
+description: "Add a resource to the submission resource list."
localization_priority: Normal ms.prod: "education"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Adds a resource to the resources list. This action can only be done by the student to whom this submission is assigned. This action will not succeed if the **allowStudentsToAddResources** flag is not set to true. If the caller wants to create a new file-based resource, the file must be uploaded to the resources folder that is associated with the submission. If the file does not exist or is not in that folder, the POST request will fail.
+Add a resource to the submission resource list.
+
+Only the student assigned to the submission can perform this operation.
+
+The operation will not succeed if the **allowStudentsToAddResources** flag is not set to `true`.
+
+If the caller wants to create a new file-based resource, upload the file to the resources folder associated with the submission. If the file doesn't exist or is not in that folder, the POST request will fail.
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
POST /education/classes/{id}/assignments/{id}/submissions/{id}/resources
| Content-Type | application/json | ## Request body
-In the request body, supply a JSON representation of the [educationSubmissionResource](../resources/educationsubmissionresource.md) object.
+In the request body, supply a JSON representation of the resource. Supported types are [educationExcelResource](../resources/educationexcelresource.md), [educationFileResource](../resources/educationfileresource.md), [educationLinkResource](../resources/educationlinkresource.md), [educationPowerPointResource](../resources/educationpowerpointresource.md) and [educationWordResource](../resources/educationwordresource.md).
## Response
-If successful, this method returns a `201 Created` response code and an [educationSubmissionResource](../resources/educationsubmissionresource.md) object in the response body.
+If successful, this method returns a `201 Created` response code and an object according to the resource type in the response body.
## Example
-##### Request
+### Request
The following is an example of the request.+
+# [HTTP](#tab/http)
<!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "create_educationsubmissionresource_from_educationsubmission" }--> ```http
-POST https://graph.microsoft.com/beta/education/classes/11021/assignments/19002/submissions/850f51b7/resources
+POST https://graph.microsoft.com/beta/education/classes/f4a941ff-9da6-4707-ba5b-0eae93cad0b4/assignments/3c77de7f-539b-49e1-9c96-1274f2f0ee3b/submissions/4af73d2b-6b9c-493f-0688-979087bed39b/resources
Content-type: application/json Content-length: 1097 {
- "assignmentResourceUrl": "https://graph.microsoft.com/v1.0/drives/b!8-QjN2tsv0WyGnTv7vOvnQkmGHbbeMNLqYKONmHLVnvCVmBYIGpeT456457AdW9f/items/017NJZI25NOB5XZNLABF7646XAMDZTQQ6T",
- "resource": {
- "@odata.type": "#microsoft.graph.educationWordResource",
- "displayName": "Report.docx",
- "createdDateTime": "2017-10-21T07:52:53.9863696Z",
- "createdBy": {
- "application": null,
- "device": null,
- "user": {
- "id": "63cc91d2-59c7-4732-9594-35b91a26b340",
- "displayName": null
- }
- },
- "lastModifiedDateTime": "2017-10-21T07:52:53.9863696Z",
- "lastModifiedBy": {
- "application": null,
- "device": null,
- "user": {
- "id": "63cc91d2-59c7-4732-9594-35b91a26b340",
- "displayName": null
- }
- },
- "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!8-QjN2tsv0WyGnTv7vOvnQkmGHbbeMNLqYKONmHLVnvCVmBYIGpeTZ_iul5AdW9f/items/017NJZI27BCN2QI2H7HJGLIVPXR6SD2DH6"
- },
- "@odata.type": "microsoft.graph.educationResource"
+ "resource": {
+ "@odata.type": "microsoft.graph.educationWordResource",
+ "displayName": "Report.docx",
+ "fileUrl": "https://graph.microsoft.com/beta/drives/b!DPA6q59Tw0mtgmyXRUmrQRqBZTesG-lMkl1cBmvvMeUEWrOk89nKRpUEr4ZhNYBc/items/016XPCQEELISJB7NVNVBAK7V4UIF6Q27U2"
+ }
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++
-##### Response
+### Response
The following is an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- {
- "blockType": "ignored",
+ "blockType": "response",
"truncated": true,
- "@odata.type": "microsoft.graph.educationSubmissionResource"
+ "@odata.type": "microsoft.graph.educationWordResource"
} --> ```http HTTP/1.1 201 Created
Content-type: application/json
Content-length: 1152 {
- "assignmentResourceUrl": "https://graph.microsoft.com/v1.0/drives/b!8-QjN2tsv0WyGnTv7vOvnQkmGHbbeMNLqYKONmHLVnvCVmBYIGpeT456457AdW9f/items/017NJZI25NOB5XZNLABF7646XAMDZTQQ6T",
- "id": "f2387c3b-ec39-4bf2-a399-d7242677f024",
- "resource": {
- "@odata.type": "#microsoft.graph.educationWordResource",
- "displayName": "Report.docx",
- "createdDateTime": "2017-10-21T07:52:53.9863696Z",
- "createdBy": {
- "application": null,
- "device": null,
- "user": {
- "id": "63cc91d2-59c7-4732-9594-35b91a26b340",
- "displayName": null
- }
- },
- "lastModifiedDateTime": "2017-10-21T07:52:53.9863696Z",
- "lastModifiedBy": {
- "application": null,
- "device": null,
- "user": {
- "id": "63cc91d2-59c7-4732-9594-35b91a26b340",
- "displayName": null
- }
- },
- "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!8-QjN2tsv0WyGnTv7vOvnQkmGHbbeMNLqYKONmHLVnvCVmBYIGpeTZ_iul5AdW9f/items/017NJZI27BCN2QI2H7HJGLIVPXR6SD2DH6",
- }
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('f4a941ff-9da6-4707-ba5b-0eae93cad0b4')/assignments('3c77de7f-539b-49e1-9c96-1274f2f0ee3b')/submissions('4af73d2b-6b9c-493f-0688-979087bed39b')/resources/$entity",
+ "assignmentResourceUrl": null,
+ "id": "d835503f-fd00-4840-b69c-7230d10e18b8",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationWordResource",
+ "displayName": "Report.docx",
+ "createdDateTime": "2021-08-04T00:23:08.6269586Z",
+ "lastModifiedDateTime": "2021-08-04T00:23:08.6269586Z",
+ "fileUrl": "https://graph.microsoft.com/beta/drives/b!DPA6q59Tw0mtgmyXRUmrQRqBZTesG-lMkl1cBmvvMeUEWrOk89nKRpUEr4ZhNYBc/items/016XPCQEELISJB7NVNVBAK7V4UIF6Q27U2",
+ "createdBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "displayName": null
+ }
+ }
+ }
} ```
v1.0 Event Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/event-delta.md
Get a set of [event](../resources/event.md) resources that have been added, dele
You can get specific types of these incremental changes in the events in all the calendars of a mailbox or in a specific calendar, or in an event collection of a **calendarView** (range of events defined by start and end dates) of a calendar. The calendar can be the default calendar or some other specified calendar of the user's. In the case of getting incremental changes on **calendarView**, the calendar can be a group calendar as well.
-A **delta** function call is similar to a `GET /events` or `GET /calendarview` request for
-the specified calendar, except that by appropriately applying [state tokens](/graph/delta-query-overview#state-tokens) in one or more of these calls,
-you can query for incremental changes of events in that calender. This allows you to maintain and synchronize
-a local store of events in the specified calendar, without having to fetch all the events of that calendar
-from the server every time.
+Typically, synchronizing events in a calendar or **calendarView** in a local store entails a round of multiple **delta** function calls. The initial call is a full synchronization, and every subsequent **delta** call in the same round gets the incremental changes (additions, deletions, or updates). This allows you to maintain and synchronize a local store of events in the specified calendar, without having to fetch all the events of that calendar from the server every time.
The following table lists the differences between the **delta** function on events and the **delta** function on a **calendarView** in a calendar.
includes the encoded, desired parameters.
| $deltatoken | string | A [state token](/graph/delta-query-overview) returned in the `deltaLink` URL of the previous **delta** function call for the same calendar view, indicating the completion of that round of change tracking. Save and apply the entire `deltaLink` URL including this token in the first request of the next round of change tracking for that calendar view.| | $skiptoken | string | A [state token](/graph/delta-query-overview) returned in the `nextLink` URL of the previous **delta** function call, indicating there are further changes to be tracked in the same calendar view. |
-Does not support `$expand`, `$filter`, `$orderby`, `$select`, and `$search`.
+### OData query parameters
+- Expect a **delta** function call on a **calendarView** to return the same properties you'd normally get from a `GET /calendarview` request. You cannot use `$select` to get only a subset of those properties.
+
+- The **delta** function doesn't support the following query parameters for events in a user calendar, or events in a **calendarView**: `$expand`, `$filter`,`$orderby`, `$search`, and `$select`.
+ ## Request headers
If successful, this method returns a `200 OK` response code and an [event](../re
Expect to get all the properties you'd normally get from a `GET /calendarview` request.
+Within a round of **delta** function calls bound by the date range of a **calendarView**, you may find a **delta** call returning two types of events under `@removed` with the reason `deleted`:
+- Events that are within the date range and that have been deleted since the previous **delta** call.
+- Events that are _outside_ the date range and that have been added, deleted, or updated since the the previous **delta** call.
+
+Filter the events under `@removed` for the date range that your scenario requires.
+ ## Examples ### Example 1: Delta function on events in a calendar (preview)
Content-type: application/json
The following example shows the initial sync request to get events in the specified calendar of the signed-in user, within the range of dates indicated by the **calendarView**. The initial request does not include any state token.
-The request uses the `Prefer: odata.maxpagesize` header to limit the maximum number of events in each response to 2.
-Continue calling the `delta` function by using the query returned in `@odata.nextLink` until you get all the events in that calendar view, and a `@odata.deltaLink`
+The request uses the `Prefer: odata.maxpagesize` header to limit the maximum number of events in each response to 2. Continue calling the `delta` function by using the query returned in `@odata.nextLink` until you get all the events in that calendar view, and a `@odata.deltaLink`
in the response. # [HTTP](#tab/http)
GET https://graph.microsoft.com/beta/me/calendars/AAMkADI5M1BbeAAA=/calendarview
Prefer: odata.maxpagesize=2 ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Java](#tab/java)
--- #### Response
v1.0 Externalconnectors Externalconnection Post Schema https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/externalconnectors-externalconnection-post-schema.md
When registering a custom item schema, the `schema` object MUST have the `baseTy
## Response
-With the `Prefer: respond-async` header included in the request, if successful, this method returns a `202 Accepted` response code and a URL in the `Location` response header that can be used to [get the operation status](../api/externalconnectors-connectionoperation-get.md).
-
-Without the `Prefer: respond-async` header included in the request, if successful, this method returns a `201 Created` response code and a new [schema](../resources/externalconnectors-schema.md) object in the response body.
-
-> [!NOTE]
-> Creating a schema is a long-running process prone to gateway timeouts. We recommend using the `Prefer: respond-async` header to avoid timeout errors.
+If successful, this method returns a `202 Accepted` response code and a URL in the `Location` response header that can be used to [get the operation status](../api/externalconnectors-connectionoperation-get.md).
## Examples
The following is an example of the request.
```http POST https://graph.microsoft.com/beta/external/connections/contosohr/schema Content-type: application/json
-Prefer: respond-async
{ "baseType": "microsoft.graph.externalItem",
v1.0 Group Assignlicense https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-assignlicense.md
If successful, this method returns a `202 Accepted` response code and a target [
The following example adds licenses to the group. #### Request + # [HTTP](#tab/http) <!-- { "blockType": "request", "name": "group_assignlicense" }--> ```http
-POST https://graph.microsoft.com/beta/groups/1ad75eeb-7e5a-4367-a493-9214d90d54d0/assignLicense
+POST https://graph.microsoft.com/beta/groups/1132b215-826f-42a9-8cfe-1643d19d17fd/assignLicense
Content-type: application/json - { "addLicenses": [ {
- "disabledPlans": [ "11b0131d-43c8-4bbb-b2c8-e80f9a50834a" ],
- "skuId": "skuId-value-1"
+ "disabledPlans": [
+ "113feb6c-3fe4-4440-bddc-54d774bf0318",
+ "14ab5db5-e6c4-4b20-b4bc-13e36fd2227f"
+ ],
+ "skuId": "b05e124f-c7cc-45a0-a6aa-8cf78c946968"
}, {
- "disabledPlans": [ "a571ebcc-fqe0-4ca2-8c8c-7a284fd6c235" ],
- "skuId": "skuId-value-2"
+ "disabledPlans": [
+ "a413a9ff-720c-4822-98ef-2f37c2a21f4c"
+ ],
+ "skuId": "c7df2760-2c81-4ef7-b578-5b5392b571df"
} ], "removeLicenses": []
The response is the updated group object.
```http HTTP/1.1 202 Accepted Content-type: application/json
-location: https://graph.microsoft.com/v2/d056d009-17b3-4106-8173-cd3978ada898/directoryObjects/1ad75eeb-7e5a-4367-a493-9214d90d54d0/Microsoft.DirectoryServices.Group
+location: https://graph.microsoft.com/v2/e8e96c2a-d787-4eb1-98d7-9e57c965f1de/directoryObjects/1132b215-826f-42a9-8cfe-1643d19d17fd/Microsoft.DirectoryServices.Group
{
- "id": "1ad75eeb-7e5a-4367-a493-9214d90d54d0",
- "deletedDateTime": null,
- "classification": null,
- "createdDateTime": "2018-04-18T22:05:03Z",
+ "id": "1132b215-826f-42a9-8cfe-1643d19d17fd",
+ "createdDateTime": "2021-03-12T11:15:03Z",
+ "groupTypes": [],
"securityEnabled": true,- } ```
The following example removes licenses from the group.
#### Request + # [HTTP](#tab/http) <!-- { "blockType": "request",
The following example removes licenses from the group.
}--> ```http
-POST https://graph.microsoft.com/beta/groups/1ad75eeb-7e5a-4367-a493-9214d90d54d0/assignLicense
+POST https://graph.microsoft.com/beta/groups/1132b215-826f-42a9-8cfe-1643d19d17fd/assignLicense
Content-type: application/json - { "addLicenses": [],
- "removeLicenses": ["skuId-value-1", "skuId-value-2"]
+ "removeLicenses": [
+ "c7df2760-2c81-4ef7-b578-5b5392b571df",
+ "b05e124f-c7cc-45a0-a6aa-8cf78c946968"
+ ]
} ``` # [C#](#tab/csharp)
The response is the updated group object.
```http HTTP/1.1 202 Accepted Content-type: application/json
-location: https://graph.microsoft.com/v2/d056d009-17b3-4106-8173-cd3978ada898/directoryObjects/1ad75eeb-7e5a-4367-a493-9214d90d54d0/Microsoft.DirectoryServices.Group
-
+location: https://graph.microsoft.com/v2/e8e96c2a-d787-4eb1-98d7-9e57c965f1de/directoryObjects/1132b215-826f-42a9-8cfe-1643d19d17fd/Microsoft.DirectoryServices.Group
{
- "id": "1ad75eeb-7e5a-4367-a493-9214d90d54d0",
- "deletedDateTime": null,
- "classification": null,
- "createdDateTime": "2018-04-18T22:05:03Z",
+ "id": "1132b215-826f-42a9-8cfe-1643d19d17fd",
+ "createdDateTime": "2021-03-12T11:15:03Z",
+ "groupTypes": [],
"securityEnabled": true,- } ```
v1.0 Group Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-delta.md
HTTP/1.1 200 OK
Content-type: application/json {
- "@odata.context":"https://graph.microsoft.com/beta/$metadata#groups","@odata.nextLink":"https://graph.microsoft.com/beta/groups/delta?$skiptoken=pqwSUjGYvb3jQpbwVAwEL7yuI3dU1LecfkkfLPtnIjvY1FSSc_",
+ "@odata.context":"https://graph.microsoft.com/beta/$metadata#groups",
+ "@odata.nextLink":"https://graph.microsoft.com/beta/groups/delta?$skiptoken=pqwSUjGYvb3jQpbwVAwEL7yuI3dU1LecfkkfLPtnIjvY1FSSc_",
"value":[ {
- "classification": "classification-value",
- "createdDateTime":"datetime-value",
- "description":"Test group 1",
- "displayName":"TestGroup1",
+ "createdDateTime":"2021-03-12T10:36:14Z",
+ "description":"This is the default group for everyone in the network",
+ "displayName":"All Company",
"groupTypes": [
- "groupTypes-value"
+ "Unified"
],
- "mail": "mail-value",
+ "mail": "allcompany@contoso.com",
"members@delta": [
- {
- "@odata.type": "#microsoft.graph.user",
- "id": "693acd06-2877-4339-8ade-b704261fe7a0"
- },
- {
- "@odata.type": "#microsoft.graph.user",
- "id": "49320844-be99-4164-8167-87ff5d047ace"
- }
+ {
+ "@odata.type": "#microsoft.graph.user",
+ "id": "693acd06-2877-4339-8ade-b704261fe7a0"
+ },
+ {
+ "@odata.type": "#microsoft.graph.user",
+ "id": "49320844-be99-4164-8167-87ff5d047ace"
+ }
] } ]
Content-type: application/json
"@odata.nextLink":"https://graph.microsoft.com/beta/groups/delta?$skiptoken=pqwSUjGYvb3jQpbwVAwEL7yuI3dU1LecfkkfLPtnIjsXoYQp_dpA3cNJWc", "value": [ {
- "displayName": "displayName-value",
+ "displayName": "All Company",
"description": null,
- "mailNickname": "mailNickname-value"
+ "mailNickname": "allcompany@contoso.com"
} ] }
Content-type: application/json
"@odata.nextLink":"https://graph.microsoft.com/beta/groups/delta?$skiptoken=pqwSUjGYvb3jQpbwVAwEL7yuI3dU1LecfkkfLPtnIjsXoYQp_dpA3cNJWc", "value": [ {
- "displayName": "displayName-value",
+ "displayName": "Everyone",
"description": null } ]
v1.0 Group Getmembergroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-getmembergroups.md
If successful, this method returns `200 OK` response code and String collection
## Example
-#### Request
+### Request
The following is an example of the request. + # [HTTP](#tab/http) <!-- { "blockType": "request",
The following is an example of the request.
}--> ```http
-POST https://graph.microsoft.com/beta/groups/{id}/getMemberGroups
+POST https://graph.microsoft.com/beta/groups/1132b215-826f-42a9-8cfe-1643d19d17fd/getMemberGroups
Content-type: application/json
-Content-length: 33
{ "securityEnabledOnly": false
Content-length: 33
-#### Response
+### Response
The following is an example of the response.
The following is an example of the response.
```http HTTP/1.1 200 OK Content-type: application/json
-Content-length: 39
{ "value": [
- "string-value"
+ "1132b215-826f-42a9-8cfe-1643d19d17fd"
] } ```
v1.0 Group Getmemberobjects https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-getmemberobjects.md
In the request body, provide a JSON object with the following parameters.
| Parameter | Type |Description| |:|:--|:-|
-|securityEnabledOnly|Boolean|Set to **false**. Returning only security-enabled groups is supported for users only.|
+|securityEnabledOnly|Boolean|Set to `false`. Returning only security-enabled groups is supported for users only.|
## Response If successful, this method returns `200 OK` response code and String collection in the response body that contains the IDs of the groups that the group is a member of. ## Example
-#### Request
+
+### Request
The following is an example of the request. + # [HTTP](#tab/http) <!-- { "blockType": "request", "name": "group_getmemberobjects" }--> ```http
-POST https://graph.microsoft.com/beta/groups/{id}/getMemberObjects
+POST https://graph.microsoft.com/beta/groups/1132b215-826f-42a9-8cfe-1643d19d17fd/getMemberObjects
Content-type: application/json
-Content-length: 33
{ "securityEnabledOnly": false
Content-length: 33
-#### Response
+### Response
The following is an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- {
The following is an example of the response.
```http HTTP/1.1 200 OK Content-type: application/json
-Content-length: 39
{ "value": [
- "string-value"
+ "1132b215-826f-42a9-8cfe-1643d19d17fd"
] } ```
v1.0 Group List Conversations https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-list-conversations.md
GET /groups/{id}/conversations
``` ## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+This method supports the `$select` and `$filter` [OData query parameters](/graph/query-parameters) to help customize the response.
## Request headers | Header | Value |
Do not supply a request body for this method.
If successful, this method returns a `200 OK` response code and collection of [conversation](../resources/conversation.md) objects in the response body. ## Example
-#### Request
+### Request
The following is an example of the request. # [HTTP](#tab/http)
GET https://graph.microsoft.com/beta/groups/{id}/conversations
-#### Response
+### Response
The following is an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- {
The following is an example of the response.
```http HTTP/1.1 200 OK Content-type: application/json
-Content-length: 262
{
- "value": [
- {
- "topic": "topic-value",
- "hasAttachments": true,
- "lastDeliveredDateTime": "2016-10-19T10:37:00Z",
- "uniqueSenders": [
- "uniqueSenders-value"
- ],
- "preview": "preview-value",
- "id": "id-value"
- }
- ]
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#groups('f448435d-3ca7-4073-8152-a1fd73c0fd09')/conversations",
+ "value": [
+ {
+ "id": "AAQkAGFhZDhkNGI1LTliZmEtNGEzMi04NTkzLWZjMWExZDkyMWEyZgAQAH4o7SknOTNKqAqMhqJHtUM=",
+ "topic": "The new All Company group is ready",
+ "hasAttachments": false,
+ "lastDeliveredDateTime": "2021-08-02T10:34:00Z",
+ "uniqueSenders": [
+ "All Company"
+ ],
+ "preview": "Welcome to the All Company group.Use the group to share ideas, files, and important dates.Start a conversationRead group conversations or start your own.Share filesView, edit, and share all group files, including email attachments.Connect your"
+ }
+ ]
} ```
v1.0 Group Post Conversations https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-post-conversations.md
The response includes the IDs for the new conversation and thread, which you can
[list posts](conversationthread-list-posts.md) operation to get the new post as well. ## Example
-#### Request
+### Request
The following is an example of the request.
Content-type: application/json
-#### Response
+### Response
The following is an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- {
HTTP/1.1 200 OK
Content-type: application/json {
- "@odata.context":"https://graph.microsoft.com/beta/$metadata#groups('29981b6a-0e57-42dc-94c9-cd24f5306196')/conversations/$entity",
- "id":"AAQkADPxBgqECsrFDTuM=",
- "threads@odata.context":"https://graph.microsoft.com/beta/$metadata#groups('29981b6a-0e57-42dc-94c9-cd24f5306196')/conversations('AAQkADPxBgqECsrFDTuM%3D')/threads",
- "threads":[
- {
- "id":"AAQkADUNO4xAAMbGA93Sw-EGCoQKysUNO4w=="
- }
- ]
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#groups('29981b6a-0e57-42dc-94c9-cd24f5306196')/conversations/$entity",
+ "id": "AAQkAGRhZmRhMWM3LTYwZTktNDZmYy1hNWU1LThhZWU4NzI2YTEyZgAQALW_4yZl5X5HqtIFyIQHmJs=",
+ "threads@odata.context": "https://graph.microsoft.com/beta/$metadata#groups('4d81ce71-486c-41e9-afc5-e41bf2d0722a')/conversations('AAQkAGRhZmRhMWM3LTYwZTktNDZmYy1hNWU1LThhZWU4NzI2YTEyZgAQALW_4yZl5X5HqtIFyIQHmJs%3D')/threads",
+ "threads": [
+ {
+ "id": "AAQkAGRhZmRhMWM3LTYwZTktNDZmYy1hNWU1LThhZWU4NzI2YTEyZgMkABAAtb7jJmXlfkeq0gXIhAeYmxAAtb7jJmXlfkeq0gXIhAeYmw=="
+ }
+ ]
} ```
v1.0 Group Post Groups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-post-groups.md
The following table shows the properties of the [group](../resources/group.md) r
| description | string | A description for the group. Optional. | | isAssignableToRole | Boolean | Set to **true** to enable the group to be assigned to an Azure AD role. Only Privileged Role Administrator and Global Administrator can set the value of this property. Optional. | | mailEnabled | boolean | Set to **true** for mail-enabled groups. Required. |
-| mailNickname | string | The mail alias for the group. This property can contain only characters in the [ASCII character set 0 - 127](/office/vba/language/reference/user-interface-help/character-set-0127) except the following: ` @ () \ [] " ; : . <> , SPACE `. Required. |
+| mailNickname | string | The mail alias for the group. Max. length: 64 characters. This property can contain only characters in the [ASCII character set 0 - 127](/office/vba/language/reference/user-interface-help/character-set-0127) except the following: ` @ () \ [] " ; : . <> , SPACE`. Required. |
| securityEnabled | boolean | Set to **true** for security-enabled groups, including Microsoft 365 groups. Required. | | owners | [directoryObject](../resources/directoryobject.md) collection | This property represents the owners for the group at creation time. Owners aren't automatically added as group members unless specified in the **members** property. Optional. | | members | [directoryObject](../resources/directoryobject.md) collection | This property represents the members for the group at creation time. Optional. |
v1.0 List Post Columns https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/list-post-columns.md
Last updated 08/30/2020 Title: "Create columnDefinition in a list"
+ Title: "Create columnDefinition"
description: "Create a list column." localization_priority: Normal doc_type: apiPageType ms.prod: "sites-and-lists"
-# Create columnDefinition for a list
+# Create columnDefinition
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Create a column for a [list][list] by specifying a [columnDefinition][columnDefinition].
+Create a column for a [list][list] with a request that specifies a [columnDefinition][columnDefinition].
## Permissions
In the request body, supply a JSON representation of the [columnDefinition][] re
## Response
-If successful, this method returns a `201 Created` response code and [columnDefinition][] object in the response body.
+If successful, this method returns a `201 Created` response code and a [columnDefinition][] object in the response body.
## Example
Content-type: application/json
"maxLength": 255 } }- ```
v1.0 Serviceprincipal Addkey https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceprincipal-addkey.md
ServicePrincipals that donΓÇÖt have any existing valid certificates (i.e.: no ce
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | None. |
+|Delegated (work or school account) | Directory.AccessAsUser.All, Application.ReadWrite.All, Directory.ReadWrite.All |
|Delegated (personal Microsoft account) | None. |
-|Application | None. |
+|Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All, Directory.ReadWrite.All |
-> [!NOTE]
-> A servicePrincipal does not need any specific permission to roll its own keys.
## HTTP request
v1.0 Serviceprincipal Addpassword https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceprincipal-addpassword.md
POST /servicePrincipals/{id}/addPassword
## Request body
-In the request body, provide an optional `passwordCredential` object with the following properties.
+In the request body, provide an empty [passwordCredential](../resources/passwordcredential.md) object or with the following optional properties.
| Property | Type |Description| |:|:--|:-|
Content-type: application/json
### Response The following is an example of the response.-
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
v1.0 Serviceprincipal Removekey https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceprincipal-removekey.md
As part of the request validation for this method, a proof of possession of an e
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | None. |
+|Delegated (work or school account) | Directory.AccessAsUser.All, Application.ReadWrite.All, Directory.ReadWrite.All |
|Delegated (personal Microsoft account) | None. |
-|Application | None. |
-
-> [!NOTE]
-> A servicePrincipal does not need any specific permission to roll its own keys.
+|Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All, Directory.ReadWrite.All |
## HTTP request
v1.0 Signin List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/signin-list.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get a list of [signIn](../resources/signin.md) objects. The list contains the user sign-ins for your Azure Active Directory tenant. Sign-ins where a username and password are passed as part of authorization token, and successful federated sign-ins are currently included in the sign-in logs. The maximum and default page size is 1,000 objects and by default, the most recent sign-ins are returned first.
+Get a list of [signIn](../resources/signin.md) objects. The list contains the user sign-ins for your Azure Active Directory tenant. Sign-ins where a username and password are passed as part of authorization token, and successful federated sign-ins are currently included in the sign-in logs.
+
+The maximum and default page size is 1,000 objects and by default, the most recent sign-ins are returned first. Only sign-in events that occurred within the Azure Active Directory (Azure AD) [default retention period](/azure/active-directory/reports-monitoring/reference-reports-data-retention#how-long-does-azure-ad-store-the-data) are available.
## Permissions
v1.0 Subscribedsku List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/subscribedsku-list.md
GET /subscribedSkus
``` ## Optional query parameters
-This method does not support the [OData query parameters](/graph//query-parameters) to help customize the response (`$filter` is not supported).
+This method does not support `$select` the [OData query parameter](/graph//query-parameters) to help customize the response (`$filter` is not supported).
## Request headers
Content-length: 547
{ "value": [ {
- "capabilityStatus": "capabilityStatus-value",
- "consumedUnits": 99,
+ "capabilityStatus": "Enabled",
+ "consumedUnits": 20,
"prepaidUnits": {
- "enabled": 99,
- "suspended": 99,
- "warning": 99
+ "enabled": 20,
+ "suspended": 0,
+ "warning": 0
}, "servicePlans": [ {
- "servicePlanId": "servicePlanId-value",
- "servicePlanName": "servicePlanName-value",
- "provisioningStatus": "provisioningStatus-value",
- "appliesTo": "appliesTo-value"
+ "servicePlanId": "113feb6c-3fe4-4440-bddc-54d774bf0318",
+ "servicePlanName": "EXCHANGE_S_FOUNDATION",
+ "provisioningStatus": "Success",
+ "appliesTo": "Company"
} ],
- "skuId": "skuId-value",
- "skuPartNumber": "skuPartNumber-value"
+ "skuId": "b05e124f-c7cc-45a0-a6aa-8cf78c946968",
+ "skuPartNumber": "EMSPREMIUM"
} ] }
v1.0 Tenantappmanagementpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/tenantAppManagementPolicy-get.md
If successful, this method returns a `200 OK` response code and the requested [d
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_tenantAppManagementPolicy"
The following is an example of the request.
```msgraph-interactive GET https://graph.microsoft.com/beta/policies/defaultAppManagementPolicy ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Tenantappmanagementpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/tenantAppManagementPolicy-update.md
If successful, this method returns a `204 No Content` response code. It does not
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_tenantAppManagementPolicy"
Content-Type: application/json
} } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Termstore Group Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/termstore-group-delete.md
Title: "Delete group"
-description: "Delete a group object."
+description: "Delete a group object in a term store."
localization_priority: Normal doc_type: apiPageType
-# Delete groups
+# Delete group
Namespace: microsoft.graph.termStore [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Delete a [group](../resources/termstore-group.md) object in the term [store].
+Delete a [group](../resources/termstore-group.md) object in a term [store].
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Unifiedroleassignmentschedule Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/unifiedroleassignmentschedule-filterbycurrentuser.md
If successful, this method returns a `200 OK` response code and a collection of[
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "unifiedroleassignmentschedule_filterbycurrentuser"
If successful, this method returns a `200 OK` response code and a collection of[
``` http GET https://graph.microsoft.com/beta/roleManagement/directory/roleAssignmentSchedules/filterByCurrentUser(on='principal') ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Unifiedroleassignmentscheduleinstance Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/unifiedroleassignmentscheduleinstance-filterbycurrentuser.md
If successful, this method returns a `200 OK` response code and a collection of
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "unifiedroleassignmentscheduleinstance_filterbycurrentuser"
If successful, this method returns a `200 OK` response code and a collection of
``` http GET https://graph.microsoft.com/beta/roleManagement/directory/roleAssignmentScheduleInstances/filterByCurrentUser(on='principal') ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Unifiedroleassignmentschedulerequest Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/unifiedroleassignmentschedulerequest-filterbycurrentuser.md
If successful, this method returns a `200 OK` response code and a collection of[
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "unifiedroleassignmentschedulerequest_filterbycurrentuser"
If successful, this method returns a `200 OK` response code and a collection of[
``` http GET https://graph.microsoft.com/beta/roleManagement/directory/RoleAssignmentScheduleRequests/filterByCurrentUser(on='principal') ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Unifiedroleassignmentschedulerequest Post Unifiedroleassignmentschedulerequests https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/unifiedroleassignmentschedulerequest-post-unifiedroleassignmentschedulerequests.md
Content-Type: application/json
In the following request, a user identified by **principalId** `c6ad1942-4afa-47f8-8d48-afb5d8d69d2f` activates their own eligible role identified by `9b895d92-2cd3-44c7-9d02-a6ac2d5ea5c3`. The scope of their role is all directory objects in the tenant and the assignment is for five hours. To run this request, the calling user must have multi-factor authentication (MFA) enforced, and running the query in a session in which they were challenged for MFA. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_unifiedroleassignmentschedulerequest_from_unifiedroleassignmentschedulerequests_SelfActivate"
Content-Type: application/json
} } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
Content-Type: application/json
"ticketSystem": "MS Project" } }
-```
+```
v1.0 Unifiedroleeligibilityschedule Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/unifiedroleeligibilityschedule-filterbycurrentuser.md
If successful, this method returns a `200 OK` response code and a collection of
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "unifiedroleeligibilityschedule_filterbycurrentuser"
If successful, this method returns a `200 OK` response code and a collection of
``` http GET https://graph.microsoft.com/beta/roleManagement/directory/roleEligibilitySchedules/filterByCurrentUser(on='principal') ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Unifiedroleeligibilityscheduleinstance Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/unifiedroleeligibilityscheduleinstance-filterbycurrentuser.md
If successful, this method returns a `200 OK` response code and a collection of
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "unifiedroleeligibilityscheduleinstance_filterbycurrentuser"
If successful, this method returns a `200 OK` response code and a collection of
``` http GET https://graph.microsoft.com/beta/roleManagement/directory/roleEligibilityScheduleInstances/filterByCurrentUser(on='principal') ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Unifiedroleeligibilityschedulerequest Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/unifiedroleeligibilityschedulerequest-filterbycurrentuser.md
If successful, this function returns a `200 OK` response code and a [unifiedRole
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "unifiedRoleEligibilityScheduleRequest_filterbycurrentuser"
If successful, this function returns a `200 OK` response code and a [unifiedRole
``` http GET https://graph.microsoft.com/beta/roleManagement/directory/RoleEligibilityScheduleRequests/filterByCurrentUser(on='principal') ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Unifiedroleeligibilityschedulerequest Post Unifiedroleeligibilityschedulerequests https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/unifiedroleeligibilityschedulerequest-post-unifiedroleeligibilityschedulerequests.md
In the following request, the admin creates a request to revoke the eligibility
#### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_unifiedroleeligibilityschedulerequest_from_unifiedroleeligibilityschedulerequests_AdminRemove"
Content-Type: application/json
} } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++
Content-Type: application/json
"ticketSystem": null } }
-```
+```
v1.0 User Activateserviceplan https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-activateserviceplan.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from most to least privileged)| | : | : |
-| Delegated (work or school account) | Directory.ReadWrite.All, Directory.ReadWriteAdvanced.All |
+| Delegated (work or school account) | Directory.ReadWrite.All |
| Delegated (personal Microsoft account) | Not Supported. |
-| Application | Directory.ReadWrite.All, Directory.ReadWriteAdvanced.All |
+| Application | Directory.ReadWrite.All |
## HTTP request
v1.0 Conversation https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/conversation.md
This resource supports subscribing to [change notifications](/graph/webhooks).
## Properties | Property | Type |Description| |:|:--|:-|
-|hasAttachments|Boolean|Indicates whether any of the posts within this Conversation has at least one attachment.|
+|hasAttachments|Boolean|Indicates whether any of the posts within this Conversation has at least one attachment. Supports `$filter` (`eq`, `ne`) and `$search`.|
|id|String|The conversations's unique identifier. Read-only.|
-|lastDeliveredDateTime|DateTimeOffset|The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`|
-|preview|String|A short summary from the body of the latest post in this converstaion.|
+|lastDeliveredDateTime|DateTimeOffset|The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Supports `$filter` (`eq`, `ne`, `le`, `ge`).|
+|preview|String|A short summary from the body of the latest post in this conversation.|
|topic|String|The topic of the conversation. This property can be set when the conversation is created, but it cannot be updated.| |uniqueSenders|String collection|All the users that sent a message to this Conversation.|
v1.0 Expirationpattern https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/expirationpattern.md
In [Azure AD entitlement management](entitlementmanagement-root.md), an access p
| Property | Type | Description | |:-|:|:|
-|endDateTime|DateTimeOffset|The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.|
-|duration|Duration|The requestor's desired duration of access. If specified in a request, endDateTime should not be present.|
+|endDateTime|DateTimeOffset|Timestamp of date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.|
+|duration|Duration|The requestor's desired duration of access represented in ISO 8601 format for durations. For example, PT3H refers to three hours. If specified in a request, **endDateTime** should not be present and the **type** property should be set to `afterDuration`.|
|type|expirationPatternType|The requestor's desired expiration pattern type.| ### expirationPatternType values
In [Azure AD entitlement management](entitlementmanagement-root.md), an access p
|notSpecified|0|No expiration schedule was specified.| |noExpiration|1|The requestor did not wish the access to expire.| |afterDateTime|2|Access will expire after a specified date and time.|
-|afterDuration|3|Access will expire after a specified duration relative to access being granted.|
+|afterDuration|3|Access will expire after a specified duration relative to access being granted. Required when the **duration** property is specified.|
## JSON representation
v1.0 Passwordcredential https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/passwordcredential.md
Namespace: microsoft.graph
Represents a password credential associated with an application or a service principal. The **passwordCredentials** property of the [application](application.md) and [servicePrincipal](serviceprincipal.md) entitites is a collection of **passwordCredential** objects. > [!IMPORTANT]
-> Using POST or PATCH to set **passwordCredential** is not supported. Use the addPassword and removePassword methods to update the password for an application or a servicePrincipal:
+> Using POST or PATCH to set **passwordCredential** is not supported. Use the following addPassword and removePassword methods to update the password for an application or a servicePrincipal:
> > - [application: addPassword](../api/application-addpassword.md) > - [application: removePassword](../api/application-removepassword.md)
v1.0 Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/post.md
Even though you cannot explicitly create a post, doing any of the following woul
This resource lets you add your own data to custom properties using [extensions](/graph/extensibility-overview).
+## Methods
+
+| Method | Return Type |Description|
+|:|:--|:-|
+|[List posts](../api/conversationthread-list-posts.md) | [post](post.md) |Get the posts of the specified thread. |
+|[Get post](../api/post-get.md) | [post](post.md) |Get the properties and relationships of a post in a specified thread.|
+|[Reply](../api/post-reply.md)|None|Reply to a post and add a new post to the specified thread in a group conversation.|
+|[Forward](../api/post-forward.md)|None|Forward a post to a recipient.|
+|**Attachments**| | |
+|[List attachments](../api/post-list-attachments.md) |[attachment](attachment.md) collection| Get all attachments on a post.|
+|[Add attachment](../api/post-post-attachments.md) |[attachment](attachment.md)| Add an attachment to a post. |
+|**Open extensions**| | |
+|[Create open extension](../api/opentypeextension-post-opentypeextension.md) |[openTypeExtension](opentypeextension.md)| Create an open extension and add custom properties to a new or existing resource.|
+|[Get open extension](../api/opentypeextension-get.md) |[openTypeExtension](opentypeextension.md) collection| Get an open extension identified by the extension name.|
+|**Schema extensions**| | |
+|[Add schema extension values](/graph/extensibility-schema-groups) || Create a schema extension definition and then use it to add custom typed data to a resource.|
+|**Extended properties**| | |
+|[Create single-value extended property](../api/singlevaluelegacyextendedproperty-post-singlevalueextendedproperties.md) |[post](post.md) |Create one or more single-value extended properties in a new or existing post. |
+|[Get post with single-value extended property](../api/singlevaluelegacyextendedproperty-get.md) | [post](post.md) | Get posts that contain a single-value extended property by using `$expand` or `$filter`. |
+|[Create multi-value extended property](../api/multivaluelegacyextendedproperty-post-multivalueextendedproperties.md) | [post](post.md) | Create one or more multi-value extended properties in a new or existing post. |
+|[Get post with multi-value extended property](../api/multivaluelegacyextendedproperty-get.md) | [post](post.md) | Get a post that contains a multi-value extended property by using `$expand`. |
+
+## Properties
+| Property | Type |Description|
+|:|:--|:-|
+|body|[itemBody](itembody.md)|The contents of the post. This is a default property. This property can be null.|
+|categories|String collection|The categories associated with the post. Each category corresponds to the **displayName** property of an [outlookCategory](outlookcategory.md) that has been defined for a user.|
+|changeKey|String|Identifies the version of the post. Every time the post is changed, ChangeKey changes as well. This allows Exchange to apply changes to the correct version of the object.|
+|conversationId|String|Unique ID of the conversation. Read-only.|
+|conversationThreadId|String|Unique ID of the conversation thread. Read-only.|
+|createdDateTime|DateTimeOffset|Specifies when the post was created. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`|
+|from|[recipient](recipient.md)|Used in delegate access scenarios. Indicates who posted the message on behalf of another user. This is a default property.|
+|hasAttachments|Boolean|Indicates whether the post has at least one attachment. This is a default property.|
+|id|String| Read-only.|
+|importance | importance| The importance of a group post: `low`, `normal`, `high`. |
+|lastModifiedDateTime|DateTimeOffset|Specifies when the post was last modified. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`|
+|newParticipants|[recipient](recipient.md) collection|Conversation participants that were added to the thread as part of this post.|
+|receivedDateTime|DateTimeOffset|Specifies when the post was received. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`|
+|sender|[recipient](recipient.md)|Contains the address of the sender. The value of Sender is assumed to be the address of the authenticated user in the case when Sender is not specified. This is a default property.|
+
+## Relationships
+| Relationship | Type |Description|
+|:|:--|:-|
+|attachments|[Attachment](attachment.md) collection|The collection of [fileAttachment](fileattachment.md), [itemAttachment](itemattachment.md), and [referenceAttachment](referenceattachment.md) attachments for the post. Read-only. Nullable. Supports `$expand`.|
+|extensions|[Extension](extension.md) collection|The collection of open extensions defined for the post. Read-only. Nullable. Supports `$expand`.|
+|inReplyTo|[Post](post.md)|The earlier post that this post is replying to in the [conversationThread](conversationthread.md). Read-only. Supports `$expand`.|
+|multiValueExtendedProperties|[multiValueLegacyExtendedProperty](multivaluelegacyextendedproperty.md) collection| The collection of multi-value extended properties defined for the post. Read-only. Nullable.|
+|singleValueExtendedProperties|[singleValueLegacyExtendedProperty](singlevaluelegacyextendedproperty.md) collection| The collection of single-value extended properties defined for the post. Read-only. Nullable.|
+ ## JSON representation Here is a JSON representation of the resource
Here is a JSON representation of the resource
} ```
-## Properties
-| Property | Type |Description|
-|:|:--|:-|
-|body|[itemBody](itembody.md)|The contents of the post. This is a default property. This property can be null.|
-|categories|String collection|The categories associated with the post. Each category corresponds to the **displayName** property of an [outlookCategory](outlookcategory.md) that has been defined for a user.|
-|changeKey|String|Identifies the version of the post. Every time the post is changed, ChangeKey changes as well. This allows Exchange to apply changes to the correct version of the object.|
-|conversationId|String|Unique ID of the conversation. Read-only.|
-|conversationThreadId|String|Unique ID of the conversation thread. Read-only.|
-|createdDateTime|DateTimeOffset|Specifies when the post was created. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`|
-|from|[recipient](recipient.md)|Used in delegate access scenarios. Indicates who posted the message on behalf of another user. This is a default property.|
-|hasAttachments|Boolean|Indicates whether the post has at least one attachment. This is a default property.|
-|id|String| Read-only.|
-|importance | importance| The importance of a group post: `low`, `normal`, `high`. |
-|lastModifiedDateTime|DateTimeOffset|Specifies when the post was last modified. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`|
-|newParticipants|[recipient](recipient.md) collection|Conversation participants that were added to the thread as part of this post.|
-|receivedDateTime|DateTimeOffset|Specifies when the post was received. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`|
-|sender|[recipient](recipient.md)|Contains the address of the sender. The value of Sender is assumed to be the address of the authenticated user in the case when Sender is not specified. This is a default property.|
-
-## Relationships
-| Relationship | Type |Description|
-|:|:--|:-|
-|attachments|[Attachment](attachment.md) collection|The collection of [fileAttachment](fileattachment.md), [itemAttachment](itemattachment.md), and [referenceAttachment](referenceattachment.md) attachments for the post. Read-only. Nullable.|
-|extensions|[Extension](extension.md) collection|The collection of open extensions defined for the post. Read-only. Nullable.|
-|inReplyTo|[Post](post.md)|The earlier post that this post is replying to in the [conversationThread](conversationthread.md). Read-only.|
-|multiValueExtendedProperties|[multiValueLegacyExtendedProperty](multivaluelegacyextendedproperty.md) collection| The collection of multi-value extended properties defined for the post. Read-only. Nullable.|
-|singleValueExtendedProperties|[singleValueLegacyExtendedProperty](singlevaluelegacyextendedproperty.md) collection| The collection of single-value extended properties defined for the post. Read-only. Nullable.|
-
-## Methods
-
-| Method | Return Type |Description|
-|:|:--|:-|
-|[List posts](../api/conversationthread-list-posts.md) | [post](post.md) |Get the posts of the specified thread. |
-|[Get post](../api/post-get.md) | [post](post.md) |Get the properties and relationships of a post in a specified thread.|
-|[Reply](../api/post-reply.md)|None|Reply to a post and add a new post to the specified thread in a group conversation.|
-|[Forward](../api/post-forward.md)|None|Forward a post to a recipient.|
-|**Attachments**| | |
-|[List attachments](../api/post-list-attachments.md) |[attachment](attachment.md) collection| Get all attachments on a post.|
-|[Add attachment](../api/post-post-attachments.md) |[attachment](attachment.md)| Add an attachment to a post. |
-|**Open extensions**| | |
-|[Create open extension](../api/opentypeextension-post-opentypeextension.md) |[openTypeExtension](opentypeextension.md)| Create an open extension and add custom properties to a new or existing resource.|
-|[Get open extension](../api/opentypeextension-get.md) |[openTypeExtension](opentypeextension.md) collection| Get an open extension identified by the extension name.|
-|**Schema extensions**| | |
-|[Add schema extension values](/graph/extensibility-schema-groups) || Create a schema extension definition and then use it to add custom typed data to a resource.|
-|**Extended properties**| | |
-|[Create single-value extended property](../api/singlevaluelegacyextendedproperty-post-singlevalueextendedproperties.md) |[post](post.md) |Create one or more single-value extended properties in a new or existing post. |
-|[Get post with single-value extended property](../api/singlevaluelegacyextendedproperty-get.md) | [post](post.md) | Get posts that contain a single-value extended property by using `$expand` or `$filter`. |
-|[Create multi-value extended property](../api/multivaluelegacyextendedproperty-post-multivalueextendedproperties.md) | [post](post.md) | Create one or more multi-value extended properties in a new or existing post. |
-|[Get post with multi-value extended property](../api/multivaluelegacyextendedproperty-get.md) | [post](post.md) | Get a post that contains a multi-value extended property by using `$expand`. |
## See also
v1.0 Responsestatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/responsestatus.md
Title: "responseStatus resource type"
description: "The response status of a meeting request." localization_priority: Normal doc_type: resourcePageType
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-The response status of a meeting request.
+The response status of an attendee or organizer for a meeting request.
+
+You can get the response status of an attendee or organizer through the **responseStatus** property of an [event](event.md) or the **status** property of an [attendee](attendee.md).
## Properties | Property | Type | Description | |:|:|:|
-| response | String | The response type. Possible values are: `None`, `Organizer`, `TentativelyAccepted`, `Accepted`, `Declined`, `NotResponded`.
+| response | String | The response type. Possible values are: `none`, `organizer`, `tentativelyAccepted`, `accepted`, `declined`, `notResponded`.<br><br>To differentiate between `none` and `notResponded`: as an example, if attendee Alex hasn't responded to a meeting request, getting Alex' response status for that event in Alex' calendar returns `notResponded`. Getting Alex' response from the calendar of any other attendee or the organizer's returns `none`. Getting the organizer's response for the event in anybody's calendar also returns `none`.
| time | DateTimeOffset | The date and time that the response was returned. It uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z` ## JSON representation
v1.0 Signin https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/signin.md
Namespace: microsoft.graph
Provides details about user or application sign-in activity in your directory. You must have an Azure AD Premium P1 or P2 license to download sign-in logs using the Microsoft Graph API.
+The availability of sign-in logs is governed by the [Azure AD data retention policies](/azure/active-directory/reports-monitoring/reference-reports-data-retention#how-long-does-azure-ad-store-the-data).
+ ## Methods | Method | Return Type |Description|
v1.0 User https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/user.md
This resource supports:
| consentProvidedForMinor | [consentProvidedForMinor](#consentprovidedforminor-values) | Sets whether consent has been obtained for minors. Allowed values: `null`, `granted`, `denied` and `notRequired`. Refer to the [legal age group property definitions](#legal-age-group-property-definitions) for further information. <br><br>Supports `$filter` (`eq`, `ne`, `NOT`, and `in`).| | country | String | The country/region in which the user is located; for example, `US` or `UK`. Maximum length is 128 characters. <br><br>Supports `$filter` (`eq`, `ne`, `NOT`, `ge`, `le`, `in`, `startsWith`). | | createdDateTime | DateTimeOffset | The date and time the user was created. The value cannot be modified and is automatically populated when the entity is created. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. Property is nullable. A null value indicates that an accurate creation time couldn't be determined for the user. Read-only. <br><br>Supports `$filter` (`eq`, `ne`, `NOT` , `ge`, `le`, and `in` operators). |
-| creationType | String | Indicates whether the user account was created as a regular school or work account (`null`), an external account (`Invitation`), a local account for an Azure Active Directory B2C tenant (`LocalAccount`) or self-service sign-up using email verification (`EmailVerified`). Read-only. <br><br>Supports `$filter` (`eq`, `ne`, `NOT`, and `in`). |
+| creationType | String | Indicates whether the user account was created through one of the following methods: <br/> <ul><li>As a regular school or work account (`null`). <li>As an external account (`Invitation`). <li>As a local account for an Azure Active Directory B2C tenant (`LocalAccount`). <li>Through self-service sign-up by an internal user using email verification (`EmailVerified`). <li>Through self-service sign-up by an external user signing up through a link that is part of a user flow (`SelfServiceSignUp`). </ul> <br>Read-only.<br>Supports `$filter` (`eq`, `ne`, `NOT`, and `in`). |
| deletedDateTime | DateTimeOffset | The date and time the user was deleted. <br><br>Supports `$filter` (`eq`, `ne`, `NOT`, `ge`, `le`, and `in`). | | department | String | The name for the department in which the user works. Maximum length is 64 characters.<br><br>Supports `$filter` (`eq`, `ne`, `NOT` , `ge`, `le`, and `in` operators). | | displayName | String | The name displayed in the address book for the user. This value is usually the combination of the user's first name, middle initial, and last name. This property is required when a user is created and it cannot be cleared during updates. Maximum length is 256 characters. <br><br>Supports `$filter` (`eq`, `ne`, `NOT` , `ge`, `le`, `in`, `startsWith`), `$orderBy`, and `$search`.|
v1.0 Application Post Applications https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/application-post-applications.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) | Application.ReadWrite.All, Directory.AccessAsUser.All | |Delegated (personal Microsoft account) | Application.ReadWrite.All |
-|Application | Application.ReadWrite.All, Application.ReadWrite.OwnedBy |
+|Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All |
## HTTP request <!-- { "blockType": "ignored" } -->
Content-length: 67
### Response
-Here is an example of the response.
+The following is an example of the response.
> **Note:** The response object shown here might be shortened for readability. <!-- {
v1.0 Conversation Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/conversation-delete.md
Do not supply a request body for this method.
If successful, this method returns `204 No Content` response code. It does not return anything in the response body. ## Example
-##### Request
-Here is an example of the request.
+### Request
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
DELETE https://graph.microsoft.com/v1.0/groups/{id}/conversations/{id}
-##### Response
-Here is an example of the response.
+### Response
+The following is an example of the response.
<!-- { "blockType": "response", "truncated": true
v1.0 Conversation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/conversation-get.md
GET /groups/{id}/conversations/{id}
``` ## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response.
## Request headers | Header | Value | |:|:--|
Do not supply a request body for this method.
If successful, this method returns a `200 OK` response code and [conversation](../resources/conversation.md) object in the response body. ## Example
-##### Request
-Here is an example of the request.
+### Request
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
Here is an example of the request.
"name": "get_conversation" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/v1.0/groups/{id}/conversations/{id}
+GET https://graph.microsoft.com/v1.0/groups/4d81ce71-486c-41e9-afc5-e41bf2d0722a/conversations/AAQkAGRhZmRhMWM3LTYwZTktNDZmYy1hNWU1LThhZWU4NzI2YTEyZgAQABKPPJ682apIiV1UFlj7XxY=
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-conversation-csharp-snippets.md)]
GET https://graph.microsoft.com/v1.0/groups/{id}/conversations/{id}
-##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Here is an example of the response. Note: The response object shown here might b
```http HTTP/1.1 200 OK Content-type: application/json
-Content-length: 201
{
- "topic": "topic-value",
- "hasAttachments": true,
- "lastDeliveredDateTime": "datetime-value",
- "uniqueSenders": [
- "uniqueSenders-value"
- ],
- "preview": "preview-value",
- "id": "id-value"
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groups('4d81ce71-486c-41e9-afc5-e41bf2d0722a')/conversations/$entity",
+ "id": "AAQkAGRhZmRhMWM3LTYwZTktNDZmYy1hNWU1LThhZWU4NzI2YTEyZgAQABKPPJ682apIiV1UFlj7XxY=",
+ "topic": "The new Ask HR group is ready",
+ "hasAttachments": false,
+ "lastDeliveredDateTime": "2021-08-02T11:42:38Z",
+ "uniqueSenders": [
+ "Ask HR"
+ ],
+ "preview": "Welcome to the Ask HR group.Use the group to share ideas, files, and important dates.Start a conversationRead group conversations or start your own.Add to the team siteStart sharing and collaborating on content in SharePoint.Share filesView,"
} ```
v1.0 Conversation List Threads https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/conversation-list-threads.md
One of the following permissions is required to call this API. To learn more, in
GET /groups/{id}/conversations/{id}/threads ``` ## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response for example, to retrieve the **toRecipients** and **ccRecipients** properties.
## Request headers | Header | Value | |:|:--|
Do not supply a request body for this method.
If successful, this method returns a `200 OK` response code and collection of [conversationThread](../resources/conversationthread.md) objects in the response body. ## Example
-##### Request
-Here is an example of the request.
+### Request
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
Here is an example of the request.
"name": "get_threads" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/v1.0/groups/{id}/conversations/{id}/threads
+GET https://graph.microsoft.com/v1.0/groups/4d81ce71-486c-41e9-afc5-e41bf2d0722a/conversations/AAQkAGRhZmRhMWM3LTYwZTktNDZmYy1hNWU1LThhZWU4NzI2YTEyZgAQABKPPJ682apIiV1UFlj7XxY=/threads
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-threads-csharp-snippets.md)]
GET https://graph.microsoft.com/v1.0/groups/{id}/conversations/{id}/threads
-##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Here is an example of the response. Note: The response object shown here might b
```http HTTP/1.1 200 OK Content-type: application/json
-Content-length: 536
{
- "value": [
- {
- "toRecipients": [
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groups('4d81ce71-486c-41e9-afc5-e41bf2d0722a')/conversations('AAQkAGRhZmRhMWM3LTYwZTktNDZmYy1hNWU1LThhZWU4NzI2YTEyZgAQABKPPJ682apIiV1UFlj7XxY%3D')/threads",
+ "value": [
{
- "emailAddress": {
- "name": "name-value",
- "address": "address-value"
- }
+ "id": "AAQkAGRhZmRhMWM3LTYwZTktNDZmYy1hNWU1LThhZWU4NzI2YTEyZgMkABAAEo88nrzZqkiJXVQWWPtfFhAAEo88nrzZqkiJXVQWWPtfFg==",
+ "topic": "The new Ask HR group is ready",
+ "hasAttachments": false,
+ "lastDeliveredDateTime": "2021-08-02T11:42:38Z",
+ "uniqueSenders": [
+ "Ask HR"
+ ],
+ "preview": "Welcome to the Ask HR group.Use the group to share ideas, files, and important dates.Start a conversationRead group conversations or start your own.Add to the team siteStart sharing and collaborating on content in SharePoint.Share filesView,",
+ "isLocked": false
}
- ],
- "topic": "topic-value",
- "hasAttachments": true,
- "lastDeliveredDateTime": "datetime-value",
- "uniqueSenders": [
- "uniqueSenders-value"
- ],
- "ccRecipients": [
- {
- "emailAddress": {
- "name": "name-value",
- "address": "address-value"
- }
- }
- ]
- }
- ]
+ ]
} ```
v1.0 Conversation Post Threads https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/conversation-post-threads.md
POST /groups/{id}/conversations/{id}/threads
| Authorization | string | Bearer {token}. Required. | ## Request body
-In the request body, supply a JSON representation of [ConversationThread](../resources/conversationthread.md) object.
+In the request body, supply a JSON representation of [conversationThread](../resources/conversationthread.md) object.
## Response
-If successful, this method returns `201 Created` response code and [ConversationThread](../resources/conversationthread.md) object in the response body.
+If successful, this method returns `201 Created` response code and [conversationThread](../resources/conversationthread.md) object in the response body.
## Example
-##### Request
-Here is an example of the request.
+### Request
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
POST https://graph.microsoft.com/v1.0/groups/{id}/conversations/{id}/threads
Content-type: application/json {
- "topic": "topic-value",
- "posts": [{
- "body": {
- "contentType": "html",
- "content": "this is body content"
- }
- }]
+ "topic": "Take your wellness days and rest",
+ "posts": [
+ {
+ "body": {
+ "contentType": "html",
+ "content": "Waiting for the summer holidays."
+ }
+ }
+ ]
} ``` # [C#](#tab/csharp)
Content-type: application/json
In the request body, supply a JSON representation of [conversationThread](../resources/conversationthread.md) object.
-##### Response
+### Response
If successful, this method returns `201 Created` response code and the `id` of the new thread in the response body.
-Here is an example of the response.
+The following is an example of the response.
<!-- { "blockType": "response", "truncated": true,
Here is an example of the response.
```http HTTP/1.1 201 Created Content-type: application/json
-Content-length: 346
{
- "id": "thread-id-value"
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groups('4d81ce71-486c-41e9-afc5-e41bf2d0722a')/conversations('AAQkAGRhZmRhMWM3LTYwZTktNDZmYy1hNWU1LThhZWU4NzI2YTEyZgAQABKPPJ682apIiV1UFlj7XxY%3D')/threads/$entity",
+ "id": "AAQkAGRhZmRhMWM3LTYwZTktNDZmYy1hNWU1LThhZWU4NzI2YTEyZgMkABAArnv4XDMi_kemtqM1d730TxAArnv4XDMi_kemtqM1d730Tw=="
} ```
v1.0 Conversationthread List Posts https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/conversationthread-list-posts.md
GET /groups/{groupId}/conversations/{conversationId}/threads/{threadId}/posts
``` ## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response. `$expand` is also supported to expand specific relationships and only one relationship can be expanded in a single request.
## Request headers | Header | Value | |:|:--|
v1.0 Educationsubmission Post Resources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/educationsubmission-post-resources.md
doc_type: apiPageType
Namespace: microsoft.graph
-Add a resource to the submission resource list.
+Add a resource to the submission resource list.
-This action can only be done by the student to whom this submission is assigned. This action will not succeed if the **allowStudentsToAddResources** flag isn't set to `true`. If the caller wants to create a new file-based resource, the file must be uploaded to the resources folder that is associated with the submission. If the file does not exist or isn't in that folder, the POST request will fail.
+Only the student assigned to the submission can perform this operation.
+
+The operation will not succeed if the **allowStudentsToAddResources** flag is not set to `true`.
+
+If the caller wants to create a new file-based resource, upload the file to the resources folder associated with the submission. If the file doesn't exist or is not in that folder, the POST request will fail.
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
POST /education/classes/{id}/assignments/{id}/submissions/{id}/resources
| Content-Type | application/json | ## Request body
-In the request body, supply a JSON representation of the [educationSubmissionResource](../resources/educationsubmissionresource.md) object.
+In the request body, supply a JSON representation of the resource. Supported types are [educationExcelResource](../resources/educationexcelresource.md), [educationFileResource](../resources/educationfileresource.md), [educationLinkResource](../resources/educationlinkresource.md), [educationPowerPointResource](../resources/educationpowerpointresource.md) and [educationWordResource](../resources/educationwordresource.md).
## Response
-If successful, this method returns a `201 Created` response code and an [educationSubmissionResource](../resources/educationsubmissionresource.md) object in the response body.
+If successful, this method returns a `201 Created` response code and an object according to the resource type in the response body.
## Example ### Request The following is an example of the request.
+# [HTTP](#tab/http)
+ # [HTTP](#tab/http) <!-- { "blockType": "request", "name": "create_educationsubmissionresource_from_educationsubmission" }--> ```http
-POST https://graph.microsoft.com/v1.0/education/classes/acdefc6b-2dc6-4e71-b1e9-6d9810ab1793/assignments/ad8afb28-c138-4ad7-b7f5-a6986c2655a8/submissions/fbe51c90-78b7-418a-b5f3-871bf8d8d21e/resources
+POST https://graph.microsoft.com/v1.0/education/classes/f4a941ff-9da6-4707-ba5b-0eae93cad0b4/assignments/3c77de7f-539b-49e1-9c96-1274f2f0ee3b/submissions/4af73d2b-6b9c-493f-0688-979087bed39b/resources
Content-type: application/json Content-length: 1097 {
- "assignmentResourceUrl": "https://graph.microsoft.com/v1.0/drives/b!8-QjN2tsv0WyGnTv7vOvnQkmGHbbeMNLqYKONmHLVnvCVmBYIGpeT456457AdW9f/items/017NJZI25NOB5XZNLABF7646XAMDZTQQ6T",
- "resource": {
- "@odata.type": "#microsoft.graph.educationWordResource",
- "displayName": "Report.docx",
- "createdDateTime": "2017-10-21T07:52:53.9863696Z",
- "createdBy": {
- "application": null,
- "device": null,
- "user": {
- "id": "63cc91d2-59c7-4732-9594-35b91a26b340",
- "displayName": null
- }
- },
- "lastModifiedDateTime": "2017-10-21T07:52:53.9863696Z",
- "lastModifiedBy": {
- "application": null,
- "device": null,
- "user": {
- "id": "63cc91d2-59c7-4732-9594-35b91a26b340",
- "displayName": null
- }
- },
- "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!8-QjN2tsv0WyGnTv7vOvnQkmGHbbeMNLqYKONmHLVnvCVmBYIGpeTZ_iul5AdW9f/items/017NJZI27BCN2QI2H7HJGLIVPXR6SD2DH6"
- },
- "@odata.type": "microsoft.graph.educationResource"
+ "resource": {
+ "@odata.type": "microsoft.graph.educationWordResource",
+ "displayName": "Report.docx",
+ "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!DPA6q59Tw0mtgmyXRUmrQRqBZTesG-lMkl1cBmvvMeUEWrOk89nKRpUEr4ZhNYBc/items/016XPCQEELISJB7NVNVBAK7V4UIF6Q27U2"
+ }
} ``` # [C#](#tab/csharp)
The following is an example of the response.
<!-- { "blockType": "response", "truncated": true,
- "@odata.type": "microsoft.graph.educationSubmissionResource"
+ "@odata.type": "microsoft.graph.educationWordResource"
} --> ```http HTTP/1.1 201 Created
Content-type: application/json
Content-length: 1152 {
- "assignmentResourceUrl": "https://graph.microsoft.com/v1.0/drives/b!8-QjN2tsv0WyGnTv7vOvnQkmGHbbeMNLqYKONmHLVnvCVmBYIGpeT456457AdW9f/items/017NJZI25NOB5XZNLABF7646XAMDZTQQ6T",
- "id": "f2387c3b-ec39-4bf2-a399-d7242677f024",
- "resource": {
- "@odata.type": "#microsoft.graph.educationWordResource",
- "displayName": "Report.docx",
- "createdDateTime": "2017-10-21T07:52:53.9863696Z",
- "createdBy": {
- "application": null,
- "device": null,
- "user": {
- "id": "63cc91d2-59c7-4732-9594-35b91a26b340",
- "displayName": null
- }
- },
- "lastModifiedDateTime": "2017-10-21T07:52:53.9863696Z",
- "lastModifiedBy": {
- "application": null,
- "device": null,
- "user": {
- "id": "63cc91d2-59c7-4732-9594-35b91a26b340",
- "displayName": null
- }
- },
- "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!8-QjN2tsv0WyGnTv7vOvnQkmGHbbeMNLqYKONmHLVnvCVmBYIGpeTZ_iul5AdW9f/items/017NJZI27BCN2QI2H7HJGLIVPXR6SD2DH6",
- }
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#education/classes('f4a941ff-9da6-4707-ba5b-0eae93cad0b4')/assignments('3c77de7f-539b-49e1-9c96-1274f2f0ee3b')/submissions('4af73d2b-6b9c-493f-0688-979087bed39b')/resources/$entity",
+ "assignmentResourceUrl": null,
+ "id": "d835503f-fd00-4840-b69c-7230d10e18b8",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationWordResource",
+ "displayName": "Report.docx",
+ "createdDateTime": "2021-08-04T00:23:08.6269586Z",
+ "lastModifiedDateTime": "2021-08-04T00:23:08.6269586Z",
+ "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!DPA6q59Tw0mtgmyXRUmrQRqBZTesG-lMkl1cBmvvMeUEWrOk89nKRpUEr4ZhNYBc/items/016XPCQEELISJB7NVNVBAK7V4UIF6Q27U2",
+ "createdBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "displayName": null
+ }
+ }
+ }
} ```
v1.0 Event Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/event-delta.md
doc_type: apiPageType
Namespace: microsoft.graph
-Get a set of events that have been added, deleted, or updated in a **calendarView** (a range of events)
-of the user's primary calendar.
+Get a set of [event](../resources/event.md) resources that have been added, deleted, or updated in a **calendarView** (a range of events defined by start and end dates) of the user's primary calendar.
-A **delta** function call for events is similar to a `GET /calendarview` request for
-a range of dates in the user's primary calendar, except that by appropriately
-applying [state tokens](/graph/delta-query-overview) in one or more of these calls,
-you can query for incremental changes in that calender view. This allows you to maintain and synchronize
-a local store of a user's events in the primary calendar, without having to fetch all the events of that calendar
-from the server every time.
+Typically, synchronizing events in a **calendarView** in a local store entails a round of multiple **delta** function calls. The initial call is a full synchronization, and every subsequent **delta** call in the same round gets the incremental changes (additions, deletions, or updates). This allows you to maintain and synchronize a local store of events in the specified **calendarView**, without having to fetch all the events of that calendar from the server every time.
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
includes the encoded, desired parameters.
| $deltatoken | string | A [state token](/graph/delta-query-overview) returned in the `deltaLink` URL of the previous **delta** function call for the same calendar view, indicating the completion of that round of change tracking. Save and apply the entire `deltaLink` URL including this token in the first request of the next round of change tracking for that calendar view.| | $skiptoken | string | A [state token](/graph/delta-query-overview) returned in the `nextLink` URL of the previous **delta** function call, indicating there are further changes to be tracked in the same calendar view. |
-When you do a delta query on a calendar view, expect to get all the properties you'd normally get from
-a `GET /calendarview` request. `$select` is not supported in this case.
+### OData query parameters
+- Expect a **delta** function call on a **calendarView** to return the same properties you'd normally get from a `GET /calendarview` request. You cannot use `$select` to get only a subset of those properties.
+
+- There are other OData query parameters that the **delta** function for **calendarView** doesn't support: `$expand`, `$filter`,`$orderby`, and `$search`.
## Request headers
a `GET /calendarview` request. `$select` is not supported in this case.
If successful, this method returns a `200 OK` response code and [event](../resources/event.md) collection object in the response body.
+Within a round of **delta** function calls bound by the date range of a **calendarView**, you may find a **delta** call returning two types of events under `@removed` with the reason `deleted`:
+- Events that are within the date range and that have been deleted since the previous **delta** call.
+- Events that are _outside_ the date range and that have been added, deleted, or updated since the the previous **delta** call.
+
+Filter the events under `@removed` for the date range that your scenario requires.
+ ## Example ##### Request
GET https://graph.microsoft.com/v1.0/me/calendarView/delta?startdatetime={start_
Prefer: odata.maxpagesize=2 ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Java](#tab/java)
--- ##### Response If the request is successful, the response would include a state token, which is either a _skipToken_
v1.0 Group Assignlicense https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-assignlicense.md
If successful, this method returns a `202 Accepted` response code and a target [
The following example adds licenses to the group. #### Request + # [HTTP](#tab/http) <!-- { "blockType": "request", "name": "group_assignlicense" }--> ```http
-POST https://graph.microsoft.com/v1.0/groups/1ad75eeb-7e5a-4367-a493-9214d90d54d0/assignLicense
+POST https://graph.microsoft.com/v1.0/groups/1132b215-826f-42a9-8cfe-1643d19d17fd/assignLicense
Content-type: application/json - { "addLicenses": [ {
- "disabledPlans": [ "11b0131d-43c8-4bbb-b2c8-e80f9a50834a" ],
- "skuId": "skuId-value-1"
+ "disabledPlans": [
+ "113feb6c-3fe4-4440-bddc-54d774bf0318",
+ "14ab5db5-e6c4-4b20-b4bc-13e36fd2227f"
+ ],
+ "skuId": "b05e124f-c7cc-45a0-a6aa-8cf78c946968"
}, {
- "disabledPlans": [ "a571ebcc-fqe0-4ca2-8c8c-7a284fd6c235" ],
- "skuId": "skuId-value-2"
+ "disabledPlans": [
+ "a413a9ff-720c-4822-98ef-2f37c2a21f4c"
+ ],
+ "skuId": "c7df2760-2c81-4ef7-b578-5b5392b571df"
} ], "removeLicenses": []
The response is the updated group object.
```http HTTP/1.1 202 Accepted Content-type: application/json
-location: https://graph.microsoft.com/v2/d056d009-17b3-4106-8173-cd3978ada898/directoryObjects/1ad75eeb-7e5a-4367-a493-9214d90d54d0/Microsoft.DirectoryServices.Group
+location: https://graph.microsoft.com/v2/e8e96c2a-d787-4eb1-98d7-9e57c965f1de/directoryObjects/1132b215-826f-42a9-8cfe-1643d19d17fd/Microsoft.DirectoryServices.Group
{
- "id": "1ad75eeb-7e5a-4367-a493-9214d90d54d0",
- "deletedDateTime": null,
- "classification": null,
- "createdDateTime": "2018-04-18T22:05:03Z",
+ "id": "1132b215-826f-42a9-8cfe-1643d19d17fd",
+ "createdDateTime": "2021-03-12T11:15:03Z",
+ "groupTypes": [],
"securityEnabled": true,- } ```
The following example removes licenses from the group.
#### Request + # [HTTP](#tab/http) <!-- { "blockType": "request",
The following example removes licenses from the group.
}--> ```http
-POST https://graph.microsoft.com/v1.0/groups/1ad75eeb-7e5a-4367-a493-9214d90d54d0/assignLicense
+POST https://graph.microsoft.com/v1.0/groups/1132b215-826f-42a9-8cfe-1643d19d17fd/assignLicense
Content-type: application/json - { "addLicenses": [],
- "removeLicenses": ["skuId-value-1", "skuId-value-2"]
+ "removeLicenses": [
+ "c7df2760-2c81-4ef7-b578-5b5392b571df",
+ "b05e124f-c7cc-45a0-a6aa-8cf78c946968"
+ ]
} ``` # [C#](#tab/csharp)
v1.0 Group Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-delta.md
Content-type: application/json
"@odata.context":"https://graph.microsoft.com/v1.0/$metadata#groups","@odata.nextLink":"https://graph.microsoft.com/v1.0/groups/delta?$skiptoken=pqwSUjGYvb3jQpbwVAwEL7yuI3dU1LecfkkfLPtnIjvY1FSSc_", "value":[ {
- "classification": "classification-value",
- "createdDateTime":"datetime-value",
- "description":"Test group 1",
- "displayName":"TestGroup1",
+ "createdDateTime":"2021-03-12T10:36:14Z",
+ "description":"This is the default group for everyone in the network",
+ "displayName":"All Company",
"groupTypes": [
- "groupTypes-value"
+ "Unified"
],
- "mail": "mail-value",
+ "mail": "allcompany@contoso.com",
"members@delta": [
- {
- "@odata.type": "#microsoft.graph.user",
- "id": "693acd06-2877-4339-8ade-b704261fe7a0"
- },
- {
- "@odata.type": "#microsoft.graph.user",
- "id": "49320844-be99-4164-8167-87ff5d047ace"
- }
+ {
+ "@odata.type": "#microsoft.graph.user",
+ "id": "693acd06-2877-4339-8ade-b704261fe7a0"
+ },
+ {
+ "@odata.type": "#microsoft.graph.user",
+ "id": "49320844-be99-4164-8167-87ff5d047ace"
+ }
] } ]
Content-type: application/json
"@odata.nextLink":"https://graph.microsoft.com/v1.0/groups/delta?$skiptoken=pqwSUjGYvb3jQpbwVAwEL7yuI3dU1LecfkkfLPtnIjsXoYQp_dpA3cNJWc", "value": [ {
- "displayName": "displayName-value",
+ "displayName": "All Company",
"description": null,
- "mailNickname": "mailNickname-value"
+ "mailNickname": "allcompany@contoso.com"
} ] }
Content-type: application/json
"@odata.nextLink":"https://graph.microsoft.com/v1.0/groups/delta?$skiptoken=pqwSUjGYvb3jQpbwVAwEL7yuI3dU1LecfkkfLPtnIjsXoYQp_dpA3cNJWc", "value": [ {
- "displayName": "displayName-value",
+ "displayName": "Everyone",
"description": null } ]
v1.0 Group Getmembergroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-getmembergroups.md
If successful, this method returns `200 OK` response code and String collection
## Example
-#### Request
+### Request
The following is an example of the request.
The following is an example of the request.
}--> ```http
-POST https://graph.microsoft.com/v1.0/groups/{id}/getMemberGroups
+POST https://graph.microsoft.com/v1.0/groups/1132b215-826f-42a9-8cfe-1643d19d17fd/getMemberGroups
Content-type: application/json
-Content-length: 33
{ "securityEnabledOnly": false
Content-length: 33
-#### Response
+### Response
The following is an example of the response.
The following is an example of the response.
```http HTTP/1.1 200 OK Content-type: application/json
-Content-length: 39
{ "value": [
- "string-value"
+ "1132b215-826f-42a9-8cfe-1643d19d17fd"
] } ```
v1.0 Group Getmemberobjects https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-getmemberobjects.md
In the request body, provide a JSON object with the following parameters.
| Parameter | Type |Description| |:|:--|:-|
-|securityEnabledOnly|Boolean| Set to **false**. Returning only security-enabled groups is supported for users only.|
+|securityEnabledOnly|Boolean| Set to `false`. Returning only security-enabled groups is supported for users only.|
## Response If successful, this method returns `200 OK` response code and String collection in the response body that contains the IDs of the groups that the group is a member of. ## Example
-#### Request
+### Request
The following is an example of the request. + # [HTTP](#tab/http) <!-- { "blockType": "request", "name": "group_getmemberobjects" }--> ```http
-POST https://graph.microsoft.com/v1.0/groups/{id}/getMemberObjects
+POST https://graph.microsoft.com/v1.0/groups/1132b215-826f-42a9-8cfe-1643d19d17fd/getMemberObjects
Content-type: application/json
-Content-length: 33
{ "securityEnabledOnly": false
Content-length: 33
-#### Response
+### Response
The following is an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- {
The following is an example of the response.
```http HTTP/1.1 200 OK Content-type: application/json
-Content-length: 39
{ "value": [
- "string-value"
+ "1132b215-826f-42a9-8cfe-1643d19d17fd"
] } ```
v1.0 Group List Conversations https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-list-conversations.md
GET /groups/{id}/conversations
``` ## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+This method supports the `$select` and `$filter` [OData query parameters](/graph/query-parameters) to help customize the response.
## Request headers | Header | Value |
Do not supply a request body for this method.
If successful, this method returns a `200 OK` response code and collection of [conversation](../resources/conversation.md) objects in the response body. ## Example
-#### Request
+### Request
The following is an example of the request. # [HTTP](#tab/http)
GET https://graph.microsoft.com/v1.0/groups/{id}/conversations
-#### Response
+### Response
The following is an example of the response. >**Note:** The response object shown here might be shortened for readability.
The following is an example of the response.
```http HTTP/1.1 200 OK Content-type: application/json
-Content-length: 262
{
- "value": [
- {
- "topic": "topic-value",
- "hasAttachments": true,
- "lastDeliveredDateTime": "datetime-value",
- "uniqueSenders": [
- "uniqueSenders-value"
- ],
- "preview": "preview-value",
- "id": "id-value"
- }
- ]
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groups('f448435d-3ca7-4073-8152-a1fd73c0fd09')/conversations",
+ "value": [
+ {
+ "id": "AAQkAGFhZDhkNGI1LTliZmEtNGEzMi04NTkzLWZjMWExZDkyMWEyZgAQAH4o7SknOTNKqAqMhqJHtUM=",
+ "topic": "The new All Company group is ready",
+ "hasAttachments": false,
+ "lastDeliveredDateTime": "2021-08-02T10:34:00Z",
+ "uniqueSenders": [
+ "All Company"
+ ],
+ "preview": "Welcome to the All Company group.Use the group to share ideas, files, and important dates.Start a conversationRead group conversations or start your own.Share filesView, edit, and share all group files, including email attachments.Connect your"
+ }
+ ]
} ```
v1.0 Group Post Conversations https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-post-conversations.md
The response includes the IDs for the new conversation and thread, which you can
[list posts](conversationthread-list-posts.md) operation to get the new post as well. ## Example
-#### Request
+### Request
The following is an example of the request.
POST https://graph.microsoft.com/v1.0/groups/29981b6a-0e57-42dc-94c9-cd24f530619
Content-type: application/json {
- "topic":"New locations for this quarter",
- "threads":[
- {
- "posts":[
+ "topic": "Take your wellness days and rest",
+ "threads": [
{
- "body":{
- "contentType":"html",
- "content":"What do we know so far?"
- },
- "newParticipants":[
- {
- "emailAddress":{
- "name":"Adele Vance",
- "address":"AdeleV@contoso.onmicrosoft.com"
- }
- }
- ]
+ "posts": [
+ {
+ "body": {
+ "contentType": "html",
+ "content": "Contoso cares about you: Rest and Recharge"
+ },
+ "newParticipants": [
+ {
+ "emailAddress": {
+ "name": "Adele Vance",
+ "address": "AdeleV@contoso.onmicrosoft.com"
+ }
+ }
+ ]
+ }
+ ]
}
- ]
- }
- ]
+ ]
} ``` # [C#](#tab/csharp)
Content-type: application/json
-#### Response
+### Response
The following is an example of the response. >**Note:** The response object shown here might be shortened for readability.
HTTP/1.1 200 OK
Content-type: application/json {
- "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#groups('29981b6a-0e57-42dc-94c9-cd24f5306196')/conversations/$entity",
- "id":"AAQkADDVKtMlRp4Txc6k=",
- "threads@odata.context":"https://graph.microsoft.com/v1.0/$metadata#groups('29981b6a-0e57-42dc-94c9-cd24f5306196')/conversations('AAQkADDVKtMlRp4Txc6k%3D')/threads",
- "threads":[
- {
- "id":"AAQkADQDarUNUq0yVGnhPFzqQ=="
- }
- ]
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groups('4d81ce71-486c-41e9-afc5-e41bf2d0722a')/conversations/$entity",
+ "id": "AAQkAGRhZmRhMWM3LTYwZTktNDZmYy1hNWU1LThhZWU4NzI2YTEyZgAQADamkjVbzvRKnUq1oBRdwhk=",
+ "threads@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groups('4d81ce71-486c-41e9-afc5-e41bf2d0722a')/conversations('AAQkAGRhZmRhMWM3LTYwZTktNDZmYy1hNWU1LThhZWU4NzI2YTEyZgAQADamkjVbzvRKnUq1oBRdwhk%3D')/threads",
+ "threads": [
+ {
+ "id": "AAQkAGRhZmRhMWM3LTYwZTktNDZmYy1hNWU1LThhZWU4NzI2YTEyZgMkABAANqaSNVvO9EqdSrWgFF3CGRAANqaSNVvO9EqdSrWgFF3CGQ=="
+ }
+ ]
} ```
v1.0 Group Post Groups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-post-groups.md
The following table shows the properties of the [group](../resources/group.md) r
| description | string | A description for the group. Max. length: 1024 characters. Optional. | | isAssignableToRole | Boolean | Set to **true** to enable the group to be assigned to an Azure AD role. Only Privileged Role Administrator and Global Administrator can set the value of this property. Optional. | | mailEnabled | boolean | Set to **true** for mail-enabled groups. Required. |
-| mailNickname | string | The mail alias for the group. Max. length: 64 characters. This property can contain only characters in the [ASCII character set 0 - 127](/office/vba/language/reference/user-interface-help/character-set-0127) except the following: ` @ () \ [] " ; : . <> , SPACE `. Required. |
+| mailNickname | string | The mail alias for the group. Max. length: 64 characters. This property can contain only characters in the [ASCII character set 0 - 127](/office/vba/language/reference/user-interface-help/character-set-0127) except the following: ` @ () \ [] " ; : . <> , SPACE`. Required. |
| securityEnabled | boolean | Set to **true** for security-enabled groups, including Microsoft 365 groups. Required. | | owners | string collection | This property represents the owners for the group at creation time. Owners aren't automatically added as group members unless specified in the **members** property. Optional. | | members | string collection | This property represents the members for the group at creation time. Optional. |
v1.0 Groupsetting List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/groupsetting-list.md
Do not supply a request body for this method.
If successful, this method returns a `200 OK` response code and collection of [groupSetting](../resources/groupsetting.md) objects in the response body. ## Example
-##### Request
+### Request
# [HTTP](#tab/http)
GET https://graph.microsoft.com/v1.0/groupSettings
-##### Response
+### Response
Note: The response object shown here might be shortened for readability. <!-- {
Note: The response object shown here might be shortened for readability.
```http HTTP/1.1 200 OK Content-type: application/json
-Content-length: 263
{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groupSettings",
"value": [ {
- "displayName": "displayName-value",
- "templateId": "templateId-value",
+ "id": "f0b2d6f5-097d-4177-91af-a24e530b53cc",
+ "displayName": "Group.Unified",
+ "templateId": "62375ab9-6b52-47ed-826b-58e47e0e304b",
"values": [ {
- "name": "name-value",
- "value": "value-value"
+ "name": "EnableMIPLabels",
+ "value": "true"
+ },
+ {
+ "name": "CustomBlockedWordsList",
+ "value": ""
+ },
+ {
+ "name": "EnableMSStandardBlockedWords",
+ "value": "true"
+ },
+ {
+ "name": "ClassificationDescriptions",
+ "value": ""
+ },
+ {
+ "name": "DefaultClassification",
+ "value": ""
+ },
+ {
+ "name": "PrefixSuffixNamingRequirement",
+ "value": "[Contoso-][GroupName]"
+ },
+ {
+ "name": "AllowGuestsToBeGroupOwner",
+ "value": "false"
+ },
+ {
+ "name": "AllowGuestsToAccessGroups",
+ "value": "true"
+ },
+ {
+ "name": "GuestUsageGuidelinesUrl",
+ "value": "https://privacy.contoso.com/privacystatement"
+ },
+ {
+ "name": "GroupCreationAllowedGroupId",
+ "value": ""
+ },
+ {
+ "name": "AllowToAddGuests",
+ "value": "true"
+ },
+ {
+ "name": "UsageGuidelinesUrl",
+ "value": ""
+ },
+ {
+ "name": "ClassificationList",
+ "value": ""
+ },
+ {
+ "name": "EnableGroupCreation",
+ "value": "true"
}
- ],
- "id": "id-value"
+ ]
} ] }
v1.0 Groupsetting Post Groupsettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/groupsetting-post-groupsettings.md
In the request body, supply a JSON representation of [groupSetting](../resources
If successful, this method returns `201 Created` response code and [groupSetting](../resources/groupsetting.md) object in the response body.
-## Example
+## Example 1: Create a new setting for all Microsoft 365 groups in the tenant
-##### Request
+### Request
# [HTTP](#tab/http)
If successful, this method returns `201 Created` response code and [groupSetting
```http POST https://graph.microsoft.com/v1.0/groupSettings Content-type: application/json
-Content-length: 215
{
- "displayName": "displayName-value",
- "templateId": "templateId-value",
+ "displayName": "Group.Unified",
+ "templateId": "62375ab9-6b52-47ed-826b-58e47e0e304b",
"values": [ {
- "name": "name-value",
- "value": "value-value"
+ "name": "GuestUsageGuidelinesUrl",
+ "value": "https://privacy.contoso.com/privacystatement"
+ },
+ {
+ "name": "EnableMSStandardBlockedWords",
+ "value": "true"
+ },
+ {
+ "name": "EnableMIPLabels",
+ "value": "true"
+ },
+ {
+ "name": "PrefixSuffixNamingRequirement",
+ "value": "[Contoso-][GroupName]"
} ] }
Content-length: 215
+
+In the request body, supply a JSON representation of [groupSetting](../resources/groupsetting.md) object.
+
+### Response
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.groupSetting"
+} -->
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groupSettings/$entity",
+ "id": "b11b99c5-f0a3-4c32-a250-548cf11cae1c",
+ "displayName": "Group.Unified",
+ "templateId": "62375ab9-6b52-47ed-826b-58e47e0e304b",
+ "values": [
+ {
+ "name": "GuestUsageGuidelinesUrl",
+ "value": "https://privacy.contoso.com/privacystatement"
+ },
+ {
+ "name": "EnableMSStandardBlockedWords",
+ "value": "true"
+ },
+ {
+ "name": "EnableMIPLabels",
+ "value": "true"
+ },
+ {
+ "name": "PrefixSuffixNamingRequirement",
+ "value": "[Contoso-][GroupName]"
+ }
+ ]
+}
+```
+
+## Example 2: Create a setting to block guests for a specific Microsoft 365 group
+
+### Request
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "create_groupsetting_from_groupsettings_for_guests"
+}-->
+```http
+POST https://graph.microsoft.com/v1.0/groups/055a5d18-a3a9-4338-b9c5-de92559b7ebf/settings
+Content-type: application/json
+
+{
+ "displayName": "Group.Unified.Guest",
+ "templateId": "08d542b9-071f-4e16-94b0-74abb372e3d9",
+ "values": [
+ {
+ "name": "AllowToAddGuests",
+ "value": "false"
+ }
+ ]
+}
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
++++ In the request body, supply a JSON representation of [groupSetting](../resources/groupsetting.md) object.
-##### Response
-Note: The response object shown here might be shortened for readability.
+### Response
+
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Note: The response object shown here might be shortened for readability.
```http HTTP/1.1 201 Created Content-type: application/json
-Content-length: 238
{
- "displayName": "displayName-value",
- "templateId": "templateId-value",
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groupSettings/$entity",
+ "id": "2a0248a2-fde9-4a80-a53e-c0141f68e03d",
+ "displayName": "Group.Unified.Guest",
+ "templateId": "08d542b9-071f-4e16-94b0-74abb372e3d9",
"values": [ {
- "name": "name-value",
- "value": "value-value"
+ "name": "AllowToAddGuests",
+ "value": "false"
}
- ],
- "id": "id-value"
+ ]
} ```
v1.0 Groupsetting Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/groupsetting-update.md
In this example, `{id}` is the identifier of the tenant-wide groupSetting object
"name": "update_tenant_setting" }--> ```http
-PATCH https://graph.microsoft.com/v1.0/groupSettings/{id}
+PATCH https://graph.microsoft.com/v1.0/groupSettings/f0b2d6f5-097d-4177-91af-a24e530b53cc
Content-type: application/json {
- "displayName": "Group.Unified",
- "templateId": "62375ab9-6b52-47ed-826b-58e47e0e304b",
"values": [
- {
- "name": "EnableMIPLabels",
- "value": "false"
- },
- {
- "name": "CustomBlockedWordsList",
- "value": ""
- },
- {
- "name": "EnableMSStandardBlockedWords",
- "value": "false"
- },
- {
- "name": "ClassificationDescriptions",
- "value": ""
- },
- {
- "name": "DefaultClassification",
- "value": ""
- },
- {
- "name": "PrefixSuffixNamingRequirement",
- "value": ""
- },
- {
- "name": "AllowGuestsToBeGroupOwner",
- "value": "false"
- },
- {
- "name": "AllowGuestsToAccessGroups",
- "value": "true"
- },
- {
- "name": "GuestUsageGuidelinesUrl",
- "value": ""
- },
- {
- "name": "GroupCreationAllowedGroupId",
- "value": ""
- },
{ "name": "AllowToAddGuests",
- "value": "true"
- },
- {
- "name": "UsageGuidelinesUrl",
- "value": ""
- },
- {
- "name": "ClassificationList",
- "value": ""
- },
- {
- "name": "EnableGroupCreation",
- "value": "true"
+ "value": "false"
} ] }
In this example, the first `{id}` in the request is the identifier of the group,
#### Request + # [HTTP](#tab/http) <!-- { "blockType": "request", "name": "update_groupsetting" }--> ```http
-PATCH https://graph.microsoft.com/v1.0/groups/{id}/settings/{id}
+PATCH https://graph.microsoft.com/v1.0/groups/0167b5af-f3d1-4910-82d2-398747fa381c/settings/fa6df613-159b-4f94-add2-7093f961900b
Content-type: application/json {
- "displayName": "GroupSettings",
- "templateId": "08d542b9-071f-4e16-94b0-74abb372e3d9",
"values": [ {
- "name": "AllowToAddGuests",
- "value": "false"
+ "name": "AllowToAddGuests",
+ "value": "true"
} ] }
v1.0 Groupsettingtemplate Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/groupsettingtemplate-get.md
Do not supply a request body for this method.
If successful, this method returns a `200 OK` response code and [groupSettingTemplate](../resources/groupsettingtemplate.md) object in the response body. ## Example
-##### Request
+### Request
+ # [HTTP](#tab/http) <!-- {
If successful, this method returns a `200 OK` response code and [groupSettingTem
"name": "get_groupsettingtemplate" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/v1.0/groupSettingTemplates/{id}
+GET https://graph.microsoft.com/v1.0/groupSettingTemplates/08d542b9-071f-4e16-94b0-74abb372e3d9
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-groupsettingtemplate-csharp-snippets.md)]
GET https://graph.microsoft.com/v1.0/groupSettingTemplates/{id}
-##### Response
+
+### Response
Note: The response object shown here might be shortened for readability. <!-- {
Note: The response object shown here might be shortened for readability.
```http HTTP/1.1 200 OK Content-type: application/json
-Content-length: 1341
{
- "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groupSettingTemplates/$entity",
- "id": "62375ab9-6b52-47ed-826b-58e47e0e304b",
- "deletedDateTime": null,
- "displayName": "Group.Unified",
- "description": "Setting templates define the different settings that can be used for the associated ObjectSettings. This template defines settings that can be used for Unified Groups.",
- "values": [
- {
- "name": "CustomBlockedWordsList",
- "type": "System.String",
- "defaultValue": "",
- "description": "A comma-delimited list of blocked words for Unified Group displayName and mailNickName."
- },
- {
- "name": "EnableMSStandardBlockedWords",
- "type": "System.Boolean",
- "defaultValue": "false",
- "description": "A flag indicating whether or not to enable the Microsoft Standard list of blocked words for Unified Group displayName and mailNickName."
- },
- {
- "name": "ClassificationDescriptions",
- "type": "System.String",
- "defaultValue": "",
- "description": "A comma-delimited list of structured strings describing the classification values in the ClassificationList. The structure of the string is: Value: Description"
- }
- ]
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groupSettingTemplates/$entity",
+ "id": "08d542b9-071f-4e16-94b0-74abb372e3d9",
+ "deletedDateTime": null,
+ "displayName": "Group.Unified.Guest",
+ "description": "Settings for a specific Unified Group",
+ "values": [
+ {
+ "name": "AllowToAddGuests",
+ "type": "System.Boolean",
+ "defaultValue": "true",
+ "description": "Flag indicating if guests are allowed in a specific Unified Group."
+ }
+ ]
} ```
v1.0 Groupsettingtemplate List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/groupsettingtemplate-list.md
One of the following permissions is required to call this API. To learn more, in
GET /groupSettingTemplates ``` ## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response.
> **Note:** $filter is not supported.
Note: The response object shown here might be shortened for readability.
```http HTTP/1.1 200 OK Content-type: application/json
-Content-length: 1770
{
- "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groupSettingTemplates",
- "value": [
- {
- "id": "62375ab9-6b52-47ed-826b-58e47e0e304b",
- "deletedDateTime": null,
- "displayName": "Group.Unified",
- "description": "Setting templates define the different settings that can be used for the associated ObjectSettings. This template defines settings that can be used for Unified Groups.",
- "values": [
- {
- "name": "CustomBlockedWordsList",
- "type": "System.String",
- "defaultValue": "",
- "description": "A comma-delimited list of blocked words for Unified Group displayName and mailNickName."
- },
- {
- "name": "EnableMSStandardBlockedWords",
- "type": "System.Boolean",
- "defaultValue": "false",
- "description": "A flag indicating whether or not to enable the Microsoft Standard list of blocked words for Unified Group displayName and mailNickName."
- },
- {
- "name": "ClassificationDescriptions",
- "type": "System.String",
- "defaultValue": "",
- "description": "A comma-delimited list of structured strings describing the classification values in the ClassificationList. The structure of the string is: Value: Description"
- }
- ]
- }
- ]
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groupSettingTemplates",
+ "value": [
+ {
+ "id": "08d542b9-071f-4e16-94b0-74abb372e3d9",
+ "deletedDateTime": null,
+ "displayName": "Group.Unified.Guest",
+ "description": "Settings for a specific Unified Group",
+ "values": [
+ {
+ "name": "AllowToAddGuests",
+ "type": "System.Boolean",
+ "defaultValue": "true",
+ "description": "Flag indicating if guests are allowed in a specific Unified Group."
+ }
+ ]
+ },
+ {
+ "id": "80661d51-be2f-4d46-9713-98a2fcaec5bc",
+ "deletedDateTime": null,
+ "displayName": "Prohibited Names Settings",
+ "description": "Setting templates define the different settings that can be used for the associated ObjectSettings. This template defines settings that can be used for managing tenant-wide prohibited names settings.",
+ "values": [
+ {
+ "name": "CustomBlockedSubStringsList",
+ "type": "System.String",
+ "defaultValue": "",
+ "description": "A comma delimited list of substring reserved words to block for application display names."
+ },
+ {
+ "name": "CustomBlockedWholeWordsList",
+ "type": "System.String",
+ "defaultValue": "",
+ "description": "A comma delimited list of reserved words to block for application display names."
+ }
+ ]
+ }
+ ]
} ```
v1.0 Oauth2permissiongrant Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/oauth2permissiongrant-delta.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) | Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.All | |Delegated (personal Microsoft account) | Not supported. |
-|oauth2permissiongrant | Directory.Read.All, Directory.ReadWrite.All |
+|Application | Directory.Read.All, Directory.ReadWrite.All |
## HTTP request
v1.0 Presence Clearpresence https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/presence-clearpresence.md
The following request shows the application with ID `22553876-f5ab-4529-bffb-cfe
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "clear--presence"
Content-Type: application/json
"sessionId": "22553876-f5ab-4529-bffb-cfe50aa89f87" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Presence Setpresence https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/presence-setpresence.md
The following request shows the application with ID `22553876-f5ab-4529-bffb-cfe
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "set-presence"
Content-Type: application/json
"expirationDuration": "PT1H" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Serviceprincipal Addkey https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceprincipal-addkey.md
ServicePrincipals that donΓÇÖt have any existing valid certificates (i.e.: no ce
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | None. |
+|Delegated (work or school account) | Directory.AccessAsUser.All, Application.ReadWrite.All, Directory.ReadWrite.All |
|Delegated (personal Microsoft account) | None. |
-|Application | None. |
+|Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All, Directory.ReadWrite.All |
-> [!NOTE]
-> A servicePrincipal does not need any specific permission to roll it's own keys.
## HTTP request
v1.0 Serviceprincipal Addpassword https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceprincipal-addpassword.md
POST /servicePrincipals/{id}/addPassword
## Request body
-In the request body, provide an optional `passwordCredential` object with the following properties.
+In the request body, provide an empty [passwordCredential](../resources/passwordcredential.md) object or with the following optional properties.
| Property | Type |Description| |:|:--|:-|
Content-type: application/json
### Response The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response",
v1.0 Serviceprincipal Removekey https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceprincipal-removekey.md
As part of the request validation for this method, a proof of possession of an e
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | None. |
+|Delegated (work or school account) | Directory.AccessAsUser.All, Application.ReadWrite.All, Directory.ReadWrite.All |
|Delegated (personal Microsoft account) | None. |
-|Application | None. |
-
-> [!NOTE]
-> A servicePrincipal does not need any specific permission to roll its own keys.
+|Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All, Directory.ReadWrite.All |
## HTTP request
v1.0 Signin List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/signin-list.md
doc_type: apiPageType
Namespace: microsoft.graph
-Retrieve the Azure AD user sign-ins for your tenant. Sign-ins that are interactive in nature (where a username/password is passed as part of auth token) and successful federated sign-ins are currently included in the sign-in logs. The maximum and default page size is 1,000 objects and by default, the most recent sign-ins are returned first.
+Retrieve the Azure AD user sign-ins for your tenant. Sign-ins that are interactive in nature (where a username/password is passed as part of auth token) and successful federated sign-ins are currently included in the sign-in logs.
+
+The maximum and default page size is 1,000 objects and by default, the most recent sign-ins are returned first. Only sign-in events that occurred within the Azure Active Directory (Azure AD) [default retention period](/azure/active-directory/reports-monitoring/reference-reports-data-retention#how-long-does-azure-ad-store-the-data) are available.
## Permissions
v1.0 Termstore Group Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/termstore-group-delete.md
+
+ Title: "Delete group"
+description: "Delete a group object in a term store."
+
+localization_priority: Normal
++
+# Delete group
+Namespace: microsoft.graph.termStore
+
+Delete a [group](../resources/termstore-group.md) object in a term [store].
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account) |TermStore.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE sites/{site-id}/termStore/groups/{group-id}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "delete_group_from_store"
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/v1.0/sites/microsoft.sharepoint.com,b9b0bc03-cbc4-40d2-aba9-2c9dd9821ddf,6a742cee-9216-4db5-8046-13a595684e74/termStore/groups/03577abb-975e-4fb4-9ee0-4102a9108f94
+```
+
+### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
+[microsoft.graph.termStore.group]: ../resources/termstore-group.md
+[microsoft.graph.termStore.store]: ../resources/termstore-store.md
+[microsoft.graph.termStore.set]: ../resources/termstore-set.md
+[store]: ../resources/termstore-store.md
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Delete a termGroup entity in termStore",
+ "keywords": "term,termStore",
+ "section": "documentation",
+ "tocPath": "termStore/Delete termGroup",
+ "suppressions": [
+ ]
+}
+-->
++
v1.0 Termstore Group Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/termstore-group-get.md
+
+ Title: "Get group"
+description: "Read the properties and relationships of a term store group object."
+
+localization_priority: Normal
++
+# Get group
+Namespace: microsoft.graph.termStore
+
+Read the properties and relationships of a term store [group](../resources/termstore-group.md) object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account) | TermStore.Read.All, TermStore.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+GET sites/{site-id}/termStore/groups/{group-id}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [microsoft.graph.termStore.group](../resources/termstore-group.md) object in the response body.
+
+## Examples
+
+### Example 1: Get a termStore group
+
+#### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "get_group_3"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/v1.0/sites/microsoft.sharepoint.com,b9b0bc03-cbc4-40d2-aba9-2c9dd9821ddf,6a742cee-9216-4db5-8046-13a595684e74/termStore/groups/1FFD3F87-9464-488A-A0EC-8FB90911182C
+```
+
+#### Response
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.termStore.group"
+} -->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "createdDateTime": "2019-06-21T20:01:37Z",
+ "description": "My term group",
+ "scope" : "global",
+ "id": "1FFD3F87-9464-488A-A0EC-8FB90911182C",
+ "displayName": "myGroup"
+}
+```
+### Example 2: Get a site collection termStore group and its parent site ID
+
+#### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "get_group"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/v1.0/sites/mycompany.sharepoint.com,8f03a01c-dcfa-4aaf-9be5-b3fb48e538c1,739084f3-c0fa-46ac-b7f8-13b344781ad0/termStore/groups/1FFD3F87-9464-488A-A0EC-8FB90911182C?$select=*,parentSiteId
+```
+
+#### Response
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.termStore.group"
+} -->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "createdDateTime": "2019-06-21T20:01:37Z",
+ "description": "My term group",
+ "scope" : "global",
+ "id": "1FFD3F87-9464-488A-A0EC-8FB90911182C",
+ "displayName": "myGroup",
+ "parentSiteId": "mycompany.sharepoint.com,a3c7cde8-ce00-4292-b4af-75f32b8b293f,739084f3-c0fa-46ac-b7f8-13b344781ad0"
+}
+```
+
+[microsoft.graph.termStore.store]: ../resources/termstore-store.md
+[microsoft.graph.termStore.group]: ../resources/termstore-group.md
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Get termGroup entity in termStore",
+ "keywords": "term,termStore",
+ "section": "documentation",
+ "tocPath": "termStore/Get termGroup",
+ "suppressions": [
+ ]
+}
+-->
++
v1.0 Termstore Group List Sets https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/termstore-group-list-sets.md
+
+ Title: "List sets"
+description: "Get a list of the set objects and their properties."
+
+localization_priority: Normal
++
+# List sets
+Namespace: microsoft.graph.termStore
+
+Get a list of the [set](../resources/termstore-set.md) objects and their properties.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account) |TermStore.Read.All, TermStore.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+GET sites/{site-id}/termStore/groups/{group-id}/sets
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [set](../resources/termstore-set.md) objects in the response body.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "get_set_1"
+}-->
+
+``` http
+GET https://graph.microsoft.com/v1.0/microsoft.sharepoint.com,b9b0bc03-cbc4-40d2-aba9-2c9dd9821ddf,6a742cee-9216-4db5-8046-13a595684e74/termStore/groups/03577abb-975e-4fb4-9ee0-4102a9108f94/sets
+```
+
+### Response
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.termStore.set",
+ "isCollection": true
+} -->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "id": "3607e9f9-e9f9-3607-f9e9-0736f9e90736",
+ "description": "Starting term Set",
+ "localizedNames" : [
+ {
+ "languageTag" : "en-US",
+ "name" : "Department"
+ }
+ ]
+ }
+ ]
+}
+```
+
+[microsoft.graph.termStore.set]: ../resources/termstore-set.md
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Get termSet entity in termStore",
+ "keywords": "term,termStore",
+ "section": "documentation",
+ "tocPath": "termStore/List termstore-set",
+ "suppressions": [
+ ]
+}
+-->
++
v1.0 Termstore Group Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/termstore-group-post.md
+
+ Title: "Create group"
+description: "Create a new group object in a term store."
+
+localization_priority: Normal
++
+# Create termStore group
+Namespace: microsoft.graph.termStore
+
+Create a new [group](../resources/termstore-group.md) object in a term store.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account) |TermStore.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+POST sites/{site-id}/termStore/groups
+```
+
+## 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 [group](../resources/termstore-group.md) object.
+
+The following table shows the properties that are required when you create the [group](../resources/termstore-group.md) object.
+
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|Name of the group to be created.|
+++
+## Response
+
+If successful, this method returns a `201 Created` response code and a [microsoft.graph.termStore.group](../resources/termstore-group.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "displayName": "myGroup"
+}-->
+
+``` http
+POST https://graph.microsoft.com/v1.0/sites/microsoft.sharepoint.com,b9b0bc03-cbc4-40d2-aba9-2c9dd9821ddf,6a742cee-9216-4db5-8046-13a595684e74/termStore/groups
+Content-Type: application/json
+Content-length: 135
+
+{
+ "displayName" : "myGroup"
+}
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.termStore.group"
+}-->
+
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "id": "85825593-5593-8582-9355-828593558285",
+ "createdDateTime": "2019-06-21T20:01:37Z",
+ "description": "My term group",
+ "scope" : "global",
+ "displayName": "myGroup"
+}
+```
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Create a termGroup entity in termStore",
+ "keywords": "term,termStore",
+ "section": "documentation",
+ "tocPath": "termStore/Create termGroup",
+ "suppressions": [
+ ]
+}
+-->
++
v1.0 Termstore List Groups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/termstore-list-groups.md
+
+ Title: "List groups"
+description: "Get a list of group objects in a term store."
+
+localization_priority: Normal
++
+# List termStore groups
+Namespace: microsoft.graph.termStore
+
+Get a list of [group](../resources/termstore-group.md) objects in a term [store](../resources/termstore-store.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account) | TermStore.Read.All, TermStore.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not Supported. |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+GET sites/{site-id}/termStore/groups
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [microsoft.graph.termStore.group](../resources/termstore-group.md) objects in the response body.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "get_group_2"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/v1.0/sites/microsoft.sharepoint.com,b9b0bc03-cbc4-40d2-aba9-2c9dd9821ddf,6a742cee-9216-4db5-8046-13a595684e74/termStore/groups
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.termStore.group",
+ "isCollection": true
+} -->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "id": "85825593-5593-8582-9355-828593558285",
+ "createdDateTime": "2019-06-21T20:01:37Z",
+ "description": "My term group",
+ "scope" : "global",
+ "displayName": "myGroup"
+ }
+ ]
+}
+```
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Get termGroup entity in termStore",
+ "keywords": "term,termStore",
+ "section": "documentation",
+ "tocPath": "termStore/List termGroups",
+ "suppressions": [
+ ]
+}
+-->
+++
v1.0 Termstore Relation Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/termstore-relation-post.md
+
+ Title: "Create relation"
+description: "Create a new relation object."
+
+localization_priority: Normal
++
+# Create relation
+Namespace: microsoft.graph.termStore
+
+Create a new [relation](../resources/termstore-relation.md) object. These are used to create pinned and reused relations between terms or between a term and set. If you create a pinned/reused term between term and set, then **fromTerm** must be set to *null* in the post body.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account) |TermStore.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST sites/{site-id}/termStore/sets/{set-id}/terms/{term-id}/relations
+```
+
+## 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 [relation](../resources/termstore-relation.md) object.
+
+The following table shows the properties that are required when you create the [relation](../resources/termstore-relation.md) object.
+
+|Property|Type|Description|
+|:|:|:|
+|relationship|microsoft.graph.termStore.relationType|Type of relation to be created. Possible values are: `pin`, `reuse`.|
+|set| [microsoft.graph.termStore.set](../resources/termstore-set.md)| The set where the relationship needs to be created.|
+|fromTerm| [microsoft.graph.termStore.term](../resources/termstore-term.md) | The term with which the relationship needs to be created.|
+++
+## Response
+
+If successful, this method returns a `201 Created` response code and a [microsoft.graph.termStore.relation](../resources/termstore-relation.md) object in the response body.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "create_relation_from_"
+}
+-->
+
+``` http
+POST https://graph.microsoft.com/v1.0/sites/microsoft.sharepoint.com,b9b0bc03-cbc4-40d2-aba9-2c9dd9821ddf,6a742cee-9216-4db5-8046-13a595684e74/termStore/v1.0/27fd2d26-60d3-485c-9420-0c71f74a0cfd/terms/8861b57a-c777-49e7-826f-47d6afecf80d/relations
+Content-Type: application/json
+Content-length: 89
+
+{
+ "@odata.type": "#microsoft.graph.termStore.relation",
+ "relationship": "pin",
+ "fromTerm" : {
+ "id" : "b49f64b3-4722-4336-9a5c-56c326b344d4"
+ },
+ "set" : {
+ "id": "95e553ae-a91a-4670-a139-67a6cea285b3"
+ }
+}
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.termStore.relation"
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.termStore.relation",
+ "id": "052c749c-749c-052c-9c74-2c059c742c05",
+ "relationship": "pin",
+ "fromTerm" : {
+ "id" : "b49f64b3-4722-4336-9a5c-56c326b344d4"
+ },
+ "toTerm" : {
+ "id" : "226e8ee3-f4b6-49d7-92d5-ec9d5475eec5"
+ },
+ "set" : {
+ "id" : "95e553ae-a91a-4670-a139-67a6cea285b3"
+ }
+}
+```
+
+[microsoft.graph.termStore.set]: ../resources/termstore-set.md
+[microsoft.graph.termStore.term]: ../resources/termstore-term.md
+[microsoft.graph.termStore.relation]: ../resources/termstore-relation.md
++
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Create a pinned term entity in termStore",
+ "keywords": "term,termStore",
+ "section": "documentation",
+ "tocPath": "termStore/Pinned term",
+ "suppressions": [
+ ]
+}
+-->
++
v1.0 Termstore Set Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/termstore-set-delete.md
+
+ Title: "Delete set"
+description: "Delete a set object."
+
+localization_priority: Normal
++
+# Delete set
+Namespace: microsoft.graph.termStore
+
+Delete a [set](../resources/termstore-set.md) object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account) |TermStore.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE sites/{site-id}/termStore/sets/{set-id}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "delete_set"
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/v1.0/sites/microsoft.sharepoint.com,b9b0bc03-cbc4-40d2-aba9-2c9dd9821ddf,6a742cee-9216-4db5-8046-13a595684e74/termStore/sets/8861b57a-c777-49e7-826f-47d6afecf80d
+```
+
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
+[microsoft.graph.termStore.group]: ../resources/termstore-group.md
+[microsoft.graph.termStore.set]: ../resources/termstore-set.md
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Delete a termSet entity in termStore",
+ "keywords": "term,termStore",
+ "section": "documentation",
+ "tocPath": "termStore/Delete termSet",
+ "suppressions": [
+ ]
+}
+-->
++
v1.0 Termstore Set Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/termstore-set-get.md
+
+ Title: "Get set"
+description: "Read the properties and relationships of a set object."
+
+localization_priority: Normal
++
+# Get set
+Namespace: microsoft.graph.termStore
+
+Read the properties and relationships of a [set](../resources/termstore-set.md) object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account) |TermStore.Read.All, TermStore.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+GET sites/{site-id}/termStore/sets/{set-id}
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [microsoft.graph.termStore.set](../resources/termstore-set.md) object in the response body.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "get_set_2"
+}-->
+
+``` http
+GET https://graph.microsoft.com/v1.0/sites/microsoft.sharepoint.com,b9b0bc03-cbc4-40d2-aba9-2c9dd9821ddf,6a742cee-9216-4db5-8046-13a595684e74/termStore/sets/8ed8c9ea-7052-4c1d-a4d7-b9c10bffea6f
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.termStore.set"
+} -->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+
+ "createdDateTime": "2019-06-21T20:01:37Z",
+ "description": "Starting term Set",
+ "id": "8ed8c9ea-7052-4c1d-a4d7-b9c10bffea6f",
+ "localizedNames" : [
+ {
+ "languageTag" : "en-US",
+ "name" : "Department"
+ }
+ ]
+}
+```
+
+[microsoft.graph.termStore.group]: ../resources/termstore-group.md
+[microsoft.graph.termStore.set]: ../resources/termstore-set.md
+[microsoft.graph.termStore.store]: ../resources/termstore-store.md
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Get termSet entity in termStore",
+ "keywords": "term,termStore",
+ "section": "documentation",
+ "tocPath": "termStore/Get termSet",
+ "suppressions": [
+ ]
+}
+-->
++
v1.0 Termstore Set Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/termstore-set-post.md
+
+ Title: "Create set"
+description: "Create a new set object."
+
+localization_priority: Normal
++
+# Create set
+Namespace: microsoft.graph.termStore
+
+Create a new [set](../resources/termstore-set.md) object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account) |TermStore.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST sites/{site-id}/termStore/sets
+```
+
+## 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 [set](../resources/termstore-set.md) object.
+
+The following table shows the properties that are required when you create the [set](../resources/termstore-set.md) object.
+
+|Property|Type|Description|
+|:|:|:|
+|localizedNames|[microsoft.graph.termstore.localizedName](../resources/termstore-localizedname.md) collection|Name of the set to be created.|
+|parentGroup|[microsoft.graph.termstore.group](../resources/termstore-group.md)|termstore-group under which the set needs to be created.|
+++
+## Response
+
+If successful, this method returns a `201 Created` response code and a [microsoft.graph.termStore.set](../resources/termstore-set.md) object in the response body.
+
+## Examples
+
+### Request
+``` http
+POST https://graph.microsoft.com/v1.0/sites/microsoft.sharepoint.com,b9b0bc03-cbc4-40d2-aba9-2c9dd9821ddf,6a742cee-9216-4db5-8046-13a595684e74/termStore/sets
+Content-Type: application/json
+Content-length: 288
+
+{
+ "@odata.type": "#microsoft.graph.termStore.set",
+ "parentGroup":{
+ "id": "fc733b51-10f1-40fd-b784-dc6d1e42804b"
+ },
+ "localizedNames" : [
+ {
+ "languageTag" : "en-US",
+ "name" : "Department"
+ }
+ ]
+}
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.termstore.set"
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+{
+ "@odata.type": "#microsoft.graph.termStore.set",
+ "id": "3607e9f9-e9f9-3607-f9e9-0736f9e90736",
+ "localizedNames" : [
+ {
+ "languageTag" : "en-US",
+ "name" : "Department"
+ }
+ ]
+}
+```
++
+[microsoft.graph.termStore.set]: ../resources/termstore-set.md
+[microsoft.graph.termStore.group]: ../resources/termstore-group.md
+[microsoft.graph.termStore.term]: ../resources/termstore-term.md
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Create a termSet entity in termStore",
+ "keywords": "term,termStore",
+ "section": "documentation",
+ "tocPath": "termStore/Create termSet",
+ "suppressions": [
+ ]
+}
+-->
++
v1.0 Termstore Set Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/termstore-set-update.md
+
+ Title: "Update set"
+description: "Update the properties of a set object."
+
+localization_priority: Normal
++
+# Update set
+Namespace: microsoft.graph.termStore
+
+Update the properties of a [set](../resources/termstore-set.md) object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account) |TermStore.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+PATCH sites/{site-id}/termStore/sets/{set-id}
+```
+
+## 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 [set](../resources/termstore-set.md) object.
+
+The following table shows the properties that can be edited for the [set](../resources/termstore-set.md) object.
+
+|Property|Type|Description|
+|:|:|:|
+|localizedNames|[microsoft.graph.termStore.localizedName](../resources/termstore-localizedname.md) collection|Name of the set.|
+|description|String|Description of the set.|
+|properties|[microsoft.graph.keyValue](../resources/keyvalue.md) collection|Properties of a set.|
+++
+## Response
+
+If successful, this method returns a `200 OK` response code and an updated [microsoft.graph.termStore.set](../resources/termstore-set.md) object in the response body.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "update_set"
+} -->
+
+``` http
+PATCH https://graph.microsoft.com/v1.0/sites/microsoft.sharepoint.com,b9b0bc03-cbc4-40d2-aba9-2c9dd9821ddf,6a742cee-9216-4db5-8046-13a595684e74/termStore/sets/3607e9f9-e9f9-3607-f9e9-0736f9e90736
+Content-Type: application/json
+Content-length: 288
+
+{
+ "description": "mySet"
+}
+```
+
+### Response
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.termStore.set"
+}-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "id": "3607e9f9-e9f9-3607-f9e9-0736f9e90736",
+ "description": "mySet",
+ "localizedNames" : [
+ {
+ "languageTag" : "en-US",
+ "name" : "Department"
+ }
+ ]
+}
+```
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Get termSet entity in termStore",
+ "keywords": "term,termStore",
+ "section": "documentation",
+ "tocPath": "termStore/Update termSet",
+ "suppressions": [
+ ]
+}
+-->
++
v1.0 Termstore Store Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/termstore-store-get.md
+
+ Title: "Get store"
+description: "Read the properties and relationships of a store object."
+
+localization_priority: Normal
++
+# Get store
+Namespace: microsoft.graph.termStore
+
+Read the properties and relationships of a [store](../resources/termstore-store.md) object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account) | TermStore.Read.All, TermStore.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+GET sites/{site-id}/termStore
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [microsoft.graph.termStore.store](../resources/termstore-store.md) object in the response body.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "get_store"
+}-->
+
+``` http
+GET https://graph.microsoft.com/v1.0/sites/microsoft.sharepoint.com,b9b0bc03-cbc4-40d2-aba9-2c9dd9821ddf,6a742cee-9216-4db5-8046-13a595684e74/termStore
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.termStore.store"
+} -->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "id": "dad13b4b-3b4b-dad1-4b3b-d1da4b3bd1da",
+ "defaultLanguageTag" : "en-US",
+ "languageTags" : ["en-US", "de-DE", "fr-FR"]
+}
+```
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Get termStore entity in termStore",
+ "keywords": "term,termStore",
+ "section": "documentation",
+ "tocPath": "termStore/Get termStore",
+ "suppressions": []
+}
+-->
++
v1.0 Termstore Store Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/termstore-store-update.md
+
+ Title: "Update store"
+description: "Update the properties of a store object."
+
+localization_priority: Normal
++
+# Update store
+Namespace: microsoft.graph.termStore
+
+Update the properties of a [store](../resources/termstore-store.md) object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account) |TermStore.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}-->
+
+``` http
+PATCH sites/{site-id}/termStore
+```
+
+## 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 [store](../resources/termstore-store.md) object.
+
+The following table shows the properties that can be edited for the [store](../resources/termstore-store.md) object.
+
+|Property|Type|Description|
+|:|:|:|
+|defaultLanguageTag|String|Default language of the [microsoft.graph.termstore.store](../resources/termstore-store.md).|
+|languageTags|String collection|Available languages in the [microsoft.graph.termstore.store](../resources/termstore-store.md).|
+++
+## Response
+
+If successful, this method returns a `200 OK` response code and an updated [microsoft.graph.termStorestore](../resources/termstore-store.md) object in the response body.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "update_store"
+} -->
+
+``` http
+PATCH https://graph.microsoft.com/v1.0/sites/microsoft.sharepoint.com,b9b0bc03-cbc4-40d2-aba9-2c9dd9821ddf,6a742cee-9216-4db5-8046-13a595684e74/termStore
+Content-Type: application/json
+Content-length: 133
+
+{
+ "defaultLanguageTag": "en-US"
+}
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.termStore.store"
+} -->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "id": "dad13b4b-3b4b-dad1-4b3b-d1da4b3bd1da",
+ "defaultLanguageTag": "en-US",
+ "languageTags": [
+ "en-US",
+ "fr-FR"
+ ]
+}
+```
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Get term entity in termStore",
+ "keywords": "term,termStore",
+ "section": "documentation",
+ "tocPath": "termStore/Update termstore",
+ "suppressions": [
+ ]
+}
+-->
+++
v1.0 Termstore Term Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/termstore-term-delete.md
+
+ Title: "Delete term"
+description: "Delete a term object."
+
+localization_priority: Normal
++
+# Delete term
+Namespace: microsoft.graph.termStore
+
+Delete a [term](../resources/termstore-term.md) object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account) |TermStore.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE sites/{site-id}/termStore/sets/{set-id}/terms/{term-id}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "delete_term"
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/v1.0/sites/microsoft.sharepoint.com,b9b0bc03-cbc4-40d2-aba9-2c9dd9821ddf,6a742cee-9216-4db5-8046-13a595684e74/termStore/sets/584b2331-f5c9-4b45-a5ec-d3cb9af67006/terms/a929ae3c-a11f-447f-9835-f09b461cd59a
+```
+
+### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
+[microsoft.graph.termStore.term]: ../resources/termstore-term.md
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Delete a term entity in termStore",
+ "keywords": "term,termStore",
+ "section": "documentation",
+ "tocPath": "termStore/Delete term",
+ "suppressions": [
+ ]
+}
+-->
++
v1.0 Termstore Term Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/termstore-term-get.md
+
+ Title: "Get term"
+description: "Read the properties and relationships of a term object."
+
+localization_priority: Normal
++
+# Get term
+Namespace: microsoft.graph.termStore
+
+Read the properties and relationships of a [term](../resources/termstore-term.md) object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account) | TermStore.Read.All, TermStore.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+} -->
+
+``` http
+GET sites/{site-id}/termStore/groups/{group-id}/sets/{set-id}/terms/{term-id}
+GET sites/{site-id}/termStore/sets/{set-id}/terms/{term-id}
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [microsoft.graph.termStore.term](../resources/termstore-term.md) object in the response body.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "get_term_1"
+} -->
+
+``` http
+GET https://graph.microsoft.com/v1.0/sites/microsoft.sharepoint.com,b9b0bc03-cbc4-40d2-aba9-2c9dd9821ddf,6a742cee-9216-4db5-8046-13a595684e74/termStore/groups/8401c566-a86e-4734-a4db-eeb434cd99f9/sets/dcaae29d-2234-4619-bccf-c2ec50b52344/terms/81be9856-9856-81be-5698-be815698be81
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.termStore.term"
+} -->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "id": "81be9856-9856-81be-5698-be815698be81",
+ "createdDateTime": "2019-06-21T20:01:37Z",
+ "labels" : [
+ {
+ "name" : "Copy of myTerm",
+ "languageTag" : "en-US",
+ "isDefault" : true
+ }
+ ],
+ "lastModifiedDateTime": "2019-06-21T20:01:37Z"
+}
+```
+
+[microsoft.graph.termStore.term]: ../resources/termstore-term.md
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Get term entity in termStore",
+ "keywords": "term,termStore",
+ "section": "documentation",
+ "tocPath": "termStore/Get term",
+ "suppressions": [
+ ]
+}
+-->
+++
v1.0 Termstore Term List Children https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/termstore-term-list-children.md
+
+ Title: "List children"
+description: "Get the terms from the children navigation property."
+
+localization_priority: Normal
++
+# List children
+Namespace: microsoft.graph.termStore
+
+Get the first level children of a [set] or [term] resource using the children navigation property.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account) | TermStore.Read.All, TermStore.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET sites/{site-id}/termStore/sets/{set-id}/children
+GET sites/{site-id}/termStore/sets/{set-id}/terms/{term-id}/children
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [microsoft.graph.termStore.term](../resources/termstore-term.md) objects in the response body.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "get_term_2"
+}-->
+
+``` http
+GET https://graph.microsoft.com/v1.0/sites/microsoft.sharepoint.com,b9b0bc03-cbc4-40d2-aba9-2c9dd9821ddf,6a742cee-9216-4db5-8046-13a595684e74/termStore/sets/17de5527-72f2-47ce-854e-99c0c5af5c17/children
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.termStore.term",
+ "isCollection": true
+}-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "id": "81be9856-9856-81be-5698-be815698be81",
+ "labels" : [
+ {
+ "name" : "Car",
+ "languageTag" : "en-US",
+ "isDefault" : true
+ }
+ ],
+ "lastModifiedDateTime": "2019-06-21T20:01:37Z"
+ }
+ ]
+}
+```
+
+[term]: ../resources/termstore-term.md
+[set]: ../resources/termstore-set.md
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Get children of a term or termSet in termStore",
+ "keywords": "term,termStore",
+ "section": "documentation",
+ "tocPath": "termStore/Get termchildren",
+ "suppressions": []
+}
+-->
++
v1.0 Termstore Term List Relations https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/termstore-term-list-relations.md
+
+ Title: "List relations"
+description: "Get the relations from the relations navigation property."
+
+localization_priority: Normal
++
+# List relations
+Namespace: microsoft.graph.termStore
+
+Get the different relation of a [term] or [set] from the relations navigation property.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account) |TermStore.Read.All, TermStore.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET sites/{site-id}/termStore/sets/{set-id}/relations
+GET sites/{site-id}/termStore/sets/{set-id}/terms/{term-id}/relations
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [microsoft.graph.termStore.relation](../resources/termstore-relation.md) objects in the response body.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "get_relation"
+}-->
+
+``` http
+GET https://graph.microsoft.com/v1.0/sites/microsoft.sharepoint.com,b9b0bc03-cbc4-40d2-aba9-2c9dd9821ddf,6a742cee-9216-4db5-8046-13a595684e74/termStore/sets/874be29c-35c8-4295-b3f8-ca2400c966c3/relations
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.termStore.relation",
+ "isCollection": true
+}-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "id": "052c749c-749c-052c-9c74-2c059c742c05",
+ "relationship": "pin"
+ }
+ ]
+}
+```
++
+[set]: ../resources/termstore-set.md
+[term]: ../resources/termstore-term.md
+[microsoft.graph.termStore.relation]: ../resources/termstore-relation.md
++
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Create a pinned term entity in termStore",
+ "keywords": "term,termStore",
+ "section": "documentation",
+ "tocPath": "termStore/term list relations",
+ "suppressions": [
+ ]
+}
+-->
++
v1.0 Termstore Term Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/termstore-term-post.md
+
+ Title: "Create term"
+description: "Create a new term object."
+
+localization_priority: Normal
++
+# Create term
+Namespace: microsoft.graph.termStore
+
+Create a new [term](../resources/termstore-term.md) object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account) | TermStore.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+} -->
+
+``` http
+POST sites/{site-id}/termStore/sets/{set-id}/children
+POST sites/{site-id}/termStore/sets/{set-id}/terms/{term-id}/children
+```
+
+## 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 [term](../resources/termstore-term.md) object.
+
+The following table shows the properties that are required when you create the [term](../resources/termstore-term.md) object.
+
+|Property|Type|Description|
+|:|:|:|
+|labels|[microsoft.graph.termStore.localizedLabel](../resources/termstore-localizedlabel.md) collection|Label for the term to be created.|
+++
+## Response
+
+If successful, this method returns a `201 Created` response code and a [microsoft.graph.termStore.term](../resources/termstore-term.md) object in the response body.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "create_term_from_"
+} -->
+
+``` http
+POST https://graph.microsoft.com/v1.0/sites/microsoft.sharepoint.com,b9b0bc03-cbc4-40d2-aba9-2c9dd9821ddf,6a742cee-9216-4db5-8046-13a595684e74/termStore/sets/462bd0ae-30bb-4c58-845c-761ff6481ac1/terms
+Content-Type: application/json
+Content-length: 366
+
+{
+ "labels": [
+ {
+ "languageTag" : "en-US",
+ "name" : "Car",
+ "isDefault" : true
+ }
+ ]
+}
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.termStore.term"
+}-->
+
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "createdDateTime": "2019-06-21T20:01:37Z",
+ "id": "8ed8c9ea-7052-4c1d-a4d7-b9c10bffea6f",
+ "labels" : [
+ {
+ "name" : "Car",
+ "languageTag" : "en-US",
+ "isDefault" : true
+ }
+ ],
+ "lastModifiedDateTime": "2019-06-21T20:01:37Z"
+}
+```
+
+[microsoft.graph.termStore.set]: ../resources/termstore-set.md
+[microsoft.graph.termStore.term]: ../resources/termstore-term.md
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Post term entity in termStore",
+ "keywords": "term,termStore",
+ "section": "documentation",
+ "tocPath": "termStore/Post term",
+ "suppressions": [
+ ]
+}
+-->
++
v1.0 Termstore Term Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/termstore-term-update.md
+
+ Title: "Update term"
+description: "Update the properties of a term object."
+
+localization_priority: Normal
++
+# Update term
+Namespace: microsoft.graph.termStore
+
+Update the properties of a [term](../resources/termstore-term.md) object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account) | TermStore.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}-->
+
+``` http
+PATCH sites/{site-id}/termStore/sets/{set-id}/terms/{term-id}
+```
+
+## 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 [term](../resources/termstore-term.md) object.
+
+The following table shows the properties that can be updated for a [term](../resources/termstore-term.md) object.
+
+|Property|Type|Description|
+|:|:|:|
+|labels|[microsoft.graph.termStore.localizedLabel](../resources/termstore-localizedlabel.md) collection|Labels of a term.|
+|descriptions|[microsoft.graph.termStore.localizedDescription](../resources/termstore-localizeddescription.md) collection|Description about the term.|
+|properties|[microsoft.graph.keyValue](../resources/keyvalue.md) collection|Properties associated with the term.|
+++
+## Response
+
+If successful, this method returns a `200 OK` response code and an updated [microsoft.graph.termStore.term](../resources/termstore-term.md) object in the response body.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "update_term"
+} -->
+
+``` http
+PATCH https://graph.microsoft.com/v1.0/sites/microsoft.sharepoint.com,b9b0bc03-cbc4-40d2-aba9-2c9dd9821ddf,6a742cee-9216-4db5-8046-13a595684e74/termStore/sets/6362a3a4-c24c-4ce7-b491-e32c8a087071/terms/81be9856-9856-81be-5698-be815698be81
+Content-Type: application/json
+Content-length: 366
+
+{
+ "labels" : [
+ {
+ "name" : "changedLabel",
+ "languageTag" : "en-US",
+ "isDefault" : true
+ }
+ ]
+}
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.termStore.term"
+}-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "id": "81be9856-9856-81be-5698-be815698be81",
+ "labels" : [
+ {
+ "name" : "changedLabel",
+ "languageTag" : "en-US",
+ "isDefault" : true
+ }
+ ]
+}
+```
+
+[microsoft.graph.termStore.term]: ../resources/termstore-term.md
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Get term entity in termStore",
+ "keywords": "term,termStore",
+ "section": "documentation",
+ "tocPath": "termStore/Update term",
+ "suppressions": [
+ ]
+}
+-->
++
v1.0 Conversation https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/conversation.md
This resource supports subscribing to [change notifications](/graph/webhooks).
## Properties | Property | Type |Description| |:|:--|:-|
-|hasAttachments|Boolean|Indicates whether any of the posts within this Conversation has at least one attachment.|
+|hasAttachments|Boolean|Indicates whether any of the posts within this Conversation has at least one attachment. Supports `$filter` (`eq`, `ne`) and `$search`.|
|id|String|The conversations's unique identifier. Read-only.| |lastDeliveredDateTime|DateTimeOffset|The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`|
-|preview|String|A short summary from the body of the latest post in this converstaion.|
+|preview|String|A short summary from the body of the latest post in this conversation. Supports `$filter` (`eq`, `ne`, `le`, `ge`).|
|topic|String|The topic of the conversation. This property can be set when the conversation is created, but it cannot be updated.| |uniqueSenders|String collection|All the users that sent a message to this Conversation.|
v1.0 Conversationthread https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/conversationthread.md
A new thread is created when a recipient is removed from the thread.
| Property | Type | Description | |:-|:-|:-| | id | String | Read-only. <br/><br/>Returned by default. |
-| toRecipients | [recipient](recipient.md) collection | The To: recipients for the thread. <br/><br/>Returned only on $select. |
-| ccRecipients | [recipient](recipient.md) collection | The Cc: recipients for the thread. <br/><br/>Returned only on $select. |
+| toRecipients | [recipient](recipient.md) collection | The To: recipients for the thread. <br/><br/>Returned only on `$select`. |
+| ccRecipients | [recipient](recipient.md) collection | The Cc: recipients for the thread. <br/><br/>Returned only on `$select`. |
| topic | String | The topic of the conversation. This property can be set when the conversation is created, but it cannot be updated. <br/><br/>Returned by default. | | hasAttachments | Boolean | Indicates whether any of the posts within this thread has at least one attachment. <br/><br/>Returned by default. | | lastDeliveredDateTime | DateTimeOffset | The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.<br/><br/>Returned by default. |
v1.0 Enums Termstore https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/enums-termstore.md
+
+ Title: "termStore enumeration values"
+description: "Microsoft Graph termStore enumeration values."
+localization_priority: Normal
+++
+# termStore enumeration values
+
+Namespace: microsoft.graph.termStore
+
+### relationType values
+
+Specifies the value types relations can take in a termStore.
+
+|Member|
+|:|
+|pin|
+|reuse|
+
+### termGroupScope values
+
+Specifies the values different group types can take within the termStore.
+
+|Member|
+|:|
+|global|
+|system|
+|siteCollection|
+
+<!--
+{
+ "type": "#page.annotation",
+ "namespace": "microsoft.graph.termStore"
+}
+-->
++
v1.0 Excel https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/excel.md
The Excel REST API supports only Office Open XML file formatted workbooks. The `
## Authorization and scopes
-You can use the [Azure AD v.2 endpoint](../index.md) to authenticate Excel APIs. All APIs require the `Authorization: Bearer {access-token}` HTTP header.  
+You can use the [Azure AD v.2 endpoint](/graph/auth-register-app-v2) to authenticate Excel APIs. All APIs require the `Authorization: Bearer {access-token}` HTTP header.  
One of the following [permission scopes](/graph/permissions-reference) is required to use the Excel resource:
v1.0 Passwordcredential https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/passwordcredential.md
Namespace: microsoft.graph
Represents a password credential associated with an application or a service principal. The **passwordCredentials** property of the [application](application.md) <!--and [servicePrincipal](serviceprincipal.md) entitites--> entity is a collection of **passwordCredential** objects. > [!IMPORTANT]
-> Using POST or PATCH to set **passwordCredential** is not supported. Use the addPassword and removePassword methods to update the password for an application or a servicePrincipal:
+> Using POST or PATCH to set the **passwordCredential** property is not supported. Use the following addPassword and removePassword methods to update the password for an application or a servicePrincipal:
> > - [application: addPassword](../api/application-addpassword.md) > - [application: removePassword](../api/application-removepassword.md)
v1.0 Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/post.md
This resource lets you add your own data to custom properties using [extensions]
## Relationships | Relationship | Type |Description| |:|:--|:-|
-|attachments|[Attachment](attachment.md) collection| Read-only. Nullable.|
-|extensions|[Extension](extension.md) collection|The collection of open extensions defined for the post. Read-only. Nullable.|
-|inReplyTo|[post](post.md)| Read-only.|
+|attachments|[Attachment](attachment.md) collection| Read-only. Nullable. Supports `$expand`.|
+|extensions|[Extension](extension.md) collection|The collection of open extensions defined for the post. Read-only. Nullable. Supports `$expand`.|
+|inReplyTo|[post](post.md)| Read-only. Supports `$expand`.|
|multiValueExtendedProperties|[multiValueLegacyExtendedProperty](multivaluelegacyextendedproperty.md) collection| The collection of multi-value extended properties defined for the post. Read-only. Nullable.| |singleValueExtendedProperties|[singleValueLegacyExtendedProperty](singlevaluelegacyextendedproperty.md) collection| The collection of single-value extended properties defined for the post. Read-only. Nullable.|
v1.0 Responsestatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/responsestatus.md
Title: "responseStatus resource type"
description: "The response status of a meeting request." localization_priority: Normal doc_type: resourcePageType
doc_type: resourcePageType
Namespace: microsoft.graph
-The response status of a meeting request.
+The response status of an attendee or organizer for a meeting request.
+
+You can get the response status of an attendee or organizer through the **responseStatus** property of an [event](event.md) or the **status** property of an [attendee](attendee.md).
## Properties | Property | Type | Description | |:|:|:|
-| response | responseType | The response type. The possible values are: `None`, `Organizer`, `TentativelyAccepted`, `Accepted`, `Declined`, `NotResponded`.
+| response | responseType | The response type. Possible values are: `none`, `organizer`, `tentativelyAccepted`, `accepted`, `declined`, `notResponded`.<br><br>To differentiate between `none` and `notResponded`: as an example, if attendee Alex hasn't responded to a meeting request, getting Alex' response status for that event in Alex' calendar returns `notResponded`. Getting Alex' response from the calendar of any other attendee or the organizer's returns `none`. Getting the organizer's response for the event in anybody's calendar also returns `none`.
| time | DateTimeOffset | The date and time that the response was returned. It uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z` ## JSON representation
v1.0 Serviceprincipal https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/serviceprincipal.md
This resource supports using [delta query](/graph/delta-query-overview) to track
|notes|String|Free text field to capture information about the service principal, typically used for operational purposes. Maximum allowed size is 1024 characters.| |notificationEmailAddresses|String collection|Specifies the list of email addresses where Azure AD sends a notification when the active certificate is near the expiration date. This is only for the certificates used to sign the SAML token issued for Azure AD Gallery applications.| |oauth2PermissionScopes|[permissionScope](permissionScope.md) collection|The delegated permissions exposed by the application. For more information see the **oauth2PermissionScopes** property on the [application](application.md) entity's **api** property. Not nullable.|
+| passwordCredentials | [passwordCredential](passwordcredential.md) collection|The collection of password credentials associated with the application. Not nullable.|
|preferredSingleSignOnMode|string|Specifies the single sign-on mode configured for this application. Azure AD uses the preferred single sign-on mode to launch the application from Microsoft 365 or the Azure AD My Apps. The supported values are `password`, `saml`, `notSupported`, and `oidc`.| |replyUrls|String collection|The URLs that user tokens are sent to for sign in with the associated application, or the redirect URIs that OAuth 2.0 authorization codes and access tokens are sent to for the associated application. Not nullable. | |samlSingleSignOnSettings|[samlSingleSignOnSettings](samlsinglesignonsettings.md)|The collection for settings related to saml single sign-on.|
v1.0 Signin https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/signin.md
doc_type: resourcePageType
Namespace: microsoft.graph
-Details user and application sign-in activity for a tenant (directory). You must have an Azure AD Premium P1 or P2 license to download sign-in logs using the Microsoft Graph API.
+Details user and application sign-in activity for a tenant (directory). You must have an Azure AD Premium P1 or P2 license to download sign-in logs using the Microsoft Graph API.
+
+The availability of sign-in logs is governed by the [Azure AD data retention policies](/azure/active-directory/reports-monitoring/reference-reports-data-retention#how-long-does-azure-ad-store-the-data).
## Methods
v1.0 Site https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/site.md
The `root` identifier always references the root site for a given target, as fol
## Relationships
-| Relationship | Type | Description
-|:|:|:-
-| **analytics** | [itemAnalytics][] resource | Analytics about the view activities that took place in this site.
-| **columns** | Collection([columnDefinition][]) | The collection of column definitions reusable across lists under this site.
-| **contentTypes** | Collection([contentType][]) | The collection of content types defined for this site.
-| **drive** | [drive][] | The default drive (document library) for this site.
-| **drives** | Collection([drive][]) | The collection of drives (document libraries) under this site.
-| **items** | Collection([baseItem][]) | Used to address any item contained in this site. This collection cannot be enumerated.
-| **lists** | Collection([list][]) | The collection of lists under this site.
-| **permissions** | Collection([permission][]) | The permissions associated with the site. Nullable.
-| **sites** | Collection([site][]) | The collection of the sub-sites under this site.
-| **onenote** | [onenote][] | Calls the OneNote service for notebook related operations.
+| Relationship | Type | Description
+|:|:-|:-
+| **analytics** | [itemAnalytics][] resource | Analytics about the view activities that took place in this site.
+| **columns** | Collection([columnDefinition][]) | The collection of column definitions reusable across lists under this site.
+| **contentTypes** | Collection([contentType][]) | The collection of content types defined for this site.
+| **drive** | [drive][] | The default drive (document library) for this site.
+| **drives** | Collection([drive][]) | The collection of drives (document libraries) under this site.
+| **items** | Collection([baseItem][]) | Used to address any item contained in this site. This collection can't be enumerated.
+| **lists** | Collection([list][]) | The collection of lists under this site.
+| **onenote** | [onenote][] | Calls the OneNote service for notebook related operations.
+| **permissions** | Collection([permission][]) | The permissions associated with the site. Nullable.
+| **sites** | Collection([site][]) | The collection of the sub-sites under this site.
+| **termStore** | [microsoft.graph.termStore.store] | The default termStore under this site.
+| **termStores** | Collection([microsoft.graph.termStore.store]) | The collection of termStores under this site.
[columnDefinition]: columndefinition.md [baseItem]: baseitem.md
The `root` identifier always references the root site for a given target, as fol
[permission]: permission.md [site]: site.md [onenote]: onenote.md
+[microsoft.graph.termStore.store]: termstore-store.md
## JSON representation
The **site** resource is derived from [**baseItem**](baseitem.md) and inherits p
"sites": [ { "@odata.type": "microsoft.graph.site"} ], "columns": [ { "@odata.type": "microsoft.graph.columnDefinition" }], "onenote": { "@odata.type": "microsoft.graph.onenote"},
+ "termStore": { "@odata.type": "microsoft.graph.termStore.store" },
+ "termStores": [ { "@odata.type": "microsoft.graph.termStore.store" } ],
/* inherited from baseItem */ "name": "string",
v1.0 Termstore Group https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/termstore-group.md
++
+ Title: Group resource type
+description: "Represents a group used in a term store."
+localization_priority: Normal
++
+# Group resource type
+
+Namespace: microsoft.graph.termStore
++
+Represents a group used in a term [store](../resources/termstore-store.md). A group is a logical hierarchy that contains a collection of sets under it.
+
+Inherits from [entity](../resources/entity.md).
++
+## Methods
+
+| Method | Return type | Description |
+|:|:|:
+| [Create group](../api/termstore-group-post.md) | [microsoft.graph.termStore.group] | Create a group in a term [store]. |
+| [Get group](../api/termstore-group-get.md) | [microsoft.graph.termStore.group] | Retrieve the data of a group in a term [store]. |
+| [Delete group](../api/termstore-group-delete.md) | None | Delete a group in a term [store]. |
+
+## Properties
+
+| Property | Type | Description |
+|:|:-|:
+| createdDateTime | DateTimeOffset | Date and time of group creation. Read-only. |
+| description | string | Description giving details on the term usage. |
+| id | string | Unique identifier of group. Read-Only. |
+| displayName | string | Name of group. |
+| scope | string | Returns type of group. Possible values are 'global', 'system' and 'siteCollection'. |
+| parentSiteId | string | Id of the parent site of this group. |
+
+## Relationships
+| Relationship | Type | Description |
+|:-|:-|:--
+| sets | [microsoft.graph.termStore.set][] collection | All sets under the group in a term [store]. |
+
+## JSON representation
+
+The following is a JSON representation of a **group** resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.termStore.group",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+```json
+{
+ "@odata.type": "#microsoft.graph.termStore.group",
+ "id": "string",
+ "createdDateTime": "string (timestamp)",
+ "description": "string",
+ "scope" : "microsoft.graph.termStore.groupScope",
+ "displayName": "string",
+ "parentSiteId" : "string"
+}
+```
+++
+[identitySet]: identitySet.md
+[microsoft.graph.termStore.set]: termstore-set.md
+[microsoft.graph.termStore.group]: termstore-group.md
+[microsoft.graph.termStore.store]: termstore-store.md
+[store]: ../resources/termstore-store.md
+[group]: ../resources/termstore-group.md
+[set]: ../resources/termstore-set.md
+<!--
+{
+ "type": "#page.annotation",
+ "description": "TermGroup is the entity used for managing permissions for the termSets in termStore",
+ "keywords": "termGroup,facet,resource",
+ "section": "documentation",
+ "tocPath": "TermGroup",
+ "tocBookmarks": {
+ "Resources/termStore.group": "#"
+ },
+ "suppressions": []
+}
+-->
++
v1.0 Termstore Localizeddescription https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/termstore-localizeddescription.md
+
+ Title: "localizedDescription resource type"
+description: "Represents the localized description used to describe a term in the term store."
+
+localization_priority: Normal
++
+# localizedDescription resource type
+
+Namespace: microsoft.graph.termStore
+
+Represents the localized description used to describe a [term] in the term [store].
++
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|description|String|The description in the localized language.|
+|languageTag|String|The language tag for the label.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.termStore.localizedDescription"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.termStore.localizedDescription",
+ "description": "String",
+ "languageTag": "String"
+}
+```
+
+[microsoft.graph.termStore.term]: termStore-term.md
+[microsoft.graph.termStore.store]: termStore-store.md
+[term]: ../resources/termstore-term.md
+[store]: ../resources/termstore-store.md
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "TermLocalizedDescriptionFacet is the facet for containing the description of a set",
+ "keywords": "termLocalizedDescriptionFacet,facet,resource",
+ "section": "documentation",
+ "tocPath": "TermLocalizedDescriptionFacet",
+ "tocBookmarks": {
+ "Resources/termStore.termLocalizedDescription": "#"
+ },
+ "suppressions": []
+}
+-->
++
v1.0 Termstore Localizedlabel https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/termstore-localizedlabel.md
+
+ Title: "localizedLabel resource type"
+description: "Represents the label for a term in the term store."
+
+localization_priority: Normal
++
+# localizedLabel resource type
+
+Namespace: microsoft.graph.termStore
+
+Represents the label for a [term] in the term [store].
+
+Identifies the labels associated with a given term.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|isDefault|Boolean|Indicates whether the label is the default label.|
+|languageTag|String|The language tag for the label.|
+|name|String|The name of the label.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.termStore.localizedLabel"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.termStore.localizedLabel",
+ "name": "String",
+ "isDefault": "Boolean",
+ "languageTag": "String"
+}
+```
++
+[microsoft.graph.termStore.term]: termstore-term.md
+[microsoft.graph.termStore.localizedName]: termstore-localizedname.md
+[microsoft.graph.termStore.store]: termstore-store.md
+[term]: ../resources/termstore-term.md
+[store]: ../resources/termstore-store.md
++
+<!--
+{
+ "type": "#page.annotation",
+ "description": "TermLocalizedLabelFacet is the facet for containing the label of a term",
+ "keywords": "termLocalizedLabelFacet,facet,resource",
+ "section": "documentation",
+ "tocPath": "termstorelocalizedlabel",
+ "tocBookmarks": {
+ "Resources/termStore.termstorelocalizedlabel": "#"
+ },
+ "suppressions": []
+}
+-->
++
v1.0 Termstore Localizedname https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/termstore-localizedname.md
+
+ Title: "localizedName resource type"
+description: "Represents the localized name used in the term store, which identifies the name in the localized language."
+
+localization_priority: Normal
++
+# localizedName resource type
+
+Namespace: microsoft.graph.termStore
+
+Represents the localized name used in the term [store], which identifies the name in the localized language. For more information, see [localizedLabel].
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|languageTag|String|The language tag for the label.|
+|name|String|The name in the localized language.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.termStore.localizedName"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.termStore.localizedName",
+ "name": "String",
+ "languageTag": "String"
+}
+```
+
+[microsoft.graph.termStore.localizedLabel]: termstore-localizedlabel.md
+[microsoft.graph.termstore.store]: termstore-store.md
+[store]: ../resources/termstore-store.md
+[localizedLabel]: ../resources/termstore-localizedlabel.md
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "TermLocalizedName is the facet for containing the name of termGroup",
+ "keywords": "termLocalizedLNameFacet,facet,resource",
+ "section": "documentation",
+ "tocPath": "TermLocalizedNameFacet",
+ "tocBookmarks": {
+ "Resources/termStore.termLocalizedName": "#"
+ },
+ "suppressions": []
+}
+-->
++
v1.0 Termstore Relation https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/termstore-relation.md
+
+ Title: "relation resource type"
+description: "Represents the relationship between terms in a term store."
+
+localization_priority: Normal
++
+# relation resource type
+
+Namespace: microsoft.graph.termStore
+
+Represents the relationship between [terms](../resources/termstore-term.md) in a term [store]. Currently, two types of relationships are supported: **pin** and **reuse**.
+
+In a pin relationship, a term can be pinned under a different term in a different term set. In a pinned relationship, new children to the term can only be added in the term set in which the term was created. Any change in the hierarchy under the term is reflected across the sets in which the term was pinned.
+
+The reuse relationship is similar to the pinned relationship except that changes to the reused term can be made from any hierarchy in which the term is reused. Also, a change in hierarchy made to the reused term doesn't get reflected in the other term sets in which the term is reused.
+
+Inherits from [entity](../resources/entity.md).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List relations](../api/termstore-term-list-relations.md)|[microsoft.graph.termStore.relation](../resources/termstore-relation.md) collection|Retrieve a list of **relation** objects.|
+|[Create relation](../api/termstore-relation-post.md)|[microsoft.graph.termStore.relation](../resources/termstore-relation.md)|Create a new **relation** object.|
++
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|The ID of the relation.|
+|relationship|microsoft.graph.termStore.relationType|The type of relation. Possible values are: `pin`, `reuse`.|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|fromTerm|[microsoft.graph.termStore.term](../resources/termstore-term.md)|The from [term] of the relation. The term from which the relationship is defined. A *null* value would indicate the relation is directly with the [set]. |
+|set|[microsoft.graph.termStore.set](../resources/termstore-set.md)|The [set] in which the relation is relevant.|
+|toTerm|[microsoft.graph.termStore.term](../resources/termstore-term.md)|The to [term] of the relation. The term to which the relationship is defined.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.termStore.relation",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.termStore.relation",
+ "id": "String (identifier)",
+ "relationship": "String"
+}
+```
+
+[microsoft.graph.termStore.term]: termstore-term.md
+[microsoft.graph.termStore.set]: termstore-set.md
+[microsoft.graph.termStore.relations]: termstore-relation.md
+[microsoft.graph.termStore.relation]: termstore-relation.md
+[store]: ../resources/termstore-store.md
+[term]: ../resources/termstore-term.md
+[set]: ../resources/termstore-set.md
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "TermRelation is the entity for mapping relations between different terms",
+ "keywords": "termRelation,facet,resource",
+ "section": "documentation",
+ "tocPath": "TermRelation",
+ "tocBookmarks": {
+ "Resources/termStore.relation": "#"
+ },
+ "suppressions": []
+}
+-->
++
v1.0 Termstore Set https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/termstore-set.md
+
+ Title: "set resource type"
+description: "Represents a set in a term store."
+
+localization_priority: Normal
++
+# set resource type
+
+Namespace: microsoft.graph.termStore
+
+Represents the set used in a term [store]. The set represents a unit which contains a collection of hierarchical terms. A [group] can contain multiple sets.
+
+Inherits from [entity](../resources/entity.md).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List sets](../api/termstore-group-list-sets.md)|collection [microsoft.graph.termStore.set] | Returns a list of sets contained within a [group] of a term [store]. |
+|[Create set](../api/termstore-set-post.md)|[microsoft.graph.termStore.set](../resources/termstore-set.md)|Create a new set object in a term [store].|
+|[Create term](../api/termstore-term-post.md)|[microsoft.graph.termStore.term](../resources/termstore-term.md)|Create a new [term] object in a term [store].|
+|[Get set](../api/termstore-set-get.md)|[microsoft.graph.termStore.set](../resources/termstore-set.md)| Get a set object in a term [store].|
+|[Get term](../api/termstore-term-get.md)|[microsoft.graph.termStore.term](../resources/termstore-term.md)| Get a [term] object in a term [store].|
+|[Update set](../api/termstore-set-update.md)|[microsoft.graph.termStore.set](../resources/termstore-set.md)|Update the properties of a set object in a term [store].|
+|[Delete set](../api/termstore-set-delete.md)|None|Deletes a set object in a term [store].|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|createdDateTime|DateTimeOffset|Date and time of set creation. Read-only.|
+|description|String|Description that gives details on the term usage.|
+|id|String|Unique identifier. Read-only.|
+|localizedNames|[microsoft.graph.termStore.localizedName](../resources/termstore-localizedname.md) collection|Name of the set for each languageTag.|
+|properties|[microsoft.graph.keyValue](../resources/keyvalue.md) collection|Custom properties for the set.|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|children|[microsoft.graph.termStore.term](../resources/termstore-term.md) collection|Children terms of set in term [store].|
+|parentGroup|[microsoft.graph.termStore.group](../resources/termstore-group.md)|The parent [group] that contains the set.|
+|relations|[microsoft.graph.termStore.relation](../resources/termstore-relation.md) collection|Indicates which terms have been pinned or reused directly under the set.|
+|terms|[microsoft.graph.termStore.term](../resources/termstore-term.md) collection|All the terms under the set.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.termStore.set",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.termStore.set",
+ "id": "String (identifier)",
+ "localizedNames": [
+ {
+ "@odata.type": "microsoft.graph.termStore.localizedName"
+ }
+ ],
+ "description": "String",
+ "createdDateTime": "String (timestamp)",
+ "properties": [
+ {
+ "@odata.type": "microsoft.graph.termStore.keyValue"
+ }
+ ]
+}
+```
+
+[microsoft.graph.termStore.term]: termstore-term.md
+[microsoft.graph.termStore.set]: termstore-set.md
+[microsoft.graph.termStore.group]: termstore-group.md
+[microsoft.graph.termStore.relation]: termstore-relation.md
+[microsoft.graph.termStore.store]: termstore-store.md
+[microsoft.graph.termStore.localizedName]: termstore-localizedname.md
+[store]: ../resources/termstore-store.md
+[group]: ../resources/termstore-group.md
+[set]: ../resources/termstore-set.md
+[term]: ../resources/termstore-term.md
++
+<!--
+{
+ "type": "#page.annotation",
+ "description": "TermSet is the entity containing the particular taxonomy for a tenant",
+ "keywords": "termSet,facet,resource",
+ "section": "documentation",
+ "tocPath": "TermSet",
+ "tocBookmarks": {
+ "Resources/termStore.set": "#"
+ },
+ "suppressions": []
+}
+-->
++
v1.0 Termstore Store https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/termstore-store.md
+
+ Title: "store resource type"
+description: "Represents a taxonomy term store."
+
+localization_priority: Normal
++
+# store resource type
+
+Namespace: microsoft.graph.termStore
+
+Represents a taxonomy term store.
+
+Inherits from [entity](../resources/entity.md).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List groups](../api/termstore-list-groups.md)|[microsoft.graph.termStore.group](../resources/termstore-group.md) collection| Get the groups available in the term store object.|
+|[Get store](../api/termstore-store-get.md) | [microsoft.graph.termStore.store](../resources/termstore-store.md) | Read the properties and relationships of a term store object.|
+|[Update store](../api/termstore-store-update.md) | [microsoft.graph.termStore.store](../resources/termstore-store.md) | Update the properties of a term store object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|defaultLanguageTag | String | Default language of the term store.|
+|id|String | Unique identifier of the term store. Read-only.|
+|languageTags | String collection | List of languages for the term store.|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|groups |[microsoft.graph.termStore.group](../resources/termstore-group.md) collection | Collection of all groups available in the term store.|
+|sets | [microsoft.graph.termStore.set](../resources/termstore-set.md) collection | Collection of all sets available in the term store.|
++
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.termStore.store",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.termStore.store",
+ "id": "String (identifier)",
+ "defaultLanguageTag": "String",
+ "languageTags": [
+ "String"
+ ]
+}
+```
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "TermStore is the top-level entity used for managing taxonomy for a client",
+ "keywords": "termStore,facet,resource",
+ "section": "documentation",
+ "tocPath": "TermStore",
+ "tocBookmarks": {
+ "Resources/termStore.store": "#"
+ },
+ "suppressions": []
+}
+-->
+++
v1.0 Termstore Term https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/termstore-term.md
+
+ Title: "term resource type"
+description: "Defines a term entity in a term store."
+
+localization_priority: Normal
++
+# term resource type
+
+Namespace: microsoft.graph.termStore
+
+Represents a term used in a term [store]. A term can be used to represent an object which can then be used as a metadata to tag content. Multiple terms can be organized in a hierarchical manner within a [set].
+
+Inherits from [entity](../resources/entity.md).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List children](../api/termstore-term-list-children.md)|[microsoft.graph.termStore.term](../resources/termstore-term.md) collection|Get the first level children of a term in a term [store].|
+|[List relations](../api/termstore-term-list-relations.md)|[microsoft.graph.termStore.relation](../resources/termstore-relation.md) collection|Get the relations of a term in a term [store].|
+|[Create relation](../api/termstore-relation-post.md)|[microsoft.graph.termStore.relation](../resources/termstore-relation.md)|Create a new relation for a term or a [set] in a term [store].|
+|[Create term](../api/termstore-term-post.md)|[microsoft.graph.termStore.term](../resources/termstore-term.md)|Create a new term object in a term [store].|
+|[Get term](../api/termstore-term-get.md)|[microsoft.graph.termStore.term](../resources/termstore-term.md)|Read the properties and relationships of a term object in a term [store].|
+|[Update term](../api/termstore-term-update.md)|[microsoft.graph.termStore.term](../resources/termstore-term.md)|Update the properties of a term object in a term [store].|
+|[Delete term](../api/termstore-term-delete.md)|None|Delete a term object in a term [store].|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|createdDateTime|DateTimeOffset|Date and time of term creation. Read-only.|
+|descriptions|[microsoft.graph.termStore.localizedDescription](../resources/termstore-localizeddescription.md) collection|Description about term that is dependent on the languageTag.|
+|id|String|Unique identifier of term. Read-Only.|
+|labels|[microsoft.graph.termStore.localizedLabel](../resources/termstore-localizedlabel.md) collection|Label metadata for a term.|
+|lastModifiedDateTime|DateTimeOffset|Last date and time of term modification. Read-only.|
+|properties|[microsoft.graph.keyValue](../resources/keyvalue.md) collection|Collection of properties on the term.|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|children|[microsoft.graph.termStore.term](../resources/termstore-term.md) collection|Children of current term.|
+|relations|[microsoft.graph.termStore.relation](../resources/termstore-relation.md) collection|To indicate which terms are related to the current term as either pinned or reused.|
+|set|[microsoft.graph.termStore.set](../resources/termstore-set.md)|The [set] in which the term is created.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.termStore.term",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.termStore.term",
+ "id": "String (identifier)",
+ "labels": [
+ {
+ "@odata.type": "microsoft.graph.termStore.localizedLabel"
+ }
+ ],
+ "createdDateTime": "String (timestamp)",
+ "lastModifiedDateTime": "String (timestamp)",
+ "descriptions": [
+ {
+ "@odata.type": "microsoft.graph.termStore.localizedDescription"
+ }
+ ],
+ "properties": [
+ {
+ "@odata.type": "microsoft.graph.keyValue"
+ }
+ ]
+}
+```
+
+[store]: ../resources/termstore-store.md
+[set]: ../resources/termstore-set.md
+[term]: ../resources/termstore-term.md
+[group]: ../resources/termstore-group.md
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Term is the entity used for tagging in termStore",
+ "keywords": "term,facet,resource",
+ "section": "documentation",
+ "tocPath": "Terms",
+ "tocBookmarks": {
+ "Resources/termstore-term": "#"
+ },
+ "suppressions": []
+}
+-->
++
v1.0 User https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/user.md
This resource supports:
|consentProvidedForMinor|[consentProvidedForMinor](#consentprovidedforminor-values)|Sets whether consent has been obtained for minors. Allowed values: `null`, `granted`, `denied` and `notRequired`. Refer to the [legal age group property definitions](#legal-age-group-property-definitions) for further information. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `NOT`, and `in`).| |country|String|The country/region in which the user is located; for example, `US` or `UK`. Maximum length is 128 characters. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `NOT`, `ge`, `le`, `in`, `startsWith`).| |createdDateTime | DateTimeOffset |The created date of the user object. Read-only. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `NOT` , `ge`, `le`, and `in` operators).|
-|creationType|String|Indicates whether the user account was created as a regular school or work account (`null`), an external account (`Invitation`), a local account for an Azure Active Directory B2C tenant (`LocalAccount`) or self-service sign-up using email verification (`EmailVerified`). Read-only. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `NOT`, and `in`).|
+| creationType | String | Indicates whether the user account was created through one of the following methods: <br/> <ul><li>As a regular school or work account (`null`). <li>As an external account (`Invitation`). <li>As a local account for an Azure Active Directory B2C tenant (`LocalAccount`). <li>Through self-service sign-up by an internal user using email verification (`EmailVerified`). <li>Through self-service sign-up by an external user signing up through a link that is part of a user flow (`SelfServiceSignUp`).</ul> <br>Read-only.<br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `NOT`, and `in`). |
|deletedDateTime| DateTimeOffset | The date and time the user was deleted. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `NOT`, `ge`, `le`, and `in`). | |department|String|The name for the department in which the user works. Maximum length is 64 characters. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `NOT` , `ge`, `le`, and `in` operators).| |displayName|String|The name displayed in the address book for the user. This is usually the combination of the user's first name, middle initial and last name. This property is required when a user is created and it cannot be cleared during updates. Maximum length is 256 characters. <br><br>Returned by default. Supports `$filter` (`eq`, `ne`, `NOT` , `ge`, `le`, `in`, `startsWith`), `$orderBy`, and `$search`.|
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/toc.yml a/api-reference/v1.0/toc.yml
items:
href: api/listitem-list.md - name: Create list href: api/list-create.md
- - name: ListItems
+ - name: List items
href: resources/listitem.md items: - name: Get item
items:
href: api/listitem-list-versions.md - name: Get item analytics href: api/itemanalytics-get.md
+ - name: Taxonomy
+ displayname: Taxonomy API
+ items:
+ - name: Store
+ href: resources/termstore-store.md
+ items:
+ - name: Get
+ href: api/termstore-store-get.md
+ - name: Update
+ href: api/termstore-store-update.md
+ - name: Group
+ href: resources/termstore-group.md
+ items:
+ - name: List
+ href: api/termstore-list-groups.md
+ - name: Create
+ href: api/termstore-group-post.md
+ - name: Get
+ href: api/termstore-group-get.md
+ - name: Delete
+ href: api/termstore-group-delete.md
+ - name: Set
+ href: resources/termstore-set.md
+ items:
+ - name: List
+ href: api/termstore-group-list-sets.md
+ - name: List children
+ href: api/termstore-term-list-children.md
+ - name: Create
+ href: api/termstore-set-post.md
+ - name: Get
+ href: api/termstore-set-get.md
+ - name: Update
+ href: api/termstore-set-update.md
+ - name: Delete
+ href: api/termstore-set-delete.md
+ - name: Term
+ href: resources/termstore-term.md
+ items:
+ - name: List children
+ href: api/termstore-term-list-children.md
+ - name: Create
+ href: api/termstore-term-post.md
+ - name: Get
+ href: api/termstore-term-get.md
+ - name: Update
+ href: api/termstore-term-update.md
+ - name: Delete
+ href: api/termstore-term-delete.md
+ - name: Relation
+ href: resources/termstore-relation.md
+ items:
+ - name: List
+ href: api/termStore-term-list-relations.md
+ - name: Create
+ href: api/termStore-relation-post.md
- name: Tasks and plans displayName: Planner items: