Updates from: 07/16/2021 03:12:25
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Educationassignment Post Resources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationassignment-post-resources.md
In the request body, supply a JSON representation of the [educationAssignmentRes
If successful, this method returns a `201 Created` response code and an [educationAssignmentResource](../resources/educationassignmentresource.md) object in the response body. ## Example
-##### Request
+### Request
The following is an example of the request. <!-- { "blockType": "ignored",
Content-length: 212
"@odata.type": "#microsoft.education.assignments.api.educationLinkResource" } }- ``` In the request body, supply a JSON representation of the [educationAssignmentResource](../resources/educationassignmentresource.md) object.
-##### Response
+### Response
The following is an example of the response. >**Note:** The response object shown here might be shortened for readability.
Content-length: 229
"@odata.type": "#microsoft.education.assignments.api.educationLinkResource" } }- ``` <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC -->
v1.0 Termstore Group Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/termstore-group-get.md
+
+ Title: "Get termStore group"
+description: "Read the properties and relationships of a group object."
+
+localization_priority: Normal
++
+# Get termStore 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 /termStore/groups/{group-id}
+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
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_group_3"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/beta/termStore/groups/1FFD3F87-9464-488A-A0EC-8FB90911182C
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++
+#### 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 termStore group and its parent site ID
+
+#### Request
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_group"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/beta/sites/microsoft.sharepoint.com,c6482504-4a85-4b21-858a-7e88dafc8232,d90ca07d-25c0-4ce7-864b-d68b607e697f/termStore/groups/1FFD3F87-9464-488A-A0EC-8FB90911182C?$select=*,parentSiteId
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
++++
+#### 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": "microsoft.sharepoint.com,c6482504-4a85-4b21-858a-7e88dafc8232,d90ca07d-25c0-4ce7-864b-d68b607e697f"
+}
+```
+
+### Example 3: Get a site collection termStore group
+#### Request
++
+<!-- {
+ "blockType": "request",
+ "name": "get_group"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/beta/sites/microsoft.sharepoint.com,c6482504-4a85-4b21-858a-7e88dafc8232,d90ca07d-25c0-4ce7-864b-d68b607e697f/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",
+}
+```
+
+[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 Set Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/termstore-set-get.md
Title: "Get set"
description: "Read the properties and relationships of a set object." localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
--> ``` http
-GET /termStore/sets/{setId}
+GET /termStore/sets/{set-id}
+GET /sites/{site-id}/termStore/sets/{set-id}
``` ## Optional query parameters
If successful, this method returns a `200 OK` response code and a [set](../resou
## Examples
-### Request
+### Example 1: Get a termStore set
+
+#### Request
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_set_2" }--> ``` http
-GET https://graph.microsoft.com/beta/termStore/sets/{setId}
+GET https://graph.microsoft.com/beta/termStore/sets/8ed8c9ea-7052-4c1d-a4d7-b9c10bffea6f
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-set-2-csharp-snippets.md)]
GET https://graph.microsoft.com/beta/termStore/sets/{setId}
+#### 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"
+ }
+ ]
+}
+```
+
+### Example 2: Get a site collection termStore Set
+
+#### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "get_siteCollection_termStore_set"
+}-->
+``` http
+GET https://graph.microsoft.com/beta/sites/microsoft.sharepoint.com,c6482504-4a85-4b21-858a-7e88dafc8232,d90ca07d-25c0-4ce7-864b-d68b607e697f/termStore/sets/8ed8c9ea-7052-4c1d-a4d7-b9c10bffea6f
+```
-### 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,
v1.0 Termstore Store Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/termstore-store-get.md
Title: "Get store"
description: "Read the properties and relationships of a store object." localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
``` http GET /termStore
+GET /sites/{site-id}/termStore
``` ## Request headers
If successful, this method returns a `200 OK` response code and a [store](../res
## Examples
-### Request
+### Example 1: Get a termStore
+
+#### Request
# [HTTP](#tab/http) <!-- {
GET https://graph.microsoft.com/beta/termStore
-### 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,
+ "@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"]
+}
+```
+
+### Example 2: Get a site collection termStore
+
+#### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "get_store"
+}-->
+
+``` http
+GET https://graph.microsoft.com/beta/sites/microsoft.sharepoint.com,c6482504-4a85-4b21-858a-7e88dafc8232,d90ca07d-25c0-4ce7-864b-d68b607e697f/termStore
+```
+
+#### Response
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response",
v1.0 Termstore Term Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/termstore-term-get.md
Title: "Get term"
description: "Read the properties and relationships of a term object." localization_priority: Normal doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-GET /termStore/groups/{groupId}/sets/{setId}/terms/{termId}
-GET /termStore/sets/{setId}/terms/{termId}
+GET /termStore/groups/{group-id}/sets/{set-id}/terms/{term-id}
+GET /termStore/sets/{set-id}/terms/{term-id}
+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
If successful, this method returns a `200 OK` response code and a [term](../reso
## Examples
-### Request
+### Example 1: Get a termStore term
+
+#### Request
# [HTTP](#tab/http) <!-- {
If successful, this method returns a `200 OK` response code and a [term](../reso
} --> ``` http
-GET https://graph.microsoft.com/beta/termStore/groups/{groupId}/sets/{setId}/terms/{termId}
+GET https://graph.microsoft.com/beta/termStore/groups/1FFD3F87-9464-488A-A0EC-8FB90911182C/sets/8ed8c9ea-7052-4c1d-a4d7-b9c10bffea6f/terms/81be9856-9856-81be-5698-be815698be81
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-term-1-csharp-snippets.md)]
GET https://graph.microsoft.com/beta/termStore/groups/{groupId}/sets/{setId}/ter
+#### 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"
+}
+```
+### Example 2 : Get a site collection termStore term
+
+#### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "get_term_1"
+} -->
+``` http
+GET https://graph.microsoft.com/beta/sites/microsoft.sharepoint.com,c6482504-4a85-4b21-858a-7e88dafc8232,d90ca07d-25c0-4ce7-864b-d68b607e697f/termStore/groups/1FFD3F87-9464-488A-A0EC-8FB90911182C/sets/8ed8c9ea-7052-4c1d-a4d7-b9c10bffea6f/terms/81be9856-9856-81be-5698-be815698be81
+```
-### 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,
v1.0 Columndefinition https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/columndefinition.md
-description: "Here is a JSON representation of a columnDefinition resource."
+description: "Represents a column in a site, a list, or a contentType."
Last updated 09/11/2017 Title: ColumnDefinition localization_priority: Normal
Represents a column in a [site][], [list][] or [contentType][].
|[Update columnDefinition](../api/columndefinition-update.md)|[columnDefinition](../resources/columndefinition.md)|Update the properties of a [columnDefinition](../resources/columndefinition.md) object.| |[Delete columnDefinition](../api/columndefinition-delete.md)|None|Deletes a [columnDefinition](../resources/columndefinition.md) object.|
+## Properties
+
+Columns can hold data of various types.
+The following properties indicate what type of data a column stores, as well as additional settings for that data.
+The type-related properties (boolean, calculated, choice, currency, dateTime, lookup, number, personOrGroup, text) are mutually exclusive -- a column can only have one of them specified.
+
+| Property name | Type | Description
+|:|:--|:--
+| **columnGroup** | string | For site columns, the name of the group this column belongs to. Helps organize related columns.
+| **description** | string | The user-facing description of the column.
+| **displayName** | string | The user-facing name of the column.
+| **enforceUniqueValues** | Boolean | If `true`, no two list items may have the same value for this column.
+| **hidden** | Boolean | Specifies whether the column is displayed in the user interface.
+| **id** | string | The unique identifier for the column.
+| **indexed** | Boolean | Specifies whether the column values can used for sorting and searching.
+| **name** | string | The API-facing name of the column as it appears in the [fields][] on a [listItem][]. For the user-facing name, see **displayName**.
+| **readOnly** | Boolean | Specifies whether the column values can be modified.
+| **required** | Boolean | Specifies whether the column value isn't optional.
+| **boolean** | [booleanColumn][] | This column stores boolean values.
+| **calculated** | [calculatedColumn][] | This column's data is calculated based on other columns.
+| **choice** | [choiceColumn][] | This column stores data from a list of choices.
+| **currency** | [currencyColumn][] | This column stores currency values.
+| **dateTime** | [dateTimeColumn][] | This column stores DateTime values.
+| **defaultValue** | [defaultColumnValue][] | The default value for this column.
+| **geolocation** | [geolocationColumn][] | This column stores a geolocation.
+| **lookup** | [lookupColumn][] | This column's data is looked up from another source in the site.
+| **number** | [numberColumn][] | This column stores number values.
+| **personOrGroup** | [personOrGroupColumn][] | This column stores Person or Group values.
+| **text** | [textColumn][] | This column stores text values.
+| **isDeletable** | Boolean | Indicates whether this column can be deleted.
+| **propagateChanges** | Boolean | If `true`, changes to this column will be propagated to lists that implement the column.
+| **isReorderable** | Boolean | Indicates whether values in the column can be reordered. Read-only.
+| **isSealed** | Boolean | Specifies whether the column can be changed.
+| **validation** | [columnValidation][] | This column stores validation formula and message for the column.
+| **hyperlinkOrPicture** | [hyperlinkOrPictureColumn][] | This column stores hyperlink or picture values.
+| **term** | [termColumn][] | This column stores taxonomy terms.
+| **sourceContentType** |[contentTypeInfo][] | ContentType from which this column is inherited from. Used only to fetch contentTypes columns.
+| **thumbnail** |[thumbnailColumn][] | This column stores thumbnail values.
+| **type** | columnTypes | For site columns, the type of column. Read-only.
+| **contentApprovalStatus**| [contentApprovalStatusColumn][] | This column stores content approval status.
+
+## Relationships
+
+| Property name | Type | Description
+|:-|:--|:-
+| **sourceColumn** | [columnDefinition][] | The source column for content type column.
+
+>**Note:** These properties correspond to the SharePoint [SPFieldType][] enumeration.
+Note that the most common field types are represented in the previous table. However, this beta API is still missing some.
+In those cases, none of the column type facets will be populated, and the column will only have its basic properties.
+ ## JSON representation Here is a JSON representation of a columnDefinition resource.
Here is a JSON representation of a columnDefinition resource.
} ```
-## Properties
-
-Columns can hold data of various types.
-The following properties indicate what type of data a column stores, as well as additional settings for that data.
-The type-related properties (boolean, calculated, choice, currency, dateTime, lookup, number, personOrGroup, text) are mutually exclusive -- a column can only have one of them specified.
-
-| Property name | Type | Description
-|:|:--|:--
-| **columnGroup** | string | For site columns, the name of the group this column belongs to. Helps organize related columns.
-| **description** | string | The user-facing description of the column.
-| **displayName** | string | The user-facing name of the column.
-| **enforceUniqueValues** | Boolean | If true, no two list items may have the same value for this column.
-| **hidden** | Boolean | Specifies whether the column is displayed in the user interface.
-| **id** | string | The unique identifier for the column.
-| **indexed** | Boolean | Specifies whether the column values can used for sorting and searching.
-| **name** | string | The API-facing name of the column as it appears in the [fields][] on a [listItem][]. For the user-facing name, see **displayName**.
-| **readOnly** | Boolean | Specifies whether the column values can be modified.
-| **required** | Boolean | Specifies whether the column value is not optional.
-| **boolean** | [booleanColumn][] | This column stores boolean values.
-| **calculated** | [calculatedColumn][] | This column's data is calculated based on other columns.
-| **choice** | [choiceColumn][] | This column stores data from a list of choices.
-| **currency** | [currencyColumn][] | This column stores currency values.
-| **dateTime** | [dateTimeColumn][] | This column stores DateTime values.
-| **defaultValue** | [defaultColumnValue][] | The default value for this column.
-| **geolocation** | [geolocationColumn][] | This column stores a geolocation.
-| **lookup** | [lookupColumn][] | This column's data is looked up from another source in the site.
-| **number** | [numberColumn][] | This column stores number values.
-| **personOrGroup** | [personOrGroupColumn][] | This column stores Person or Group values.
-| **text** | [textColumn][] | This column stores text values.
-| **isDeletable** | Boolean | Indicates whether this column can be deleted.
-| **propagateChanges** | Boolean | If 'True' changes to this column will be propagated to lists that implement the column.
-| **isReorderable** | Boolean | Indicates whether values in the column can be reordered. Read-only.
-| **isSealed** | Boolean | Specifies whether column can be changed.
-| **validation** | [columnValidation][] | This column stores validation formula and message for the column.
-| **hyperlinkOrPicture** | [hyperlinkOrPictureColumn][] | This column stores hyperlink or picture values.
-| **term** | [termColumn][] | This column stores taxonomy terms.
-| **sourceContentType** |[contentTypeInfo][] | ContentType from which this column is inherited from. Used only while fetching contentTypes columns.
-| **thumbnail** |[thumbnailColumn][] | This column stores thumbnail values.
-| **type** | columnTypes | For site columns, the type of column. Read-only
-| **contentApprovalStatus**| [contentApprovalStatusColumn][] | This column stores content approval status.
-
-## Relationships
-
-| Property name | Type | Description
-|:-|:--|:-
-| **sourceColumn** | [columnDefinition][] | The source column for content type column.
-
->**Note:** These properties correspond to SharePoint's [SPFieldType][] enumeration.
-While the most common field types are represented in the previous table, this beta API is still missing some.
-In those cases, none of the column type facets will be populated, and the column will only have its basic properties.
- ## Remarks ColumnDefinitions and field values for `hidden` columns are not shown by default.
To see them when showing **field** values on [listItems][listItem], include the
"tocPath": "Resources/ColumnDefinition", "suppressions": [] }>
+-->
v1.0 Schemaextension https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/schemaextension.md
See the [schema extension example](/graph/extensibility-schema-groups) to learn
## Properties | Property | Type |Description| |:|:--|:-|
-|description|String|Description for the schema extension.|
-|id|String|The unique identifier for the schema extension definition. <br>You can assign a value in one of two ways: <ul><li>Concatenate the name of one of your verified domains with a name for the schema extension to form a unique string in this format, \{_&#65279;domainName_\}\_\{_&#65279;schemaName_\}. As an example, `contoso_mySchema`. </li><li>Provide a schema name, and let Microsoft Graph use that schema name to complete the **id** assignment in this format: ext\{_&#65279;8-random-alphanumeric-chars_\}\_\{_&#65279;schema-name_\}. An example would be `extkvbmkofy_mySchema`.</li></ul>This property cannot be changed after creation. |
-|owner|String| The `appId` of the application that is the owner of the schema extension. This property can be supplied on creation, to set the owner. If not supplied, then the calling application's `appId` will be set as the owner. In either case, the signed-in user must be the owner of the application. So, for example, if creating a new schema extension definition using Graph Explorer, you **must** supply the owner property. Once set, this property is read-only and cannot be changed.|
+|description|String|Description for the schema extension. Supports `$filter` (`eq`).|
+|id|String|The unique identifier for the schema extension definition. <br>You can assign a value in one of two ways: <ul><li>Concatenate the name of one of your verified domains with a name for the schema extension to form a unique string in this format, \{_&#65279;domainName_\}\_\{_&#65279;schemaName_\}. As an example, `contoso_mySchema`. </li><li>Provide a schema name, and let Microsoft Graph use that schema name to complete the **id** assignment in this format: ext\{_&#65279;8-random-alphanumeric-chars_\}\_\{_&#65279;schema-name_\}. An example would be `extkvbmkofy_mySchema`.</li></ul>This property cannot be changed after creation. Supports `$filter` (`eq`). |
+|owner|String| The `appId` of the application that is the owner of the schema extension. This property can be supplied on creation, to set the owner. If not supplied, then the calling application's `appId` will be set as the owner. In either case, the signed-in user must be the owner of the application. So, for example, if creating a new schema extension definition using Graph Explorer, you **must** supply the owner property. Once set, this property is read-only and cannot be changed. Supports `$filter` (`eq`).|
|properties|[extensionSchemaProperty](extensionschemaproperty.md) collection|The collection of property names and types that make up the schema extension definition.|
-|status|String|The lifecycle state of the schema extension. Possible states are **InDevelopment**, **Available**, and **Deprecated**. Automatically set to **InDevelopment** on creation. [Schema extensions](/graph/extensibility-overview#schema-extensions) provides more information on the possible state transitions and behaviors.|
+|status|String|The lifecycle state of the schema extension. Possible states are **InDevelopment**, **Available**, and **Deprecated**. Automatically set to **InDevelopment** on creation. [Schema extensions](/graph/extensibility-overview#schema-extensions) provides more information on the possible state transitions and behaviors. Supports `$filter` (`eq`).|
|targetTypes|String collection|Set of Microsoft Graph types (that can support extensions) that the schema extension can be applied to. Select from **administrativeUnit**, **contact**, **device**, **event**, **group**, **message**, **organization**, **post**, or **user**.| ## JSON representation
v1.0 Subscription https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/subscription.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-A subscription allows a client app to receive change notifications about changes to data in Microsoft Graph. Currently, subscriptions are enabled for the following resources:
+A subscription allows a client app to receive change notifications about changes to data in Microsoft Graph. Currently, subscriptions are enabled for the following resources.
+
+> **Note** Subscriptions marked with an asterisk (*) are supported in the beta endpoint only.
- An [alert][] from the Microsoft Graph Security API. - A [callRecord][] produced after a call or meeting in Microsoft Teams.-- A [channel](./channel.md) in Microsoft Teams.-- A [chat](./chat.md) in Microsoft Teams.
+- A [channel](./channel.md) in Microsoft Teams.*
+- A [chat](./chat.md) in Microsoft Teams.*
- A [chatMessage][] sent via teams or channels in Microsoft Teams. - A [conversation][] in a Microsoft 365 group.-- A [conversationMember](./conversationmember.md) in a team, channel, or chat in Microsoft Teams.
+- A [conversationMember](./conversationmember.md) in a team, channel, or chat in Microsoft Teams.*
- Content in the hierarchy of a root folder [driveItem][] in OneDrive for Business, or of a root folder or subfolder [driveItem][] in a user's personal OneDrive.
+- A [group][] in Azure Active Directory.
- A [list][] under a SharePoint [site][]. - A [message][], [event][], or [contact][] in Outlook.-- The [presence][] of a user in Microsoft Teams.-- A [team](./team.md) in Microsoft Teams.-- A [user][] or [group][] in Azure Active Directory.
+- The [presence][] of a user in Microsoft Teams.*
+- A [team](./team.md) in Microsoft Teams.*
- A [printer][] (when a print job for the printer gets to JobFetchable state - ready to be fetched for printing) and a [printTaskDefinition][] in Universal Print. For more information, see [Subscribe to change notifications from cloud printing APIs](/graph/universal-print-webhook-notifications).-- A [todoTask][] of a user in Microsoft To Do.
+- A [todoTask][] of a user in Microsoft To Do.*
+- A [user][] in Azure Active Directory.
See [Use the Microsoft Graph API to get change notifications](webhooks.md) for the possible resource path values for each supported resource.
v1.0 Termstore Group https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/termstore-group.md
Title: Group resource type
doc_type: "resourcePageType" description: "Represents a group used in a term store." localization_priority: Normal # Group resource type
Inherits from [entity](../resources/entity.md).
| 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-store-get-group.md) | [microsoft.graph.termStore.group] | Retrieve the data of 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
v1.0 User https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/user.md
This resource supports:
| onPremisesSyncEnabled | Boolean | `true` if this object is synced from an on-premises directory; `false` if this object was originally synced from an on-premises directory but is no longer synced; `null` if this object has never been synced from an on-premises directory (default). Read-only. <br><br>Supports `$filter` (`eq`, `ne`, `NOT`, `in`). | | onPremisesUserPrincipalName | String | Contains the on-premises `userPrincipalName` synchronized from the on-premises directory. The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. Read-only. <br><br>Supports `$filter` (`eq`, `ne`, `NOT`, `ge`, `le`, `in`, `startsWith`). | | otherMails | String collection | A list of additional email addresses for the user; for example: `["bob@contoso.com", "Robert@fabrikam.com"]`.<br>NOTE: While this property can contain accent characters, they can cause access issues to first-party applications for the user.<br><br>Supports `$filter` (`eq`, `NOT`, `ge`, `le`, `in`, `startsWith`). |
-| passwordPolicies | String | Specifies password policies for the user. This value is an enumeration with one possible value being `DisableStrongPassword`, which allows weaker passwords than the default policy to be specified. `DisablePasswordExpiration` can also be specified. The two may be specified together; for example: `DisablePasswordExpiration, DisableStrongPassword`.<br><br>Supports `$filter` (`ne`, `NOT`).|
+| passwordPolicies | String | Specifies password policies for the user. This value is an enumeration with one possible value being `DisableStrongPassword`, which allows weaker passwords than the default policy to be specified. `DisablePasswordExpiration` can also be specified. The two may be specified together; for example: `DisablePasswordExpiration, DisableStrongPassword`. For more information on the default password policies, see [Azure AD pasword policies](/azure/active-directory/authentication/concept-sspr-policy#password-policies-that-only-apply-to-cloud-user-accounts). <br><br>Supports `$filter` (`ne`, `NOT`).|
| passwordProfile | [passwordProfile](passwordprofile.md) | Specifies the password profile for the user. The profile contains the user's password. This property is required when a user is created. The password in the profile must satisfy minimum requirements as specified by the **passwordPolicies** property. By default, a strong password is required. **NOTE:** For Azure B2C tenants, the **forceChangePasswordNextSignIn** property should be set to `false` and instead use custom policies and user flows to force password reset at first logon. See [Force password reset at first logon](https://github.com/azure-ad-b2c/samples/tree/master/policies/force-password-reset-first-logon). <br><br>Supports `$filter` (`eq`, `ne`, `NOT`, `in`).| | pastProjects | String collection | A list for the user to enumerate their past projects. <br><br>Returned only on `$select`. | | postalCode | String | The postal code for the user's postal address. The postal code is specific to the user's country/region. In the United States of America, this attribute contains the ZIP code. Maximum length is 40 characters. <br><br>Supports `$filter` (`eq`, `ne`, `NOT`, `ge`, `le`, `in`, `startsWith`).|
v1.0 Channel List Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/channel-list-messages.md
The following is an example of the request.
"blockType": "request", "name": "get_listchannelmessages_1" }-->
-```
+```http
GET https://graph.microsoft.com/v1.0/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/channels/19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2/messages ``` # [C#](#tab/csharp)
v1.0 Countrynamedlocation https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/countrynamedlocation.md
Inherits from [namedLocation](../resources/namedLocation.md)
| Property | Type | Description | |:-|:|:| |countriesAndRegions|String collection|List of countries and/or regions in two-letter format specified by ISO 3166-2.|
+|countryLookupMethod|countryLookupMethodType|Determines what method is used to decide which country the user is located in. Possible values are `clientIpAddress` and `authenticatorAppGps`.|
|createdDateTime|DateTimeOffset|The Timestamp type represents creation date and time of the location using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only. Inherited from [namedLocation](../resources/namedLocation.md).| |displayName|String|Human-readable name of the location. Inherited from [namedLocation](../resources/namedLocation.md).| |id|String|Identifier of a namedLocation object. Read-only. Inherited from [namedLocation](../resources/namedLocation.md).|
The following is a JSON representation of the resource.
```json { "countriesAndRegions": ["String"],
+ "countryLookupMethod": "String",
"createdDateTime": "String (timestamp)", "displayName": "String", "id": "String (identifier)",
The following is a JSON representation of the resource.
"section": "documentation", "tocPath": "" }-->-
v1.0 Enums https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/enums.md
Namespace: microsoft.graph
|clientIpAddress| |authenticatorAppGps|
+### countryLookupMethodType values
+
+|Member|
+|:|
+|clientIpAddress|
+|authenticatorAppGps|
+ ### consentRequestFilterByCurrentUserOptions values |Member|
v1.0 Schemaextension https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/schemaextension.md
See the [schema extension example](/graph/extensibility-schema-groups) to learn
## Properties | Property | Type |Description| |:|:--|:-|
-|description|String|Description for the schema extension.|
-|id|String|The unique identifier for the schema extension definition. <br>You can assign a value in one of two ways: <ul><li>Concatenate the name of one of your verified domains with a name for the schema extension to form a unique string in this format, \{_&#65279;domainName_\}\_\{_&#65279;schemaName_\}. As an example, `contoso_mySchema`. </li><li>Provide a schema name, and let Microsoft Graph use that schema name to complete the **id** assignment in this format: ext\{_&#65279;8-random-alphanumeric-chars_\}\_\{_&#65279;schema-name_\}. An example would be `extkvbmkofy_mySchema`.</li></ul>This property cannot be changed after creation. |
-|owner|String|The `appId` of the application that is the owner of the schema extension. This property can be supplied on creation, to set the owner. If not supplied, then the calling application's `appId` will be set as the owner. In either case, the signed-in user must be the owner of the application. So, for example, if creating a new schema extension definition using Graph Explorer, you **must** supply the owner property. Once set, this property is read-only and cannot be changed.|
+|description|String|Description for the schema extension. Supports `$filter` (`eq`).|
+|id|String|The unique identifier for the schema extension definition. <br>You can assign a value in one of two ways: <ul><li>Concatenate the name of one of your verified domains with a name for the schema extension to form a unique string in this format, \{_&#65279;domainName_\}\_\{_&#65279;schemaName_\}. As an example, `contoso_mySchema`. </li><li>Provide a schema name, and let Microsoft Graph use that schema name to complete the **id** assignment in this format: ext\{_&#65279;8-random-alphanumeric-chars_\}\_\{_&#65279;schema-name_\}. An example would be `extkvbmkofy_mySchema`.</li></ul>This property cannot be changed after creation. Supports `$filter` (`eq`). |
+|owner|String|The `appId` of the application that is the owner of the schema extension. This property can be supplied on creation, to set the owner. If not supplied, then the calling application's `appId` will be set as the owner. In either case, the signed-in user must be the owner of the application. So, for example, if creating a new schema extension definition using Graph Explorer, you **must** supply the owner property. Once set, this property is read-only and cannot be changed. Supports `$filter` (`eq`).|
|properties|[extensionSchemaProperty](extensionschemaproperty.md) collection|The collection of property names and types that make up the schema extension definition.|
-|status|String|The lifecycle state of the schema extension. Possible states are **InDevelopment**, **Available**, and **Deprecated**. Automatically set to **InDevelopment** on creation. [Schema extensions](/graph/extensibility-overview#schema-extensions) provides more information on the possible state transitions and behaviors.|
+|status|String|The lifecycle state of the schema extension. Possible states are **InDevelopment**, **Available**, and **Deprecated**. Automatically set to **InDevelopment** on creation. [Schema extensions](/graph/extensibility-overview#schema-extensions) provides more information on the possible state transitions and behaviors. Supports `$filter` (`eq`).|
|targetTypes|String collection|Set of Microsoft Graph types (that can support extensions) that the schema extension can be applied to. Select from **contact**, **device**, **event**, **group**, **message**, **organization**, **post**, or **user**.| ## JSON representation
v1.0 Subscription https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/subscription.md
A subscription allows a client app to receive change notifications about changes
- A [chatMessage][] sent via teams or channels in Microsoft Teams. - A [conversation][] in a Microsoft 365 group. - Content in the hierarchy of a root folder [driveItem][] in OneDrive for Business, or of a root folder or subfolder [driveItem][] in a user's personal OneDrive.
+- A [group][] in Azure Active Directory.
- A [list][] under a SharePoint [site][]. - A [message][], [event][], or [contact][] in Outlook. - A [printer][] (when a print job for the printer gets to JobFetchable state - ready to be fetched for printing) and a [printTaskDefinition][] in Universal Print. For more information, see [Subscribe to change notifications from cloud printing APIs](/graph/universal-print-webhook-notifications).-- A [user][] or [group][] in Azure Active Directory.
+- A [user][] in Azure Active Directory.
See [Use the Microsoft Graph API to get change notifications](webhooks.md) for the possible resource path values for each supported resource.
v1.0 User https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/user.md
This resource supports:
|onPremisesSyncEnabled|Boolean| `true` if this object is synced from an on-premises directory; `false` if this object was originally synced from an on-premises directory but is no longer synced; `null` if this object has never been synced from an on-premises directory (default). Read-only. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `NOT`, `in`).| |onPremisesUserPrincipalName|String| Contains the on-premises `userPrincipalName` synchronized from the on-premises directory. The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. Read-only. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `NOT`, `ge`, `le`, `in`, `startsWith`).| |otherMails|String collection| A list of additional email addresses for the user; for example: `["bob@contoso.com", "Robert@fabrikam.com"]`. <br>NOTE: While this property can contain accent characters, they can cause access issues to first-party applications for the user. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `NOT`, `ge`, `le`, `in`, `startsWith`).|
-|passwordPolicies|String|Specifies password policies for the user. This value is an enumeration with one possible value being `DisableStrongPassword`, which allows weaker passwords than the default policy to be specified. `DisablePasswordExpiration` can also be specified. The two may be specified together; for example: `DisablePasswordExpiration, DisableStrongPassword`. <br><br>Returned only on `$select`. Supports `$filter` (`ne`, `NOT`).|
+|passwordPolicies|String|Specifies password policies for the user. This value is an enumeration with one possible value being `DisableStrongPassword`, which allows weaker passwords than the default policy to be specified. `DisablePasswordExpiration` can also be specified. The two may be specified together; for example: `DisablePasswordExpiration, DisableStrongPassword`. <br><br>Returned only on `$select`. For more information on the default password policies, see [Azure AD pasword policies](/azure/active-directory/authentication/concept-sspr-policy#password-policies-that-only-apply-to-cloud-user-accounts). Supports `$filter` (`ne`, `NOT`).|
|passwordProfile|[passwordProfile](passwordprofile.md)|Specifies the password profile for the user. The profile contains the userΓÇÖs password. This property is required when a user is created. The password in the profile must satisfy minimum requirements as specified by the **passwordPolicies** property. By default, a strong password is required. **NOTE:** For Azure B2C tenants, the **forceChangePasswordNextSignIn** property should be set to `false` and instead use custom policies and user flows to force password reset at first logon. See [Force password reset at first logon](https://github.com/azure-ad-b2c/samples/tree/master/policies/force-password-reset-first-logon).<br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `NOT`, `in`).| |pastProjects|String collection|A list for the user to enumerate their past projects. <br><br>Returned only on `$select`.| |postalCode|String|The postal code for the user's postal address. The postal code is specific to the user's country/region. In the United States of America, this attribute contains the ZIP code. Maximum length is 40 characters. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `NOT`, `ge`, `le`, `in`, `startsWith`).|