Updates from: 02/20/2021 04:24:52
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Accesspackage Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackage-delete.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.ReadWrite.All |
## HTTP request
One of the following permissions is required to call this API. To learn more, in
```http DELETE /identityGovernance/entitlementManagement/accessPackages/{id}- ``` ## Request headers
v1.0 Accesspackage Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackage-get.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Accesspackage List Accesspackageresourcerolescopes https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackage-list-accesspackageresourcerolescopes.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Accesspackage List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackage-list.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Accesspackage Post Accesspackageresourcerolescopes https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackage-post-accesspackageresourcerolescopes.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Accesspackage Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackage-post.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Accesspackage Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackage-update.md
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account) | EntitlementManagement.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | Not supported. |
+|Application | EntitlementManagement.ReadWrite.All |
## HTTP request <!-- {
Content-length: 38
``` http HTTP/1.1 204 No Content Content-Type: application/json- ``` <!--
v1.0 Accesspackageassignment List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageassignment-list.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Accesspackageassignmentpolicy Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageassignmentpolicy-delete.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Accesspackageassignmentpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageassignmentpolicy-get.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Accesspackageassignmentpolicy List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageassignmentpolicy-list.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Accesspackageassignmentpolicy Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageassignmentpolicy-post.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Accesspackageassignmentpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageassignmentpolicy-update.md
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account) | EntitlementManagement.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | Not supported. |
+|Application | EntitlementManagement.ReadWrite.All |
## HTTP request <!-- {
v1.0 Accesspackageassignmentrequest Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageassignmentrequest-get.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Accesspackageassignmentrequest List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageassignmentrequest-list.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Accesspackageassignmentrequest Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageassignmentrequest-post.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Accesspackageassignmentresourcerole Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageassignmentresourcerole-get.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Accesspackageassignmentresourcerole List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageassignmentresourcerole-list.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Accesspackagecatalog Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackagecatalog-delete.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Accesspackagecatalog Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackagecatalog-get.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Accesspackagecatalog List Accesspackageresourceroles https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackagecatalog-list-accesspackageresourceroles.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Accesspackagecatalog List Accesspackageresources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackagecatalog-list-accesspackageresources.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Accesspackagecatalog List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackagecatalog-list.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Accesspackagecatalog Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackagecatalog-post.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Accesspackagecatalog Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackagecatalog-update.md
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account) | EntitlementManagement.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | Not supported. |
+|Application | EntitlementManagement.ReadWrite.All |
## HTTP request <!-- {
v1.0 Accesspackageresourceenvironment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageresourceenvironment-get.md
If successful, this method returns a `200 OK` response code and an [accessPackag
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_accesspackageresourceenvironment"
If successful, this method returns a `200 OK` response code and an [accessPackag
``` http GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageResourceEnvironments/{accessPackageResourceEnvironmentId} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Accesspackageresourceenvironment List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageresourceenvironment-list.md
doc_type: apiPageType
# List accessPackageResourceEnvironments Namespace: microsoft.graph + Retrieve a list of [accessPackageResourceEnvironment](../resources/accesspackageresourceenvironment.md) objects and their properties. ## Permissions
If successful, this method returns a `200 OK` response code and a collection of
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_accesspackageresourceenvironment"
If successful, this method returns a `200 OK` response code and a collection of
``` http GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageResourceEnvironments?$filter=originSystem eq 'SharePointOnline' ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Accesspackageresourcerequest List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageresourcerequest-list.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Accesspackageresourcerequest Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageresourcerequest-post.md
Content-type: application/json
The following is an example of the request. In this example, the `@odata.bind` annotation is used to assign the `id` of the `accessPackageResourceEnvironment` to an `accessPackageResourceEnvironment` object. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_accesspackageresourcerequest_from_accesspackageresourcerequests_with_accessPackageResourceEnvironment"
Content-type: application/json
"requestType": "AdminAdd" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
Content-type: application/json
The following is an example of the request. In this example, the parameters of an `accessPackageResourceEnvironment` are specified in an `accessPackageResourceEnvironment` object. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_accesspackageresourcerequest_from_accesspackageresourcerequests_with_accessPackageResourceEnvironment_New"
Content-type: application/json
"requestType": "AdminAdd" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
v1.0 Activities List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/activities-list.md
- Last updated 09/10/2017 Title: File Activities description: "List the recent activities that took place on an item or under a hierarchy."
v1.0 Application Addkey https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-addkey.md
The following is an example of the response.
<!-- { "blockType": "response",
- "truncated": true
+ "truncated": true,
+ "@odata.type": "microsoft.graph.keyCredential"
} --> ```http
Content-Type: application/json
"section": "documentation", "tocPath": "", "suppressions": [
- "Error: application_addkey:\r\n Resource type was null or missing, so we assume there is no response to validate."
- ]
+ ]
}-->
v1.0 Application Post Calls https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-post-calls.md
With tenant admin credentials, call the following cmdlets on the tenant remote P
PS C:\> Set-CsOnlineVoiceApplicationInstance -Identity <UPN> -TelephoneNumber <TelephoneNumber> PS C:\> Sync-CsOnlineApplicationInstance -ObjectId <ObjectId> ```
-> **Note:** If a tenant has Australian PSTN numbers assigned to any application instances, this call might fail. If a tenant is newly created, it might take several days for this feature to be available.
#### Request The following example shows the request to make a peer-to-peer call between the bot and a PSTN number. 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.
Content-Type: application/json
This call needs application instance with PSTN number assigned, as described in Example 9.
-> **Note:** If a tenant has Australian PSTN numbers assigned to any application instances, this call might not work. If a tenant is newly created, it might take several days for this feature to be available.
- #### Request The following example shows a request to make a peer-to-peer call between the bot and a PSTN number. In this example, the media is hosted locally by the application. Replace the values for authorization token, callback URL, application ID, application name, user ID, user name, and tenant ID to make the example work.
v1.0 Application Post Onlinemeetings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-post-onlinemeetings.md
One of the following permissions is required to call this API. To learn more, in
| :- | :- | | Delegated (work or school account) | OnlineMeetings.ReadWrite | | Delegated (personal Microsoft account) | Not supported. |
-| Application | OnlineMeetings.Read.All, OnlineMeetings.ReadWrite.All* |
+| Application | OnlineMeetings.ReadWrite.All* |
> [!IMPORTANT] > \* Administrators must create an [application access policy](/graph/cloud-communication-online-meeting-application-access-policy) and grant it to a user, authorizing the app configured in the policy to create an online meeting on behalf of that user (user ID specified in the request path).
Content-Type: application/json
"creationDateTime": "2019-07-11T02:17:17.6491364Z", "startDateTime": "2019-07-11T02:17:17.6491364Z", "endDateTime": "2019-07-11T02:47:17.651138Z",
- "id": "550fae72-d251-43ec-868c-373732c2704f_19:meeting_M2IzYzczNTItYmY3OC00MDlmLWJjMzUtYmFiMjNlOTY4MGEz@thread.skype",
+ "id": "MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZiMi04ZdFpHRTNaR1F6WGhyZWFkLnYy",
"joinWebUrl": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_M2IzYzczNTItYmY3OC00MDlmLWJjMzUtYmFiMjNlOTY4MGEz%40thread.skype/0?context=%7b%22Tid%22%3a%2272f988bf-86f1-41af-91ab-2d7cd011db47%22%2c%22Oid%22%3a%22550fae72-d251-43ec-868c-373732c2704f%22%7d", "participants": { "organizer": {
Content-Type: application/json
"creationDateTime": "2019-07-11T02:17:17.6491364Z", "startDateTime": "2019-07-11T02:17:17.6491364Z", "endDateTime": "2019-07-11T02:47:17.651138Z",
- "id": "550fae72-d251-43ec-868c-373732c2704f_19%3A3b52398f3c524556894b776357c1dd79%40thread.skype",
+ "id": "MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZiMi04ZdFpHRTNaR1F6WGhyZWFkLnYy",
"joinWebUrl": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_M2IzYzczNTItYmY3OC00MDlmLWJjMzUtYmFiMjNlOTY4MGEz%40thread.skype/0?context=%7b%22Tid%22%3a%2272f988bf-86f1-41af-91ab-2d7cd011db47%22%2c%22Oid%22%3a%22550fae72-d251-43ec-868c-373732c2704f%22%7d", "participants": { "organizer": {
v1.0 Attachment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/attachment-get.md
Read the properties, relationships, or raw contents of an attachment that is att
An attachment can be one of the following types:
-* A file. Programmatically, this is a [fileAttachment](../resources/fileattachment.md) resource.
-* An Outlook item (contact, event or message). Programmatically, an item attachment is an [itemAttachment](../resources/itemattachment.md) resource. You can use `$expand` to further get the properties of that item. See an [example](#request-2) below.
-* A link to a file stored in the cloud. Programmatically, this is a [referenceAttachment](../resources/referenceattachment.md) resource.
+* A file. Programmatically, this is a [fileAttachment](../resources/fileattachment.md) resource. See [example 1](#example-1-get-the-properties-of-a-file-attachment).
+* An Outlook item (contact, event or message). Programmatically, an item attachment is an [itemAttachment](../resources/itemattachment.md) resource. You can use `$expand` to further get the properties of that item, including any nested attachments up to 30 levels. See [example 3](#example-3-expand-and-get-the-properties-of-the-item-attached-to-a-message) and [example 4](#example-4-expand-and-get-the-properties-of-an-item-attached-to-a-message-including-any-attachment-to-the-item).
+* A link to a file stored in the cloud. Programmatically, this is a [referenceAttachment](../resources/referenceattachment.md) resource. See [example 5](#example-5-get-the-properties-of-a-reference-attachment).
All these types of attachments are derived from the [attachment](../resources/attachment.md) resource. ### Get the raw contents of a file or item attachment You can append the path segment `/$value` to get the raw contents of a file or item attachment.
-For a file attachment, the content type is based on its original content type. See an [example](#example-5-get-the-raw-contents-of-a-file-attachment-on-a-message) below.
+For a file attachment, the content type is based on its original content type. See an [example 6](#example-6-get-the-raw-contents-of-a-file-attachment-on-a-message).
For an item attachment that is a [contact](../resources/contact.md), [event](../resources/event.md), or [message](../resources/message.md), the raw contents returned is in MIME format. | Item attachment type | Raw contents returned | |:--|:-|
-| **contact** | [vCard](http://www.faqs.org/rfcs/rfc2426.html) MIME format. See [example](#example-6-get-the-mime-raw-contents-of-a-contact-attachment-on-a-message). |
-| **event** | iCal MIME format. See [example](#example-7-get-the-mime-raw-contents-of-an-event-attachment-on-a-message). |
-| **message** | MIME format. See [example](#example-8-get-the-mime-raw-contents-of-a-meeting-invitation-item-attachment-on-a-message). |
+| **contact** | [vCard](http://www.faqs.org/rfcs/rfc2426.html) MIME format. See [example 7](#example-7-get-the-mime-raw-contents-of-a-contact-attachment-on-a-message). |
+| **event** | iCal MIME format. See [example 8](#example-8-get-the-mime-raw-contents-of-an-event-attachment-on-a-message). |
+| **message** | MIME format. See [example 9](#example-9-get-the-mime-raw-contents-of-a-meeting-invitation-item-attachment-on-a-message). |
Attempting to get the `$value` of a reference attachment returns HTTP 405.
GET /groups/{id}/conversations/{id}/threads/{id}/posts/{id}/attachments/{id}/$va
## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+This method supports some of the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+
+Use `$expand` to get the properties of an item attachment (contact, event, or message). See [example 3](#example-3-expand-and-get-the-properties-of-the-item-attached-to-a-message) and [example 4](#example-4-expand-and-get-the-properties-of-an-item-attached-to-a-message-including-any-attachment-to-the-item).
## Request headers
Content-type: application/json
"hasAttachments":false, "internetMessageId":"<BY2PR15MB05189A084C01F466709E414F9CA40@BY2PR15MB0518.namprd15.prod.outlook.com>", "subject":"Reminder - please bring laptop",
+ "bodyPreview": "PFA\r\n\r\nThanks,\r\nRob",
"importance":"normal", "conversationId":"AAQkADA1MzMyOGI4LTlkZDctNDkzYy05M2RiLTdiN2E1NDE3MTRkOQAQAMG_NSCMBqdKrLa2EmR-lO0=", "conversationIndex":"AQHTAbcSwb41IIwGp0qstrYSZH+U7Q==",
Content-type: application/json
"isRead":false, "isDraft":false, "webLink":"https://outlook.office365.com/owa/?ItemID=AAMkADA1M3MTRkOQAAAA%3D%3D&exvsurl=1&viewmodel=ReadMessageItem",
+ "internetMessageHeaders": [ ],
"body":{ "contentType":"html", "content":"<html><head>\r\n</head>\r\n<body>\r\n</body>\r\n</html>"
Content-type: application/json
} ```
-### Example 4: Get the properties of a reference attachment
+### Example 4: Expand and get the properties of an item attached to a message, including any attachment to the item
+#### Request
+The next example uses the same request as in [example 3](#example-3-expand-and-get-the-properties-of-the-item-attached-to-a-message) to get the properties of an item attachment on a message by using `$expand`. In this case, because the attached item also has a file attachment, the response includes the properties of the file attachment as well.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_and_expand_nested_item_attachment",
+ "sampleKeys": ["AAMkADA1M-zAAA=","AAMkADA1M-CJKtzmnlcqVgqI="]
+}-->
+
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/me/messages('AAMkADA1M-zAAA=')/attachments('AAMkADA1M-CJKtzmnlcqVgqI=')/?$expand=microsoft.graph.itemattachment/item
+```
+
+#### Response
+<!-- {
+ "blockType": "response",
+ "name": "get_and_expand_nested_item_attachment",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.itemAttachment"
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('d1a2fae9-db66-4cc9-8133-2184c77af1b8')/messages('AAMkADA1M-zAAA%3D')/attachments(microsoft.graph.itemAttachment/item())/$entity",
+ "@odata.type": "#microsoft.graph.itemAttachment",
+ "id": "AAMkADA1MCJKtzmnlcqVgqI=",
+ "lastModifiedDateTime": "2021-01-06T13:28:11Z",
+ "name": "Nested Message With Attachment",
+ "contentType": null,
+ "size": 465916,
+ "isInline": false,
+ "item@odata.context": "https://graph.microsoft.com/beta/$metadata#users('d1a2fae9-db66-4cc9-8133-2184c77af1b8')/messages('AAMkADA1M-zAAA%3D')/attachments('AAMkADA1M-CJKtzmnlcqVgqI%3D')/microsoft.graph.itemAttachment/item/$entity",
+ "item": {
+ "@odata.type": "#microsoft.graph.message",
+ "id": "",
+ "createdDateTime": "2021-01-06T13:28:30Z",
+ "lastModifiedDateTime": "2021-01-06T13:27:40Z",
+ "receivedDateTime": "2021-01-06T13:27:25Z",
+ "sentDateTime": "2021-01-06T13:27:04Z",
+ "hasAttachments": true,
+ "internetMessageId": "<BY2PR15MB05189A084C01F466709E414F9CA40@BY2PR15MB0518.namprd15.prod.outlook.com>",
+ "subject": "Nested Message With Attachment",
+ "bodyPreview": "PFAThanks,Adele",
+ "importance": "normal",
+ "conversationId": "AAQkADg3NTY5MDg4LWMzYmQtNDQzNi05OTgwLWQyZjg2YWQwMTNkZAAQAO6hkp84oMdGm6ZBsSH72sE=",
+ "conversationIndex": "AQHW5C+U7qGSnzigx0abpkGxIfvawQ==",
+ "isDeliveryReceiptRequested": false,
+ "isReadReceiptRequested": false,
+ "isRead": true,
+ "isDraft": false,
+ "webLink": "https://outlook.office365.com/owa/?ItemID=AAMkADA1M3MTRkOQAAAA%3D%3D&exvsurl=1&viewmodel=ItemAttachment",
+ "internetMessageHeaders": [],
+ "body": {
+ "contentType": "html",
+ "content": "<html><head>\r\n</head>\r\n<body>\r\n</body>\r\n</html>"
+ },
+ "sender": {
+ "emailAddress": {
+ "name": "Adele Vance",
+ "address": "Adele.Vance@microsoft.com"
+ }
+ },
+ "from": {
+ "emailAddress": {
+ "name": "Adele Vance",
+ "address": "Adele.Vance@microsoft.com"
+ }
+ },
+ "toRecipients": [
+ {
+ "emailAddress": {
+ "name": "Adele Vance",
+ "address": "Adele.Vance@microsoft.com"
+ }
+ }
+ ],
+ "flag": {
+ "flagStatus": "notFlagged"
+ },
+ "attachments@odata.context": "https://graph.microsoft.com/beta/$metadata#users('d1a2fae9-db66-4cc9-8133-2184c77af1b8')/messages('AAMkADA1M-zAAA%3D')/attachments('AAMkADA1M-CJKtzmnlcqVgqI%3D')/microsoft.graph.itemAttachment/microsoft.graph.itemAttachment/item/microsoft.graph.message/microsoft.graph.message/microsoft.graph.message/microsoft.graph.message/microsoft.graph.message/microsoft.graph.message/microsoft.graph.message/attachments",
+ "attachments": [
+ {
+ "@odata.type": "#microsoft.graph.fileAttachment",
+ "@odata.mediaContentType": "application/pdf",
+ "id": "AAMkADg3NTYULmbsDYNg==",
+ "lastModifiedDateTime": "2021-01-21T14:56:18Z",
+ "name": "Info.pdf",
+ "contentType": "application/pdf",
+ "size": 417351,
+ "isInline": false,
+ "contentId": null,
+ "contentLocation": null,
+ "contentBytes": "JVBERi0xLjUNCiW1tbW1DQoxIDAgb2JqDQo8PC9UeXBlL0NhdGFsb2cvUGFnZXMgMiAwIFIvTGFuZyhlbi1JTikgL1N0cnVjdFRyZWVSb29"
+ }
+ ]
+ }
+}
+```
+
+### Example 5: Get the properties of a reference attachment
#### Request
Content-type: application/json
```
-### Example 5: Get the raw contents of a file attachment on a message
+### Example 6: Get the raw contents of a file attachment on a message
#### Request
HTTP/1.1 200 OK
```
-### Example 6: Get the MIME raw contents of a contact attachment on a message
+### Example 7: Get the MIME raw contents of a contact attachment on a message
#### Request
END:VCARD
```
-### Example 7: Get the MIME raw contents of an event attachment on a message
+### Example 8: Get the MIME raw contents of an event attachment on a message
#### Request
END:VCALENDAR
```
-### Example 8: Get the MIME raw contents of a meeting invitation item attachment on a message
+### Example 9: Get the MIME raw contents of a meeting invitation item attachment on a message
#### Request
v1.0 B2cidentityuserflow Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2cidentityuserflow-update.md
HTTP/1.1 204 No Content
"section": "documentation", "tocPath": "", "suppressions": [
- "Error: update_b2cidentityuserflow/userFlowTypeVersion:\r\n Expected type Single but actual was Int64. Property: userFlowTypeVersion, actual value: '1'",
- "Error: update_b2cidentityuserflow/userFlowTypeVersion:\r\n Expected type Single but actual was Int64. Property: userFlowTypeVersion, actual value: '1'"
] }-->
v1.0 Bundle Additem https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/bundle-additem.md
- Title: Add item to a bundle description: Add item to a bundle of driveItems localization_priority: Normal
v1.0 Bundle Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/bundle-delete.md
- Title: Delete bundle description: Delete a bundle of driveItems localization_priority: Normal
v1.0 Bundle Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/bundle-get.md
- Title: Get bundle description: Get a bundle of driveItems localization_priority: Normal
v1.0 Bundle List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/bundle-list.md
- Title: List bundles description: List the bundles in a user's drive localization_priority: Normal
v1.0 Bundle Removeitem https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/bundle-removeitem.md
- Title: Remove item from bundle description: Remove item from a bundle of driveItems localization_priority: Normal
v1.0 Bundle Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/bundle-update.md
- Title: Update a bundle description: Update a bundle of driveItems localization_priority: Normal
v1.0 Call Redirect https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/call-redirect.md
With tenant admin credentials, call the following cmdlets on the tenant remote P
PS C:\> Set-CsOnlineVoiceApplicationInstance -Identity <UPN> -TelephoneNumber <TelephoneNumber> PS C:\> Sync-CsOnlineApplicationInstance -ObjectId <ObjectId> ```
-> **Note:** If a tenant has Australian PSTN numbers assigned to any application instances, this call might fail. If a tenant is newly created, it might take several days for this feature to be available.
#### Notification - incoming <!-- {
v1.0 Call Transfer https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/call-transfer.md
With tenant admin credentials, call the following cmdlets on the tenant remote P
PS C:\> Set-CsOnlineVoiceApplicationInstance -Identity <UPN> -TelephoneNumber <TelephoneNumber> PS C:\> Sync-CsOnlineApplicationInstance -ObjectId <ObjectId> ```
-> **Note:** If a tenant has Australian PSTN numbers assigned to any application instances, this call might fail. If a tenant is newly created, it might take several days for this feature to be available.
#### Request The following example shows the request.
Content-Type: application/json
This call requires an application instance with PSTN number assigned, as described in Example 3.
-> **Note:** This call may fail if a tenant has Australian PSTN numbers assigned to any application instances. If a tenant is newly created, it might take several days for this feature to be available.
-- #### Request The following example shows the request.
v1.0 Connectedorganization Delete Externalsponsors https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectedorganization-delete-externalsponsors.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) | EntitlementManagement.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | Not supported. |
+|Application | EntitlementManagement.ReadWrite.All |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Connectedorganization Delete Internalsponsors https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectedorganization-delete-internalsponsors.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) | EntitlementManagement.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | Not supported. |
+|Application | EntitlementManagement.ReadWrite.All |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Connectedorganization Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectedorganization-delete.md
One of the following permissions is required to call this API. To learn more, in
|:|:| | Delegated (work or school account) | EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Connectedorganization Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectedorganization-get.md
One of the following permissions is required to call this API. To learn more, in
|:|:| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Connectedorganization List Externalsponsors https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectedorganization-list-externalsponsors.md
One of the following permissions is required to call this API. To learn more, in
|:|:| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Connectedorganization List Internalsponsors https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectedorganization-list-internalsponsors.md
One of the following permissions is required to call this API. To learn more, in
|:|:| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Connectedorganization List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectedorganization-list.md
One of the following permissions is required to call this API. To learn more, in
|:|:| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Connectedorganization Post Externalsponsors https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectedorganization-post-externalsponsors.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) | EntitlementManagement.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | Not supported. |
+|Application | EntitlementManagement.ReadWrite.All |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Connectedorganization Post Internalsponsors https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectedorganization-post-internalsponsors.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) | EntitlementManagement.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | Not supported. |
+|Application | EntitlementManagement.ReadWrite.All |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Connectedorganization Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectedorganization-post.md
One of the following permissions is required to call this API. To learn more, in
|:|:| | Delegated (work or school account) | EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Connectedorganization Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/connectedorganization-update.md
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account) | EntitlementManagement.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | Not supported. |
+|Application | EntitlementManagement.ReadWrite.All |
## HTTP request
PATCH /identityGovernance/entitlementManagement/connectedOrganizations/{id}
## Request body In the request body, supply a JSON representation of the [connectedOrganization](../resources/connectedorganization.md) object.
-The following table shows the properties that are required when you update the [connectedOrganization](../resources/connectedorganization.md).
+The following table shows the properties that can be supplied when you update the [connectedOrganization](../resources/connectedorganization.md).
|Property|Type|Description| |:|:|:|
v1.0 Custodian List Usersources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/custodian-list-usersources.md
If successful, this method returns a `200 OK` response code and a collection of
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_usersource"
If successful, this method returns a `200 OK` response code and a collection of
``` http GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/4c8f8f70-7785-4bd4-b296-c98376a2c5e1/custodians/2192ca408ea2410eba3bec8ae873be6b/userSources ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Directory Deleteditems Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directory-deleteditems-delete.md
For users:
|:--|:| |Delegated (work or school account) | User.ReadWrite.All, Directory.AccessAsUser.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | User.ReadWrite.All |
+|Application | Not supported. |
For groups:
For groups:
|:--|:| |Delegated (work or school account) | Group.ReadWrite.All, Directory.AccessAsUser.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | Group.ReadWrite.All |
+|Application | Not supported. |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Directory Deleteditems Restore https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directory-deleteditems-restore.md
Title: "Restore deleted item"
description: "Restores a recently deleted item from deleted items. " localization_priority: Normal doc_type: apiPageType
Namespace: microsoft.graph
Restores a recently deleted item from [deleted items](../resources/directory.md).
-Currently, deleted items functionality is only supported for the [application](../resources/application.md), [group](../resources/group.md) and [user](../resources/user.md) resources. If an item was accidentally deleted, you can fully restore the item.
+Currently, restore deleted items functionality is only supported for the [application](../resources/application.md), [group](../resources/group.md), and [user](../resources/user.md) resources. If an item was accidentally deleted, you can fully restore the item. This is not applicable to Security groups which are deleted permanently.
A recently deleted item will remain available for up to 30 days. After 30 days, the item is permanently deleted.
v1.0 Directoryobject Checkmembergroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryobject-checkmembergroups.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | User.ReadBasic.All and GroupMember.Read.All, User.Read.All and GroupMember.Read.All, User.ReadBasic.All and Group.Read.All, User.Read.All and Group.Read.All, Directory.Read.All |
+|Delegated (work or school account) | User.ReadBasic.All, User.Read.All, Directory.Read.All |
|Delegated (personal Microsoft account) | Not supported. |
-|Application | User.Read.All and GroupMember.Read.All, User.Read.All and Group.Read.All, Directory.Read.All |
+|Application | User.Read.All, Directory.Read.All |
Use the follow scenario guidance to help determine which permission types to use: - Use User.Read and GroupMember.Read.All or User.Read and Group.Read.All permissions to get group memberships for the signed-in user.
v1.0 Drive Post Bundles https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/drive-post-bundles.md
- Title: Create bundle description: Create a bundle of driveItems localization_priority: Normal
v1.0 Driveitem Unfollow https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/driveitem-unfollow.md
- description: Unfollow an item that the user is following. Title: Unfollow drive item localization_priority: Normal
v1.0 Dynamics Agedaccountsreceivable Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/dynamics-agedaccountsreceivable-get.md
documentationcenter: '' localization_priority: Normal- doc_type: apiPageType ms.prod: "dynamics-365-business-central"
v1.0 Educationassignmentdefaults Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationassignmentdefaults-get.md
+
+ Title: "Get educationAssignmentDefaults"
+description: "Read the properties and relationships of an educationAssignmentDefaults object."
+
+localization_priority: Normal
++
+# Get educationAssignmentDefaults
+Namespace: microsoft.graph
++
+Read the properties and relationships of an [educationAssignmentDefaults](../resources/educationassignmentdefaults.md) object. These are the class-level assignment defaults respected by new assignments created in the class. Callers can continue to specify custom values on each assignment creation if they do not want the default behaviors.
+
+## 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)| EduAssignments.ReadBasic, EduAssignments.ReadWriteBasic, EduAssignments.Read, EduAssignments.ReadWrite |
+|Delegated (personal Microsoft account)| Not supported. |
+|Application| Not supported. |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /education/classes/{id}/assignmentDefaults
+```
+
+## 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 an [educationAssignmentDefaults](../resources/educationassignmentdefaults.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_educationassignmentdefaults"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/education/classes/{id}/assignmentDefaults
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationAssignmentDefaults"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": {
+ "addedStudentAction": "none",
+ "dueTime": "23:59:00",
+ "notificationChannelUrl": "https://graph.microsoft.com/beta/teams('id')/channels('id')"
+ }
+}
+```
+
v1.0 Educationassignmentdefaults Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationassignmentdefaults-update.md
+
+ Title: "Update educationAssignmentDefaults"
+description: "Update the properties of an educationAssignmentDefaults object."
+
+localization_priority: Normal
++
+# Update educationAssignmentDefaults
+Namespace: microsoft.graph
++
+Update the properties of an [educationAssignmentDefaults](../resources/educationassignmentdefaults.md) object. Only teachers can update these settings.
+
+## 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) | EduAssignments.ReadWriteBasic, EduAssignments.ReadWrite |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /education/classes/{id}/assignmentDefaults
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply the values for relevant fields of the [educationAssignmentDefaults](../resources/educationassignmentdefaults.md) object that should be updated. Existing properties that are not included in the request body will maintain their previous values. For best performance, don't include existing values that haven't changed.
+
+|Property|Type|Description|
+|:|:|:|
+|addedStudentAction|educationAddedStudentAction|Class-level default behavior for handling students who are added after the assignment is published. Possible values are: `none`, `assignIfOpen`. The default value is `none`.|
+|dueTime|TimeOfDay|Class-level default value for due time field. Default value is `23:59:00`|
+|notificationChannelUrl|String|Default Teams channel to which notifications will be sent. Default value is `null`.|
+++
+## Response
+
+If successful, this method returns a `200 OK` response code and an updated [educationAssignmentDefaults](../resources/educationassignmentdefaults.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "update_educationassignmentdefaults"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/education/classes/{id}/assignmentDefaults
+Content-Type: application/json
+Content-length: 181
+
+{
+ "addedStudentAction": "assignIfOpen",
+ "notificationChannelUrl": "https://graph.microsoft.com/beta/teams('id')/channels('id')"
+}
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationAssignmentDefaults"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "addedStudentAction": "assignIfOpen",
+ "dueTime": "23:59:00",
+ "notificationChannelUrl": "https://graph.microsoft.com/beta/teams('id')/channels('id')"
+}
+```
+
v1.0 Educationassignmentsettings Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationassignmentsettings-get.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|EduAssignments.ReadWriteBasic, EduAssignments.ReadWrite|
+|Delegated (work or school account)|EduAssignments.ReadBasic, EduAssignments.ReadWriteBasic, EduAssignments.Read, EduAssignments.ReadWrite|
|Delegated (personal Microsoft account)|Not supported.| |Application|Not supported.|
v1.0 Educationclass List Assignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationclass-list-assignments.md
Content-length: 344
"value": [ { "id": "19002",
- "addedStudentAction": "String",
+ "addedStudentAction": "none",
"allowLateSubmissions": true, "allowStudentsToAddResourcesToSubmission": true, "assignDateTime": "2014-02-01T00:00:00Z",
Content-length: 344
} }, "lastModifiedDateTime": "2014-02-01T00:00:00Z",
- "notificationChannelUrl": "String",
+ "notificationChannelUrl": null,
"status": "published" } ]
v1.0 Educationsubmission List Submittedresources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationsubmission-list-submittedresources.md
Content-length: 1045
"displayName": null } },
- "link": "https://www.microsoft.com
- },
- "@odata.type": "microsoft.graph.educationSubmittedSubmissionResource"
+ "link": "https://www.microsoft.com"
+ },
+ "@odata.type": "microsoft.graph.educationSubmittedSubmissionResource"
} ] }
Content-length: 1045
"tocPath": "", "suppressions": [] }>
+-->
v1.0 Entitlementmanagementsettings Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/entitlementmanagementsettings-get.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
## HTTP request
v1.0 Entitlementmanagementsettings Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/entitlementmanagementsettings-update.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) | EntitlementManagement.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | Not supported. |
+|Application | EntitlementManagement.ReadWrite.All |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Fido2authenticationmethod Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/fido2authenticationmethod-get.md
For delegated scenarios where an admin is acting on another user, the admin need
} --> ``` http
-GET /me/authentication/fido2AuthenticationMethod/{id}
-GET /users/{id | userPrincipalName}/authentication/fido2AuthenticationMethod/{id}
+GET /me/authentication/fido2Methods/{id}
+GET /users/{id | userPrincipalName}/authentication/fido2Methods/{id}
``` ## Request headers
If successful, this method returns a `200 OK` response code and the requested [f
### Request
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_fido2authenticationmethod" } --> ``` http
-GET https://graph.microsoft.com/beta/me/authentication/fido2AuthenticationMethod/-2_GRUg2-HYz6_1YG4YRAQ2
+GET https://graph.microsoft.com/beta/me/authentication/fido2Methods/-2_GRUg2-HYz6_1YG4YRAQ2
```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
---- ### Response The following is an example of the response.
v1.0 Group List Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-list-members.md
One of the following permissions is required to call this API. To learn more, in
| Permission type | Permissions (from least to most privileged) | |: |:- |
-| Delegated (work or school account) | Group.Read.All, Directory.Read.All |
+| Delegated (work or school account) | GroupMember.Read.All, Group.Read.All, GroupMember.ReadWrite.All, Group.ReadWrite.All, Directory.Read.All |
| Delegated (personal Microsoft account) | Not supported. |
-| Application | Group.Read.All, Directory.Read.All |
+| Application | GroupMember.Read.All, Group.Read.All, GroupMember.ReadWrite.All, Group.ReadWrite.All, Directory.Read.All |
> **Note:** To list the members of a hidden membership group, the Member.Read.Hidden permission is required.
v1.0 Group List Owners https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-list-owners.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | Group.Read.All and User.ReadBasic.All, Group.Read.All and User.Read.All, Group.Read.All and User.ReadWrite.All, Group.Read.All and User.Read.All and Application.Read.All |
+|Delegated (work or school account) | GroupMember.Read.All, Group.Read.All, GroupMember.ReadWrite.All, Group.ReadWrite.All, Directory.Read.All, Directory.AccessAsUser.All |
|Delegated (personal Microsoft account) | Not supported. |
-|Application | Group.Read.All and User.Read.All, Group.Read.All and User.ReadWrite.All, Group.Read.All and User.Read.All and Application.Read.All |
+|Application | GroupMember.Read.All, Group.Read.All, GroupMember.ReadWrite.All, Group.ReadWrite.All, Directory.Read.All, Directory.AccessAsUser.All |
[!INCLUDE [limited-info](../../includes/limited-info.md)]
v1.0 Group List Transitivemembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-list-transitivemembers.md
One of the following permissions is required to call this API. To learn more, in
| Permission type | Permissions (from least to most privileged) | |: |:- |
-| Delegated (work or school account) | Directory.Read.All, Directory.AccessAsUser.All, User.ReadBasic.All, User.Read.All |
+| Delegated (work or school account) | GroupMember.Read.All, Group.Read.All, GroupMember.ReadWrite.All, Group.ReadWrite.All, Directory.Read.All, Directory.AccessAsUser.All |
| Delegated (personal Microsoft account) | Not supported. |
-| Application | Directory.Read.All, User.Read.All |
+| Application | GroupMember.Read.All, Group.Read.All, GroupMember.ReadWrite.All, Group.ReadWrite.All, Directory.Read.All |
> **Note:** To list the members of a hidden membership group, the Member.Read.Hidden permission is required.
v1.0 Identitycontainer Post B2cuserflows https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/identitycontainer-post-b2cuserflows.md
Content-type: application/json
"section": "documentation", "tocPath": "", "suppressions": [
- "Error: create_b2cUserFlow_from_b2cUserFlows/userFlowTypeVersion:\r\n Expected type Single but actual was Int64. Property: userFlowTypeVersion, actual value: '1'",
- "Error: create_b2cUserFlow_from_b2cUserFlows_identityProviders/userFlowTypeVersion:\r\n Expected type Single but actual was Int64. Property: userFlowTypeVersion, actual value: '1'",
"Error: create_b2cUserFlow_from_b2cuserflows_apiconnectors/userFlowTypeVersion:\r\n Expected type Single but actual was Int64. Property: userFlowTypeVersion, actual value: '1'" ] }-->
v1.0 Identityuserflow Post Userflows https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/identityuserflow-post-userflows.md
POST https://graph.microsoft.com/beta/identity/userFlows
Content-type: application/json {
+ "id": "Pol1",
"userFlowType": "signUpOrSignIn", "userFlowTypeVersion": 1 }
v1.0 Onlinemeeting Createorget https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/onlinemeeting-createorget.md
One of the following permissions is required to call this API. To learn more, in
> \* Administrators must create an [application access policy](/graph/cloud-communication-online-meeting-application-access-policy) and grant it to a user, authorizing the app configured in the policy to create or get an online meeting with external ID on behalf of that user (user ID specified in the request path). ## HTTP request-
-Request when using a delegated token:
+To call **createOrGet** API with delegated token:
<!-- { "blockType": "ignored" } --> ```http POST /me/onlineMeetings/createOrGet ```
-Request when using an application token:
+To call **createOrGet** API with application token:
<!-- { "blockType": "ignored" } --> ```http POST /users/{userId}/onlineMeetings/createOrGet
v1.0 Onlinemeeting Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/onlinemeeting-delete.md
DELETE https://graph.microsoft.com/beta/users/{userId}/onlineMeetings/{meetingId
> **Note:** > > - `userId` is the object ID of a user in [Azure user management portal](https://portal.azure.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). For more details, see [application access policy](/graph/cloud-communication-online-meeting-application-access-policy).
-> - `meetingId` is the **id** of an [onlineMeeting entity](../resources/onlinemeeting.md).
+> - `meetingId` is the **id** of an [onlineMeeting](../resources/onlinemeeting.md) object.
## Request headers | Name | Description |
v1.0 Onlinemeeting Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/onlinemeeting-get.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request
-To get the specified onlineMeeting using meeting ID:
+To get the specified onlineMeeting using meeting ID with delegated permission:
<!-- { "blockType": "ignored" } --> ```http GET /me/onlineMeetings/{meetingId}
+```
+
+To get the specified onlineMeeting using meeting ID with application permission:
+<!-- { "blockType": "ignored" } -->
+```http
GET /users/{userId}/onlineMeetings/{meetingId} ``` To get the specified onlineMeeting using **videoTeleconferenceId**: <!-- { "blockType": "ignored" } --> ```http
-GET /app/onlineMeetings/?$filter=VideoTeleconferenceId%20eq%20'{id}'
-GET /communications/onlineMeetings/?$filter=VideoTeleconferenceId%20eq%20'{id}'
+GET /app/onlineMeetings/?$filter=VideoTeleconferenceId%20eq%20'{videoTeleconferenceId}'
+GET /communications/onlineMeetings/?$filter=VideoTeleconferenceId%20eq%20'{videoTeleconferenceId}'
``` To get the specified onlineMeeting using **joinWebUrl**:
GET /users/{userId}/onlineMeetings/{meetingId}/alternativeRecording
>**Notes:** >- The `/app` path is deprecated. Going forward, use the `/communications` path.
->- `id` in the first two routes refers to [VTC conference id](/microsoftteams/cloud-video-interop-for-teams-set-up).
>- `userId` is the object ID of a user in [Azure user management portal](https://portal.azure.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). For more details, see [application access policy](/graph/cloud-communication-online-meeting-application-access-policy).
->- `meetingId` is the **id** of an [onlineMeeting entity](../resources/onlinemeeting.md).
+>- `meetingId` is the **id** of an [onlineMeeting](../resources/onlinemeeting.md) object.
+> - **videoTeleconferenceId** is generated for Cloud-Video-Interop licensed users and can be found in an [onlineMeeting](../resources/onlinemeeting.md) object. Refer to [VTC conference id](/microsoftteams/cloud-video-interop-for-teams-set-up) for more details.
>- `joinWebUrl` must be URL encoded and this route can only be used to retrieve meetings created by `userId`. ## Optional query parameters
Content-Length: 1574
``` ### Example 2: Retrieve an online meeting by meeting ID
-You can retrieve meeting information via meeting ID with either a user or application token. The meeting ID is provided in the response object when creating an [onlineMeeting](../resources/onlinemeeting.md). This option is available to support use cases where the meeting ID is known, such as when an application first creates the meeting, then retrieves meeting information later as a seperate action.
+You can retrieve meeting information via meeting ID with either a user or application token. The meeting ID is provided in the response object when creating an [onlineMeeting](../resources/onlinemeeting.md). This option is available to support use cases where the meeting ID is known, such as when an application first creates the online meeting using Graph API first then retrieves meeting information later as a separate action.
#### Request
+> **Note:** The meeting ID has been truncated for readability.
+ The following request uses a user token. <!-- { "blockType": "ignored" } --> ```http
-GET https://graph.microsoft.com/betQyNTEtNTQ2NS00YjQxLTlkM2EtZWVkODYxODYzMmY2@thread.v2
+GET https://graph.microsoft.com/beta/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZiMi04ZdFpHRTNaR1F6WGhyZWFkLnYy
``` The following request uses an app token. <!-- { "blockType": "ignored" } --> ```http
-GET https://graph.microsoft.com/betQyNTEtNTQ2NS00YjQxLTlkM2EtZWVkODYxODYzMmY2@thread.v2
+GET https://graph.microsoft.com/beta/users/dc17674c-81d9-4adb-bfb2-8f6a442e4622/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZiMi04ZdFpHRTNaR1F6WGhyZWFkLnYy
``` #### Response
GET https://graph.microsoft.com/beta/users/dc17674c-81d9-4adb-bfb2-8f6a442e4622/
```json {
- "id": "dc17674c-81d9-4adb-bfb2-8f6a442e4622_19:meeting_MGQ4MDQyNTEtNTQ2NS00YjQxLTlkM2EtZWVkODYxODYzMmY2@thread.v2",
+ "id": "MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZiMi04ZdFpHRTNaR1F6WGhyZWFkLnYy",
"creationDateTime": "2020-09-29T22:35:33.1594516Z", "startDateTime": "2020-09-29T22:35:31.389759Z", "endDateTime": "2020-09-29T23:35:31.389759Z",
v1.0 Onlinemeeting Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/onlinemeeting-update.md
Update the **startDateTime**, **endDateTime**, **participants**, and **subject**
> \* Administrators must create an [application access policy](/graph/cloud-communication-online-meeting-application-access-policy) and grant it to a user, authorizing the app configured in the policy to update an online meeting on behalf of that user (user ID specified in the request path). ## HTTP request-
-Request using a delegated token:
+To update the specified onlineMeeting by meeting ID with delegated token:
<!-- { "blockType": "ignored" } --> ```http
-PATCH https://graph.microsoft.com/beta/me/onlineMeetings/{meetingId}
+PATCH /me/onlineMeetings/{meetingId}
```
-Request using an application token:
+To update the specified onlineMeeting by meeting ID with application token:
<!-- { "blockType": "ignored" } --> ```http
-PATCH https://graph.microsoft.com/beta/users/{userId}/onlineMeetings/{meetingId}
+PATCH /users/{userId}/onlineMeetings/{meetingId}
``` > **Notes:**
->
> - `userId` is the object ID of a user in [Azure user management portal](https://portal.azure.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). For more details, see [application access policy](/graph/cloud-communication-online-meeting-application-access-policy).
-> - `meetingId` is the **id** of an [onlineMeeting entity](../resources/onlinemeeting.md).
+> - `meetingId` is the **id** of an [onlineMeeting](../resources/onlinemeeting.md) object.
## Request headers | Name | Description |
v1.0 Openshiftchangerequest Approve https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/openshiftchangerequest-approve.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-POST /teams/{id}/schedule/openShiftsChangeRequests/{openShiftChangeRequestId}/approve
+POST /teams/{id}/schedule/openShiftChangeRequests/{openShiftChangeRequestId}/approve
``` ## Request headers
The following is an example of a request.
}--> ```http
-POST https://graph.microsoft.com/beta/teams/{id}/schedule/openShiftsChangeRequests/{openShiftChangeRequestId}/approve
+POST https://graph.microsoft.com/beta/teams/{id}/schedule/openShiftChangeRequests/{openShiftChangeRequestId}/approve
Content-type: application/json {
v1.0 Openshiftchangerequest Decline https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/openshiftchangerequest-decline.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-POST /teams/{id}/schedule/openShiftsChangeRequests/{openShiftChangeRequestId}/decline
+POST /teams/{id}/schedule/openShiftChangeRequests/{openShiftChangeRequestId}/decline
``` ## Request headers
The following is an example of the request.
}--> ```http
-POST https://graph.microsoft.com/beta/teams/{id}/schedule/openShiftsChangeRequests/{openShiftChangeRequestId}/decline
+POST https://graph.microsoft.com/beta/teams/{id}/schedule/openShiftChangeRequests/{openShiftChangeRequestId}/decline
Content-type: application/json {
v1.0 Openshiftchangerequest Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/openshiftchangerequest-get.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-GET /teams/{id}/schedule/openShiftsChangeRequests/{openShiftsChangeRequestId}
+GET /teams/{id}/schedule/openShiftChangeRequests/{openShiftsChangeRequestId}
``` ## Optional query parameters
The following is an example of the request.
}--> ```http
-GET https://graph.microsoft.com/beta/teams/{id}/schedule/openShiftsChangeRequests/SREQ_0b87dd20-d5ed-4764-9c3e-cfc8516def09
+GET https://graph.microsoft.com/beta/teams/{id}/schedule/openShiftChangeRequests/SREQ_0b87dd20-d5ed-4764-9c3e-cfc8516def09
``` ### Response
v1.0 Openshiftchangerequest List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/openshiftchangerequest-list.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-GET /teams/{id}/schedule/openShiftsChangeRequests
+GET /teams/{id}/schedule/openShiftChangeRequests
``` ## Optional query parameters
The following is an example of the request.
}--> ```http
-GET https://graph.microsoft.com/beta/teams/{id}/schedule/openShiftsChangeRequests
+GET https://graph.microsoft.com/beta/teams/{id}/schedule/openShiftChangeRequests
``` ### Response
v1.0 Openshiftchangerequest Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/openshiftchangerequest-post.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-POST /teams/{id}/schedule/openShiftsChangeRequests
+POST /teams/{id}/schedule/openShiftChangeRequests
``` ## Optional query parameters
The following is an example of the request.
}--> ```http
-POST https://graph.microsoft.com/beta/teams/788b75d2-a911-48c0-a5e2-dc98480457e3/schedule/openShiftsChangeRequests
+POST https://graph.microsoft.com/beta/teams/788b75d2-a911-48c0-a5e2-dc98480457e3/schedule/openShiftChangeRequests
Authorization: Bearer {token} Content-type: application/json Content-length: 244
v1.0 Participant Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/participant-delete.md
Title: "Delete participant"
description: "Delete a specific participant in a call." - localization_priority: Normal ms.prod: "cloud-communications" doc_type: apiPageType
v1.0 Participant Invite https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/participant-invite.md
With tenant admin credentials, call the following cmdlets on the tenant remote P
PS C:\> Set-CsOnlineVoiceApplicationInstance -Identity <UPN> -TelephoneNumber <TelephoneNumber> PS C:\> Sync-CsOnlineApplicationInstance -ObjectId <ObjectId> ```
-> **Note:** If a tenant has Australian PSTN numbers assigned to any application instances, this call might fail. If a tenant is newly created, it might take several days for this feature to be available.
#### Request
v1.0 Permission Grant https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/permission-grant.md
- Title: Grant permission description: Grant a list of users access to use the specified link localization_priority: Normal
v1.0 Personresponsibility Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/personresponsibility-delete.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-DELETE /me/profile/responsibilities/{id}
-DELETE /users/{id | userPrincipalName}/profile/responsibilities/{id}
+DELETE /me/responsibilities/{id}
+DELETE /users/{id | userPrincipalName}/responsibilities/{id}
``` ## Request headers
If successful, this method returns a `204 No Content` response code.
} --> ``` http
-DELETE https://graph.microsoft.com/beta/me/profile/responsibilities/0fb4c1e3-c1e3-0fb4-e3c1-b40fe3c1b40f
+DELETE https://graph.microsoft.com/beta/me/responsibilities/0fb4c1e3-c1e3-0fb4-e3c1-b40fe3c1b40f
``` ### Response
v1.0 Personresponsibility Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/personresponsibility-get.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-GET /me/profile/responsibilities/{id}
-GET /users/{id | userPrincipalName}/profile/responsibilities/{id}
+GET /me/responsibilities/{id}
+GET /users/{id | userPrincipalName}/responsibilities/{id}
``` ## Optional query parameters
If successful, this method returns a `200 OK` response code and a [personRespons
## Examples ### Request
-# [HTTP](#tab/http)
+ <!-- { "blockType": "request", "sampleKeys": ["0fb4c1e3-c1e3-0fb4-e3c1-b40fe3c1b40f"],
If successful, this method returns a `200 OK` response code and a [personRespons
} --> ``` http
-GET https://graph.microsoft.com/beta/me/profile/responsibilities/0fb4c1e3-c1e3-0fb4-e3c1-b40fe3c1b40f
+GET https://graph.microsoft.com/beta/me/responsibilities/0fb4c1e3-c1e3-0fb4-e3c1-b40fe3c1b40f
```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-- ### Response **Note:** The response object shown here might be shortened for readability.
v1.0 Personresponsibility Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/personresponsibility-update.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-PATCH /me/profile/responsibilities/{id}
-PATCH /users/{id | userPrincipalName}/profile/responsibilities/{id}
+PATCH /me/responsibilities/{id}
+PATCH /users/{id | userPrincipalName}/responsibilities/{id}
``` ## Request headers
If successful, this method returns a `200 OK` response code and an updated [pers
## Examples ### Request
-# [HTTP](#tab/http)
+ <!-- { "blockType": "request", "sampleKeys": ["0fb4c1e3-c1e3-0fb4-e3c1-b40fe3c1b40f"],
If successful, this method returns a `200 OK` response code and an updated [pers
} --> ``` http
-PATCH https://graph.microsoft.com/beta/me/profile/responsibilities/0fb4c1e3-c1e3-0fb4-e3c1-b40fe3c1b40f
+PATCH https://graph.microsoft.com/beta/me/responsibilities/0fb4c1e3-c1e3-0fb4-e3c1-b40fe3c1b40f
Content-Type: application/json Content-length: 446
Content-length: 446
] } ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-- ### Response **Note:** The response object shown here might be shortened for readability.
v1.0 Place List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/place-list.md
Content-type: application/json
"section": "documentation", "tocPath": "", "suppressions": [
- "Error: Malformed function params 'id-of-roomlist'"
] }-->
v1.0 Planner Post Rosters https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/planner-post-rosters.md
+
+ Title: "Create plannerRoster"
+description: "Create a new plannerRoster object."
+
+localization_priority: Normal
++
+# Create plannerRoster
+Namespace: microsoft.graph
++
+Create a new [plannerRoster](../resources/plannerroster.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)|Tasks.ReadWrite|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /planner/rosters
+```
+
+## 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 [plannerRoster](../resources/plannerroster.md) object.
+
+There are no writable properties on [plannerRoster](../resources/plannerroster.md).
+
+## Response
+
+If successful, this method returns a `201 Created` response code and a [plannerRoster](../resources/plannerroster.md) object in the response body.
+
+## Examples
+
+### Request
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "create_plannerroster_from_"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/planner/rosters
+Content-Type: application/json
+Content-length: 55
+
+{
+ "@odata.type": "#microsoft.graph.plannerRoster"
+}
+```
+# [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.plannerRoster"
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.plannerRoster",
+ "id": "6519868f-868f-6519-8f86-19658f861965"
+}
+```
+
v1.0 Plannerroster Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/plannerroster-delete.md
+
+ Title: "Delete plannerRoster"
+description: "Deletes a plannerRoster object."
+
+localization_priority: Normal
++
+# Delete plannerRoster
+Namespace: microsoft.graph
++
+Delete a [plannerRoster](../resources/plannerroster.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)|Tasks.ReadWrite|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /planner/rosters/{plannerRosterId}
+```
+
+## 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
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "delete_plannerroster"
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/beta/planner/rosters/5ba84f7a-aa11-4a51-a298-9f2c7ec6bb38
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++++
+### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Plannerroster Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/plannerroster-get.md
+
+ Title: "Get plannerRoster"
+description: "Read the properties and relationships of a plannerRoster object."
+
+localization_priority: Normal
++
+# Get plannerRoster
+Namespace: microsoft.graph
++
+Read the properties and relationships of a [plannerRoster](../resources/plannerroster.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)|Tasks.Read, Tasks.ReadWrite|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /planner/rosters/{plannerRosterId}
+```
+
+## Optional query parameters
+This method only supports following OData query parameters:
+
+- $expand
+
+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 [plannerRoster](../resources/plannerroster.md) object in the response body.
+
+## Examples
+
+### Request
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_plannerroster"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/planner/rosters/6519868f-868f-6519-8f86-19658f861965
+```
+# [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.plannerRoster"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": {
+ "@odata.type": "#microsoft.graph.plannerRoster",
+ "id": "6519868f-868f-6519-8f86-19658f861965"
+ }
+}
+```
+
v1.0 Plannerroster List Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/plannerroster-list-members.md
+
+ Title: "List members of a roster"
+description: "Get the plannerRosterMember resources from the members navigation property."
+
+localization_priority: Normal
++
+# List members of a roster
+Namespace: microsoft.graph
++
+Get the list of [plannerRosterMembers](../resources/plannerrostermember.md) from a [plannerRoster](../resources/plannerroster.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)|Tasks.Read, Tasks.ReadWrite|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /planner/rosters/{plannerRosterId}/members
+```
+
+## Optional query parameters
+This method only supports following OData query parameters:
+
+- $select
+
+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 [plannerRosterMember](../resources/plannerrostermember.md) objects in the response body.
+
+## Examples
+
+### Request
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "list_plannerrostermember"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/planner/rosters/6519868f-868f-6519-8f86-19658f861965/members
+```
+# [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": "Collection(microsoft.graph.plannerRosterMember)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.plannerRosterMember",
+ "id": "670095cd-95cd-6700-cd95-0067cd950067",
+ "userId": "5ba84f7a-aa11-4a51-a298-9f2c7ec6bb38",
+ "tenantId": "7084c257-c1b7-4286-98b0-20ea7b5c1319",
+ "roles": [
+ ]
+ }
+ ]
+}
+```
+
v1.0 Plannerroster List Plans https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/plannerroster-list-plans.md
+
+ Title: "List plans"
+description: "Get the plannerPlan resources from the plans navigation property."
+
+localization_priority: Normal
++
+# List plans
+Namespace: microsoft.graph
++
+Get the [plannerPlans](../resources/plannerplan.md) contained by the [plannerRoster](../resources/plannerRoster.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)|Tasks.Read, Tasks.ReadWrite|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /planner/rosters/{plannerRosterId}/plans
+```
+
+## Optional query parameters
+This method only supports following OData query parameters:
+
+- $select
+
+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 [plannerPlan](../resources/plannerplan.md) objects in the response body.
+
+## Examples
+
+### Request
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "list_plannerplan"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/planner/rosters/6519868f-868f-6519-8f86-19658f861965/plans
+```
+# [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": "Collection(microsoft.graph.plannerPlan)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.plannerPlan",
+ "id": "c6442b38-2b38-c644-382b-44c6382b44c6",
+ "createdBy": {
+ "@odata.type": "microsoft.graph.identitySet"
+ },
+ "title": "Test plan",
+ "container": {
+ "@odata.type": "microsoft.graph.plannerPlanContainer",
+ "url": "https://graph.microsoft.com/beta/planner/rosters/6519868f-868f-6519-8f86-19658f861965",
+ "containerId": "6519868f-868f-6519-8f86-19658f861965",
+ "type": "roster"
+ }
+ }
+ ]
+}
+```
+
v1.0 Plannerroster Post Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/plannerroster-post-members.md
+
+ Title: "Create plannerRosterMember"
+description: "Create a new plannerRosterMember object."
+
+localization_priority: Normal
++
+# Create plannerRosterMember
+Namespace: microsoft.graph
++
+Add a member to the [plannerRoster](../resources/plannerrostermember.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)|Tasks.ReadWrite|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /planner/rosters/{plannerRosterId}/members
+```
+
+## 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 [plannerRosterMember](../resources/plannerrostermember.md) object.
+
+The following table shows the properties that are required when you create the [plannerRosterMember](../resources/plannerrostermember.md).
+
+|Property|Type|Description|
+|:|:|:|
+|userId|String|Identifier of the .|
+|tenantId|String|Identifier of the tenant the user belongs to. Optional. Currently roster members cannot be from different tenants.|
+|roles|String collection|Additional roles assigned to the user. Optional. Currently there are no additional roles available for users.|
+++
+## Response
+
+If successful, this method returns a `201 Created` response code and a [plannerRosterMember](../resources/plannerrostermember.md) object in the response body.
+
+## Examples
+
+### Request
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "create_plannerrostermember_from_"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/planner/rosters/6519868f-868f-6519-8f86-19658f861965/members
+Content-Type: application/json
+Content-length: 78
+
+{
+ "@odata.type": "#microsoft.graph.plannerRosterMember",
+ "userId": "String"
+}
+```
+# [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.plannerRosterMember"
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.plannerRosterMember",
+ "id": "670095cd-95cd-6700-cd95-0067cd950067",
+ "userId": "5ba84f7a-aa11-4a51-a298-9f2c7ec6bb38",
+ "roles": [
+ ]
+}
+```
+
v1.0 Plannerrostermember Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/plannerrostermember-delete.md
+
+ Title: "Delete plannerRosterMember"
+description: "Deletes a plannerRosterMember object."
+
+localization_priority: Normal
++
+# Delete plannerRosterMember
+Namespace: microsoft.graph
++
+Delete a [plannerRosterMember](../resources/plannerrostermember.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)|Tasks.ReadWrite|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /planner/rosters/{plannerRosterId}/members/{plannerRosterMemberId}
+```
+
+## 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
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "delete_plannerrostermember"
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/beta/planner/rosters/523a9d5a-f9d5-45c1-929f-b8525393515c/members/5ba84f7a-aa11-4a51-a298-9f2c7ec6bb38
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++++
+### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Plannerrostermember Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/plannerrostermember-get.md
+
+ Title: "Get plannerRosterMember"
+description: "Read the properties and relationships of a plannerRosterMember object."
+
+localization_priority: Normal
++
+# Get plannerRosterMember
+Namespace: microsoft.graph
++
+Read the properties and relationships of a [plannerRosterMember](../resources/plannerrostermember.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)|Tasks.Read, Tasks.ReadWrite|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /planner/rosters/{plannerRosterId}/members/{plannerRosterMemberId}
+```
+
+## Optional query parameters
+This method only supports following OData query parameters:
+
+- $select
+
+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 [plannerRosterMember](../resources/plannerrostermember.md) object in the response body.
+
+## Examples
+
+### Request
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_plannerrostermember"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/planner/rosters/523a9d5a-f9d5-45c1-929f-b8525393515c/members/5ba84f7a-aa11-4a51-a298-9f2c7ec6bb38
+```
+# [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.plannerRosterMember"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.plannerRosterMember",
+ "id": "670095cd-95cd-6700-cd95-0067cd950067",
+ "userId": "5ba84f7a-aa11-4a51-a298-9f2c7ec6bb38",
+ "tenantId": "7084c257-c1b7-4286-98b0-20ea7b5c1319",
+ "roles": [
+ ]
+}
+```
+
v1.0 Plannertask Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/plannertask-update.md
In the request body, supply the values for relevant fields that should be update
|dueDateTime|DateTimeOffset|Date and time at which the task is due. 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 would look like this: `'2014-01-01T00:00:00Z'`| |orderHint|String|Hint used to order items of this type in a list view. The format is defined as outlined [here](../resources/planner-order-hint-format.md).| |percentComplete|Int32|Percentage of task completion. When set to `100`, the task is considered completed. |
+|planId|String|Plan id to which the task belongs.|
|priority|Int32|Priority of the task. Valid range of values is between `0` and `10` (inclusive), with increasing value being lower priority (`0` has the highest priority and `10` has the lowest priority). Currently, Planner interprets values `0` and `1` as "urgent", `2` and `3` and `4` as "important", `5`, `6`, and `7` as "medium", and `8`, `9`, and `10` as "low". Currently, Planner sets the value `1` for "urgent", `3` for "important", `5` for "medium", and `9` for "low".| |startDateTime|DateTimeOffset|Date and time at which the task starts. 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 would look like this: `'2014-01-01T00:00:00Z'`| |title|String|Title of the task.|
v1.0 Planneruser List Rosterplans https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/planneruser-list-rosterplans.md
+
+ Title: "List rosterPlans"
+description: "Get the plannerPlan resources from the rosterPlans navigation property."
+
+localization_priority: Normal
++
+# List rosterPlans
+Namespace: microsoft.graph
++
+Get the list of [plannerPlans](../resources/plannerplan.md) that are contained by the [plannerRosters](../resources/plannerroster.md) of which the user is a member.
+
+## 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)|Tasks.Read, Tasks.ReadWrite|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /users/{usersId}/planner/rosterPlans
+```
+
+## Optional query parameters
+This method only supports following OData query parameters:
+
+- $select
+
+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 [plannerPlan](../resources/plannerplan.md) objects in the response body.
+
+## Examples
+
+### Request
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "list_plannerplan"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/users/{usersId}/planner/rosterPlans
+```
+# [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": "Collection(microsoft.graph.plannerPlan)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.plannerPlan",
+ "id": "c6442b38-2b38-c644-382b-44c6382b44c6",
+ "createdBy": {
+ "@odata.type": "microsoft.graph.identitySet"
+ },
+ "title": "Test plan",
+ "container": {
+ "@odata.type": "microsoft.graph.plannerPlanContainer",
+ "url": "https://graph.microsoft.com/beta/planner/rosters/5ba84f7a-aa11-4a51-a298-9f2c7ec6bb38",
+ "containerId": "5ba84f7a-aa11-4a51-a298-9f2c7ec6bb38",
+ "type": "roster"
+ }
+ }
+ ]
+}
+```
+
v1.0 Printershare Delete Alloweduser https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/printershare-delete-alloweduser.md
To use the Universal Print service, the user or app's tenant must have an active
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-DELETE /print/printerShare/{id}/allowedUsers/{id}/$ref
+DELETE /print/printerShares/{id}/allowedUsers/{id}/$ref
``` ## Request headers | Name | Description |
The following is an example of the request.
"name": "delete_alloweduser" }--> ```http
-DELETE https://graph.microsoft.com/beta/print/printerShare/{id}/allowedUsers/{id}/$ref
+DELETE https://graph.microsoft.com/beta/print/printerShares/{id}/allowedUsers/{id}/$ref
``` ### Response
v1.0 Profile List Accounts https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/profile-list-accounts.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-GET /me/profile/accounts
-GET /users/{id | userPrincipalName}/profile/accounts
+GET /me/profile/account
+GET /users/{id | userPrincipalName}/profile/account
``` ## Optional query parameters
If successful, this method returns a `200 OK` response code and a collection of
The following is an example of the request.
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_account" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/me/profile/accounts
+GET https://graph.microsoft.com/beta/me/profile/account
```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-- ### Response
v1.0 Profile List Responsibilities https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/profile-list-responsibilities.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-GET /me/profile/responsibilities
-GET /users/{id | userPrincipalName}/profile/responsibilities
+GET /me/responsibilities
+GET /users/{id | userPrincipalName}/responsibilities
``` ## Optional query parameters
If successful, this method returns a `200 OK` response code and a collection of
## Examples
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_responsibilities_from_profile" } --> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/me/profile/responsibilities
+GET https://graph.microsoft.com/beta/me/responsibilities
```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-- ### Response **Note:** The response object shown here might be shortened for readability.
v1.0 Profile Post Accounts https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/profile-post-accounts.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-POST /me/profile/accounts
-POST /users/{id | userPrincipalName}/profile/accounts
+POST /me/profile/account
+POST /users/{id | userPrincipalName}/profile/account
``` ## Request headers
If successful, this method returns a `201 Created` response code and a [userAcco
## Examples
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_useraccountinformation_from_profile" } --> ``` http
-POST https://graph.microsoft.com/beta/me/profile/accounts
+POST https://graph.microsoft.com/beta/me/profile/account
Content-Type: application/json Content-length: 494
Content-length: 494
"countryCode": "NO", } ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-- ### Response **Note:** The response object shown here might be shortened for readability.
v1.0 Profile Post Educationalactivities https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/profile-post-educationalactivities.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-POST /user/profile/educationalActivities
+POST /me/profile/educationalActivities
POST /users/{id | userPrincipalName}/profile/educationalActivities ```
v1.0 Profile Post Responsibilities https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/profile-post-responsibilities.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-POST /me/profile/responsibilities
-POST /users/{id | userPrincipalName}/profile/responsibilities
+POST /me/responsibilities
+POST /users/{id | userPrincipalName}/responsibilities
``` ## Request headers
If successful, this method returns a `201 Created` response code and a [personRe
## Examples
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_personresponsibility_from_profile" } --> ``` http
-POST https://graph.microsoft.com/beta/me/profile/responsibilities
+POST https://graph.microsoft.com/beta/me/responsibilities
Content-Type: application/json Content-length: 413
Content-length: 413
] } ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-- ### Response **Note:** The response object shown here might be shortened for readability.
v1.0 Riskyusers Dismiss https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/riskyusers-dismiss.md
Namespace: microsoft.graph
>**Note:** Using the riskyUsers API requires an Azure AD Premium P2 license.
-Dismiss the risk of one or more [riskyUser](../resources/riskyuser.md) objects. This action sets the targeted user's risk level to none.
+Dismiss the risk of one or more [riskyUser](../resources/riskyuser.md) objects. This action sets the targeted user's risk level to none. The maximum count of users to dismiss in one call is 60.
+ ## 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 Serviceprincipal Addkey https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceprincipal-addkey.md
The following is an example of the response.
<!-- { "blockType": "response",
- "truncated": true
+ "truncated": true,
+ "@odata.type": "microsoft.graph.keyCredential"
} --> ```http
Content-Type: application/json
"section": "documentation", "tocPath": "", "suppressions": [
- "Error: serviceprincipal_addkey:\r\n Resource type was null or missing, so we assume there is no response to validate."
- ]
+ ]
}-->
v1.0 Signin List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/signin-list.md
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and collection of [signIn](../resources/signin.md) objects in the response body.
+If successful, this method returns a `200 OK` response code and collection of [signIn](../resources/signin.md) objects in the response body. The collection of objects is listed in descending order based on **createdDateTime**.
## Examples
v1.0 Site Delete Permission https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/site-delete-permission.md
If successful, this method returns `204 No Content` response code. It does not r
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_permission"
If successful, this method returns `204 No Content` response code. It does not r
``` http DELETE https://graph.microsoft.com/beta/sites/{sitesId}/permissions/{permissionId} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Site Get Permission https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/site-get-permission.md
If successful, this method returns a `200 OK` response code and the [permission]
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_permission"
If successful, this method returns a `200 OK` response code and the [permission]
``` http GET https://graph.microsoft.com/beta/sites/{sitesId}/permissions/{permissionId} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
Content-Type: application/json
"type": "#page.annotation", "section": "documentation", "tocPath": "Sites/Permissions/Get site permission"
-} -->
+} -->
v1.0 Site List Permissions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/site-list-permissions.md
If successful, this method returns a `200 OK` response code and a collection of
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_permission"
If successful, this method returns a `200 OK` response code and a collection of
``` http GET https://graph.microsoft.com/beta/sites/{sitesId}/permissions ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
Content-Type: application/json
"type": "#page.annotation", "section": "documentation", "tocPath": "Sites/Permissions/List site permissions"
-} -->
+} -->
v1.0 Site Post Permissions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/site-post-permissions.md
If successful, this method returns a `201 Created` response code and a [permissi
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_permission_from_"
Content-Type: application/json
}] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Site Update Permission https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/site-update-permission.md
If successful, this method returns a `200 OK` response code and a [permission](.
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_permission_from_"
Content-Type: application/json
"roles": ["read"] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Smsauthenticationmethodconfiguration Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/smsauthenticationmethodconfiguration-delete.md
+
+ Title: "Delete smsAuthenticationMethodConfiguration"
+description: "Delete a smsAuthenticationMethodConfiguration object."
+
+localization_priority: Normal
++
+# Delete smsAuthenticationMethodConfiguration
+Namespace: microsoft.graph
++
+Remove changes made to the [Text Message authentication method policy](../resources/smsauthenticationmethodconfiguration.md) by reverting the policy to its default configuration.
+
+## 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)|Policy.ReadWrite.AuthenticationMethod|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Policy.ReadWrite.AuthenticationMethod|
+
+For delegated scenarios, the administrator needs the Global admin role. For more information, see [role](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles).
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/sms
+```
+
+## 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_smsauthenticationmethodconfiguration"
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/sms
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Smsauthenticationmethodconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/smsauthenticationmethodconfiguration-get.md
+
+ Title: "Get smsAuthenticationMethodConfiguration"
+description: "Read the properties and relationships of a smsAuthenticationMethodConfiguration object."
+
+localization_priority: Normal
++
+# Get smsAuthenticationMethodConfiguration
+Namespace: microsoft.graph
++
+Read the properties and relationships of a [smsAuthenticationMethodConfiguration](../resources/smsauthenticationmethodconfiguration.md) object, which represents the Text Message authentication method policy for the Azure AD tenant.
+
+## 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)|Policy.ReadWrite.AuthenticationMethod|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Policy.ReadWrite.AuthenticationMethod|
+
+For delegated scenarios, the administrator needs the Global admin role. For more information, see [role](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles).
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/sms
+```
+
+## 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 [smsAuthenticationMethodConfiguration](../resources/smsauthenticationmethodconfiguration.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_smsauthenticationmethodconfiguration"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/sms
+```
+
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.smsAuthenticationMethodConfiguration"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": {
+ "@odata.type": "#microsoft.graph.smsAuthenticationMethodConfiguration",
+ "id": "713980c7-80c7-7139-c780-3971c7803971",
+ "state": "String"
+ }
+}
+```
+
v1.0 Smsauthenticationmethodconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/smsauthenticationmethodconfiguration-update.md
+
+ Title: "Update smsAuthenticationMethodConfiguration"
+description: "Update the properties of a smsAuthenticationMethodConfiguration object."
+
+localization_priority: Normal
++
+# Update smsAuthenticationMethodConfiguration
+Namespace: microsoft.graph
++
+Update the properties of a [smsAuthenticationMethodConfiguration](../resources/smsauthenticationmethodconfiguration.md) object, which represents the Text Message authentication method policy for the Azure AD tenant.
+
+## 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)|Policy.ReadWrite.AuthenticationMethod|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Policy.ReadWrite.AuthenticationMethod|
+
+For delegated scenarios, the administrator needs the Global admin role. For more information, see [role](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles).
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/sms
+```
+
+## 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 [smsAuthenticationMethodConfiguration](../resources/smsauthenticationmethodconfiguration.md) object with the values of fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+
+The following table shows the properties that are required when you update the [smsAuthenticationMethodConfiguration](../resources/smsauthenticationmethodconfiguration.md) object.
+
+|Property|Type|Description|
+|:|:|:|
+|id|String|The authentication method policy identifier.|
+|state|authenticationMethodState|Possible values are: `enabled`, `disabled`.|
+
+>**Note:** The `@odata.type` property with a value of `#microsoft.graph.smsAuthenticationMethodConfiguration` must be included in the body.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and an updated [smsAuthenticationMethodConfiguration](../resources/smsauthenticationmethodconfiguration.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "update_smsauthenticationmethodconfiguration"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/sms
+Content-Type: application/json
+Content-length: 100
+
+{
+ "@odata.type": "#microsoft.graph.smsAuthenticationMethodConfiguration",
+ "id": "Sms",
+ "state": "enabled"
+}
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.smsAuthenticationMethodConfiguration"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.smsAuthenticationMethodConfiguration",
+ "id": "713980c7-80c7-7139-c780-3971c7803971",
+ "state": "String"
+}
+```
+
v1.0 Subscriptions Socketio https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/subscriptions-socketio.md
- Title: "Get websocket endpoint" description: "Use of these APIs in production applications is not supported." localization_priority: Normal
v1.0 Synchronization Synchronization Acquireaccesstoken https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/synchronization-synchronization-acquireaccesstoken.md
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account)|Directory.ReadWrite.All| |Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
+|Application|Application.ReadWrite.OwnedBy, Directory.ReadWrite.All|
## HTTP request
v1.0 Synchronization Synchronizationjob Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/synchronization-synchronizationjob-delete.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) |Directory.ReadWrite.All | |Delegated (personal Microsoft account) |Not supported. |
-|Application |Not supported. |
+|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
## HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationjob Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/synchronization-synchronizationjob-get.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) |Directory.ReadWrite.All | |Delegated (personal Microsoft account) |Not supported. |
-|Application |Not supported. |
+|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
## HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationjob List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/synchronization-synchronizationjob-list.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) |Directory.ReadWrite.All | |Delegated (personal Microsoft account) |Not supported. |
-|Application |Not supported. |
+|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
## HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationjob Pause https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/synchronization-synchronizationjob-pause.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) |Directory.ReadWrite.All | |Delegated (personal Microsoft account) |Not supported. |
-|Application |Not supported. |
+|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
## HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationjob Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/synchronization-synchronizationjob-post.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) |Directory.ReadWrite.All | |Delegated (personal Microsoft account) |Not supported.|
-|Application |Not supported. |
+|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
## HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationjob Provision On Demand https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/synchronization-synchronizationjob-provision-on-demand.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) |Directory.ReadWrite.All | |Delegated (personal Microsoft account) |Not supported. |
-|Application |Not supported. |
+|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
## HTTP request
v1.0 Synchronization Synchronizationjob Restart https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/synchronization-synchronizationjob-restart.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) |Directory.ReadWrite.All | |Delegated (personal Microsoft account) |Not supported. |
-|Application |Not supported. |
+|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
## HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationjob Start https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/synchronization-synchronizationjob-start.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) |Directory.ReadWrite.All | |Delegated (personal Microsoft account) |Not supported. |
-|Application |Not supported. |
+|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
## HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationjob Validatecredentials https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/synchronization-synchronizationjob-validatecredentials.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) |Directory.ReadWrite.All | |Delegated (personal Microsoft account) |Not supported. |
-|Application |Not supported.|
+|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationschema Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/synchronization-synchronizationschema-delete.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) |Directory.ReadWrite.All | |Delegated (personal Microsoft account) |Not supported.|
-|Application |Not supported.|
+|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
## HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationschema Filteroperators https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/synchronization-synchronizationschema-filteroperators.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) |Directory.ReadWrite.All | |Delegated (personal Microsoft account) |Not supported.|
-|Application |Not supported. |
+|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
## HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationschema Functions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/synchronization-synchronizationschema-functions.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) |Directory.ReadWrite.All | |Delegated (personal Microsoft account) |Not supported.|
-|Application |Not supported. |
+|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
## HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationschema Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/synchronization-synchronizationschema-get.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) |Directory.ReadWrite.All | |Delegated (personal Microsoft account) |Not supported. |
-|Application |Not supported. |
+|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
## HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationschema Parseexpression https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/synchronization-synchronizationschema-parseexpression.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) |Directory.ReadWrite.All | |Delegated (personal Microsoft account) |Not supported.|
-|Application |Not supported.|
+|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationschema Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/synchronization-synchronizationschema-update.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) |Directory.ReadWrite.All | |Delegated (personal Microsoft account) |Not supported.|
-|Application |Not supported.|
+|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
## HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationtemplate Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/synchronization-synchronizationtemplate-get.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) |Directory.ReadWrite.All | |Delegated (personal Microsoft account) |Not supported.|
-|Application |Not supported.|
+|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
### HTTP Request
v1.0 Synchronization Synchronizationtemplate List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/synchronization-synchronizationtemplate-list.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) |Directory.ReadWrite.All | |Delegated (personal Microsoft account) |Not supported.|
-|Application |Not supported.|
+|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
### HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationtemplate Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/synchronization-synchronizationtemplate-post.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) |Directory.ReadWrite.All | |Delegated (personal Microsoft account) |Not supported.|
-|Application |Not supported.|
+|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
### HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Synchronization Synchronizationtemplate Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/synchronization-synchronizationtemplate-update.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) |Directory.ReadWrite.All | |Delegated (personal Microsoft account) |Not supported.|
-|Application |Not supported.|
+|Application |Application.ReadWrite.OwnedBy, Directory.ReadWrite.All |
### HTTP Request <!-- { "blockType": "ignored" } -->
v1.0 Temporaryaccesspassauthenticationmethod Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/temporaryaccesspassauthenticationmethod-delete.md
+
+ Title: "Delete temporaryAccessPassAuthenticationMethod"
+description: "Deletes a temporaryAccessPassAuthenticationMethod object."
++
+localization_priority: Normal
++
+# Delete temporaryAccessPassAuthenticationMethod
+Namespace: microsoft.graph
++
+Delete a [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md) object.
+
+While the current Temporary Access Pass on the user is valid, it needs to be deleted before a new Temporary Access Pass can be created on the user.
+
+## 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).
+
+### Permissions acting on self
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:-|
+| Delegated (work or school account) | UserAuthenticationMethod.ReadWrite |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Not supported. |
+
+### Permissions acting on other users
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:-|:--|
+| Delegated (work or school account) | UserAuthenticationMethod.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | UserAuthenticationMethod.ReadWrite.All |
+
+For delegated scenarios where an admin is acting on another user, the admin needs [one of the following roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):
+* Global admin
+* Privileged authentication admin
+* Authentication admin
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /users/{id | userPrincipalName}/authentication/temporaryAccessPassMethods/{id}
+DELETE /me/authentication/temporaryAccessPassMethods/{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. It does not return anything in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "delete_temporaryaccesspassauthenticationmethod"
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/beta/users/kim@contoso.com/authentication/temporaryAccessPassMethods/{id}
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
v1.0 Temporaryaccesspassauthenticationmethod Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/temporaryaccesspassauthenticationmethod-get.md
+
+ Title: "Get temporaryAccessPassAuthenticationMethod"
+description: "Read the properties and relationships of a temporaryAccessPassAuthenticationMethod object."
++
+localization_priority: Normal
++
+# Get temporaryAccessPassAuthenticationMethod
+Namespace: microsoft.graph
++
+Retrieve a user's single [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.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).
+
+### Permissions acting on self
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:-|
+| Delegated (work or school account) | UserAuthenticationMethod.Read, UserAuthenticationMethod.ReadWrite |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Not supported. |
+
+### Permissions acting on other users
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:-|:--|
+| Delegated (work or school account) | UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All |
+
+For delegated scenarios where an admin is acting on another user, the admin needs [one of the following roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):
+* Global admin
+* Global reader
+* Privileged authentication admin
+* Authentication admin
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /me/authentication/temporaryAccessPassMethods/{temporaryAccessPassAuthenticationMethodId}
+GET /users/{id | userPrincipalName}/authentication/temporaryAccessPassMethods/{temporaryAccessPassAuthenticationMethodId}
+```
++
+## 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 [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_temporaryaccesspassauthenticationmethod"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/users/kim@contoso.com/authentication/temporaryAccessPassMethods/30fd0dfc-0dfc-30fd-fc0d-fd30fc0dfd30
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.temporaryAccessPassAuthenticationMethod"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": {
+ "@odata.type": "#microsoft.graph.temporaryAccessPassAuthenticationMethod",
+ "id": "30fd0dfc-0dfc-30fd-fc0d-fd30fc0dfd30",
+ "temporaryAccessPass": null,
+ "createdDateTime": "String (timestamp)",
+ "startDateTime": "String (timestamp)",
+ "lifetimeInMinutes": "Integer",
+ "isUsableOnce": "Boolean",
+ "isUsable": "Boolean",
+ "methodUsabilityReason": "String"
+ }
+}
+```
v1.0 Temporaryaccesspassauthenticationmethod List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/temporaryaccesspassauthenticationmethod-list.md
+
+ Title: "List temporaryAccessPassAuthenticationMethods"
+description: "Get a list of the temporaryAccessPassAuthenticationMethod objects and their properties."
++
+localization_priority: Normal
++
+# List temporaryAccessPassAuthenticationMethods
+Namespace: microsoft.graph
++
+Retrieve a list of a user's [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md) objects and their properties. This call will only return a single object as only one Temporary Access Pass method can be set on users.
+
+## 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).
+
+### Permissions acting on self
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:-|
+| Delegated (work or school account) | UserAuthenticationMethod.Read, UserAuthenticationMethod.ReadWrite |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Not supported. |
+
+### Permissions acting on other users
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:-|:--|
+| Delegated (work or school account) | UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All |
++
+For delegated scenarios where an admin is acting on another user, the admin needs one of the following [roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):
+
+* Global admin
+* Global reader
+* Privileged authentication admin
+* Authentication admin
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /me/authentication/temporaryAccessPassMethods
+GET /users/{id | userPrincipalName}/authentication/temporaryAccessPassMethods
+```
+
+## Optional query parameters
+This method does not support optional query parameters to customize the response.
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md) objects in the response body. This call will only return a single object because only one **temporaryAccessPassAuthenticationMethod** can be set on users.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_temporaryaccesspassauthenticationmethod"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/me/authentication/temporaryAccessPassMethods
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.temporaryAccessPassAuthenticationMethod)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.temporaryAccessPassAuthenticationMethod",
+ "id": "String",
+ "temporaryAccessPass": "String",
+ "createdDateTime": "String (timestamp)",
+ "startDateTime": "String (timestamp)",
+ "lifetimeInMinutes": "Integer",
+ "isUsableOnce": "Boolean",
+ "isUsable": "Boolean",
+ "methodUsabilityReason": "String"
+ }
+ ]
+}
+```
v1.0 Temporaryaccesspassauthenticationmethod Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/temporaryaccesspassauthenticationmethod-post.md
+
+ Title: "Create temporaryAccessPassAuthenticationMethod"
+description: "Create a new temporaryAccessPassAuthenticationMethod object."
++
+localization_priority: Normal
++
+# Create temporaryAccessPassAuthenticationMethod
+Namespace: microsoft.graph
++
+Create a new [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md) object on a user. A user can only have one Temporary Access Pass. The passcode can be used between the start and end time of the Temporary Access Pass. If the user requires a new Temporary Access Pass:
+* While the current Temporary Access Pass is valid ΓÇô the admin needs to delete the existing Temporary Access Pass and create a new pass on the user. Deleting a valid Temporary Access Pass will revoke the userΓÇÖs sessions.
+* After the Temporary Access Pass has expired ΓÇô a new temporary access pass overrides the current temporary access pass and doesn't revoke the userΓÇÖs sessions.
++
+## 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).
+
+### Permissions acting on self
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:-|
+| Delegated (work or school account) | UserAuthenticationMethod.ReadWrite |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Not supported. |
+
+### Permissions acting on other users
+
+|Permission type | Permissions (from least to most privileged) |
+|:|:-|:--|
+| Delegated (work or school account) | UserAuthenticationMethod.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | UserAuthenticationMethod.ReadWrite.All |
+
+For delegated scenarios where an admin is acting on another user, the admin needs [one of the following roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):
+* Global admin
+* Privileged authentication admin
+* Authentication admin
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /users/{id | userPrincipalName}/authentication/temporaryAccessPassMethods
+```
+
+## 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 [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md) object.
+
+The following table describes optional properties that can be used when creating the [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md).
+
+|Property|Type|Description|Required|
+|:|:|:|:|
+|startDateTime|DateTimeOffset|The date and time when the temporaryAccessPass becomes available to use, if not set the Temporary Access Pass is available to use at creation time.| No|
+|lifetimeInMinutes|Int32|The lifetime of the temporaryAccessPass in minutes starting at creation time or at startDateTime, if set. Minimum 10, Maximum 43200 (equivalent to 30 days).| No|
+|isUsableOnce|Boolean|Determines if the pass is limited to a one time use. If True ΓÇô the pass can be used once, if False ΓÇô the pass can be used multiple times within the temporaryAccessPass life time. A multi-use Temporary Access Pass (isUsableOnce = false), can only be created and used for sign-in if it is allowed by the Temporary Access Pass Authentication method policy.| No|
+++
+## Response
+
+If successful, this method returns a `201 Created` response code and a [temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "create_temporaryaccesspassauthenticationmethod_from_"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/users/kim@contoso.com/authentication/temporaryAccessPassMethods
+Content-Type: application/json
+Content-length: 209
+
+{
+ "@odata.type": "#microsoft.graph.temporaryAccessPassAuthenticationMethod",
+ "startDateTime": "2021-01-26T00:00:00.000Z",
+ "lifetimeInMinutes": 60,
+ "isUsableOnce": false
+}
+```
+
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.temporaryAccessPassAuthenticationMethod"
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.temporaryAccessPassAuthenticationMethod",
+ "id": "81757535-e21e-4330-a338-33b8038ff12b",
+ "temporaryAccessPass": "nc+&G=xwDKCz",
+ "createdDateTime": "2021-01-25T23:53:35.5026721Z",
+ "startDateTime": "2021-01-26T00:00:00Z",
+ "lifetimeInMinutes": 60,
+ "isUsableOnce": false,
+ "isUsable": false,
+ "methodUsabilityReason": "NotYetValid"
+
+}
+```
v1.0 Temporaryaccesspassauthenticationmethodconfiguration Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/temporaryaccesspassauthenticationmethodconfiguration-delete.md
+
+ Title: "Delete temporaryAccessPassAuthenticationMethodConfiguration"
+description: "Remove changes made to a temporaryAccessPassAuthenticationMethodConfiguration object."
++
+localization_priority: Normal
++
+# Delete temporaryAccessPassAuthenticationMethodConfiguration
+Namespace: microsoft.graph
++
+Remove changes made to the [temporaryAccessPassAuthenticationMethodConfiguration](../resources/temporaryaccesspassauthenticationmethodconfiguration.md) object by reverting the policy to its default configuration.
+
+## 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)|Policy.ReadWrite.AuthenticationMethod|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Policy.ReadWrite.AuthenticationMethod|
+
+ For delegated scenarios, the administrator needs the Global admin role. For more information, see [roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles).
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/TemporaryAccessPass
+```
++
+## 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_fido2authenticationmethodconfiguration"
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/TemporaryAccessPass
+```
++
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
v1.0 Temporaryaccesspassauthenticationmethodconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/temporaryaccesspassauthenticationmethodconfiguration-get.md
+
+ Title: "Get temporaryAccessPassAuthenticationMethodConfiguration"
+description: "Read the properties and relationships of a temporaryAccessPassAuthenticationMethodConfiguration object."
++
+localization_priority: Normal
++
+# Get temporaryAccessPassAuthenticationMethodConfiguration
+Namespace: microsoft.graph
++
+Read the properties and relationships of a [temporaryAccessPassAuthenticationMethodConfiguration](../resources/temporaryaccesspassauthenticationmethodconfiguration.md) object, which represents the Temporary Access Pass [authentication method policy](../resources/authenticationmethodspolicies-overview.md) for the Azure Active Directory (Azure AD) tenant.
+
+## 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)|Policy.ReadWrite.AuthenticationMethod|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Policy.ReadWrite.AuthenticationMethod|
+
+ For delegated scenarios, the administrator needs the Global admin role. For more information, see[roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles).
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/TemporaryAccessPass
+```
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+### Response
+The following is an example of the response.
+
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.fido2AuthenticationMethodConfiguration"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#authenticationMethodConfigurations/$entity",
+ "@odata.type": "#microsoft.graph.temporaryAccessPassAuthenticationMethodConfiguration",
+ "id": "TemporaryAccessPass",
+ "state": "enabled",
+ "defaultLifetimeInMinutes": 60,
+ "defaultLength": 12,
+ "minimumLifetimeInMinutes": 60,
+ "maximumLifetimeInMinutes": 1440,
+ "isUsableOnce": false,
+ "includeTargets@odata.context": "https://graph.microsoft.com/beta/$metadata#policies/authenticationMethodsPolicy/authenticationMethodConfigurations('TemporaryAccessPass')/microsoft.graph.temporaryAccessPassAuthenticationMethodConfiguration/includeTargets",
+ "includeTargets": [
+ {
+ "targetType": "group",
+ "id": "all_users",
+ "isRegistrationRequired": false
+ }
+ ]
+}
+```
v1.0 Temporaryaccesspassauthenticationmethodconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/temporaryaccesspassauthenticationmethodconfiguration-update.md
+
+ Title: "Update temporaryAccessPassAuthenticationMethodConfiguration"
+description: "Update the properties of a temporaryAccessPassAuthenticationMethodConfiguration object."
++
+localization_priority: Normal
++
+# Update temporaryAccessPassAuthenticationMethodConfiguration
+Namespace: microsoft.graph
++
+Update the properties of a [temporaryAccessPassAuthenticationMethodConfiguration](../resources/temporaryaccesspassauthenticationmethodconfiguration.md) object, which represents the Temporary Access Pass authentication method policy for the Azure AD tenant.
+
+## 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)|Policy.ReadWrite.AuthenticationMethod|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Policy.ReadWrite.AuthenticationMethod|
+
+ For delegated scenarios, the administrator needs the Global admin role. For more information, see[roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles).
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/TemporaryAccessPass
+```
+
+## 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 [temporaryAccessPassAuthenticationMethodConfiguration](../resources/temporaryaccesspassauthenticationmethodconfiguration.md) object with the values of fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+
+All properties of the object can be updated. For a list of properties, see [temporaryAccessPassAuthenticationMethodConfiguration](../resources/temporaryaccesspassauthenticationmethodconfiguration.md).
+
+>**Note:** The `@odata.type` property with a value of `#microsoft.graph.temporaryAccessPassAuthenticationMethodConfiguration` must be included in the body.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "update_temporaryaccesspassauthenticationmethodconfiguration"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/TemporaryAccessPass
+Content-Type: application/json
+
+{
+ "@odata.type":"#microsoft.graph.temporaryAccessPassAuthenticationMethodConfiguration",
+ "state":"enabled",
+ "defaultLifetimeInMinutes":60,
+ "defaultLength":8,
+ "minimumLifetimeInMinutes":60,
+ "maximumLifetimeInMinutes":1440,"
+ isUsableOnce":false,
+ "includeTargets": [
+ {
+ "targetType": "group",
+ "id": "all_users",
+ "isRegistrationRequired": false,
+ "useForSignIn": true
+ }
+ ]
+}
++
+```
+
+### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
v1.0 Tiindicator Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/tiindicator-update.md
In the request body, supply the values for relevant fields that should be update
|additionalInformation|String|A catchall area into which extra data from the indicator not covered by the other tiIndicator properties may be placed. Data placed into additionalInformation will typically not be utilized by the targetProduct security tool.| |confidence|Int32|An integer representing the confidence the data within the indicator accurately identifies malicious behavior. Acceptable values are 0 ΓÇô 100 with 100 being the highest.| |description|String|Brief description (100 characters or less) of the threat represented by the indicator.|
-|diamondModel|[diamondModel](#diamondmodel-values)|The area of the Diamond Model in which this indicator exists. Possible values are: `unknown`, `adversary`, `capability`, `infrastructure`, `victim`.|
+|diamondModel|[diamondModel](../resources/tiindicator.md#diamondmodel-values)|The area of the Diamond Model in which this indicator exists. Possible values are: `unknown`, `adversary`, `capability`, `infrastructure`, `victim`.|
|expirationDateTime|DateTimeOffset| DateTime string indicating when the Indicator expires. All indicators must have an expiration date to avoid stale indicators persisting in the system. 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 would look like this: `2014-01-01T00:00:00Z`.| |externalId|String|An identification number that ties the indicator back to the indicator providerΓÇÖs system (e.g. a foreign key).| |isActive|Boolean|Used to deactivate indicators within system. By default, any indicator submitted is set as active. However, providers may submit existing indicators with this set to ΓÇÿFalseΓÇÖ to deactivate indicators in the system.|
-|killChain|[killChain](#killchain-values) collection|A JSON array of strings that describes which point or points on the Kill Chain this indicator targets. See "killChain values" below for exact values.|
+|killChain|[killChain](../resources/tiindicator.md#killchain-values) collection|A JSON array of strings that describes which point or points on the Kill Chain this indicator targets. See "killChain values" below for exact values.|
|knownFalsePositives|String|Scenarios in which the indicator may cause false positives. This should be human-readable text.| |lastReportedDateTime|DateTimeOffset|The last time the indicator was seen. 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 would look like this: `2014-01-01T00:00:00Z`| |malwareFamilyNames|String collection|The malware family name associated with an indicator if it exists. Microsoft prefers the Microsoft malware family name if at all possible which can be found via the Windows Defender Security Intelligence [threat encyclopedia](https://www.microsoft.com/wdsi/threats).| |passiveOnly|Boolean|Determines if the indicator should trigger an event that is visible to an end-user. When set to ΓÇÿtrue,ΓÇÖ security tools will not notify the end user that a ΓÇÿhitΓÇÖ has occurred. This is most often treated as audit or silent mode by security products where they will simply log that a match occurred but will not perform the action. Default value is false.| |severity|Int32|An integer representing the severity of the malicious behavior identified by the data within the indicator. Acceptable values are 0 ΓÇô 5 where 5 is the most severe and zero is not severe at all. Default value is 3.| |tags|String collection|A JSON array of strings that stores arbitrary tags/keywords.|
-|tlpLevel|[tlpLevel](#tlplevel-values)| Traffic Light Protocol value for the indicator. Possible values are: `unknown`, `white`, `green`, `amber`, `red`.|
+|tlpLevel|[tlpLevel](../resources/tiindicator.md#tlplevel-values)| Traffic Light Protocol value for the indicator. Possible values are: `unknown`, `white`, `green`, `amber`, `red`.|
-### diamondModel values
-
-For information about this model, see [The diamond model](http://diamondmodel.org).
-
-| Values | Description |
-|:-|:|
-|adversary|The indicator describes the adversary.|
-|capability|The indicator is a capability of the adversary.|
-|infrastructure|The indicator describes infrastructure of the adversary.|
-|victim|The indicator describes the victim of the adversary.|
-
-### killChain values
-
-| Values | Description |
-|:-|:|
-|Actions|Represents ΓÇ£Actions on ObjectivesΓÇ¥. The attacker is leveraging the compromised system to take actions such as a distributed denial of service attack.|
-|C2|Represents the control channel by which a compromised system is manipulated.|
-|Delivery|The process of distributing the exploit code to victims (for example USB, email, websites).|
-|Exploitation|The exploit code taking advantage of vulnerabilities (for example, code execution).|
-|Installation|Installing malware after a vulnerability has been exploited.|
-|Reconnaissance|Indicator is evidence of an activity group harvesting information to be used in a future attack.|
-|Weaponization|Turning a vulnerability into exploit code (for example, malware).|
-
-### tlpLevel values
-
-Every indicator must have a Traffic Light Protocol (tlp) value when it is submitted. This value represents the sensitivity and sharing scope of a given indicator.
-
-| Values | Description |
-|:-|:|
-|White| Sharing scope: Unlimited. Indicators can be shared freely, without restriction.|
-|Green| Sharing scope: Community. Indicators can be shared with the security community.|
-|Amber| Sharing scope: Limited. This is the default setting for indicators and restricts sharing to only those with a need-to-know: 1) Services and service operators that implement threat intelligence; 2) Customers whose system(s) exhibit behavior consistent with the indicator.|
-|Red| Sharing scope: Personal. These indicators are to only be shared directly and, preferably, in person. Typically, TLP Red indicators are not ingested due to their pre-defined restrictions. If TLP Red indicators are submitted, the **passiveOnly** property should be set to `True` as well. |
## Response
v1.0 User Findmeetingtimes https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-findmeetingtimes.md
Preference-Applied: outlook.timezone="Pacific Standard Time"
"section": "documentation", "tocPath": "", "suppressions": [
- "Warning: /api-reference/bet:\r\n Failed to parse any rows out of table with headers: |activityDomain value|Suggestions for meeting times|",
- "Error: user_findmeetingtimes/meetingTimeSuggestions/member/confidence:\r\n Expected type Float but actual was Int64. Property: confidence, actual value: '100'",
"Error: user_findmeetingtimes/meetingTimeSuggestions/member/confidence:\r\n Expected type Double but actual was Int64. Property: confidence, actual value: '100'" ] }
v1.0 User Getmembergroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-getmembergroups.md
One of the following permissions is required to call this API. To learn more, in
| Permission type | Permissions (from least to most privileged) | | :- | : |
-| Delegated (work or school account) | User.ReadBasic.All and GroupMember.Read.All, User.Read and GroupMember.Read.All, User.Read.All and GroupMember.Read.All, User.ReadBasic.All and Group.Read.All, User.Read and Group.Read.All, User.Read.All and Group.Read.All, Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.All |
+| Delegated (work or school account) | User.ReadBasic.All, User.Read, User.Read.All, Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.All |
| Delegated (personal Microsoft account) | Not supported. |
-| Application | User.Read.All and GroupMember.Read.All, User.Read.All and Group.Read.All, Directory.Read.All, Directory.ReadWrite.All |
+| Application | User.Read.All, Directory.Read.All, Directory.ReadWrite.All |
## HTTP request
v1.0 User List Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-list-messages.md
Namespace: microsoft.graph
Get the messages in the signed-in user's mailbox (including the Deleted Items and Clutter folders).
-Depending on the page size and mailbox data, getting messages from a mailbox can incur multiple requests. The default page size is 10 messages. To get the next page of messages, simply apply the entire URL returned in `@odata.nextLink` to the next get-messages request. This URL includes any query parameters you may have specified in the initial request.
+Depending on the page size and mailbox data, getting messages from a mailbox can incur multiple requests. The default page size is 10 messages. Use `$top` to customize the page size, within the range of 1 and 1000.
+
+To improve the operation response time, use `$select` to specify the exact properties you need; see [example 1](#example-1-list-all-messages) below. Fine-tune the values for `$select` and `$top`, especially when you must use a larger page size, as returning a page with hundreds of messages each with a full response payload may trigger the [gateway timeout](/graph/errors#http-status-codes) (HTTP 504).
+
+To get the next page of messages, simply apply the entire URL returned in `@odata.nextLink` to the next get-messages request. This URL includes any query parameters you may have specified in the initial request.
Do not try to extract the `$skip` value from the `@odata.nextLink` URL to manipulate responses. This API uses the `$skip` value to keep count of all the items it has gone through in the user's mailbox to return a page of message-type items. It's therefore possible that even in the initial response, the `$skip` value is larger than the page size. For more information, see [Paging Microsoft Graph data in your app](/graph/paging).
Do not supply a request body for this method.
If successful, this method returns a `200 OK` response code and collection of [message](../resources/message.md) objects in the response body.
-## Example
-##### Request 1
+## Examples
+### Example 1: List all messages
+#### Request
The first example gets the default, top 10 messages in the signed-in user's mailbox. It uses `$select` to return a subset of the properties of each message in the response. # [HTTP](#tab/http)
GET https://graph.microsoft.com/beta/me/messages?$select=sender,subject
-##### Response 1
+#### Response
Here is an example of the response. To get the next page of messages, apply the URL returned in `@odata.nextLink` to a subsequent GET request. <!-- {
Content-type: application/json
} ``` -
-##### Request 2
-The next example filters all messages in the signed-in user's mailbox for those that mention the user. It also uses `$select`
-to return a subset of the properties of each message in the response.
+### Example 2: Use $filter to get all messages satisfying a specific condition
+#### Request
+The next example filters all messages in the signed-in user's mailbox for those that mention the user. It also uses `$select` to return a subset of the properties of each message in the response.
The example also incorporates URL encoding for the space characters in the query parameter string.
GET https://graph.microsoft.com/beta/me/messages?$filter=MentionsPreview/IsMenti
-##### Response 2
+#### 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",
Content-length: 987
} ```
-##### Request 3
+### Example 3: Use prefer header to get the message body and uniqueBody is text format
+#### Request
The third example shows how to use a `Prefer: outlook.body-content-type="text"` header to get the **body** and **uniqueBody** properties of each message in text format. # [HTTP](#tab/http)
Prefer: outlook.body-content-type="text"
-##### Response 3
+#### Response
Here is an example of the response. <!--
v1.0 User Translateexchangeids https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-translateexchangeids.md
POST /users/{id|userPrincipalName}/translateExchangeIds
### exchangeIdFormat values
-| Values | Description |
+| Member | Description |
|:-|:| | entryId | The binary entry ID format used by MAPI clients. | | ewsId | The ID format used by Exchange Web Services clients. |
v1.0 Useraccountinformation Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/useraccountinformation-delete.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-DELETE /me/profile/accounts/{id}
-DELETE /users/{id | userPrincipalName}/profile/accounts/{id}
+DELETE /me/profile/account/{id}
+DELETE /users/{id | userPrincipalName}/profile/account/{id}
``` ## Request headers
The following is an example of the request.
}--> ```http
-DELETE https://graph.microsoft.com/beta/me/profile/accounts/{id}
+DELETE https://graph.microsoft.com/beta/me/profile/account/{id}
``` ### Response
v1.0 Useraccountinformation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/useraccountinformation-get.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-GET /me/profile/accounts/{id}
-GET /users/{id | userPrincipalName}/profile/accounts/{id}
+GET /me/profile/account/{id}
+GET /users/{id | userPrincipalName}/profile/account/{id}
``` ## Optional query parameters
The following is an example of the request.
}--> ```http
-GET https://graph.microsoft.com/beta/user/profile/accounts/{id}
+GET https://graph.microsoft.com/beta/me/profile/account/{id}
``` ### Response
v1.0 Useraccountinformation Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/useraccountinformation-update.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-PATCH /me/profile/accounts/{id}
-PATCH /users/{id | userPrincipalName}/profile/accounts/{id}
+PATCH /me/profile/account/{id}
+PATCH /users/{id | userPrincipalName}/profile/account/{id}
``` ## Request headers
v1.0 Usersource Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/usersource-get.md
If successful, this method returns a `200 OK` response code and a [userSource](.
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_usersource"
If successful, this method returns a `200 OK` response code and a [userSource](.
``` http GET https://graph.microsoft.com/beta/compliance/ediscovery/cases4c8f8f70-7785-4bd4-b296-c98376a2c5e1/custodians/2192ca408ea2410eba3bec8ae873be6b/userSources/46384443-4137-3032-3437-363939433735 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Accesspackageresourceenvironment https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/accesspackageresourceenvironment.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-In [Azure AD Entitlement Management](entitlementmanagement-root.md), an access package resource environment is a reference to the geolocation environment in which a resource is located. This environment is automatically provided as part of Azure AD Entilement Management. The API is only applicable to Multi-Geo SharePoint Online sites.
+In [Azure AD Entitlement Management](entitlementmanagement-root.md), an access package resource environment is a reference to the geolocation environment in which a resource is located. This environment is automatically provided as part of Azure AD Entitlement Management. The API is only applicable to Multi-Geo SharePoint Online sites.
## Methods |Method|Return type|Description|
The following is a JSON representation of the resource.
"blockType": "resource", "keyProperty": "id", "@odata.type": "microsoft.graph.accessPackageResourceEnvironment",
- "baseType": "",
"openType": false } -->
v1.0 Accesspackageresourcerolescope https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/accesspackageresourcerolescope.md
The following is a JSON representation of the resource.
```json {
- "createdBy": "String",
- "createdDateTime": "String (timestamp)",
- "id": "String (identifier)",
- "modifiedBy": "String",
- "modifiedDateTime": "String (timestamp)",
- "accessPackageResourceRole": {
- "id": "String (identifier)",
- "displayName": "String",
- "originSystem": "String",
- "originId": "String"
- },
- "accessPackageResourceScope": {
- "id": "String (identifier)",
- "displayName": "String",
- "description": "String",
- "originId": "String (identifier)",
- "originSystem": "String"
- }
-
+ "createdBy":"String",
+ "createdDateTime":"String (timestamp)",
+ "id":"String (identifier)",
+ "modifiedBy":"String",
+ "modifiedDateTime":"String (timestamp)",
+ "accessPackageResourceRole":{
+ "id":"String (identifier)",
+ "displayName":"String",
+ "originSystem":"String",
+ "originId":"String"
+ },
+ "accessPackageResourceScope":{
+ "id":"String (identifier)",
+ "displayName":"String",
+ "description":"String",
+ "originId":"String (identifier)",
+ "originSystem":"String"
+ }
} ```
v1.0 Accessreview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/accessreview.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + Represents an Azure AD [access review](accessreviews-root.md). ## Methods
v1.0 Accessreviewapplyaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/accessreviewapplyaction.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + Represents a base class for apply actions in the [accessReviewScheduleSettings](accessreviewschedulesettings.md) of an [accessReviewScheduleDefinition](accessreviewscheduledefinition.md). Supported derived types: - **removeAccessApplyAction** is a derived type of accessReviewApplyAction that indicates removing access of an entity being reviewed upon completion of the review. This is the default type for the applyActions property in accessReviewScheduleSettings and does not need to be specified.
v1.0 Accessreviewdecision https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/accessreviewdecision.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + In the Azure AD [access reviews](accessreviews-root.md) feature, the `accessReviewDecision` represents an Azure AD access review decision of a particular entity's access. Within an access review, or an instance of a recurring access review, there is one `accessReviewDecision` per reviewed user. For example, if a group has two guests and one non-guest as members, and an access review of guests is performed for that group, then there will be two access review decision objects. If a reviewer changes their decision, or another reviewer overrides them, then the `accessReviewDecision` is updated.
v1.0 Accessreviewinstance https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/accessreviewinstance.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + Represents an Azure AD [access review](accessreviewsv2-root.md) recurrence. If the parent [accessReviewScheduleDefinition](accessreviewscheduledefinition.md) is a recurring access review, instances represent each recurrence. A review that does not recur will have exactly one instance. Instances also represent each unique group being reviewed in the schedule definition. If a schedule definition reviews multiple groups, each group will have a unique instance for each recurrence. Every **accessReviewInstance** contains a list of [decisions](accessreviewinstancedecisionitem.md) that reviewers can take action on. There is one decision per identity being reviewed.
v1.0 Accessreviewinstancedecisionitem https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/accessreviewinstancedecisionitem.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + Represents an Azure AD [access review](accessreviewsv2-root.md) decision on an instance of a review. This decision represents the determination of a user or service principal's access for a given [access review instance](accessreviewinstance.md). ## Methods
v1.0 Accessreviewinstancedecisionitemserviceprincipaltarget https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/accessreviewinstancedecisionitemserviceprincipaltarget.md
doc_type: resourcePageType
Namespace: microsoft.graph ++ Represents a service principal under review in an [accessReviewInstance](accessreviewinstance.md). Inherits from [accessReviewInstanceDecisionItemTarget](../resources/accessreviewinstancedecisionitemtarget.md).
v1.0 Accessreviewinstancedecisionitemtarget https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/accessreviewinstancedecisionitemtarget.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + Represents a base class for different types of review targets, each one with its own specific properties. The supported target types are: [accessReviewInstanceDecisionItemUserTarget](accessreviewinstancedecisionitemusertarget.md) and [accessReviewInstanceDecisionItemServicePrincipalTarget](accessreviewinstancedecisionitemserviceprincipaltarget.md). ## Properties
v1.0 Accessreviewinstancedecisionitemusertarget https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/accessreviewinstancedecisionitemusertarget.md
doc_type: resourcePageType
Namespace: microsoft.graph ++ Represents a user identity under review in an [accessReviewInstance](accessreviewinstance.md). Inherits from [accessReviewInstanceDecisionItemTarget](../resources/accessreviewinstancedecisionitemtarget.md).
v1.0 Accessreviewrecurrencesettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/accessreviewrecurrencesettings.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + The **accessReviewRecurrenceSettings** resource type is used in the [accessReviewSettings](accessreviewsettings.md) resource and specifies that the access review recurs at regular intervals. ## Properties
v1.0 Accessreviewreviewerscope https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/accessreviewreviewerscope.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + The accessReviewReviewerScope defines who will review instances of an [accessReviewScheduleDefinition](accessreviewscheduledefinition.md). This is expressed as an OData query, which allows reviewers to be specified both as a static list of users (i.e., specific users, group owners, group members) or dynamically (i.e., the case where every user is reviewed by their manager). To create a self-review (where users review their own access), do not provide reviewers on [accessReviewScheduleDefinition](accessreviewscheduledefinition.md) creation.
v1.0 Accessreviews Root https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/accessreviews-root.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
->[!NOTE]
->The access review APIs in this section apply to all supported resource types _except for groups_. For access review APIs that apply to group memberships, see [Access reviews for groups](accessreviewsv2-root.md).
You can use [Azure AD access reviews](/azure/active-directory/active-directory-azure-ad-controls-access-reviews-overview) to configure one-time or recurring access reviews for attestation of user's access rights.
v1.0 Accessreviewscheduledefinition https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/accessreviewscheduledefinition.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + Represents the scheduling of an Azure AD [access review](accessreviewsv2-root.md). An accessReviewScheduleDefinition contains a list of [accessReviewInstance](accessreviewinstance.md) objects. Each recurrence of the schedule definition will create an instance. Instances also represent each unique group being reviewed. If a schedule definition reviews multiple groups, each group will have a unique instance per each recurrence. In the case of a one-time review, only one instance will be created per group.
An accessReviewScheduleDefinition contains a list of [accessReviewInstance](acce
| descriptionForAdmins |string | Description provided by review creators to provide more context of the review to admins. | | descriptionForReviewers |string | Description provided by review creators to provide more context of the review to reviewers. Reviewers will see this description in the email sent to them requesting their review. | | createdBy |[userIdentity](../resources/useridentity.md) | User who created this review. |
-| scope |[accessReviewScope](../resources/accessreviewscope.md) | Defines scope of users reviewed in a group. For supported scopes, see [accessReviewScope](accessreviewscope.md). Required on create. |
-| instanceEnumerationScope|[accessReviewScope](../resources/accessreviewscope.md) | In the case of an all groups review, this determines the scope of which groups will be reviewed. Each group will become a unique accessReviewInstance of the access review series. For supported scopes, see [accessReviewScope](accessreviewscope.md). |
+| scope |[accessReviewScope](../resources/accessreviewscope.md) | Defines scope of users reviewed. For supported scopes, see [accessReviewScope](accessreviewscope.md). Required on create. |
+| instanceEnumerationScope|[accessReviewScope](../resources/accessreviewscope.md) | In the case of a review of guest users across all Microsoft 365 groups, this determines the scope of which groups will be reviewed. Each group will become a unique accessReviewInstance of the access review series. For supported scopes, see [accessReviewScope](accessreviewscope.md). |
| settings |[accessReviewScheduleSettings](../resources/accessreviewschedulesettings.md)| The settings for an access review series, see type definition below. | | reviewers |[accessReviewReviewerScope](../resources/accessreviewreviewerscope.md) collection| This collection of access review scopes is used to define who are the reviewers. See [accessReviewReviewerScope](accessreviewreviewerscope.md). Required on create. | | backupReviewers |[accessReviewReviewerScope](../resources/accessreviewreviewerscope.md) collection| This collection of reviewer scopes is used to define the list of fallback reviewers. These fallback reviewers will be notified to take action if no users are found from the list of reviewers specified. This could occur when either the group owner is specified as the reviewer but the group owner does not exist, or manager is specified as reviewer but a user's manager does not exist. See [accessReviewReviewerScope](accessreviewreviewerscope.md). |
An accessReviewScheduleDefinition contains a list of [accessReviewInstance](acce
| Relationship | Type |Description| |:|:--|:-|
-| `instances` |[accessReviewInstance](accessreviewinstance.md) collection | If the `accessReviewScheduleDefinition` is a recurring access review, instances represent each recurrence. A review that does not recur will have exactly one instance. Instances also represent each unique group under review in the `accessReviewScheduleDefinition`. If a review has multiple groups and multiple instances, each group will have a unique instance for each recurrence. |
+| `instances` |[accessReviewInstance](accessreviewinstance.md) collection | If the `accessReviewScheduleDefinition` is a recurring access review, instances represent each recurrence. A review that does not recur will have exactly one instance. Instances also represent each unique resource under review in the `accessReviewScheduleDefinition`. If a review has multiple resources and multiple instances, each resource will have a unique instance for each recurrence. |
+
+### Supported queries for accessReviewScheduleDefinition
+The following are queries supported on an [accessReviewScheduleDefinition](accessreviewscheduledefinition.md) based on the [accessReviewScope](accessreviewscope.md).
+
+|Scenario| Query |
+|--|--|
+| List every `accessReviewScheduleDefinition` on individual groups (excludes definitions scoped to all Microsoft 365 groups with guest users) | /beta/identityGovernance/accessReviews/definitions?$filter=contains(scope/query, '/groups') |
+| List every `accessReviewScheduleDefinition` on a specific group (excludes definitions scoped to all Microsoft 365 groups with guest users) | /beta/identityGovernance/accessReviews/definitions?$filter=contains(scope/query, '/groups/{group id}') |
+| List every `accessReviewScheduleDefinition` scoped to all Microsoft 365 groups with guest users | /beta/identityGovernance/accessReviews/definitions?$filter=contains(scope/query, './members') |
## JSON representation The following is a JSON representation of the resource.
v1.0 Accessreviewschedulesettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/accessreviewschedulesettings.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + The **accessReviewScheduleSettings** defines the settings of an [accessReviewScheduleDefinition](accessreviewscheduledefinition.md). ## Properties
v1.0 Accessreviewscope https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/accessreviewscope.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + The **accessReviewScope** defines what entities will be reviewed in an [accessReviewScheduleDefinition](accessreviewscheduledefinition.md). This is expressed as an odata query. The query type must also be expressed so that scenarios can be supported to review entities outside of MicrosoftGraph, such as ARM. ## Properties
The following are queries supported as the `scope` property in an [accessReviewS
|--|--|-- | | Review of all users assigned to a group | /groups/{group id}/transitiveMembers || | Review of guest users assigned to a group | /groups/{group id}/microsoft.graph.user/?$count=true&$filter=(userType eq 'Guest') ||
-| Review of guest users assigned to all groups | ./members/microsoft.graph.user/?$count=true&$filter=(userType eq 'Guest') | Note that the corresponding instanceEnumerationScope should also be passed in to the accessReviewScheduleDefinition. See table below for instanceEnumerationScope query. |
+| Review of guest users assigned to all Microsoft 365 groups | ./members/microsoft.graph.user/?$count=true&$filter=(userType eq 'Guest') | Note that the corresponding instanceEnumerationScope should also be passed in to the accessReviewScheduleDefinition. See table below for instanceEnumerationScope query. |
| Entitlement Management Access Package Assigment Reviews | /identityGovernance/entitlementManagement/accessPackageAssignments?$filter=(accessPackageId eq '{package id}' and assignmentPolicyId eq '{id}')| Note that only READ is supported for Access Package Assignment Reviews| ### Supported queries for accessReviewScope as instanceEnumerationScope
The following are queries supported as the `instanceEnumerationScope` property i
|Scenario| Query | Additional Comments | |--|--|--|
-| Review of guest users assigned to all groups, excluding specified groups | /groups?$filter=(groupTypes/any(c:c+eq+'Unified') and id ne '{group id}' and id ne '{group id}' and id ne '{group id}')&$count=true | Note that the corresponding scope should also be passed in to the accessReviewScheduleDefinition. See "Review of guest users assigned to all groups" in scope property table above for the scope query. |
+| Review of guest users assigned to all Microsoft 365 groups, excluding specified groups | /groups?$filter=(groupTypes/any(c:c+eq+'Unified') and id ne '{group id}' and id ne '{group id}' and id ne '{group id}')&$count=true | Note that the corresponding scope should also be passed in to the accessReviewScheduleDefinition. See "Review of guest users assigned to all Microsoft 365 groups" in scope property table above for the scope query. |
## Relationships None.
v1.0 Accessreviewsettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/accessreviewsettings.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + Provides additional settings when creating an access review, to control the feature behavior when starting an access review. ## Properties
v1.0 Accessreviewsv2 Root https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/accessreviewsv2-root.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
->[!NOTE]
->The access review APIs in this section apply to only group memberships. For access reviews on all other supported resource types, see [Access reviews](accessreviews-root.md).
You can use [Azure AD access reviews](/azure/active-directory/active-directory-azure-ad-controls-access-reviews-overview) to configure one-time or recurring access reviews for attestation of user's access rights.
v1.0 Album https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/album.md
- Title: album resource type description: Facet describing a bundle which is a photo album. localization_priority: Normal
v1.0 Approle https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/approle.md
Namespace: microsoft.graph
Represents an application role that can be requested by (and granted to) a client application, or that can be used to assign an application to users or groups in a specified role.
-The **appRoles** property of the [application](application.md) and [servicePrincipal](serviceprincipal.md) entities are a collection of **appRole**.
+To add, update, or remove app roles for an application, [update the application](../api/application-update.md) for the app or service. App roles on the application entity will be available in all tenants where the application is used. To define app roles that are only applicable in your tenant (for example, app roles representing custom roles in your instance of a multi-tenant application), you can also [update the service principal](../api/serviceprincipal-update.md) for the app, to add or update app roles to the **appRoles** collection.
With [appRoleAssignments](approleassignment.md), app roles can be assigned to users, groups, or other applications' service principals.
v1.0 Authenticationmethods Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/authenticationmethods-overview.md
The authentication method APIs are used to manage a user's authentication method
|[passwordlessmicrosoftauthenticatorauthenticationmethod](passwordlessmicrosoftauthenticatorauthenticationmethod.md) (deprecated)|Microsoft Authenticator Passwordless Phone Sign-in can be used by a user to sign-in to Azure AD|Delete a Passwordless Phone Sign-in authentication method.| |[emailAuthenticationMethod](emailauthenticationmethod.md)|An email address can be user by a user as part of the Self-Service Password Reset (SSPR) process.|See a user's authentication email address. Add, update, or remove an email address to a user.| |[windowsHelloForBusinessAuthenticationMethod](windowsHelloForBusinessAuthenticationMethod.md)|Windows Hello for Business is a passwordless sign-in method on Windows devices.|See devices where a user has enabled Windows Hello for Business sign-in. Delete a Windows Hello for Business credential.|
+|[temporaryaccesspassauthenticationmethod](temporaryaccesspassauthenticationmethod.md)|Temporary Access Pass is a time-limited passcode that serves as a strong credential and allows onboarding of passwordless credentials. | Set a new Temporary Access Pass on a user.|
+ ## Next steps
v1.0 Authenticationmethodspolicies Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/authenticationmethodspolicies-overview.md
Title: "Azure AD authentication methods policy API overview"
description: "Authentication methods policies define which authentication methods can be used by users in Azure AD." localization_priority: Normal + ms.prod: "identity-and-sign-in" doc_type: "conceptualPageType"
The authentication method policies APIs are used to manage policy settings. For
|Authentication method policy | Description | |:|:|:|
+|[smsAuthenticationMethodConfiguration](smsAuthenticationMethodConfiguration.md)| Define users who can use Text Message on the Azure AD tenant.|
|[fido2authenticationmethodconfiguration](fido2authenticationmethodconfiguration.md)| Define FIDO2 security key restrictions and users who can use them to sign in to Azure AD.| |[microsoftauthenticatorauthenticationmethodconfiguration](microsoftauthenticatorauthenticationmethodconfiguration.md)|Define users who can use Microsoft Authenticator on the Azure AD tenant.| |[emailauthenticationmethodconfiguration](emailauthenticationmethodconfiguration.md)|Define users who can use email OTP on the Azure AD tenant.| |[passwordlessmicrosoftauthenticatorauthenticationmethodconfiguration](passwordlessmicrosoftauthenticatorauthenticationmethodconfiguration.md) (deprecated)|Define users who can use Passwordless Phone Sign-in to sign in to Azure AD.|
+|[temporaryaccesspassauthenticationmethodconfiguration](temporaryaccesspassauthenticationmethodconfiguration.md)|Define users who can use Temporary Access Pass to sign in to Azure AD.|
## Next steps
v1.0 Bundle https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/bundle.md
- Title: bundle resource type description: Facet describing a driveItem that is a logical grouping of other driveItems localization_priority: Normal
v1.0 Calendarpermission https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/calendarpermission.md
Once a sharee or delegate has been set up for a calendar, you can [update](../ap
### calendarRoleType values
-| Values | Description |
+| Member | Description |
|:--|:| | none | Calendar is not shared with the user. | | freeBusyRead | User is a sharee who can view free/busy status of the owner on the calendar. |
v1.0 Device https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/device.md
This resource lets you add your own data to custom properties using [extensions]
|alternativeSecurityIds|alternativeSecurityId collection| For internal use only. Not nullable. | |approximateLastSignInDateTime|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 would look like this: `'2014-01-01T00:00:00Z'`. Read-only. | |complianceExpirationDateTime|DateTimeOffset| The timestamp when the device is no longer deemed compliant. 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 would look like this: `'2014-01-01T00:00:00Z'`. Read-only. |
+|deviceCategory|String|User-defined property set by Intune to automatically add devices to groups and simplify managing devices.|
|deviceId|Guid| Unique identifier set by Azure Device Registration Service at the time of registration. | |deviceMetadata|String| For internal use only. Set to null. |
+|deviceOwnership|String|Ownership of the device. This property is set by Intune. Possible values are: unknown, company, personal.|
|deviceVersion|Int32| For internal use only. | |displayName|String| The display name for the device. Required. |
+|domainName|String|The on-premises domain name of Hybrid Azure AD joined devices. This property is set by Intune.|
+|enrollmentProfileName|String|Enrollment profile applied to the device. For example, Apple Device Enrollment Profile, Device enrollment - Corporate device identifiers, or Windows Autopilot profile name. This property is set by Intune.|
+|enrollmentType|String|Enrollment type of the device. This property is set by Intune. Possible values are: unknown, userEnrollment, deviceEnrollmentManager, appleBulkWithUser, appleBulkWithoutUser, windowsAzureADJoin, windowsBulkUserless, windowsAutoEnrollment, windowsBulkAzureDomainJoin, windowsCoManagement.|
|id|String|The unique identifier for the device. Inherited from [directoryObject](directoryobject.md). Key, Not nullable. Read-only.| |isCompliant|Boolean|**true** if the device complies with Mobile Device Management (MDM) policies; otherwise, **false**. Read-only. This can only be updated by Intune for any device OS type or by an [approved MDM app](/windows/client-management/mdm/azure-active-directory-integration-with-mdm) for Windows OS devices.| |isManaged|Boolean|**true** if the device is managed by a Mobile Device Management (MDM) app; otherwise, **false**. This can only be updated by Intune for any device OS type or by an [approved MDM app](/windows/client-management/mdm/azure-active-directory-integration-with-mdm) for Windows OS devices. |
+|isRooted|Boolean|**true** if device is rooted; **false** if device is jail-broken. This can only be updated by Intune.|
+|managementType|String|Management channel of the device. This property is set by Intune. Possible values are: eas, mdm, easMdm, intuneClient, easIntuneClient, configurationManagerClient, configurationManagerClientMdm, configurationManagerClientMdmEas, unknown, jamf, googleCloudDevicePolicyController.|
|manufacturer|String| Manufacturer of the device. Read-only. | |mdmAppId|String|Application identifier used to register device into MDM. <br><br>Read-only. Supports $filter.| |model|String| Model of the device. Read-only. |
This resource lets you add your own data to custom properties using [extensions]
|operatingSystemVersion|String| Operating system version of the device. Required. | |physicalIds|String collection| For internal use only. Not nullable. | |profileType|String|The profile type of the device. Possible values:<br />**RegisteredDevice** (default)<br />**SecureVM**<br />**Printer**<br />**Shared**<br />**IoT**|
+|registrationDateTime|DateTimeOffset|Date and time of when the device was registered. 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 would look like this: `'2014-01-01T00:00:00Z'`. Read-only.|
|systemLabels|String collection| List of labels applied to the device by the system. | |hostNames|String collection| List of hostNames for the device.| |trustType|String| Type of trust for the joined device. Read-only. Possible values: <br />**Workplace** - indicates *bring your own personal devices*<br />**AzureAd** - Cloud only joined devices<br />**ServerAd** - on-premises domain joined devices joined to Azure AD. For more details, see [Introduction to device management in Azure Active Directory](/azure/active-directory/device-management-introduction) |
This resource lets you add your own data to custom properties using [extensions]
|registeredOwners|[directoryObject](directoryobject.md) collection| The user that cloud joined the device or registered their personal device. The registered owner is set at the time of registration. Currently, there can be only one owner. Read-only. Nullable.| |registeredUsers|[directoryObject](directoryobject.md) collection| Collection of registered users of the device. For cloud joined devices and registered personal devices, registered users are set to the same value as registered owners at the time of registration. Read-only. Nullable.| |extensions|[extension](extension.md) collection|The collection of open extensions defined for the device. Nullable.|
-|registeredOwners|[directoryObject](directoryobject.md) collection|Users that are registered owners of the device. Read-only. Nullable.|
-|registeredUsers|[directoryObject](directoryobject.md) collection|Users that are registered users of the device. Read-only. Nullable.|
|commands | [command](command.md) collection | Set of commands sent to this device| |usageRight|[usageRight](usageright.md) collection|Represents the usage rights a device has been granted. |
The following is a JSON representation of the resource.
"accountEnabled": true, "approximateLastSignInDateTime": "String (timestamp)", "complianceExpirationDateTime": "String (timestamp)",
+ "deviceCategory": "string",
"deviceId": "string", "deviceMetadata": "string",
+ "deviceOwnership": "string",
"deviceVersion": 1024, "displayName": "string",
+ "domainName": "string",
+ "enrollmentProfileName": "string",
+ "enrollmentType": "string",
"id": "string (identifier)", "isCompliant": true, "isManaged": true,
+ "isRooted": true,
"mdmAppId": "string", "onPremisesLastSyncDateTime": "String (timestamp)", "onPremisesSyncEnabled": true,
The following is a JSON representation of the resource.
"operatingSystemVersion": "string", "physicalIds": ["string"], "profileType": "string",
+ "registrationDateTime": "String (timestamp)",
"systemLabels": ["string"], "hostNames" : ["string"], "trustType": "string",
The following is a JSON representation of the resource.
"Platform": "string", "Kind": "string", "Model": "string",
+ "managementType": "string",
"Manufacturer": "string" } ```
v1.0 Drive https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/drive.md
- Title: drive resource type description: drive resource representing a user's onedrive or a document library in SharePoint localization_priority: Priority
v1.0 Dynamics Vendor https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/dynamics-vendor.md
None
## JSON representation
+<!-- {
+ "blockType": "resource",
+ "optionalProperties": [],
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.vendor"
+}-->
+ Here is a JSON representation of the vendor. ```json
Here is a JSON representation of the vendor.
"balance": "decimal", "lastModifiedDateTime": "datetime" }- ```
v1.0 Educationassignment https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/educationassignment.md
The following is a JSON representation of the resource.
```json { "id": "String (identifier)",
- "addedStudentAction": "string",
+ "addedStudentAction": "none",
"allowLateSubmissions": true, "allowStudentsToAddResourcesToSubmission": true, "assignDateTime": "String (timestamp)",
The following is a JSON representation of the resource.
"instructions": {"@odata.type": "microsoft.graph.itemBody"}, "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"}, "lastModifiedDateTime": "String (timestamp)",
- "notificationChannelUrl": "string",
+ "notificationChannelUrl": null,
"status": "string" } ```
v1.0 Educationassignmentdefaults https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/educationassignmentdefaults.md
+
+ Title: "educationAssignmentDefaults resource type"
+description: "Specifies class-level defaults respected by new assignments created in the class"
+
+localization_priority: Normal
++
+# educationAssignmentDefaults resource type
+
+Namespace: microsoft.graph
++
+Specifies class-level defaults respected by new assignments created in the class. Callers can continue to specify custom values on each assignment creation if they do not want the default behaviors.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[Get educationAssignmentDefaults](../api/educationassignmentdefaults-get.md)|[educationAssignmentDefaults](../resources/educationassignmentdefaults.md)|Read the properties and relationships of an [educationAssignmentDefaults](../resources/educationassignmentdefaults.md) object.|
+|[Update educationAssignmentDefaults](../api/educationassignmentdefaults-update.md)|[educationAssignmentDefaults](../resources/educationassignmentdefaults.md)|Update the properties of an [educationAssignmentDefaults](../resources/educationassignmentdefaults.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|addedStudentAction|educationAddedStudentAction|Class-level default behavior for handling students who are added after the assignment is published. Possible values are: `none`, `assignIfOpen`.|
+|dueTime|TimeOfDay|Class-level default value for due time field. Default value is `23:59:00`.|
+|notificationChannelUrl|String|Default Teams channel to which notifications will be sent. Default value is `null`.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.educationAssignmentDefaults",
+ "openType": false
+}
+-->
+``` json
+{
+ "addedStudentAction": "none",
+ "dueTime": "23:59:00",
+ "notificationChannelUrl": "https://graph.microsoft.com/beta/teams('id')/channels('id')"
+}
+```
+
v1.0 Educationclass https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/educationclass.md
The following is a JSON representation of the resource.
"section": "documentation", "tocPath": "", "suppressions": [
- "Error: Resource educationClass has documented navigation properties, but we thought it was a complex type!",
- "Resource educationClass has documented navigation properties, but we thought it was a complex type!"
] }-->
v1.0 Educationschool https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/educationschool.md
The following is a JSON representation of the resource.
"section": "documentation", "tocPath": "", "suppressions": [
- "Error: Resource educationSchool has documented navigation properties, but we thought it was a complex type!"
] }-->
v1.0 Educationuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/educationuser.md
The following is a JSON representation of the resource.
"section": "documentation", "tocPath": "", "suppressions": [
- "Error: Resource educationUser has documented navigation properties, but we thought it was a complex type!"
] }-->
v1.0 Enums Termstore https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/enums-termstore.md
Namespace: microsoft.graph.termstore
Specifies the value types relations can take in a termstore
-|Members|
+|Member|
|:| |pin| |reuse|
Specifies the value types relations can take in a termstore
Specifies the values different group types can take within the termstore
-|Members|
+|Member|
|:| |global| |system|
v1.0 Enums https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/enums.md
Possible values for user account types (group membership), per Windows definitio
|meeting | 2 | Indicates that the chat is a Meeting chat, which is created as a side effect of creation of an OnlineMeeting. | |unknownFutureValue | 3 | Sentinel value to indicate future values. |
+### singleSignOnMode values
+
+|Member|
+|:|
+|none|
+|onPremisesKerberos|
+|aadHeaderBased|
+|pingHeaderBased|
+ ### plannerContainerType values |Member| |:| |group|
-|unknownFutureValue|
+|unknownFutureValue|
+
+### plannerPlanContextType values
+
+|Member|
+|:|
+|teamsTab|
+|sharePointPage|
+|meetingNotes|
+|other|
+|unknownFutureValue|
+
v1.0 Group https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/group.md
This resource supports:
|unseenConversationsCount|Int32|Count of conversations that have been delivered one or more new posts since the signed-in user's last visit to the group. This property is the same as **unseenCount**. <br><br>Returned only on $select.| |unseenCount|Int32|Count of conversations that have received new posts since the signed-in user last visited the group. This property is the same as **unseenConversationsCount**.<br><br>Returned only on $select. | |unseenMessagesCount|Int32|Count of new posts that have been delivered to the group's conversations since the signed-in user's last visit to the group. <br><br>Returned only on $select.|
-|visibility|String| Specifies the visibility of a Microsoft 365 group. Possible values are: `Private`, `Public`, or `Hiddenmembership`; blank values are treated as public. See [group visibility options](#group-visibility-options) to learn more.<br>Visibility can be set only when a group is created; it is not editable.<br>Visibility is supported only for unified groups; it is not supported for security groups. <br><br>Returned by default.|
+|visibility|String| Specifies the group join policy and group content visibility for groups. Possible values are: `Private`, `Public`, or `Hiddenmembership`. `Hiddenmembership` can be set only for Microsoft 365 groups, when the groups are created. It can't be updated later. Other values of visibility can be updated after group creation.<br> If visibility value is not specified during group creation on Microsoft Graph, a security group is created as `Private` by default and Microsoft 365 group is `Public`. See [group visibility options](#group-visibility-options) to learn more. <br><br>Returned by default.|
### Group visibility options
Here's what each **visibility** property value means:
| Relationship | Type |Description| |:|:--|:-| |acceptedSenders|[directoryObject](directoryobject.md) collection|The list of users or groups that are allowed to create post's or calendar events in this group. If this list is non-empty then only users or groups listed here are allowed to post.|
+|appRoleAssignments|[appRoleAssignment](approleassignment.md) collection|Represents the app roles a group has been granted for an application. |
|calendar|[calendar](calendar.md)|The group's calendar. Read-only.| |calendarView|[event](event.md) collection|The calendar view for the calendar. Read-only.| |conversations|[conversation](conversation.md) collection|The group's conversations.|
v1.0 Identityuserflow https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/identityuserflow.md
User Flows enable you to define predefined, configurable policies for sign in, s
| Property | Type | Description | |:-|:|:|
-|id|String| Read-only.|
+|id|String| The identifier of the user flow. The prefix of **B2C_1_** is added to the value that you provide.|
|userFlowType|string| Possible values are: `signUp`, `signIn`, `signUpOrSignIn`, `passwordReset`, `profileUpdate`, `resourceOwner`, `unknownFutureValue`.| |userFlowTypeVersion|Single| This is the version of the user flow type. Each user flow type can have different possible versions such as 1, 1.1 or 2. |
v1.0 Intune Devices Devicecompliancescriptdevicestate https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/intune-devices-devicecompliancescriptdevicestate.md
Contains properties for device run state of the device compliance script.
|detectionState|[runState](../resources/intune-shared-runstate.md)|Detection state from the lastest device compliance script execution. Possible values are: `unknown`, `success`, `fail`, `scriptError`, `pending`, `notApplicable`.| |lastStateUpdateDateTime|DateTimeOffset|The last timestamp of when the device compliance script executed| |expectedStateUpdateDateTime|DateTimeOffset|The next timestamp of when the device compliance script is expected to execute|
-|lastSyncDateTime|DateTimeOffset|The last time that Intune Managment Extension synced with Intune|
+|lastSyncDateTime|DateTimeOffset|The last time that Intune Management Extension synced with Intune|
|scriptOutput|String|Output of the detection script| |scriptError|String|Error from the detection script|
v1.0 Intune Devices Devicehealthscriptdevicestate https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/intune-devices-devicehealthscriptdevicestate.md
Contains properties for device run state of the device health script.
|detectionState|[runState](../resources/intune-shared-runstate.md)|Detection state from the lastest device health script execution. Possible values are: `unknown`, `success`, `fail`, `scriptError`, `pending`, `notApplicable`.| |lastStateUpdateDateTime|DateTimeOffset|The last timestamp of when the device health script executed| |expectedStateUpdateDateTime|DateTimeOffset|The next timestamp of when the device health script is expected to execute|
-|lastSyncDateTime|DateTimeOffset|The last time that Intune Managment Extension synced with Intune|
+|lastSyncDateTime|DateTimeOffset|The last time that Intune Management Extension synced with Intune|
|preRemediationDetectionScriptOutput|String|Output of the detection script before remediation| |preRemediationDetectionScriptError|String|Error from the detection script before remediation| |remediationScriptError|String|Error output of the remediation script|
v1.0 Microsoftauthenticatorauthenticationmethodtarget https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/microsoftauthenticatorauthenticationmethodtarget.md
A collection of users or groups enabled to use [Microsoft Authenticator authenti
|isNumberMatchingRequired (Private Preview)|Boolean|Require the user to match the number displayed on the sign-in page to approve the MFA notification.| |isRegistrationRequired|Boolean|Determines whether the user is enforced to register the authentication method. *Not supported*. | |shownContext (Private Preview)|authenticatorAppContextType|Determines what types of context about the sign-in should be shown to the user in the body of the notification. Possible values are: `location`, `app`.|
-|targetType|authenticationMethodTargetType| Possible values are: `user`, `group`.|
+|targetType|authenticationMethodTargetType| Possible values are: `null`, `user`, `group`.|
## Relationships None.
v1.0 Onpremisespublishingsinglesignon https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/onpremisespublishingsinglesignon.md
Title: "kerberosSignOnSettings resource type"
+ Title: "onPremisesPublishingSingleSignOn resource type"
description: "Represents the single-sign on settings for an on-premises application published via Application Proxy." localization_priority: Normal
If you are configuring password-based single-sign this must be set using [create
| Property | Type | Description | |:-|:|:| |kerberosSignOnSettings| [kerberosSignOnSettings](kerberossignonsettings.md)| The Kerberos Constrained Delegation settings for applications that use Integrated Window Authentication. |
-|singleSignOnMode|String| The preferred single-sign on mode for the application. Possible values are: `none`, `onPremisesKerberos`, `headerBased`.|
+|singleSignOnMode|singleSignOnMode| The preferred single-sign on mode for the application. Possible values are: `none`, `onPremisesKerberos`, `aadHeaderBased`,`pingHeaderBased`. |
## JSON representation
v1.0 Outlookcategory https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/outlookcategory.md
Here is a JSON representation of the resource.
"section": "documentation", "tocPath": "", "suppressions": [
- "Warning: /api-reference/bet:\r\n Failed to parse any rows out of table with headers: |Pre-set constant|Color mapped to in Outlook|"
] } -->
v1.0 Permission https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/permission.md
- Title: permission resource type description: permission resource representing a sharing permission granted for a driveItem localization_priority: Normal
Here is a JSON representation of the resource.
### Roles property values
-| Role | Details |
+| Value | Description |
|:|:-| | read | Provides the ability to read the metadata and contents of the item. | | write | Provides the ability to read and modify the metadata and contents of the item. |
v1.0 Personorgroupcolumn https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/personOrGroupColumn.md
Here is a JSON representation of a **personOrGroupColumn** resource.
| **displayAs** | string | How to display the information about the person or group chosen. See below. | **chooseFromType** | string | Whether to allow selection of people only, or people and groups. Must be one of `peopleAndGroups` or `peopleOnly`.
-## DisplayAs values
+## displayAs values
-| DisplayAs value | Description |
+| Value | Description |
|:|:| | **account** | The raw SharePoint encoded claim string for the person or group (eg. `i:0#.f|membership|jane@contoso.com`). | | **department** | The person or group's department. |
v1.0 Planner https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/planner.md
The **planner** resource is the entry point for the Planner object model. It ret
|:|:--|:-| |[Create plannerBucket](../api/planner-post-buckets.md) |[plannerBucket](plannerbucket.md)| Create a new **plannerBucket** by posting to the buckets collection.| |[Create plannerPlan](../api/planner-post-plans.md) |[plannerPlan](plannerplan.md)| Create a new **plannerPlan** by posting to the plans collection.|
+|[Create plannerRoster](../api/planner-post-rosters.md)|[plannerRoster](plannerroster.md)|Create a new **plannerRoster** by posting to rosters collection.|
|[Create plannerTask](../api/planner-post-tasks.md) |[plannerTask](plannertask.md)| Create a new **plannerTask** by posting to the tasks collection.| ## Properties
The **planner** resource is the entry point for the Planner object model. It ret
|:|:--|:-| |buckets|[plannerBucket](plannerbucket.md) collection| Read-only. Nullable. Returns a collection of the specified buckets| |plans|[plannerPlan](plannerplan.md) collection| Read-only. Nullable. Returns a collection of the specified plans|
+|rosters|[plannerRoster](plannerroster.md) collection|Read-only. Nullable. Returns a collection of the specified rosters|
|tasks|[plannerTask](plannertask.md) collection| Read-only. Nullable. Returns a collection of the specified tasks| ## JSON representation
v1.0 Plannerappliedcategories https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/plannerappliedcategories.md
Title: "plannerAppliedCategories resource type"
-description: "The **AppliedCategoriesCollection** resource represents the collection of categories (or labels) that have been applied to a task. It is part of the plannerTask object."
+description: "Represents the collection of categories (or labels) that have been applied to a task, which is part of the plannerTask object."
localization_priority: Normal ms.prod: "planner"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-The **AppliedCategoriesCollection** resource represents the collection of categories (or labels) that have been applied to a task. It is part of the [plannerTask](plannertask.md) object.
-There can be up to 6 categories applied to a task. Category descriptions, e.g. `category1`, `category2` etc., are part of the [plan details](plannerplandetails.md) object. This is an open type.
+Represents the collection of categories (or labels) that have been applied to a task, which is part of the [plannerTask](plannertask.md) object.
+Up to 25 categories can be applied to a task. Category descriptions, are part of the [plan details](plannerplandetails.md) object. This is an open type.
## Properties
-Properties of an Open Type can be defined by the client. In this case though, the client must provide `category1`, `category2`, `category3`, `category4`, `category5` and/or `category6` as properties with their values being the `true` boolean when the corresponding categories are applied on the task. Example is shown below. When they do not apply, properties are automatically removed by setting their values to the `false` boolean.
+Properties of an open type can be defined by the client. In this case, the client must provide **category1**, **category2**, **category3**, **category4**, **category5**, and so on up to **category25** as properties with their values being `true` when the corresponding categories are applied on the task. When they do not apply, properties are automatically removed by setting their values to `false`, as shown in the following example.
+
+```json
+{
+ "category1": true,
+ "category3": true,
+ "category5": true,
+ "category21": true
+}
+```
## JSON representation
-Here is a JSON representation of the resource
+The following is a JSON representation of the resource.
<!-- { "blockType": "resource",
Here is a JSON representation of the resource
} ```
-Example:
-
-```json
-{
- "category1": true,
- "category3": true,
- "category5": true
-}
-```
- <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!--
v1.0 Plannercategorydescriptions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/plannercategorydescriptions.md
Title: "plannerCategoryDescriptions resource type"
-description: "The **plannerCategoryDescriptions** resource represents the descriptive labels for the categories that have been defined for a plan. It belongs to the plan details object. There can be up to 6 categories defined. "
+description: "Represents the descriptive labels for the categories that have been defined for a plan."
localization_priority: Normal ms.prod: "planner"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-The **plannerCategoryDescriptions** resource represents the descriptive labels for the categories that have been defined for a plan. It belongs to the [plan details](plannerplandetails.md) object. There can be up to 6 categories defined.
-
+Represents the descriptive labels for the categories that have been defined for a plan. This resource is associated with the [plan details](plannerplandetails.md) object. Up to 25 categories can be defined.
## Properties
-| Property | Type |Description|
-|:|:--|:-|
+|Property|Type|Description|
+|:|:|:|
|category1|String|The label associated with Category 1| |category2|String|The label associated with Category 2| |category3|String|The label associated with Category 3| |category4|String|The label associated with Category 4| |category5|String|The label associated with Category 5| |category6|String|The label associated with Category 6|
+|category7|String|The label associated with Category 7|
+|category8|String|The label associated with Category 8|
+|category9|String|The label associated with Category 9|
+|category10|String|The label associated with Category 10|
+|category11|String|The label associated with Category 11|
+|category12|String|The label associated with Category 12|
+|category13|String|The label associated with Category 13|
+|category14|String|The label associated with Category 14|
+|category15|String|The label associated with Category 15|
+|category16|String|The label associated with Category 16|
+|category17|String|The label associated with Category 17|
+|category18|String|The label associated with Category 18|
+|category19|String|The label associated with Category 19|
+|category20|String|The label associated with Category 20|
+|category21|String|The label associated with Category 21|
+|category22|String|The label associated with Category 22|
+|category23|String|The label associated with Category 23|
+|category24|String|The label associated with Category 24|
+|category25|String|The label associated with Category 25|
## JSON representation
-Here is a JSON representation of the resource.
-
+The following is a JSON representation of the resource.
<!-- { "blockType": "resource", "optionalProperties": [
Here is a JSON representation of the resource.
```json {
+ "@odata.type": "#microsoft.graph.plannerCategoryDescriptions",
"category1": "String", "category2": "String", "category3": "String", "category4": "String", "category5": "String",
- "category6": "String"
+ "category6": "String",
+ "category7": "String",
+ "category8": "String",
+ "category9": "String",
+ "category10": "String",
+ "category11": "String",
+ "category12": "String",
+ "category13": "String",
+ "category14": "String",
+ "category15": "String",
+ "category16": "String",
+ "category17": "String",
+ "category18": "String",
+ "category19": "String",
+ "category20": "String",
+ "category21": "String",
+ "category22": "String",
+ "category23": "String",
+ "category24": "String",
+ "category25": "String"
} ```
v1.0 Plannerplancontainer https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/plannerplancontainer.md
doc_type: resourcePageType
Namespace: microsoft.graph + Represents a container for a [plannerPlan](plannerPlan.md). The container is a resource that specifies authorization rules and the lifetime of the plan. This means that only the people who are authorized to work with the resource containing the plan will be able to work with the plan and the tasks within it. When the containing resource is deleted, the contained plans are also deleted. Properties of **plannerPlanContainer** cannot be changed after the plan is created. Planner currently supports the container types listed in the following table. When creating a plan, the **containerUrl** property must be specified with the path of the resource identified in the table. |Type|Description|Path to the resource| |-|--|--|
-|group| Plan is contained by a group.| https://graph.microsoft.com/v1.0/groups/&lt;id&gt;|
+|group| Plan is contained by a [group](group.md).| https://graph.microsoft.com/beta/groups/&lt;id&gt;|
+|roster| Plan is container by a [plannerRoster](plannerroster.md) | https://graph.microsoft.com/beta/planner/rosters/&lt;id&gt;|
## Properties |Property|Type|Description| |:|:|:| |containerId|String|The identifier of the resource that contains the plan.|
-|type|plannerContainerType| The type of the resource that contains the plan. See the previous table for supported types. Possible values are: `group`, `unknownFutureValue`.|
+|type|plannerContainerType| The type of the resource that contains the plan. See the previous table for supported types. Possible values are: `group`, `roster`, `unknownFutureValue`.|
|url|String|The full canonical URL of the container.| ## Relationships
v1.0 Plannerplancontext https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/plannerplancontext.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-The **plannerPlanContext** resource represents the relationship of a [plannerPlan](plannerplan.md) to a user experience outside of Planner. Plans in Planner can be surfaced in other experiences, such as Microsoft Teams, to track work in the context of that experience.
-The experience the **plannerPlanContext** entry reresents can be identified based on the **ownerAppId** property:
-- 5e3ce6c0-2b1f-4285-8d4b-75ee78787346 : The context entry belongs to Microsoft Teams.-- 00000003-0000-0ff1-ce00-000000000000 : The context entry belongs to SharePoint.
+The **plannerPlanContext** resource represents the relationship of a [plannerPlan](plannerplan.md) to a user experience outside of Planner. Plans in Planner can be surfaced in other experiences, such as Microsoft Teams, to track work in the context of that experience. Experiences that have external links in the [plannerPlanContextDetails](plannerplancontextdetails.md) can be displayed in a user interface, allowing users to visit these experiences.
+ ## Properties | Property | Type |Description|
The experience the **plannerPlanContext** entry reresents can be identified base
|associationType|String|Nullable. An app-defined type of association between the [plannerPlan](plannerplan.md) and the app. The app can use this information to track different kinds of relationships to the same [plannerPlan](plannerplan.md).| |createdDateTime|DateTimeOffset|Read-only. The date and time when the **plannerPlanContext** was created. 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 would look like this: `'2014-01-01T00:00:00Z'`.| |displayNameSegments|String collection|The segments of the name of the external experience. Segments represent a hierarchical structure that allows other apps to display the relationship.|
+|isCreationContext|Boolean|Read-only. Indicates whether the plan is created from the specified context. Auto-generated based on whether the context is specified as part of plan creation.|
|ownerAppId|String|Read-only. ID of the app that created the **plannerPlanContext**.| ## JSON representation
The following is a JSON representation of the resource.
"Finance Team", "Budget Plans" ],
+ "isCreationContext": false,
"ownerAppId": "5e3ce6c0-2b1f-4285-8d4b-75ee78787346" }
v1.0 Plannerplancontextdetails https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/plannerplancontextdetails.md
The **plannerPlanContextDetails** resource contains additional information about
## Properties | Property | Type |Description| |:|:--|:-|
-|url|String|URL of the user experience represented by the associated [plannerPlanContext](plannerplancontext.md). |
+|customLinkText|String|Nullable. Specifies the text to use in a user experience to display a link the the associated [plannerPlanContext](plannerplancontext.md). If null, applications should display the link with a custom text based on the **displayLinkType** property.|
+|displayLinkType|plannerPlanContextType|Specifies how an application should display the link to the associated **plannerPlanContext**. Applications may choose to provide customized text, description, icons, or other experiences based on the type of the link. Possible values are: `teamsTab`, `sharePointPage`, `meetingNotes`, `other`, `unknownFutureValue`.|
+|url|String|URL of the user experience represented by the associated **plannerPlanContext**. |
## JSON representation
The following is a JSON representation of the resource.
```json {
- "url": "String"
+ "url": "http://www.microsoft.com",
+ "customLinkText": "Visit Microsoft's home page.",
+ "displayLinkType": "other"
} ```
v1.0 Plannerplandetails https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/plannerplandetails.md
The **plannerPlanDetails** resource represents the additional information about
## Properties | Property | Type |Description| |:|:--|:-|
-|categoryDescriptions|[plannerCategoryDescriptions](plannercategorydescriptions.md)|An object that specifies the descriptions of the six categories that can be associated with tasks in the plan|
+|categoryDescriptions|[plannerCategoryDescriptions](plannercategorydescriptions.md)|An object that specifies the descriptions of the 25 categories that can be associated with tasks in the plan|
|id|String| Read-only. The ID of the plan details. It is 28 characters long and case-sensitive. [Format validation](tasks-identifiers-disclaimer.md) is done on the service.| |sharedWith|[plannerUserIds](planneruserids.md)|The set of user IDs that this plan is shared with. If you are using Microsoft 365 groups, use the groups API to manage group membership to share the [group's](group.md) plan. You can also add existing members of the group to this collection, although it is not required in order for them to access the plan owned by the group. | |contextDetails|[plannerPlanContextDetailsCollection](plannerplancontextdetailscollection.md)|Read-only. A collection of additional information associated with [plannerPlanContext](plannerplancontext.md) entries that are defined for the [plannerPlan](plannerplan.md) container. |
v1.0 Plannerroster https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/plannerroster.md
+
+ Title: "plannerRoster resource type"
+description: "The **plannerRoster** resource represents a collection of users who are collaborating on a plannerPlan."
+
+localization_priority: Normal
++
+# plannerRoster resource type
+
+Namespace: microsoft.graph
++
+The **plannerRoster** resource represents a collection of users who are collaborating on a [plannerPlan](plannerplan.md). A **plannerRoster** is a simple set of users, where everyone has the same level of permissions and they can be created by everyone, unless disabled by the tenant administrator. A **plannerRoster** can contain one plan.
+
+Deleting a **plannerRoster** will also delete the plan and all tasks in the plan. A **plannerRoster** will also be automatically deleted under the following conditions:
+
+* The **plannerRoster** doesn't contain a plan 24 hours after its creation. Membership information will be completely erased within 30 days of this deletion.
+* The **plannerRoster** doesn't have any users remaining in the membership list because the last user removed themselves. Roster, its plan and all contained tasks will be deleted within 30 days of this operation.
+* The **plannerRoster** doesn't have any users remaining in the membership list because the last user was permanently deleted. Roster, its plan and all contained tasks will be deleted immediately. Deleted users are permanently erased wihtin 30 days of their deletion; however, tenant administrators can also choose to permanently delete users without this delay.
++
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[Create plannerRoster](../api/planner-post-rosters.md)|[plannerRoster](../resources/plannerroster.md)|Create a new [plannerRoster](../resources/plannerroster.md) object.|
+|[Get plannerRoster](../api/plannerroster-get.md)|[plannerRoster](../resources/plannerroster.md)|Read the properties and relationships of a [plannerRoster](../resources/plannerroster.md) object.|
+|[Delete plannerRoster](../api/plannerroster-delete.md)|None|Deletes a [plannerRoster](../resources/plannerroster.md) object.|
+|[List members](../api/plannerroster-list-members.md)|[plannerRosterMember](../resources/plannerrostermember.md) collection|Get the plannerRosterMember resources from the members navigation property.|
+|[Create plannerRosterMember](../api/plannerroster-post-members.md)|[plannerRosterMember](../resources/plannerrostermember.md)|Create a new plannerRosterMember object.|
+|[List plans](../api/plannerroster-list-plans.md)|[plannerPlan](../resources/plannerplan.md) collection|Get the plannerPlan resources from the plans navigation property.|
+|[List user's rosterPlans](../api/planneruser-list-rosterplans.md)|[plannerPlan](plannerplan.md) collection| Get the [plannerPlans](plannerplan.md) contained by the [plannerRosters](plannerroster.md) that the user is a member.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|Read only. Identifier of the **plannerRoster**. Inherited from [entity](../resources/entity.md)|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|members|[plannerRosterMember](../resources/plannerrostermember.md) collection|Retrieves the members of the **plannerRoster**.|
+|plans|[plannerPlan](../resources/plannerplan.md) collection|Retrieves the plans contained by the **plannerRoster**.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.plannerRoster",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.plannerRoster",
+ "id": "String (identifier)"
+}
+```
+
v1.0 Plannerrostermember https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/plannerrostermember.md
+
+ Title: "plannerRosterMember resource type"
+description: "Represents a member of a plannerRoster."
+
+localization_priority: Normal
++
+# plannerRosterMember resource type
+
+Namespace: microsoft.graph
++
+Represents a member of a [plannerRoster](plannerRoster.md).
++
+Inherits from [entity](../resources/entity.md).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List plannerRosterMembers](../api/plannerroster-list-members.md)|[plannerRosterMember](../resources/plannerrostermember.md) collection|Get a list of the [plannerRosterMember](../resources/plannerrostermember.md) objects and their properties.|
+|[Create plannerRosterMember](../api/plannerroster-post-members.md)|[plannerRosterMember](../resources/plannerrostermember.md)|Create a new [plannerRosterMember](../resources/plannerrostermember.md) object.|
+|[Get plannerRosterMember](../api/plannerrostermember-get.md)|[plannerRosterMember](../resources/plannerrostermember.md)|Read the properties and relationships of a [plannerRosterMember](../resources/plannerrostermember.md) object.|
+|[Delete plannerRosterMember](../api/plannerrostermember-delete.md)|None|Deletes a [plannerRosterMember](../resources/plannerrostermember.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|The identifier of the **plannerRosterMember**. Inherited from [entity](../resources/entity.md)|
+|roles|String collection|Additional roles associated with the **PlannerRosterMember**, which determines permissions of the member in the **plannerRoster**. Currently there are no available roles to assign, and every member has full control over the contents of the **plannerRoster**.|
+|tenantId|String|Identifier of the tenant the user belongs to. Currently only the users from the same tenant can be added to a **plannerRoster**. |
+|userId|String|Identifier of the [user](user.md).|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.plannerRosterMember",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.plannerRosterMember",
+ "id": "String (identifier)",
+ "userId": "String",
+ "tenantId": "String",
+ "roles": []
+}
+```
+
v1.0 Planneruser https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/planneruser.md
The **plannerUser** resource provides access to Planner resources for a [user](u
|[List tasks](../api/planneruser-list-tasks.md) |[plannerTask](plannertask.md) collection| Get the [plannerTasks](plannertask.md) assigned to the user.| |[List favoritePlans](../api/planneruser-list-favoriteplans.md) |[plannerPlan](plannerplan.md) collection| Get the [plannerPlans](plannerplan.md) marked as favorite by the user.| |[List recentPlans](../api/planneruser-list-recentplans.md) |[plannerPlan](plannerplan.md) collection| Get the [plannerPlans](plannerplan.md) recently viewed by the user.|
+|[List rosterPlans](../api/planneruser-list-rosterplans.md)|[plannerPlan](plannerplan.md) collection| Get the [plannerPlans](plannerplan.md) contained by the [plannerRosters](plannerroster.md) that the user is a member.|
|[Update](../api/planneruser-update.md) | [plannerUser](planneruser.md)| Update a **plannerUser** object. |
The **plannerUser** resource provides access to Planner resources for a [user](u
|tasks|[plannerTask](plannertask.md) collection| Read-only. Nullable. Returns the [plannerTasks](plannertask.md) assigned to the user.| |favoritePlans|[plannerPlan](plannerplan.md) collection| Read-only. Nullable. Returns the [plannerPlans](plannerplan.md) that the user marked as favorites.| |recentPlans|[plannerPlan](plannerplan.md) collection| Read-only. Nullable. Returns the [plannerPlans](plannerplan.md) that have been recently viewed by the user in apps that support recent plans. |
+|rosterPlans|[plannerPlan](../resources/plannerplan.md) collection|Read-only. Nullable. Returns the [plannerPlans](plannerplan.md) contained by the [plannerRosters](plannerroster.md) the user is a member.|
## JSON representation The following is a JSON representation of the resource.
v1.0 Print https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/print.md
The following is a JSON representation of the resource.
"section": "documentation", "tocPath": "", "suppressions": [
- "Error: Resource print has documented navigation properties, but we thought it was a complex type!",
- "Resource print has documented navigation properties, but we thought it was a complex type!"
+ ]
}-->
v1.0 Printerdefaults https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/printerdefaults.md
Represents the printer's default settings. Check the printer's [capabilities](pr
|mediaSize|String|The default media size to use. Supports standard size names for ISO and ANSI media sizes, along with any custom sizes supported by the associated printer. |pagesPerSheet|Int32|The default number of document pages to print on each sheet. |orientation|printOrientation|The default orientation to use when printing the document. Valid values are described in the following table.|
+|inputBin|String|The default input bin that serves as the paper source.|
|outputBin|String|The default output bin to place completed prints into. See the printer's [capabilities](printercapabilities.md) for a list of supported output bins.| |fitPdfToPage|Boolean|The default fitPdfToPage setting. True to fit each page of a PDF document to a physical sheet of media; false to let the printer decide how to lay out impressions.| |multipageLayout|printMultipageLayout|The default direction to lay out pages when multiple pages are being printed per sheet. Valid values are described in the following table.|
v1.0 Projectrome Notification https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/projectrome-notification.md
The following is a JSON representation of the resource.
"displayTimeToLive": 1024, "expirationDateTime": "String (timestamp)", "priority": "string",
- "fallbackPolicy": {"@odata.type": "microsoft.graph.fallbackpolicy"},
+ "fallbackPolicy": {"@odata.type": "microsoft.graph.fallbackpolicy"}
} ```
v1.0 Recurrencerange https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/recurrencerange.md
Here is a JSON representation of the resource
"section": "documentation", "tocPath": "", "suppressions": [
- "Warning: /api-reference/bet:\r\n Failed to parse any rows out of table with headers: | type property | Type of recurrence range | Description | Example | Required properties |"
] } -->
v1.0 Serviceprincipal https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/serviceprincipal.md
This resource supports using [delta query](/graph/delta-query-overview) to track
| Relationship | Type |Description| |:|:--|:-|
-|appRoleAssignedTo|[appRoleAssignment](approleassignment.md)|Principals (users, groups, and service principals) that are assigned to this service principal. Read-only.|
-|appRoleAssignments|[appRoleAssignment](approleassignment.md) collection|Applications that this service principal is assigned to. Read-only. Nullable.|
+|appRoleAssignedTo|[appRoleAssignment](approleassignment.md)|App role assignments for this app or service, granted to users, groups, and other service principals.|
+|appRoleAssignments|[appRoleAssignment](approleassignment.md) collection|App role assignment for another app or service, granted to this service principal.|
|claimsMappingPolicies|[claimsMappingPolicy](claimsmappingpolicy.md) collection|The claimsMappingPolicies assigned to this service principal.| |createdObjects|[directoryObject](directoryobject.md) collection|Directory objects created by this service principal. Read-only. Nullable.| |delegatedPermissionClassifications|[delegatedPermissionClassification](delegatedpermissionclassification.md) collection|The permission classifications for delegated permissions exposed by the app that this service principal represents.|
v1.0 Smsauthenticationmethodconfiguration https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/smsauthenticationmethodconfiguration.md
+
+ Title: "smsAuthenticationMethodConfiguration resource type"
+description: "Represents a Text Message authentication methods policy."
+
+localization_priority: Normal
++
+# smsAuthenticationMethodConfiguration resource type
+Namespace: microsoft.graph
++
+Represents a Text Message authentication methods policy. Authentication methods policies define configuration settings and users or groups that are enabled to use the authentication method.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[Get](../api/smsauthenticationmethodconfiguration-get.md)|[smsAuthenticationMethodConfiguration](../resources/smsauthenticationmethodconfiguration.md)|Read the properties and relationships of a smsAuthenticationMethodConfiguration object.|
+|[Update](../api/smsauthenticationmethodconfiguration-update.md)|[smsAuthenticationMethodConfiguration](../resources/smsauthenticationmethodconfiguration.md)|Update the properties of a smsAuthenticationMethodConfiguration object.|
+|[Delete](../api/smsauthenticationmethodconfiguration-delete.md)|None|Reverts the smsAuthenticationMethodConfiguration object to its default configuration.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|The authentication method policy identifier.|
+|state|authenticationMethodState|Possible values are: `enabled`, `disabled`.|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|includeTargets|[smsAuthenticationMethodTarget](../resources/smsauthenticationmethodtarget.md) collection|A collection of users or groups who are enabled to use the authentication method.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.smsAuthenticationMethodConfiguration",
+ "baseType": "microsoft.graph.authenticationMethodConfiguration",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.smsAuthenticationMethodConfiguration",
+ "id": "String (identifier)",
+ "state": "String"
+}
+```
+
v1.0 Smsauthenticationmethodtarget https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/smsauthenticationmethodtarget.md
+
+ Title: "smsAuthenticationMethodTarget resource type"
+description: "A collection of users or groups enabled to use Text Message authentication methods policy."
+
+localization_priority: Normal
++
+# smsAuthenticationMethodTarget resource type
+Namespace: microsoft.graph
++
+A collection of users or groups enabled to use [Text Message authentication methods policy](../resources/smsAuthenticationMethodConfiguration.md) in Azure AD.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|Object ID of an Azure AD user or group.|
+|isRegistrationRequired|Boolean|Determines whether the user is enforced to register the authentication method. **Not supported**.|
+|isUsableForSignIn|Boolean|Determines if the users or groups can use this authentication method to sign in to Azure AD. The value is always `true`.|
+|targetType|authenticationMethodTargetType| Possible values are: `user`, `group`.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.smsAuthenticationMethodTarget",
+ "baseType": "microsoft.graph.authenticationMethodTarget",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.smsAuthenticationMethodTarget",
+ "targetType": "String",
+ "id": "String (identifier)",
+ "isRegistrationRequired": "Boolean",
+ "isUsableForSignIn": "Boolean"
+}
+```
v1.0 Statusdetails https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/statusdetails.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Describes the status of the provisioning event and the associated errors. It is inherited from [statusBase](/graph/api/resources/statusbase?view=graph-rest-beta) and only used when status is set to 'failure'.
+Describes the status of the provisioning event and the associated errors. It is inherited from [statusBase](/graph/api/resources/statusbase) and only used when status is set to `failure`.
## Properties
Describes the status of the provisioning event and the associated errors. It is
|:-|:|:| |status|String|Possible values are: `success`, `failure`, `skipped`, `unknownFutureValue`. Inherited from statusBase.| |additionalDetails|String|Additional details in case of error.|
-|errorCategory|String|Categorizes the error code.|
-|errorCode|String|Unique error code if any occurred.|
+|errorCategory|String|Categorizes the error code. Possible values are `Failure`, `NonServiceFailure`, `Success`.|
+|errorCode|String|Unique error code if any occurred. [Learn more](https://docs.microsoft.com/azure/active-directory/reports-monitoring/concept-provisioning-logs#error-codes)|
|reason|String|Summarizes the status and describes why the status happened.| |recommendedAction|String|Provides the resolution for the corresponding error.|
v1.0 Synchronization Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/synchronization-overview.md
GET https://graph.microsoft.com/beta/servicePrincipals?$select=id,appId,displayN
<!-- { "blockType": "ignored" } --> ```http HTTP/1.1 200 OK+ {
- "value": [
- {
- "id": "bc0dc311-87df-48ac-91b1-259bd2c3a31c",
- "appId": "f7808c5e-cb57-4e37-8094-406d302c0f8d",
- "displayName": "Salesforce"
- },
- {
- "id": "d813d7d7-0f41-4edc-b284-d0dfaf399d15",
- "appId": "219561ee-1480-4c67-9aa6-63d861fae3ef",
- "displayName": "salesforce 3"
- }
- ]
+ "value":[
+ {
+ "id":"bc0dc311-87df-48ac-91b1-259bd2c3a31c",
+ "appId":"f7808c5e-cb57-4e37-8094-406d302c0f8d",
+ "displayName":"Salesforce"
+ },
+ {
+ "id":"d813d7d7-0f41-4edc-b284-d0dfaf399d15",
+ "appId":"219561ee-1480-4c67-9aa6-63d861fae3ef",
+ "displayName":"salesforce 3"
+ }
+ ]
} ```
GET https://graph.microsoft.com/beta/servicePrincipals?$select=id,appId,displayN
<!-- { "blockType": "ignored" } --> ```http HTTP/1.1 200 OK+ { "value": [ {
GET https://graph.microsoft.com/beta/servicePrincipals/60443998-8cf7-4e61-b05c-a
<!-- { "blockType": "ignored" } --> ```http HTTP/1.1 200 OK+ { "value": [ {
GET https://graph.microsoft.com/beta/servicePrincipals/60443998-8cf7-4e61-b05c-a
**Response** <!-- { "blockType": "ignored" } --> ```http
- HTTP/1.1 200 OK
- {
- "id": "SfSandboxOutDelta.e4bbf44533ea4eabb17027f3a92e92aa",
- "templateId": "SfSandboxOutDelta",
- "schedule": {
- "expiration": null,
- "interval": "PT20M",
- "state": "Active"
- },
- "status": {}
- }
+HTTP/1.1 200 OK
+
+{
+ "id": "SfSandboxOutDelta.e4bbf44533ea4eabb17027f3a92e92aa",
+ "templateId": "SfSandboxOutDelta",
+ "schedule": {
+ "expiration": null,
+ "interval": "PT20M",
+ "state": "Active"
+ },
+ "status": {}
+}
``` ### Get synchronization schema
GET https://graph.microsoft.com/beta/servicePrincipals/{id}/synchronization/jobs
<!-- { "blockType": "ignored" } --> ```http HTTP/1.1 200 OK+ { "directories": [], "synchronizationRules": []
v1.0 Teamdiscoverysettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/teamdiscoverysettings.md
The following is a JSON representation of the resource.
"section": "documentation", "tocPath": "", "suppressions": [
- "Error: /api-reference/bet)\r\n at ApiDoctor.Validation.DocFile.get_LinkDestinations()\r\n at ApiDoctor.Validation.DocSet.ValidateLinks(Boolean includeWarnings, String[] relativePathForFiles, IssueLogger issues, Boolean requireFilenameCaseMatch, Boolean printOrphanedFiles)"
] }-->
v1.0 Temporaryaccesspassauthenticationmethod https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/temporaryaccesspassauthenticationmethod.md
+
+ Title: "temporaryAccessPassAuthenticationMethod resource type"
+description: "Represents a Temporary Access Pass registered to a user."
++
+localization_priority: Normal
++
+# temporaryAccessPassAuthenticationMethod resource type
+
+Namespace: microsoft.graph
++
+Represents a Temporaty Access Pass registered to a user. A Temporary Access Pass is a time-limited passcode that serves as a strong credential and allows onboarding of passwordless credentials.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List](../api/temporaryaccesspassauthenticationmethod-list.md)|[temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md) collection|Retrieve a list of a user's **temporaryAccessPassAuthenticationMethod** objects and their properties. Users can only have one Temporary Access Pass authentication method.|
+|[Create](../api/temporaryaccesspassauthenticationmethod-post.md)|[temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md)|Create a user's **temporaryAccessPassAuthenticationMethod** object.|
+|[Get](../api/temporaryaccesspassauthenticationmethod-get.md)|[temporaryAccessPassAuthenticationMethod](../resources/temporaryaccesspassauthenticationmethod.md)|Retrieve the properties of the user's **temporaryAccessPassAuthenticationMethod** object.||
+|[Delete](../api/temporaryaccesspassauthenticationmethod-delete.md)|None|Delete a user's **temporaryAccessPassAuthenticationMethod** object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|The identifier of the Temporary Access Pass registered to this user.|
+|temporaryAccessPass|String|The temporaryAccessPass used to authenticate. Returned only on creation of a new temporaryAccessPass; returned as NULL with GET.|
+|createdDateTime|DateTimeOffset|The date and time when the temporaryAccessPass was created.|
+|startDateTime|DateTimeOffset|The date and time when the temporaryAccessPass becomes available to use.|
+|lifetimeInMinutes|Int32|The lifetime of the temporaryAccessPass in minutes starting at startDateTime. Minimum 10, Maximum 43200 (equivalent to 30 days).|
+|isUsableOnce|Boolean|Determines whether the pass is limited to a one time use. If `true`, the pass can be used once; if `false`, the pass can be used multiple times within the temporaryAccessPass lifetime.|
+|isUsable|Boolean|The state of the authentication method that indicates whether it's currently usable by the user.|
+|methodUsabilityReason|String|Details about usability state (isUsable). Reasons can include: `enabledByPolicy`, `disabledByPolicy`, `expired`, `notYetValid`, `oneTimeUsed`.|
++
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.temporaryAccessPassAuthenticationMethod",
+ "baseType": "microsoft.graph.authenticationMethod",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.temporaryAccessPassAuthenticationMethod",
+ "id": "String (identifier)",
+ "temporaryAccessPass": "String",
+ "createdDateTime": "String (timestamp)",
+ "startDateTime": "String (timestamp)",
+ "lifetimeInMinutes": "Integer",
+ "isUsableOnce": "Boolean",
+ "isUsable": "Boolean",
+ "methodUsabilityReason": "String"
+}
+```
v1.0 Temporaryaccesspassauthenticationmethodconfiguration https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/temporaryaccesspassauthenticationmethodconfiguration.md
+
+ Title: "temporaryAccessPassAuthenticationMethodConfiguration resource type"
+description: "Represents a Temporary Access Pass authentication methods policy."
++
+localization_priority: Normal
++
+# temporaryAccessPassAuthenticationMethodConfiguration resource type
+Namespace: microsoft.graph
++
+Represents a Temporary Access Pass authentication methods policy. The Authentication methods policy defines the configuration settings and users or groups who are enabled to use the authentication method.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[Get](../api/temporaryaccesspassauthenticationmethodconfiguration-get.md)|[temporaryaccesspassauthenticationmethodconfiguration](../resources/temporaryaccesspassauthenticationmethodconfiguration.md)|Read the properties and relationships of a **temporaryaccesspassauthenticationmethodconfiguration** object.|
+|[Update](../api/temporaryaccesspassauthenticationmethodconfiguration-update.md)|[temporaryaccesspassauthenticationmethodconfiguration](../resources/temporaryaccesspassauthenticationmethodconfiguration.md)|Update the properties of a **temporaryaccesspassauthenticationmethodconfiguration** object.|
+|[Delete](../api/temporaryaccesspassauthenticationmethodconfiguration-delete.md)|None|Reverts the **temporaryaccesspassauthenticationmethodconfiguration** object to its default configuration.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|The authentication method policy identifier.|
+|minimumLifetimeInMinutes|Int|Minimum lifetime in minutes for any temporaryAccessPass created in the tenant. Value can be between 10 and 43200 minutes (equivalent to 30 days).|
+|maximumLifetimeInMinutes|Int|Maximum lifetime in minutes for any temporaryAccessPass created in the tenant. Value can be between 10 and 43200 minutes (equivalent to 30 days).|
+|defaultLifetimeInMinutes|int|Default lifetime, in minutes, for a temporaryAccessPass. Value can be between the minimumLifetimeInMinutes and maximumLifetimeInMinutes.|
+|defaultLength|int|Default length, in characters, of a temporaryAccessPass, between 8 and 48 characters.|
+|isUsableOnce|Boolean |If `true`, all the passes in the tenant will be restricted to one-time use. If `false`, passes in the tenant can be created to be either one-time use or multiple time use.|
+|state|authenticationMethodState|Possible values are: `enabled`, `disabled`.|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|includeTargets|[authenticationMethodTarget](../resources/authenticationmethodtarget.md) collection|A collection of users or groups who are enabled to use the authentication method.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+
+``` json
+{
+ "@odata.type": "#microsoft.authMethodPolicy.temporaryAccessPassAuthenticationMethodConfiguration",
+ "id": "String (identifier)",
+ "state": "String",
+ "defaultLifetimeInMinutes": "Integer",
+ "defaultLength": "Integer",
+ "minimumLifetimeInMinutes": "Integer",
+ "maximumLifetimeInMinutes": "Integer",
+ "isUsableOnce": "Boolean"
+},
+"includeTargets": [ { "@odata.type": "microsoft.graph.authenticationMethodTarget" } ]
+}
+```
v1.0 Termstore Localizedname https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/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 ms.prod: "sharepoint-taxonomy" doc_type: resourcePageType
v1.0 User https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/user.md
This resource supports:
| ageGroup | [ageGroup](#agegroup-values) | Sets the age group of the user. Allowed values: `null`, `minor`, `notAdult` and `adult`. Refer to the [legal age group property definitions](#legal-age-group-property-definitions) for further information. <br><br>Returned only on `$select`. | | assignedLicenses | [assignedLicense](assignedlicense.md) collection | The licenses that are assigned to the user. <br><br>Returned only on `$select`. Not nullable. | | assignedPlans | [assignedPlan](assignedplan.md) collection | The plans that are assigned to the user. <br><br>Returned only on `$select`. Read-only. Not nullable. |
-| birthday | DateTimeOffset | The birthday of the user. 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 would look like this: `'2014-01-01T00:00:00Z'` <br><br>Returned only on `$select`. |
+| birthday | DateTimeOffset | The birthday of the user. 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 only on `$select`. |
| businessPhones | String collection | The telephone numbers for the user. Only one number can be set for this property. <br><br>Returned by default. Read-only for users synced from on-premises directory. | | city | String | The city in which the user is located. <br><br>Returned only on `$select`. Supports `$filter`. | | companyName | String | The company name which the user is associated. This property can be useful for describing the company that an external user comes from. The maximum length of the company name is 64 chararcters.<br><br>Returned only on `$select`. |
This resource supports:
| externalUserStateChangeDateTime | String | Shows the timestamp for the latest change to the externalUserState property. <br><br>Returned only on $select. | | faxNumber | String | The fax number of the user. <br><br>Returned only on `$select`. | | givenName | String | The given name (first name) of the user. <br><br>Returned by default. Supports `$filter`.|
-| hireDate | DateTimeOffset | The hire date of the user. 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 would look like this: `'2014-01-01T00:00:00Z'`. <br><br>Returned only on `$select`. <br><br> **Note:** This property is specific to SharePoint Online. We recommend using the native **employeeHireDate** property to set and update hire date values using Microsoft Graph APIs. |
+| hireDate | DateTimeOffset | The hire date of the user. 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 only on `$select`. <br><br> **Note:** This property is specific to SharePoint Online. We recommend using the native **employeeHireDate** property to set and update hire date values using Microsoft Graph APIs. |
| id | String | The unique identifier for the user. Should be treated as an opaque identifier. Inherited from [directoryObject](directoryobject.md). <br><br>Returned by default. Not nullable. Read-only.| | identities | [objectIdentity](objectIdentity.md) collection | Represents the identities that can be used to sign in to this user account. An identity can be provided by Microsoft (also known as a local account), by organizations, or by social identity providers such as Facebook, Google, and Microsoft, and tied to a user account. May contain multiple items with the same **signInType** value. <br><br>Returned only on `$select`. Supports `$filter`. | | imAddresses | String collection | The instant message voice over IP (VOIP) session initiation protocol (SIP) addresses for the user. Read-only.|
This resource supports:
| interests | String collection | A list for the user to describe their interests. <br><br>Returned only on `$select`. | | isResourceAccount | Boolean | Do not use ΓÇô reserved for future use. | | jobTitle | String | The user's job title. <br><br>Returned by default. Supports `$filter`.|
-| lastPasswordChangeDateTime | DateTimeOffset | The time when this Azure AD user last changed their password. 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 would look like this: `'2014-01-01T00:00:00Z'` <br><br>Returned only on `$select`. |
+| lastPasswordChangeDateTime | DateTimeOffset | The time when this Azure AD user last changed their password. 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 only on `$select`. Read-only. |
| legalAgeGroupClassification | [legalAgeGroupClassification](#legalagegroupclassification-values) | Used by enterprise applications to determine the legal age group of the user. This property is read-only and calculated based on **ageGroup** and **consentProvidedForMinor** properties. Allowed values: `null`, `minorWithOutParentalConsent`, `minorWithParentalConsent`, `minorNoParentalConsentRequired`, `notAdult` and `adult`. Refer to the [legal age group property definitions](#legal-age-group-property-definitions) for further information. <br><br>Returned only on `$select`. | | licenseAssignmentStates | [licenseAssignmentState](licenseassignmentstate.md) collection | State of license assignments for this user. <br><br>Returned only on `$select`. Read-only. | | mail | String | The SMTP address for the user, for example, "jeff@contoso.onmicrosoft.com". <br><br>Returned by default. Supports `$filter` and `endsWith`. |
This resource supports:
| onPremisesDomainName | String | Contains the on-premises `domainFQDN`, also called dnsDomainName 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. <br><br>Returned only on `$select`. Read-only. | | onPremisesExtensionAttributes | [onPremisesExtensionAttributes](onpremisesextensionattributes.md) | Contains extensionAttributes 1-15 for the user. Note that the individual extension attributes are neither selectable nor filterable. For an `onPremisesSyncEnabled` user, the source of authority for this set of properties is the on-premises and is read-only and is read-only. For a cloud-only user (where `onPremisesSyncEnabled` is false), these properties may be set during creation or update. These extension attributes are also known as Exchange custom attributes 1-15. <br><br>Returned only on `$select`. | | onPremisesImmutableId | String | This property is used to associate an on-premises Active Directory user account to their Azure AD user object. This property must be specified when creating a new user account in the Graph if you are using a federated domain for the user's `userPrincipalName` (UPN) property. **Important:** The **$** and **\_** characters cannot be used when specifying this property. <br><br>Returned only on `$select`. Supports `$filter`. |
-| onPremisesLastSyncDateTime | DateTimeOffset | Indicates the last time at which the object was synced with the on-premises directory; for example: "2013-02-16T03:04:54Z". 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 would look like this: `'2014-01-01T00:00:00Z'`. <br><br>Returned only on `$select`. Read-only. |
+| onPremisesLastSyncDateTime | DateTimeOffset | Indicates the last time at which the object was synced with the on-premises directory; for example: "2013-02-16T03:04:54Z". 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 only on `$select`. Read-only. |
| onPremisesProvisioningErrors | [onPremisesProvisioningError](onpremisesprovisioningerror.md) collection | Errors when using Microsoft synchronization product during provisioning. <br><br>Returned only on `$select`. | | onPremisesSamAccountName | String | Contains the on-premises `sAMAccountName` 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. <br><br>Returned only on `$select`. Read-only. | | onPremisesSecurityIdentifier | String | Contains the on-premises security identifier (SID) for the user that was synchronized from on-premises to the cloud. <br><br>Returned only on `$select`. Read-only. |
Hence the type of the corresponding 3 properties remain as string type in the Pr
| Relationship | Type |Description| |:|:--|:-| |agreementAcceptances|[agreementAcceptance](agreementacceptance.md) collection| The user's terms of use acceptance statuses. Read-only. Nullable.|
+|appRoleAssignments|[appRoleAssignment](approleassignment.md) collection|Represents the app roles a user has been granted for an application. |
|calendar|[calendar](calendar.md)|The user's primary calendar. Read-only.| |calendarGroups|[calendarGroup](calendargroup.md) collection|The user's calendar groups. Read-only. Nullable.| |calendarView|[event](event.md) collection|The calendar view for the calendar. Read-only. Nullable.|
v1.0 Userflowapiconnectorconfiguration https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/userflowapiconnectorconfiguration.md
The following is a JSON representation of the resource.
"section": "documentation", "tocPath": "", "suppressions": [
- "Error: Resource userFlowApiConnectorConfiguration has documented navigation properties, but we thought it was a complex type!"
] }-->
v1.0 Application Addkey https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/application-addkey.md
The following is an example of the response.
<!-- { "blockType": "response",
- "truncated": true
+ "truncated": true,
+ "@odata.type": "microsoft.graph.keyCredential"
} --> ```http
Content-Type: application/json
"section": "documentation", "tocPath": "", "suppressions": [
- "Error: application_addkey:\r\n Resource type was null or missing, so we assume there is no response to validate."
- ]
+ ]
}-->
v1.0 Application Post Calls https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/application-post-calls.md
Content-Type: application/json
} ```
+### Example 7: Create peer-to-peer PSTN call with service hosted media
+
+> **Note:** This call requires the Calls.Initiate.All permission.
+
+This call requires an application instance with a PSTN number assigned.
+
+#### Step 1: Create application instance
+Using tenant admin credentials, call the following cmdlets on the tenant remote PowerShell to create the application instance. For more information, see [New-CsOnlineApplicationInstance](/powershell/module/skype/new-csonlineapplicationinstance?view=skype-ps&preserve-view=true) and [Sync-CsOnlineApplicationInstance](/powershell/module/skype/sync-csonlineapplicationinstance?view=skype-ps&preserve-view=true).
+```
+PS C:\> New-CsOnlineApplicationInstance -UserPrincipalName <UPN> -DisplayName <DisplayName> -ApplicationId <AppId>
+PS C:\> Sync-CsOnlineApplicationInstance -ObjectId <ObjectId>
+```
+#### Step 2: Assign Microsoft 365 licenses
+1. Use tenant admin credentials to sign in to https://admin.microsoft.com/ and go to the **Users -> Active users** tab.
+2. Select the application instance, assign **Microsoft 365 Domestic and International Calling Plan** and **Microsoft 365 Phone System - Virtual User** licenses, and click **Save changes**. If the required licenses are not available in the tenant, you can get them from the **Billing -> Purchase services** tab.
+#### Step 3: Acquire PSTN number
+1. Use tenant admin credentials to sign in to https://admin.teams.microsoft.com/ and click the **Legacy portal** tab on the left panel.
+2. In the new page, go to the **voice -> phone numbers** tab.
+3. Click the **+** button, select **New Service Numbers**, and go to the **Add new service numbers** page.
+4. Select **Country/Region**, **State/Region**, **City**, input **Quantity**, and click **add** to search. Click **acquire numbers**. The newly acquired number will show on the **phone numbers** tab.
+#### Step 4: Assign PSTN number to application instance
+With tenant admin credentials, call the following cmdlets on the tenant remote PowerShell to assign the PSTN number to the application instance. For more information, see [Set-CsOnlineVoiceApplicationInstance](https://docs.microsoft.com/powershell/module/skype/set-csonlinevoiceapplicationinstance?view=skype-ps&preserve-view=true) and [Sync-CsOnlineApplicationInstance](https://docs.microsoft.com/powershell/module/skype/sync-csonlineapplicationinstance?view=skype-ps&preserve-view=true).
+```
+PS C:\> Set-CsOnlineVoiceApplicationInstance -Identity <UPN> -TelephoneNumber <TelephoneNumber>
+PS C:\> Sync-CsOnlineApplicationInstance -ObjectId <ObjectId>
+```
+
+#### Request
+The following example shows the request to make a peer-to-peer call between the bot and a PSTN number. 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.
+
+<!-- {
+ "blockType": "request",
+ "name": "create-call-service-hosted-media",
+ "@odata.type": "microsoft.graph.call"
+}-->
+```http
+POST https://graph.microsoft.com/v1.0/communications/calls
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.call",
+ "callbackUri": "https://bot.contoso.com/callback",
+ "source": {
+ "@odata.type": "#microsoft.graph.participantInfo",
+ "identity": {
+ "@odata.type": "#microsoft.graph.identitySet",
+ "applicationInstance": {
+ "@odata.type": "#microsoft.graph.identity",
+ "displayName": "Calling Bot",
+ "id": "3d913abb-aec0-4964-8fa6-3c6850c4f278"
+ },
+ },
+ "countryCode": null,
+ "endpointType": null,
+ "region": null,
+ "languageId": null
+ },
+ "targets": [
+ {
+ "@odata.type": "#microsoft.graph.invitationParticipantInfo",
+ "identity": {
+ "@odata.type": "#microsoft.graph.identitySet",
+ "phone": {
+ "@odata.type": "#microsoft.graph.identity",
+ "id": "+12345678901"
+ }
+ }
+ }
+ ],
+ "requestedModalities": [
+ "audio"
+ ],
+ "mediaConfig": {
+ "@odata.type": "#microsoft.graph.serviceHostedMediaConfig"
+ }
+}
+```
+
+#### Response
+
+> **Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.call"
+} -->
+```http
+HTTP/1.1 201 Created
+Location: https://graph.microsoft.com/v1.0/communications/calls/2e1a0b00-2db4-4022-9570-243709c565ab
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.call",
+ "state": "establishing",
+ "direction": "outgoing",
+ "callbackUri": "https://bot.contoso.com/callback",
+ "callChainId": "d8217646-3110-40b1-bae6-e9ac6c3a9f74",
+ "callRoutes": [],
+ "source": {
+ "@odata.type": "#microsoft.graph.participantInfo",
+ "identity": {
+ "@odata.type": "#microsoft.graph.identitySet",
+ "applicationInstance": {
+ "@odata.type": "#microsoft.graph.identity",
+ "displayName": "Calling Bot",
+ "id": "3d913abb-aec0-4964-8fa6-3c6850c4f278"
+ },
+ },
+ "countryCode": null,
+ "endpointType": null,
+ "region": null,
+ "languageId": null
+ },
+ "targets": [
+ {
+ "@odata.type": "#microsoft.graph.invitationParticipantInfo",
+ "identity": {
+ "@odata.type": "#microsoft.graph.identitySet",
+ "phone": {
+ "@odata.type": "#microsoft.graph.identity",
+ "id": "+12345678901"
+ }
+ },
+ "endpointType": null,
+ "region": null,
+ "replacesCallId": null,
+ "languageId": null
+ }
+ ],
+ "requestedModalities": [
+ "audio"
+ ],
+ "activeModalities": [],
+ "mediaConfig": {
+ "@odata.type": "#microsoft.graph.serviceHostedMediaConfig",
+ "preFetchMedia": [
+ {
+ "uri": "https://cdn.contoso.com/beep.wav",
+ "resourceId": "f8971b04-b53e-418c-9222-c82ce681a582"
+ },
+ {
+ "uri": "https://cdn.contoso.com/cool.wav",
+ "resourceId": "86dc814b-c172-4428-9112-60f8ecae1edb"
+ }
+ ],
+ },
+ "routingPolicies": [],
+ "tenantId": "aa67bd4c-8475-432d-bd41-39f255720e0a",
+ "myParticipantId": "499ff390-7a72-40e8-83a0-8fac6295ae7e",
+ "id": "2e1a0b00-2db4-4022-9570-243709c565ab",
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#app/calls/$entity",
+ "subject": null,
+ "terminationReason": null,
+ "ringingTimeoutInSeconds": null,
+ "mediaState": null,
+ "resultInfo": null,
+ "answeredBy": null,
+ "chatInfo": null,
+ "meetingInfo": null,
+ "transcription": null,
+ "meetingCapability": null,
+ "toneInfo": null
+}
+```
+
+### Example 8: Create peer-to-peer PSTN call with application hosted media
+
+> **Note**: This example requires Calls.Initiate.All and Calls.AccessMedia.All permissions.
+
+This call needs application instance with PSTN number assigned, as described in Example 7.
+
+#### Request
+The following example shows a request to make a peer-to-peer call between the bot and a PSTN number. In this example, the media is hosted locally by the application. Replace the values for authorization token, callback URL, application ID, application name, user ID, user name, and tenant ID to make the example work.
+
+<!-- {
+ "blockType": "request",
+ "name": "create-call-service-hosted-media",
+ "@odata.type": "microsoft.graph.call"
+}-->
+```http
+POST https://graph.microsoft.com/v1.0/communications/calls
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.call",
+ "callbackUri": "https://bot.contoso.com/callback",
+ "source": {
+ "@odata.type": "#microsoft.graph.participantInfo",
+ "identity": {
+ "@odata.type": "#microsoft.graph.identitySet",
+ "applicationInstance": {
+ "@odata.type": "#microsoft.graph.identity",
+ "displayName": "Calling Bot",
+ "id": "3d913abb-aec0-4964-8fa6-3c6850c4f278"
+ },
+ },
+ "countryCode": null,
+ "endpointType": null,
+ "region": null,
+ "languageId": null
+ },
+ "targets": [
+ {
+ "@odata.type": "#microsoft.graph.invitationParticipantInfo",
+ "identity": {
+ "@odata.type": "#microsoft.graph.identitySet",
+ "phone": {
+ "@odata.type": "#microsoft.graph.identity",
+ "id": "+12345678901"
+ }
+ }
+ }
+ ],
+ "requestedModalities": [
+ "audio"
+ ],
+ "mediaConfig": {
+ "@odata.type": "#microsoft.graph.appHostedMediaConfig",
+ "blob": "<Media Session Configuration>"
+ }
+}
+```
+
+#### Response
+
+> **Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.call"
+} -->
+```http
+HTTP/1.1 201 Created
+Location: https://graph.microsoft.com/v1.0/communications/calls/2e1a0b00-2db4-4022-9570-243709c565ab
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.call",
+ "state": "establishing",
+ "direction": "outgoing",
+ "callbackUri": "https://bot.contoso.com/callback",
+ "callChainId": "d8217646-3110-40b1-bae6-e9ac6c3a9f74",
+ "callRoutes": [],
+ "source": {
+ "@odata.type": "#microsoft.graph.participantInfo",
+ "identity": {
+ "@odata.type": "#microsoft.graph.identitySet",
+ "applicationInstance": {
+ "@odata.type": "#microsoft.graph.identity",
+ "displayName": "Calling Bot",
+ "id": "3d913abb-aec0-4964-8fa6-3c6850c4f278"
+ },
+ },
+ "countryCode": null,
+ "endpointType": null,
+ "region": null,
+ "languageId": null
+ },
+ "targets": [
+ {
+ "@odata.type": "#microsoft.graph.invitationParticipantInfo",
+ "identity": {
+ "@odata.type": "#microsoft.graph.identitySet",
+ "phone": {
+ "@odata.type": "#microsoft.graph.identity",
+ "id": "+12345678901"
+ }
+ },
+ "endpointType": null,
+ "region": null,
+ "replacesCallId": null,
+ "languageId": null
+ }
+ ],
+ "requestedModalities": [
+ "audio"
+ ],
+ "activeModalities": [],
+ "mediaConfig": {
+ "@odata.type": "#microsoft.graph.appHostedMediaConfig",
+ "blob": "<Media Session Configuration>",
+ },
+ "routingPolicies": [],
+ "tenantId": "aa67bd4c-8475-432d-bd41-39f255720e0a",
+ "myParticipantId": "499ff390-7a72-40e8-83a0-8fac6295ae7e",
+ "id": "2e1a0b00-2db4-4022-9570-243709c565ab",
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#app/calls/$entity",
+ "subject": null,
+ "terminationReason": null,
+ "ringingTimeoutInSeconds": null,
+ "mediaState": null,
+ "resultInfo": null,
+ "answeredBy": null,
+ "chatInfo": null,
+ "meetingInfo": null,
+ "transcription": null,
+ "meetingCapability": null,
+ "toneInfo": null
+}
+```
+ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!--
v1.0 Application Post Onlinemeetings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/application-post-onlinemeetings.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | OnlineMeetings.ReadWrite | | Delegated (personal Microsoft account) | Not Supported |
-| Application | Not Supported |
+| Application | OnlineMeetings.ReadWrite.All* |
+
+> [!IMPORTANT]
+> \* Administrators must create an [application access policy](/graph/cloud-communication-online-meeting-application-access-policy) and grant it to a user, authorizing the app configured in the policy to create an online meeting on behalf of that user (user ID specified in the request path).
## HTTP request+
+Request when using a delegated token:
<!-- { "blockType": "ignored" } --> ```http POST /me/onlineMeetings ```
+Request when using an application token:
+<!-- { "blockType": "ignored" } -->
+```http
+POST /users/{userId}/onlineMeetings
+```
+
+> **Note:** `userId` is the object ID of a user in [Azure user management portal](https://portal.azure.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). See more details in [application access policy](/graph/cloud-communication-online-meeting-application-access-policy).
+ ## Request headers | Name | Description | |:--|:--|
Content-Type: application/json
"creationDateTime": "2019-07-11T02:17:17.6491364Z", "startDateTime": "2019-07-11T02:17:17.6491364Z", "endDateTime": "2019-07-11T02:47:17.651138Z",
- "id": "550fae72-d251-43ec-868c-373732c2704f_19:meeting_M2IzYzczNTItYmY3OC00MDlmLWJjMzUtYmFiMjNlOTY4MGEz@thread.skype",
+ "id": "MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZiMi04ZdFpHRTNaR1F6WGhyZWFkLnYy",
"joinWebUrl": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_M2IzYzczNTItYmY3OC00MDlmLWJjMzUtYmFiMjNlOTY4MGEz%40thread.skype/0?context=%7b%22Tid%22%3a%2272f988bf-86f1-41af-91ab-2d7cd011db47%22%2c%22Oid%22%3a%22550fae72-d251-43ec-868c-373732c2704f%22%7d", "participants": { "organizer": {
v1.0 Attachment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/attachment-get.md
Read the properties, relationships, or raw contents of an attachment that is att
An attachment can be one of the following types:
-* A file. Programmatically, this is a [fileAttachment](../resources/fileattachment.md) resource.
-* An Outlook item (contact, event or message). Programmatically, an item attachment is an [itemAttachment](../resources/itemattachment.md) resource. You can use `$expand` to further get the properties of that item. See an [example](#request-2) below.
-* A link to a file stored in the cloud. Programmatically, this is a [referenceAttachment](../resources/referenceattachment.md) resource.
+* A file. Programmatically, this is a [fileAttachment](../resources/fileattachment.md) resource. See [example 1](#example-1-get-the-properties-of-a-file-attachment).
+* An Outlook item (contact, event or message). Programmatically, an item attachment is an [itemAttachment](../resources/itemattachment.md) resource. You can use `$expand` to further get the properties of that item, including any nested attachments up to 30 levels. See [example 3](#example-3-expand-and-get-the-properties-of-the-item-attached-to-a-message) and [example 4](#example-4-expand-and-get-the-properties-of-an-item-attached-to-a-message-including-any-attachment-to-the-item).
+* A link to a file stored in the cloud. Programmatically, this is a [referenceAttachment](../resources/referenceattachment.md) resource. See [example 5](#example-5-get-the-properties-of-a-reference-attachment).
All these types of attachments are derived from the [attachment](../resources/attachment.md) resource. ### Get the raw contents of a file or item attachment You can append the path segment `/$value` to get the raw contents of a file or item attachment.
-For a file attachment, the content type is based on its original content type. See an [example](#example-5-get-the-raw-contents-of-a-file-attachment-on-a-message) below.
+For a file attachment, the content type is based on its original content type. See [example 6](#example-6-get-the-raw-contents-of-a-file-attachment-on-a-message).
For an item attachment that is a [contact](../resources/contact.md), [event](../resources/event.md), or [message](../resources/message.md), the raw contents returned is in MIME format. | Item attachment type | Raw contents returned | |:--|:-|
-| **contact** | [vCard](http://www.faqs.org/rfcs/rfc2426.html) MIME format. See [example](#example-6-get-the-mime-raw-contents-of-a-contact-attachment-on-a-message). |
-| **event** | iCal MIME format. See [example](#example-7-get-the-mime-raw-contents-of-an-event-attachment-on-a-message). |
-| **message** | MIME format. See [example](#example-8-get-the-mime-raw-contents-of-a-meeting-invitation-item-attachment-on-a-message). |
+| **contact** | [vCard](http://www.faqs.org/rfcs/rfc2426.html) MIME format. See [example](#example-7-get-the-mime-raw-contents-of-a-contact-attachment-on-a-message). |
+| **event** | iCal MIME format. See [example](#example-8-get-the-mime-raw-contents-of-an-event-attachment-on-a-message). |
+| **message** | MIME format. See [example](#example-9-get-the-mime-raw-contents-of-a-meeting-invitation-item-attachment-on-a-message). |
Attempting to get the `$value` of a reference attachment returns HTTP 405.
GET /groups/{id}/threads/{id}/posts/{id}/attachments/{id}/$value
GET /groups/{id}/conversations/{id}/threads/{id}/posts/{id}/attachments/{id}/$value ``` ## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+This method supports some of the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+
+Use `$expand` to get the properties of an item attachment (contact, event, or message). See [example 3](#example-3-expand-and-get-the-properties-of-the-item-attached-to-a-message) and [example 4](#example-4-expand-and-get-the-properties-of-an-item-attached-to-a-message-including-any-attachment-to-the-item).
+ ## Request headers | Name | Type | Description| |:--|:|:-|
Content-type: application/json
"hasAttachments":false, "internetMessageId":"<BY2PR15MB05189A084C01F466709E414F9CA40@BY2PR15MB0518.namprd15.prod.outlook.com>", "subject":"Reminder - please bring laptop",
+ "bodyPreview": "PFA\r\n\r\nThanks,\r\nRob",
"importance":"normal", "conversationId":"AAQkADA1MzMyOGI4LTlkZDctNDkzYy05M2RiLTdiN2E1NDE3MTRkOQAQAMG_NSCMBqdKrLa2EmR-lO0=", "conversationIndex":"AQHTAbcSwb41IIwGp0qstrYSZH+U7Q==",
Content-type: application/json
"isRead":false, "isDraft":false, "webLink":"https://outlook.office365.com/owa/?ItemID=AAMkADA1M3MTRkOQAAAA%3D%3D&exvsurl=1&viewmodel=ReadMessageItem",
+ "internetMessageHeaders": [ ],
"body":{ "contentType":"html", "content":"<html><head>\r\n</head>\r\n<body>\r\n</body>\r\n</html>"
Content-type: application/json
"address":"AdeleV@contoso.onmicrosoft.com" } }
- ]
+ ],
+ "flag":{
+ "flagStatus":"notFlagged"
+ }
} } ```
+### Example 4: Expand and get the properties of an item attached to a message, including any attachment to the item
+#### Request
+The next example uses the same request as in [example 3](#example-3-expand-and-get-the-properties-of-the-item-attached-to-a-message) to get the properties of an item attachment on a message by using `$expand`. In this case, because the attached item also has a file attachment, the response includes the properties of the file attachment as well.
+
+<!-- {
+ "blockType": "request",
+ "sampleKeys": ["AAMkADA1M-zAAA=", "AAMkADA1M-CJKtzmnlcqVgqI="],
+ "name": "get_and_expand_nested_item_attachment"
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/v1.0/me/messages/AAMkADA1M-zAAA=/attachments/AAMkADA1M-CJKtzmnlcqVgqI=/?$expand=microsoft.graph.itemattachment/item
+```
+#### Response
+<!-- {
+ "blockType": "response",
+ "name": "get_and_expand_nested_item_attachment",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.itemAttachment"
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('d1a2fae9-db66-4cc9-8133-2184c77af1b8')/messages('AAMkADA1M-zAAA%3D')/attachments(microsoft.graph.itemAttachment/item())/$entity",
+ "@odata.type": "#microsoft.graph.itemAttachment",
+ "id": "AAMkADA1MCJKtzmnlcqVgqI=",
+ "lastModifiedDateTime": "2021-01-06T13:28:11Z",
+ "name": "Nested Message With Attachment",
+ "contentType": null,
+ "size": 465916,
+ "isInline": false,
+ "item@odata.context": "https://graph.microsoft.com/beta/$metadata#users('d1a2fae9-db66-4cc9-8133-2184c77af1b8')/messages('AAMkADA1M-zAAA%3D')/attachments('AAMkADA1M-CJKtzmnlcqVgqI%3D')/microsoft.graph.itemAttachment/item/$entity",
+ "item": {
+ "@odata.type": "#microsoft.graph.message",
+ "id": "",
+ "createdDateTime": "2021-01-06T13:28:30Z",
+ "lastModifiedDateTime": "2021-01-06T13:27:40Z",
+ "receivedDateTime": "2021-01-06T13:27:25Z",
+ "sentDateTime": "2021-01-06T13:27:04Z",
+ "hasAttachments": true,
+ "internetMessageId": "<BY2PR15MB05189A084C01F466709E414F9CA40@BY2PR15MB0518.namprd15.prod.outlook.com>",
+ "subject": "Nested Message With Attachment",
+ "bodyPreview": "PFAThanks,Adele",
+ "importance": "normal",
+ "conversationId": "AAQkADg3NTY5MDg4LWMzYmQtNDQzNi05OTgwLWQyZjg2YWQwMTNkZAAQAO6hkp84oMdGm6ZBsSH72sE=",
+ "conversationIndex": "AQHW5C+U7qGSnzigx0abpkGxIfvawQ==",
+ "isDeliveryReceiptRequested": false,
+ "isReadReceiptRequested": false,
+ "isRead": true,
+ "isDraft": false,
+ "webLink": "https://outlook.office365.com/owa/?ItemID=AAMkADA1M3MTRkOQAAAA%3D%3D&exvsurl=1&viewmodel=ItemAttachment",
+ "internetMessageHeaders": [],
+ "body": {
+ "contentType": "html",
+ "content": "<html><head>\r\n</head>\r\n<body>\r\n</body>\r\n</html>"
+ },
+ "sender": {
+ "emailAddress": {
+ "name": "Adele Vance",
+ "address": "Adele.Vance@microsoft.com"
+ }
+ },
+ "from": {
+ "emailAddress": {
+ "name": "Adele Vance",
+ "address": "Adele.Vance@microsoft.com"
+ }
+ },
+ "toRecipients": [
+ {
+ "emailAddress": {
+ "name": "Adele Vance",
+ "address": "Adele.Vance@microsoft.com"
+ }
+ }
+ ],
+ "flag": {
+ "flagStatus": "notFlagged"
+ },
+ "attachments@odata.context": "https://graph.microsoft.com/beta/$metadata#users('d1a2fae9-db66-4cc9-8133-2184c77af1b8')/messages('AAMkADA1M-zAAA%3D')/attachments('AAMkADA1M-CJKtzmnlcqVgqI%3D')/microsoft.graph.itemAttachment/microsoft.graph.itemAttachment/item/microsoft.graph.message/microsoft.graph.message/microsoft.graph.message/microsoft.graph.message/microsoft.graph.message/microsoft.graph.message/microsoft.graph.message/attachments",
+ "attachments": [
+ {
+ "@odata.type": "#microsoft.graph.fileAttachment",
+ "@odata.mediaContentType": "application/pdf",
+ "id": "AAMkADg3NTYULmbsDYNg==",
+ "lastModifiedDateTime": "2021-01-21T14:56:18Z",
+ "name": "Info.pdf",
+ "contentType": "application/pdf",
+ "size": 417351,
+ "isInline": false,
+ "contentId": null,
+ "contentLocation": null,
+ "contentBytes": "JVBERi0xLjUNCiW1tbW1DQoxIDAgb2JqDQo8PC9UeXBlL0NhdGFsb2cvUGFnZXMgMiAwIFIvTGFuZyhlbi1JTikgL1N0cnVjdFRyZWVSb29"
+ }
+ ]
+ }
+}
+```
-### Example 4: Get the properties of a reference attachment
+### Example 5: Get the properties of a reference attachment
#### Request Here is an example of the request to get a reference attachment on a message.
Content-type: application/json
} ```
-### Example 5: Get the raw contents of a file attachment on a message
+### Example 6: Get the raw contents of a file attachment on a message
#### Request
HTTP/1.1 200 OK
```
-### Example 6: Get the MIME raw contents of a contact attachment on a message
+### Example 7: Get the MIME raw contents of a contact attachment on a message
#### Request
END:VCARD
```
-### Example 7: Get the MIME raw contents of an event attachment on a message
+### Example 8: Get the MIME raw contents of an event attachment on a message
#### Request
END:VCALENDAR
```
-### Example 8: Get the MIME raw contents of a meeting invitation item attachment on a message
+### Example 9: Get the MIME raw contents of a meeting invitation item attachment on a message
#### Request
QkVHSU46VkNBTEVOREFSDQpNRVRIT0Q6UkVRVUVTVA0KUFJPRElEOk1pY3Jvc29mdCBFeGNoYW5n
"keywords": "", "section": "documentation", "suppressions": [
- "Error: get_and_expand_item_attachment/item:
- Property 'item' is of type Custom but has no custom members."
], "tocPath": "" }-->
v1.0 Call Redirect https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/call-redirect.md
Content-Type: application/json
} ```
+### Example 3: Forward a call to a PSTN number
+
+This call requires an application instance with a PSTN number assigned.
+
+#### Step 1: Create application instance
+Using tenant admin credentials, call the following cmdlets on the tenant remote PowerShell to create the application instance. For more information, see [New-CsOnlineApplicationInstance](/powershell/module/skype/new-csonlineapplicationinstance?view=skype-ps&preserve-view=true) and [Sync-CsOnlineApplicationInstance](/powershell/module/skype/sync-csonlineapplicationinstance?view=skype-ps&preserve-view=true).
+```
+PS C:\> New-CsOnlineApplicationInstance -UserPrincipalName <UPN> -DisplayName <DisplayName> -ApplicationId <AppId>
+PS C:\> Sync-CsOnlineApplicationInstance -ObjectId <ObjectId>
+```
+#### Step 2: Assign Microsoft 365 licenses
+1. Use tenant admin credentials to sign in to https://admin.microsoft.com/ and go to the **Users -> Active users** tab.
+2. Select the application instance, assign **Microsoft 365 Domestic and International Calling Plan** and **Microsoft 365 Phone System - Virtual User** licenses, and click **Save changes**. If the required licenses are not available in the tenant, you can get them from the **Billing -> Purchase services** tab.
+#### Step 3: Acquire PSTN number
+1. Use tenant admin credentials to sign in to https://admin.teams.microsoft.com/ and click the **Legacy portal** tab on the left panel.
+2. In the new page, go to the **voice -> phone numbers** tab.
+3. Click the **+** button, select **New Service Numbers**, and go to the **Add new service numbers** page.
+4. Select **Country/Region**, **State/Region**, **City**, input **Quantity**, and click **add** to search. Click **acquire numbers**. The newly acquired number will show on the **phone numbers** tab.
+#### Step 4: Assign PSTN number to application instance
+With tenant admin credentials, call the following cmdlets on the tenant remote PowerShell to assign the PSTN number to the application instance. For more information, see [Set-CsOnlineVoiceApplicationInstance](https://docs.microsoft.com/powershell/module/skype/set-csonlinevoiceapplicationinstance?view=skype-ps&preserve-view=true) and [Sync-CsOnlineApplicationInstance](https://docs.microsoft.com/powershell/module/skype/sync-csonlineapplicationinstance?view=skype-ps&preserve-view=true).
+```
+PS C:\> Set-CsOnlineVoiceApplicationInstance -Identity <UPN> -TelephoneNumber <TelephoneNumber>
+PS C:\> Sync-CsOnlineApplicationInstance -ObjectId <ObjectId>
+```
+
+#### Notification - incoming
+<!-- {
+ "blockType": "example",
+ "@odata.type": "microsoft.graph.commsNotifications"
+}-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.commsNotifications",
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.commsNotification",
+ "changeType": "created",
+ "resourceUrl": "/communications/calls/491f0b00-ffff-4bc9-a43e-b226498ec22a",
+ "resourceData": {
+ "@odata.type": "#microsoft.graph.call",
+ "state": "incoming",
+ "direction": "incoming",
+ "callbackUri": "https://bot.contoso.com/api/calls/24701998-1a73-4d42-8085-bf46ed0ae039",
+ "source": {
+ "@odata.type": "#microsoft.graph.participantInfo",
+ "identity": {
+ "@odata.type": "#microsoft.graph.identitySet",
+ "user": {
+ "@odata.type": "#microsoft.graph.identity",
+ "id": "8d1e6ab6-26c5-4e22-a1bc-06ea7343958e",
+ "tenantId": "632899f8-2ea1-4604-8413-27bd2892079f"
+ }
+ },
+ "region": "amer",
+ },
+ "targets": [
+ {
+ "@odata.type": "#microsoft.graph.invitationParticipantInfo",
+ "identity": {
+ "@odata.type": "#microsoft.graph.identitySet",
+ "applicationInstance": {
+ "@odata.type": "#microsoft.graph.identity",
+ "displayName": "PstnAppInstance",
+ "id": "7629bdce-046c-4903-86b4-a8f718277e1a",
+ "tenantId": "632899f8-2ea1-4604-8413-27bd2892079f"
+ }
+ },
+ "endpointType": "default",
+ "id": "c339cede-4bd6-4f20-ab9f-3a13e65f6d00",
+ "region": "amer",
+ "languageId": null
+ }
+ ],
+ "tenantId": "632899f8-2ea1-4604-8413-27bd2892079f",
+ "myParticipantId": "c339cede-4bd6-4f20-ab9f-3a13e65f6d00",
+ "id": "491f0b00-ffff-4bc9-a43e-b226498ec22a"
+ }
+ }
+ ]
+}
+```
+
+#### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "call-redirect"
+} -->
+``` http
+POST https://graph.microsoft.com/v1.0/communications/calls/491f0b00-ffff-4bc9-a43e-b226498ec22a/redirect
+Content-Type: application/json
+
+{
+ "targets": [
+ {
+ "@odata.type": "#microsoft.graph.invitationParticipantInfo",
+ "identity": {
+ "@odata.type": "#microsoft.graph.identitySet",
+ "phone": {
+ "@odata.type": "#microsoft.graph.identity",
+ "id": "+12345678901"
+ }
+ }
+ }
+ ],
+ "callbackUri": "https://bot.contoso.com/api/calls/24701998-1a73-4d42-8085-bf46ed0ae039"
+}
+```
+#### Response
+
+<!-- {
+ "blockType": "response",
+ "@odata.type": "microsoft.graph.None"
+} -->
+```http
+HTTP/1.1 202 Accepted
+```
+#### Notification - terminated
+
+<!-- {
+ "blockType": "example",
+ "name": "call-redirect"
+} -->
+``` http
+POST https://bot.contoso.com/api/calls/24701998-1a73-4d42-8085-bf46ed0ae039
+Content-Type: application/json
+```
+
+<!-- {
+ "blockType": "example",
+ "@odata.type": "microsoft.graph.commsNotifications"
+} -->
+``` json
+{
+ "@odata.type": "#microsoft.graph.commsNotifications",
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.commsNotification",
+ "changeType": "deleted",
+ "resourceUrl": "/communications/calls/491f0b00-ffff-4bc9-a43e-b226498ec22a",
+ "resourceData": {
+ "@odata.type": "#microsoft.graph.call",
+ "state": "terminated",
+ "direction": "incoming",
+ "callbackUri": "https://bot.contoso.com/api/calls/24701998-1a73-4d42-8085-bf46ed0ae039",
+ "source": {
+ "@odata.type": "#microsoft.graph.participantInfo",
+ "identity": {
+ "@odata.type": "#microsoft.graph.identitySet",
+ "user": {
+ "@odata.type": "#microsoft.graph.identity",
+ "id": "8d1e6ab6-26c5-4e22-a1bc-06ea7343958e",
+ "tenantId": "632899f8-2ea1-4604-8413-27bd2892079f"
+ }
+ },
+ "region": "amer",
+ },
+ "targets": [
+ {
+ "@odata.type": "#microsoft.graph.invitationParticipantInfo",
+ "identity": {
+ "@odata.type": "#microsoft.graph.identitySet",
+ "applicationInstance": {
+ "@odata.type": "#microsoft.graph.identity",
+ "displayName": "PstnAppInstance",
+ "id": "7629bdce-046c-4903-86b4-a8f718277e1a",
+ "tenantId": "632899f8-2ea1-4604-8413-27bd2892079f"
+ }
+ },
+ "endpointType": "default",
+ "id": "c339cede-4bd6-4f20-ab9f-3a13e65f6d00",
+ "region": "amer",
+ "languageId": null
+ }
+ ],
+ "answeredBy": {
+ "@odata.type": "#microsoft.graph.participantInfo",
+ "identity": {
+ "@odata.type": "#microsoft.graph.identitySet",
+ "encrypted": {
+ "@odata.type": "#microsoft.graph.identity",
+ "id": "1xt4uextl99sdzwdxuvdxrvgrv8gehcq7jdgf9yhzeto"
+ }
+ },
+ "endpointType": "default"
+ },
+ "tenantId": "632899f8-2ea1-4604-8413-27bd2892079f",
+ "myParticipantId": "c339cede-4bd6-4f20-ab9f-3a13e65f6d00",
+ "id": "491f0b00-ffff-4bc9-a43e-b226498ec22a"
+ }
+ }
+ ]
+}
+```
+ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!--
v1.0 Call Transfer https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/call-transfer.md
Namespace: microsoft.graph
Transfer an active peer-to-peer call.
-> **Note:** This is only supported if both the transferee and transfer target are Microsoft Teams users that belong to the same tenant. Transfer to PSTN number is not supported. To learn more about transferor, transferee and transfer target, see [RFC 5589](https://tools.ietf.org/html/rfc5589#section-2).
+> **Note:** This is only supported if both the transferee and transfer target are Microsoft Teams users that belong to the same tenant. Transfer to PSTN number is supported only for application instance. To learn more about transferor, transferee and transfer target, see [RFC 5589](https://tools.ietf.org/html/rfc5589#section-2).
A consultative transfer means that the transferor can inform the person they want to transfer the call to (the transferee), before the transfer is made. This is opposed to transfering the call directly.
Content-Type: application/json
} ```
+### Example 3: Call transfer to PSTN number
+
+This call requires an application instance with a PSTN number assigned.
+
+#### Step 1: Create application instance
+Using tenant admin credentials, call the following cmdlets on the tenant remote PowerShell to create the application instance. For more information, see [New-CsOnlineApplicationInstance](/powershell/module/skype/new-csonlineapplicationinstance?view=skype-ps&preserve-view=true) and [Sync-CsOnlineApplicationInstance](/powershell/module/skype/sync-csonlineapplicationinstance?view=skype-ps&preserve-view=true).
+```
+PS C:\> New-CsOnlineApplicationInstance -UserPrincipalName <UPN> -DisplayName <DisplayName> -ApplicationId <AppId>
+PS C:\> Sync-CsOnlineApplicationInstance -ObjectId <ObjectId>
+```
+#### Step 2: Assign Microsoft 365 licenses
+1. Use tenant admin credentials to sign in to https://admin.microsoft.com/ and go to the **Users -> Active users** tab.
+2. Select the application instance, assign **Microsoft 365 Domestic and International Calling Plan** and **Microsoft 365 Phone System - Virtual User** licenses, and click **Save changes**. If the required licenses are not available in the tenant, you can get them from the **Billing -> Purchase services** tab.
+#### Step 3: Acquire PSTN number
+1. Use tenant admin credentials to sign in to https://admin.teams.microsoft.com/ and click the **Legacy portal** tab on the left panel.
+2. In the new page, go to the **voice -> phone numbers** tab.
+3. Click the **+** button, select **New Service Numbers**, and go to the **Add new service numbers** page.
+4. Select **Country/Region**, **State/Region**, **City**, input **Quantity**, and click **add** to search. Click **acquire numbers**. The newly acquired number will show on the **phone numbers** tab.
+#### Step 4: Assign PSTN number to application instance
+With tenant admin credentials, call the following cmdlets on the tenant remote PowerShell to assign the PSTN number to the application instance. For more information, see [Set-CsOnlineVoiceApplicationInstance](https://docs.microsoft.com/powershell/module/skype/set-csonlinevoiceapplicationinstance?view=skype-ps&preserve-view=true) and [Sync-CsOnlineApplicationInstance](https://docs.microsoft.com/powershell/module/skype/sync-csonlineapplicationinstance?view=skype-ps&preserve-view=true).
+```
+PS C:\> Set-CsOnlineVoiceApplicationInstance -Identity <UPN> -TelephoneNumber <TelephoneNumber>
+PS C:\> Sync-CsOnlineApplicationInstance -ObjectId <ObjectId>
+```
+
+#### Request
+The following example shows the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "call-transfer"
+}-->
+```http
+POST https://graph.microsoft.com/v1.0/communications/calls/{id}/transfer
+Content-Type: application/json
+Content-Length: 430
+
+{
+ "transferTarget": {
+ "endpointType": "default",
+ "identity": {
+ "phone": {
+ "@odata.type": "#microsoft.graph.identity",
+ "id": "+12345678901"
+ }
+ },
+ "languageId": "languageId-value",
+ "region": "region-value"
+ },
+ "clientContext": "9e90d1c1-f61e-43e7-9f75-d420159aae08"
+}
+```
+
+#### Response
+
+> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.None"
+}-->
+```http
+HTTP/1.1 202 Accepted
+```
+
+#### Notification - transferring
+
+```http
+POST https://bot.contoso.com/api/calls
+Content-Type: application/json
+```
+
+<!-- {
+ "blockType": "example",
+ "@odata.type": "microsoft.graph.commsNotifications"
+}-->
+```json
+{
+ "@odata.type": "#microsoft.graph.commsNotifications",
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.commsNotification",
+ "changeType": "updated",
+ "resourceUrl": "/communications/calls/341a0500-d4bf-4224-8b19-1581168d328b",
+ "resourceData": {
+ "@odata.type": "#microsoft.graph.call",
+ "state": "transferring"
+ }
+ }
+ ]
+}
+```
+
+#### Notification - transfer accepted
+
+> **Note:** Transfer accepted may happen after or before media state audio inactive.
+
+```http
+POST https://bot.contoso.com/api/calls
+Content-Type: application/json
+```
+
+<!-- {
+ "blockType": "example",
+ "@odata.type": "microsoft.graph.commsNotifications"
+}-->
+```json
+{
+ "@odata.type": "#microsoft.graph.commsNotifications",
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.commsNotification",
+ "changeType": "updated",
+ "resourceUrl": "/communications/calls/341a0500-d4bf-4224-8b19-1581168d328b",
+ "resourceData": {
+ "@odata.type": "#microsoft.graph.call",
+ "state": "transferAccepted"
+ }
+ }
+ ]
+}
+```
+
+#### Notification - transfer completed
+
+```http
+POST https://bot.contoso.com/api/calls
+Content-Type: application/json
+```
+
+<!-- {
+ "blockType": "example",
+ "@odata.type": "microsoft.graph.commsNotifications"
+}-->
+```json
+{
+ "@odata.type": "#microsoft.graph.commsNotifications",
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.commsNotification",
+ "changeType": "deleted",
+ "resourceUrl": "/communications/calls/341a0500-d4bf-4224-8b19-1581168d328b",
+ "resourceData": {
+ "@odata.type": "#microsoft.graph.call",
+ "state": "terminated",
+ "resultInfo": {
+ "@odata.type": "#microsoft.graph.resultInfo",
+ "code": 0,
+ "subcode": 7015,
+ "message": "GracefulTransferCompleted"
+ }
+ }
+ }
+ ]
+}
+```
+### Notification - transfer failed
+
+> **Note:** When a call transfer fails, the call state will be `established`.
+
+```http
+POST https://bot.contoso.com/api/calls
+Content-Type: application/json
+```
+
+<!-- {
+ "blockType": "example",
+ "@odata.type": "microsoft.graph.commsNotifications"
+}-->
+```json
+{
+ "@odata.type": "#microsoft.graph.commsNotifications",
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.commsNotification",
+ "changeType": "updated",
+ "resourceUrl": "/communications/calls/341a0500-d4bf-4224-8b19-1581168d328b",
+ "resourceData": {
+ "@odata.type": "#microsoft.graph.call",
+ "state": "established",
+ "resultInfo": {
+ "@odata.type": "#microsoft.graph.resultInfo",
+ "code": 500,
+ "subCode": 7000,
+ "message": "<message>"
+ }
+ }
+ }
+ ]
+}
+```
+
+### Example 4: Consultative transfer to PSTN number
+
+This call requires an application instance with PSTN number assigned, as described in Example 3.
+
+#### Request
+The following example shows the request.
+
+<!-- {
+ "blockType": "request",
+ "@odata.type": "call-transfer"
+}-->
+
+```http
+POST https://graph.microsoft.com/v1.0/communications/calls/341a0500-d4bf-4224-8b19-1581168d328b/transfer
+Content-Type: application/json
+
+{
+ "transferTarget": {
+ "@odata.type": "#microsoft.graph.invitationParticipantInfo",
+ "endpointType": "default",
+ "identity": {
+ "@odata.type": "#microsoft.graph.identitySet",
+ "phone": {
+ "@odata.type": "#microsoft.graph.identity",
+ "id": "+12345678901"
+ }
+ },
+ "languageId": "en-us",
+ "region": "amer",
+ "replacesCallId": "e5d39592-99bd-4db8-bca8-30fb894ec51d"
+ },
+ "clientContext": "9e90d1c1-f61e-43e7-9f75-d420159aae08"
+}
+```
+
+#### Response
+
+> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.None"
+}-->
+```http
+HTTP/1.1 202 Accepted
+```
+
+#### Notification - transferring
+
+```http
+POST https://bot.contoso.com/api/calls
+Content-Type: application/json
+```
+
+<!-- {
+ "blockType": "example",
+ "@odata.type": "microsoft.graph.commsNotifications"
+}-->
+```json
+{
+ "@odata.type": "#microsoft.graph.commsNotifications",
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.commsNotification",
+ "changeType": "updated",
+ "resourceUrl": "/communications/calls/341a0500-d4bf-4224-8b19-1581168d328b",
+ "resourceData": {
+ "@odata.type": "#microsoft.graph.call",
+ "state": "transferring"
+ }
+ }
+ ]
+}
+```
+
+#### Notification - transfer accepted
+
+> **Note:** Transfer accepted may happen after or before media state audio inactive.
+
+```http
+POST https://bot.contoso.com/api/calls
+Content-Type: application/json
+```
+
+<!-- {
+ "blockType": "example",
+ "@odata.type": "microsoft.graph.commsNotifications"
+}-->
+```json
+{
+ "@odata.type": "#microsoft.graph.commsNotifications",
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.commsNotification",
+ "changeType": "updated",
+ "resourceUrl": "/communications/calls/341a0500-d4bf-4224-8b19-1581168d328b",
+ "resourceData": {
+ "@odata.type": "#microsoft.graph.call",
+ "state": "transferAccepted"
+ }
+ }
+ ]
+}
+```
+
+#### Notification - transfer completed
+
+```http
+POST https://bot.contoso.com/api/calls
+Content-Type: application/json
+```
+
+<!-- {
+ "blockType": "example",
+ "@odata.type": "microsoft.graph.commsNotifications"
+}-->
+```json
+{
+ "@odata.type": "#microsoft.graph.commsNotifications",
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.commsNotification",
+ "changeType": "deleted",
+ "resourceUrl": "/communications/calls/341a0500-d4bf-4224-8b19-1581168d328b",
+ "resourceData": {
+ "@odata.type": "#microsoft.graph.call",
+ "state": "terminated",
+ "terminationReason": "AppTransferred"
+ }
+ }
+ ]
+}
+```
+
+#### Notification - transfer failed
+
+> **Note:** When a call transfer fails, the call state will be `established`.
+
+```http
+POST https://bot.contoso.com/api/calls
+Content-Type: application/json
+```
+
+<!-- {
+ "blockType": "example",
+ "@odata.type": "microsoft.graph.commsNotifications"
+}-->
+```json
+{
+ "@odata.type": "#microsoft.graph.commsNotifications",
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.commsNotification",
+ "changeType": "updated",
+ "resourceUrl": "/communications/calls/341a0500-d4bf-4224-8b19-1581168d328b",
+ "resourceData": {
+ "@odata.type": "#microsoft.graph.call",
+ "state": "established",
+ "resultInfo": {
+ "@odata.type": "#microsoft.graph.resultInfo",
+ "code": 500,
+ "subCode": 7700,
+ "message": "<message>"
+ }
+ }
+ }
+ ]
+}
+```
+ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!--
v1.0 Directory Deleteditems Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/directory-deleteditems-delete.md
For users:
|:--|:| |Delegated (work or school account) | User.ReadWrite.All, Directory.AccessAsUser.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | User.ReadWrite.All |
+|Application | Not supported. |
For groups:
For groups:
|:--|:| |Delegated (work or school account) | Group.ReadWrite.All, Directory.AccessAsUser.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | Group.ReadWrite.All |
+|Application | Not supported. |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Directory Deleteditems Restore https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/directory-deleteditems-restore.md
Title: "Restore deleted item"
description: "Restores a recently deleted item from deleted items. " localization_priority: Normal doc_type: apiPageType
Namespace: microsoft.graph
Restores a recently deleted item from [deleted items](../resources/directory.md).
-Currently, deleted items functionality is only supported for the [application](../resources/application.md), [group](../resources/group.md) and [user](../resources/user.md) resources. If an item was accidentally deleted, you can fully restore the item.
+Currently, restore deleted items functionality is only supported for the [application](../resources/application.md), [group](../resources/group.md) and [user](../resources/user.md) resources. If an item was accidentally deleted, you can fully restore the item. This is not applicable to Security groups, which are deleted permanently.
A recently deleted item will remain available for up to 30 days. After 30 days, the item is permanently deleted.
v1.0 Directoryobject Checkmembergroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/directoryobject-checkmembergroups.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | User.ReadBasic.All and GroupMember.Read.All, User.Read.All and GroupMember.Read.All, User.ReadBasic.All and Group.Read.All, User.Read.All and Group.Read.All, Directory.Read.All |
+|Delegated (work or school account) | User.ReadBasic.All, User.Read.All, Directory.Read.All |
|Delegated (personal Microsoft account) | Not supported. |
-|Application | User.Read.All and GroupMember.Read.All, User.Read.All and Group.Read.All, Directory.Read.All |
+|Application | User.Read.All, Directory.Read.All |
Use the follow scenario guidance to help determine which permission types to use: - Use User.Read and GroupMember.Read.All or User.Read and Group.Read.All permissions to get group memberships for the signed-in user.
v1.0 Drive Get Specialfolder https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/drive-get-specialfolder.md
- Last updated 09/10/2017 Title: Get Special Folders localization_priority: Normal
v1.0 Drive Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/drive-get.md
- Last updated 09/10/2017 Title: Get Drive localization_priority: Priority
If the drive does not exist and cannot be provisioned automatically (when using
"keywords": "drive,onedrive,default drive,group drive", "section": "documentation", "suppressions": [
- "Warning: /api-reference/v1.0/api/drive-get.md:
- Unable to map some markdown elements into schema.
- Unmapped methods:
- get-drive-default, get-drive-by-user, get-drive-by-group, get-drive-by-id
- Unmapped tables:
- Permissions - AuthScopes, Path parameters - PathParameters, Path parameters - PathParameters, Path parameters - PathParameters, Path parameters - PathParameters"
], "tocPath": "Drives/Get drive" } -->
v1.0 Drive List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/drive-list.md
- Last updated 09/10/2017 Title: List Drives localization_priority: Priority
v1.0 Drive Recent https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/drive-recent.md
- Last updated 09/10/2017 Title: List Recent Files localization_priority: Normal
v1.0 Drive Sharedwithme https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/drive-sharedwithme.md
- Last updated 09/10/2017 Title: List Files Shared With Me localization_priority: Priority
v1.0 Driveitem Copy https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/driveitem-copy.md
- Last updated 09/10/2017 Title: Copy a file or folder localization_priority: Normal
v1.0 Driveitem Createlink https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/driveitem-createlink.md
- Last updated 09/10/2017 Title: Share a file with a link localization_priority: Normal
v1.0 Driveitem Createuploadsession https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/driveitem-createuploadsession.md
- Last updated 09/10/2017 Title: Resumable file upload localization_priority: Priority
how errors are returned.
"description": "Upload large files using an upload session.", "keywords": "upload,large file,fragment,BITS", "suppressions": [
- "Warning: /api-reference/v1.0/api/driveitem-createuploadsession.md:
- Found potential enums in resource example that weren't defined in a table:(rename,fail,replace) are in resource, but () are in table"
], "section": "documentation" } -->
v1.0 Driveitem Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/driveitem-delete.md
- Last updated 09/10/2017 Title: Delete a file or folder localization_priority: Normal
v1.0 Driveitem Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/driveitem-delta.md
- Last updated 09/10/2017 Title: Sync the contents of a drive localization_priority: Priority
v1.0 Driveitem Get Content Format https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/driveitem-get-content-format.md
- Last updated 09/10/2017 Title: Convert to other formats localization_priority: Priority
v1.0 Driveitem Get Content https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/driveitem-get-content.md
- Last updated 09/10/2017 Title: Download a file localization_priority: Priority
v1.0 Driveitem Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/driveitem-get.md
- Last updated 09/10/2017 Title: Get a file or folder localization_priority: Priority
v1.0 Driveitem Invite https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/driveitem-invite.md
- Last updated 09/10/2017 Title: Send an invite to access an item localization_priority: Normal
v1.0 Driveitem List Children https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/driveitem-list-children.md
- Last updated 09/10/2017 Title: List the contents of a folder localization_priority: Priority
v1.0 Driveitem List Permissions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/driveitem-list-permissions.md
- Last updated 09/10/2017 Title: List who has access to a file localization_priority: Normal
v1.0 Driveitem List Thumbnails https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/driveitem-list-thumbnails.md
- Last updated 09/10/2017 Title: Retrieve thumbnails for a file or folder localization_priority: Normal
how errors are returned.
"keywords": "thumbnail,content,download,sizes", "section": "documentation", "suppressions": [
- "Warning: /api-reference/v1.0/api/driveitem-list-thumbnails.md:
- Unable to map some markdown elements into schema.
- Unmapped methods:
- enum-item-thumbnails, get-one-thumbnail, get-thumbnail-content, get-thumbnail-while-listing, get-thumbnail-custom-size
- Unmapped tables:
- Permissions - AuthScopes, Path parameters - PathParameters, Size options - Unknown, Examples of custom identifiers - Unknown",
- "Warning: Couldn't serialize request for path /me/drive/items/{var}/thumbnails/{var}/{var}/content into EDMX: System.InvalidOperationException: Uri path requires navigating into unknown object hierarchy: missing property '{var}' on 'thumbnailSet'. Possible issues:
- 1) Doc bug where '{var}' isn't defined on the resource. 2) Doc bug where '{var}' is an example key and should instead be replaced with a placeholder like {item-id} or declared in the sampleKeys annotation. 3) Doc bug where 'thumbnailSet' is supposed to be an entity type, but is being treated as a complex because it (and its ancestors) are missing the keyProperty annotation
- at ApiDocs.Publishing.CSDL.CsdlWriter.ParseRequestTargetType(String requestPath, MethodCollection requestMethodCollection, EntityFramework edmx, IssueLogger issues) in D:/src/mds2/ApiDocs.Publishing/CSDL/CsdlWriter.cs:line 1145
- at ApiDocs.Publishing.CSDL.CsdlWriter.ProcessRestRequestPaths(EntityFramework edmx, String[] baseUrlsToRemove, IssueLogger issues) in D:/src/mds2/ApiDocs.Publishing/CSDL/CsdlWriter.cs:line 821"
], "tocPath": "Items/Thumbnails" } -->
v1.0 Driveitem Move https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/driveitem-move.md
- Last updated 09/10/2017 Title: Move a file or folder localization_priority: Normal
v1.0 Driveitem Post Children https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/driveitem-post-children.md
- Last updated 09/10/2017 Title: Create a new folder localization_priority: Priority
v1.0 Driveitem Put Content https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/driveitem-put-content.md
- Last updated 09/10/2017 Title: Upload small files localization_priority: Priority
v1.0 Driveitem Search https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/driveitem-search.md
- Last updated 07/07/2020 Title: Search for files localization_priority: Priority
v1.0 Driveitem Unfollow https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/driveitem-unfollow.md
- description: Unfollow an item that the user is following. Title: Unfollow drive item localization_priority: Normal
v1.0 Driveitem Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/driveitem-update.md
- Last updated 09/10/2017 Title: Update a file or folder localization_priority: Priority
v1.0 Group List Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-list-members.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | GroupMember.Read.All, Group.Read.All, Directory.Read.All |
+|Delegated (work or school account) | GroupMember.Read.All, Group.Read.All, GroupMember.ReadWrite.All, Group.ReadWrite.All, Directory.Read.All |
|Delegated (personal Microsoft account) | Not supported. |
-|Application | GroupMember.Read.All, Group.Read.All, Directory.Read.All |
+|Application | GroupMember.Read.All, Group.Read.All, GroupMember.ReadWrite.All, Group.ReadWrite.All, Directory.Read.All |
[!INCLUDE [limited-info](../../includes/limited-info.md)]
v1.0 Group List Owners https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-list-owners.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | Group.Read.All and User.ReadBasic.All, Group.Read.All and User.Read.All, Group.Read.All and User.ReadWrite.All, Group.Read.All and User.Read.All and Application.Read.All |
+|Delegated (work or school account) | GroupMember.Read.All, Group.Read.All, GroupMember.ReadWrite.All, Group.ReadWrite.All, Directory.Read.All, Directory.AccessAsUser.All |
|Delegated (personal Microsoft account) | Not supported. |
-|Application | Group.Read.All and User.Read.All, Group.Read.All and User.ReadWrite.All, Group.Read.All and User.Read.All and Application.Read.All |
+|Application | GroupMember.Read.All, Group.Read.All, GroupMember.ReadWrite.All, Group.ReadWrite.All, Directory.Read.All, Directory.AccessAsUser.All |
[!INCLUDE [limited-info](../../includes/limited-info.md)]
v1.0 Group List Transitivemembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-list-transitivemembers.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | Directory.Read.All, Directory.AccessAsUser.All, User.ReadBasic.All, User.Read.All, Application.Read.All |
+|Delegated (work or school account) | GroupMember.Read.All, Group.Read.All, GroupMember.ReadWrite.All, Group.ReadWrite.All, Directory.Read.All, Directory.AccessAsUser.All |
|Delegated (personal Microsoft account) | Not supported. |
-|Application | Directory.Read.All, User.Read.All, Application.Read.All |
+|Application | GroupMember.Read.All, Group.Read.All, GroupMember.ReadWrite.All, Group.ReadWrite.All, Directory.Read.All |
>**Note:** To list the members of a hidden membership group, the Member.Read.Hidden permission is required.
v1.0 Group Post Owners https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-post-owners.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) | Group.ReadWrite.All, Directory.ReadWrite.All, Directory.AccessAsUser.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | Group.ReadWrite.All and User.ReadWrite.All |
+|Application | Group.ReadWrite.All, Directory.ReadWrite.All |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Invitation Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/invitation-post.md
Content-length: 551
<!-- { "type": "#page.annotation", "suppressions": [
- "Error: create_user_from_users/invitedUser:
- Property 'invitedUser' is of type Custom but has no custom members."
] }-->
v1.0 Itemactivitystat Getactivitybyinterval https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/itemactivitystat-getactivitybyinterval.md
- Title: Get item activity stats by interval description: Get itemAnalyticyStats for the activities that took place on this resource within the specified time interval. localization_priority: Normal
v1.0 Itemanalytics Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/itemanalytics-get.md
- Title: Get itemAnalytics description: Get itemAnalytics about the views that took place under this resource. localization_priority: Normal
v1.0 List Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/list-create.md
- Last updated 09/11/2017 Title: Create a SharePoint List localization_priority: Normal
v1.0 List Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/list-get.md
- Title: Get a SharePoint list localization_priority: Priority ms.prod: "sharepoint"
v1.0 List List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/list-list.md
- Last updated 09/11/2017 Title: List the SharePoint lists in a site localization_priority: Priority
v1.0 Listitem Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/listitem-create.md
- Last updated 09/11/2017 Title: Create a new entry in a SharePoint list localization_priority: Priority
v1.0 Listitem Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/listitem-delete.md
- Last updated 09/11/2017 Title: Delete an entry from a SharePoint list localization_priority: Normal
v1.0 Listitem Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/listitem-get.md
- Title: Get listItem description: Returns the metadata for an item in a SharePoint list. localization_priority: Priority
v1.0 Listitem List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/listitem-list.md
- Last updated 09/11/2017 Title: Retrieve items from a SharePoint list localization_priority: Priority
v1.0 Listitem Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/listitem-update.md
- Title: Update listItem description: Update the properties on a **[listItem][]**. localization_priority: Priority
v1.0 Onlinemeeting Createorget https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/onlinemeeting-createorget.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | OnlineMeetings.ReadWrite | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
+| Application | OnlineMeetings.ReadWrite.All* |
+
+> [!IMPORTANT]
+> \* Administrators must create an [application access policy](/graph/concepts/cloud-communication-online-meeting-application-access-policy.md) and grant it to a user, authorizing the app configured in the policy to create or get an online meeting with external ID on behalf of that user (user ID specified in the request path).
## HTTP request
+To call **createOrGet** API with delegated token:
<!-- { "blockType": "ignored" } --> ```http POST /me/onlineMeetings/createOrGet ```
+To call **createOrGet** API with application token:
+<!-- { "blockType": "ignored" } -->
+```http
+POST /users/{userId}/onlineMeetings/createOrGet
+```
+
+> **Note:** `userId` is the object ID of a user in [Azure user management portal](https://portal.azure.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). See more details in [application access policy](/graph/cloud-communication-online-meeting-application-access-policy).
+ ## Request headers | Name | Description | |:--|:--|
v1.0 Onlinemeeting Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/onlinemeeting-delete.md
Delete an [onlineMeeting](../resources/onlinemeeting.md) object.
| :-- | :-- | | Delegated (work or school account) | OnlineMeetings.ReadWrite | | Delegated (personal Microsoft account) | Not Supported. |
-| Application | Not Supported. |
+| Application | OnlineMeetings.ReadWrite.All* |
+
+> [!IMPORTANT]
+> \* Administrators must create an [application access policy](/graph/cloud-communication-online-meeting-application-access-policy) and grant it to a user, authorizing the app configured in the policy to delete an online meeting on behalf of that user (user ID specified in the reuqest path) has created.
## HTTP request
+To delete the specified onlineMeeting by meeting ID with delegated permission:
+<!-- { "blockType": "ignored" } -->
+```http
+DELETE /me/onlineMeetings/{meetingId}
+```
+
+To delete the specified onlineMeeting by meeting ID with application permission:
<!-- { "blockType": "ignored" } --> ```http
-DELETE https://graph.microsoft.com/v1.0/me/onlineMeetings/{id}
+DELETE /users/{userId}/onlineMeetings/{meetingId}
```
+> **Note:**
+> - `userId` is the object ID of a user in [Azure user management portal](https://portal.azure.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). For more details, see [application access policy](/graph/cloud-communication-online-meeting-application-access-policy).
+> - `meetingId` is the **id** of an [onlineMeeting](../resources/onlinemeeting.md) object.
## Request headers | Name | Description |
v1.0 Onlinemeeting Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/onlinemeeting-get.md
Title: "Get onlineMeeting"
-description: "Retrieve the properties and relationships of an **online meeting** object."
+description: "Retrieve the properties and relationships of an online meeting object."
localization_priority: Normal ms.prod: "cloud-communications"
doc_type: apiPageType
Namespace: microsoft.graph
-Retrieve the properties and relationships of an [onlineMeeting](../resources/onlinemeeting.md) object.
+Retrieve the properties and relationships of an [onlineMeeting](../resources/onlinemeeting.md) object. You can get details of an onlineMeeting using [VideoTeleconferenceId](#example-1-retrieve-an-online-meeting-by-videoteleconferenceid) or [meeting ID](#example-2-retrieve-an-online-meeting-by-meeting-id).
-> **Note:** The `GET` method is currently only supported for a [VTC conference id](/microsoftteams/cloud-video-interop-for-teams-set-up). These IDs are generated for Cloud-Video-Interop licensed users and this method is used to get the details to join the meeting.
## Permissions
One of the following permissions is required to call this API. To learn more, in
| Permission type | Permissions (from least to most privileged) | |:|:|
-| Delegated (work or school account) | Not Supported. |
+| Delegated (work or school account) | OnlineMeetings.Read, OnlineMeetings.ReadWrite |
| Delegated (personal Microsoft account) | Not Supported. |
-| Application | OnlineMeetings.Read.All |
+| Application | OnlineMeetings.Read.All, OnlineMeetings.ReadWrite.All* |
+
+> [!IMPORTANT]
+> \* Administrators must create an [application access policy](/graph/cloud-communication-online-meeting-application-access-policy) and grant it to a user, authorizing the app configured in the policy to retrieve an online meeting on behalf of that user (user ID specified in the request path).
## HTTP request
+To get the specified onlineMeeting using meeting ID with delegated token:
+<!-- { "blockType": "ignored" } -->
+```http
+GET /me/onlineMeetings/{meetingId}
+```
+
+To get the specified onlineMeeting using meeting ID with application token:
+<!-- { "blockType": "ignored" } -->
+```http
+GET /users/{userId}/onlineMeetings/{meetingId}
+```
+
+To get the specified onlineMeeting using **videoTeleconferenceId***:
<!-- { "blockType": "ignored" } --> ```http
-GET /communications/onlineMeetings/?$filter=VideoTeleconferenceId%20eq%20'{id}'
+GET /communications/onlineMeetings/?$filter=VideoTeleconferenceId%20eq%20'{videoTeleconferenceId}'
```
+> **Note:**
+> - `userId` is the object ID of a user in [Azure user management portal](https://portal.azure.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). For more details, see [application access policy](/graph/cloud-communication-online-meeting-application-access-policy).
+> - `meetingId` is the **id** of an [onlineMeeting](../resources/onlinemeeting.md) object.
+> - **videoTeleconferenceId** is generated for Cloud-Video-Interop licensed users and can be found in an [onlineMeeting](../resources/onlinemeeting.md) object. Refer to [VTC conference id](/microsoftteams/cloud-video-interop-for-teams-set-up) for more details.
+> - \* This scenario only supports application token and does not support application access policy.
+ ## Optional query parameters This method supports the [OData query parameters](/graph/query-parameters) to help customize the response.
If successful, this method returns a `200 OK` response code and an [onlineMeetin
## Examples
-### Request
+### Example 1: Retrieve an online meeting by VideoTeleconferenceId
+
+#### Request
The following example shows the request.
GET https://graph.microsoft.com/v1.0/communications/onlineMeetings/?$filter=Vide
} ```
-### Response
+#### Response
> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
Content-Length: 1574
} ```
+### Example 2: Retrieve an online meeting by meeting ID
+You can retrieve meeting information via meeting ID with either a user or application token. The meeting ID is provided in the response object when creating an [onlineMeeting](../resources/onlinemeeting.md). This option is available to support use cases where the meeting ID is known, such as when an application first creates the online meeting using Graph API first then retrieves meeting information later as a separate action.
+
+#### Request
+
+> **Note:** The meeting ID has been truncated for readability.
+
+The following request uses a user token.
+<!-- { "blockType": "ignored" } -->
+```http
+GET https://graph.microsoft.com/beta/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZiMi04ZdFpHRTNaR1F6WGhyZWFkLnYy
+```
+
+The following request uses an app token.
+<!-- { "blockType": "ignored" } -->
+```http
+GET https://graph.microsoft.com/beta/users/dc17674c-81d9-4adb-bfb2-8f6a442e4622/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZiMi04ZdFpHRTNaR1F6WGhyZWFkLnYy
+```
+
+#### Response
+
+> **Note:** The response object shown here has been shortened for readability. All the properties will be returned from an actual call.
+
+```json
+{
+ "id": "MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZiMi04ZdFpHRTNaR1F6WGhyZWFkLnYy",
+ "creationDateTime": "2020-09-29T22:35:33.1594516Z",
+ "startDateTime": "2020-09-29T22:35:31.389759Z",
+ "endDateTime": "2020-09-29T23:35:31.389759Z",
+ "joinWebUrl": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_MGQ4MDQyNTEtNTQ2NS00YjQxLTlkM2EtZWVkODYxODYzMmY2%40thread.v2/0?context=%7b%22Tid%22%3a%22909c6581-5130-43e9-88f3-fcb3582cde37%22%2c%22Oid%22%3a%22dc17674c-81d9-4adb-bfb2-8f6a442e4622%22%7d",
+ "subject": null,
+ "autoAdmittedUsers": "EveryoneInCompany",
+ "isEntryExitAnnounced": true,
+ "allowedPresenters": "everyone",
+ "videoTeleconferenceId": "(redacted)",
+ "participants": {
+ "organizer": {
+ "upn": "(redacted)",
+ "role": "presenter",
+ "identity": {
+ "user": {
+ "id": "dc17674c-81d9-4adb-bfb2-8f6a442e4622",
+ "displayName": null,
+ "tenantId": "909c6581-5130-43e9-88f3-fcb3582cde38",
+ "identityProvider": "AAD"
+ }
+ }
+ },
+ "attendees": [],
+ "producers": [],
+ "contributors": []
+ },
+ "lobbyBypassSettings": {
+ "scope": "organization",
+ "isDialInBypassEnabled": false
+ }
+}
+```
+ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!--
v1.0 Openshiftchangerequest Approve https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/openshiftchangerequest-approve.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-POST /teams/{id}/schedule/openShiftsChangeRequests/{openShiftChangeRequestId}/approve
+POST /teams/{id}/schedule/openShiftChangeRequests/{openShiftChangeRequestId}/approve
``` ## Request headers
The following is an example of a request.
}--> ```http
-POST https://graph.microsoft.com/v1.0/teams/{id}/schedule/openShiftsChangeRequests/{openShiftChangeRequestId}/approve
+POST https://graph.microsoft.com/v1.0/teams/{id}/schedule/openShiftChangeRequests/{openShiftChangeRequestId}/approve
Content-type: application/json {
v1.0 Openshiftchangerequest Decline https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/openshiftchangerequest-decline.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-POST /teams/{id}/schedule/openShiftsChangeRequests/{openShiftChangeRequestId}/decline
+POST /teams/{id}/schedule/openShiftChangeRequests/{openShiftChangeRequestId}/decline
``` ## Request headers
The following is an example of the request.
}--> ```http
-POST https://graph.microsoft.com/v1.0/teams/{id}/schedule/openShiftsChangeRequests/{openShiftChangeRequestId}/decline
+POST https://graph.microsoft.com/v1.0/teams/{id}/schedule/openShiftChangeRequests/{openShiftChangeRequestId}/decline
Content-type: application/json {
v1.0 Openshiftchangerequest Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/openshiftchangerequest-get.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-GET /teams/{id}/schedule/openShiftsChangeRequests/{openShiftsChangeRequestId}
+GET /teams/{id}/schedule/openShiftChangeRequests/{openShiftsChangeRequestId}
``` ## Optional query parameters
The following is an example of the request.
}--> ```http
-GET https://graph.microsoft.com/v1.0/teams/{id}/schedule/openShiftsChangeRequests/SREQ_0b87dd20-d5ed-4764-9c3e-cfc8516def09
+GET https://graph.microsoft.com/v1.0/teams/{id}/schedule/openShiftChangeRequests/SREQ_0b87dd20-d5ed-4764-9c3e-cfc8516def09
``` ### Response
v1.0 Openshiftchangerequest List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/openshiftchangerequest-list.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-GET /teams/{id}/schedule/openShiftsChangeRequests
+GET /teams/{id}/schedule/openShiftChangeRequests
``` ## Optional query parameters
The following is an example of the request.
}--> ```http
-GET https://graph.microsoft.com/v1.0/teams/{id}/schedule/openShiftsChangeRequests
+GET https://graph.microsoft.com/v1.0/teams/{id}/schedule/openShiftChangeRequests
``` ### Response
v1.0 Openshiftchangerequest Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/openshiftchangerequest-post.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-POST /teams/{id}/schedule/openShiftsChangeRequests
+POST /teams/{id}/schedule/openShiftChangeRequests
``` ## Request headers
The following is an example of the request.
}--> ```http
-POST https://graph.microsoft.com/v1.0/teams/788b75d2-a911-48c0-a5e2-dc98480457e3/schedule/openShiftsChangeRequests
+POST https://graph.microsoft.com/v1.0/teams/788b75d2-a911-48c0-a5e2-dc98480457e3/schedule/openShiftChangeRequests
Authorization: Bearer {token} Content-type: application/json Content-length: 244
v1.0 Participant Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/participant-delete.md
Title: "Delete participant"
description: "Delete a specific participant in the call." - localization_priority: Normal ms.prod: "cloud-communications" doc_type: apiPageType
v1.0 Participant Invite https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/participant-invite.md
Content-Type: application/json
>**Note:** With a "completed" status, you can expect to receive notifications on how your original peer-to-peer call has been terminated and deleted.
+### Example 4: Invite one PSTN participant to an existing group call
+
+This call requires an application instance with a PSTN number assigned.
+
+#### Step 1: Create application instance
+Using tenant admin credentials, call the following cmdlets on the tenant remote PowerShell to create the application instance. For more information, see [New-CsOnlineApplicationInstance](/powershell/module/skype/new-csonlineapplicationinstance?view=skype-ps&preserve-view=true) and [Sync-CsOnlineApplicationInstance](/powershell/module/skype/sync-csonlineapplicationinstance?view=skype-ps&preserve-view=true).
+```
+PS C:\> New-CsOnlineApplicationInstance -UserPrincipalName <UPN> -DisplayName <DisplayName> -ApplicationId <AppId>
+PS C:\> Sync-CsOnlineApplicationInstance -ObjectId <ObjectId>
+```
+#### Step 2: Assign Microsoft 365 licenses
+1. Use tenant admin credentials to sign in to https://admin.microsoft.com/ and go to the **Users -> Active users** tab.
+2. Select the application instance, assign **Microsoft 365 Domestic and International Calling Plan** and **Microsoft 365 Phone System - Virtual User** licenses, and click **Save changes**. If the required licenses are not available in the tenant, you can get them from the **Billing -> Purchase services** tab.
+#### Step 3: Acquire PSTN number
+1. Use tenant admin credentials to sign in to https://admin.teams.microsoft.com/ and click the **Legacy portal** tab on the left panel.
+2. In the new page, go to the **voice -> phone numbers** tab.
+3. Click the **+** button, select **New Service Numbers**, and go to the **Add new service numbers** page.
+4. Select **Country/Region**, **State/Region**, **City**, input **Quantity**, and click **add** to search. Click **acquire numbers**. The newly acquired number will show on the **phone numbers** tab.
+#### Step 4: Assign PSTN number to application instance
+With tenant admin credentials, call the following cmdlets on the tenant remote PowerShell to assign the PSTN number to the application instance. For more information, see [Set-CsOnlineVoiceApplicationInstance](https://docs.microsoft.com/powershell/module/skype/set-csonlinevoiceapplicationinstance?view=skype-ps&preserve-view=true) and [Sync-CsOnlineApplicationInstance](https://docs.microsoft.com/powershell/module/skype/sync-csonlineapplicationinstance?view=skype-ps&preserve-view=true).
+```
+PS C:\> Set-CsOnlineVoiceApplicationInstance -Identity <UPN> -TelephoneNumber <TelephoneNumber>
+PS C:\> Sync-CsOnlineApplicationInstance -ObjectId <ObjectId>
+```
+
+#### Request
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "participant-invite"
+}-->
+```http
+POST /communications/calls/{id}/participants/invite
+Content-Type: application/json
+Content-Length: 464
+
+{
+ "participants": [
+ {
+ "@odata.type": "#microsoft.graph.invitationParticipantInfo",
+ "identity": {
+ "@odata.type": "#microsoft.graph.identitySet",
+ "phone": {
+ "@odata.type": "#microsoft.graph.identity",
+ "id": "+12345678901"
+ }
+ }
+ }
+ ],
+ "clientContext": "f2fa86af-3c51-4bc2-8fc0-475452d9764f"
+}
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
++++
+#### Response
+
+> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.inviteParticipantsOperation"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.inviteParticipantsOperation",
+ "id": "eec3812a-fdc3-4fb4-825c-a06c9f35414e",
+ "status": "Running",
+ "clientContext": "f2fa86af-3c51-4bc2-8fc0-475452d9764f",
+ "resultInfo": null,
+ "participants": [
+ {
+ "endpointType": null,
+ "id": null,
+ "replacesCallId": null,
+ "identity": {
+ "user": null,
+ "guest": null,
+ "encrypted": null,
+ "onPremises": null,
+ "applicationInstance": null,
+ "application": null,
+ "device": null,
+ "phone": {
+ "@odata.type": "#microsoft.graph.identity",
+ "id": "+12345678901"
+ }
+ }
+ }
+ ]
+}
+```
+
+#### Notification - operation completed
+
+```http
+POST https://bot.contoso.com/api/calls
+Content-Type: application/json
+```
+
+<!-- {
+ "blockType": "example",
+ "@odata.type": "microsoft.graph.commsNotifications"
+}-->
+```json
+{
+ "@odata.type":"#microsoft.graph.commsNotifications",
+ "value":[
+ {
+ "@odata.type":"#microsoft.graph.commsNotification",
+ "changeType":"deleted",
+ "resource":"/app/calls/ab6233a5-20b7-4c5e-bea2-ce56c9776429/operations/eec3812a-fdc3-4fb4-825c-a06c9f35414e",
+ "resourceUrl":"/communications/calls/ab6233a5-20b7-4c5e-bea2-ce56c9776429/operations/eec3812a-fdc3-4fb4-825c-a06c9f35414e",
+ "resourceData":{
+ "@odata.type":"#microsoft.graph.inviteParticipantsOperation",
+ "participants":[
+ {
+ "@odata.type":"#microsoft.graph.invitationParticipantInfo",
+ "identity":{
+ "@odata.type":"#microsoft.graph.identitySet",
+ "phone": {
+ "@odata.type": "#microsoft.graph.identity",
+ "id": "+12345678901"
+ }
+ }
+ }
+ ],
+ "status":"completed",
+ "clientContext":"f2fa86af-3c51-4bc2-8fc0-475452d9764f",
+ "id":"eec3812a-fdc3-4fb4-825c-a06c9f35414e"
+ }
+ }
+ ]
+}
+```
+
+#### Notification - roster updated with participant added
+
+```http
+POST https://bot.contoso.com/api/calls
+Content-Type: application/json
+```
+
+<!-- {
+ "blockType": "example",
+ "@odata.type": "microsoft.graph.commsNotifications"
+}-->
+```json
+{
+ "@odata.type":"#microsoft.graph.commsNotifications",
+ "value":[
+ {
+ "@odata.type":"#microsoft.graph.commsNotification",
+ "changeType":"updated",
+ "resource":"/app/calls/ab6233a5-20b7-4c5e-bea2-ce56c9776429/participants",
+ "resourceUrl":"/communications/calls/ab6233a5-20b7-4c5e-bea2-ce56c9776429/participants",
+ "resourceData":[
+ {
+ "@odata.type":"#microsoft.graph.participant",
+ "info":{
+ "@odata.type":"#microsoft.graph.participantInfo",
+ "identity":{
+ "@odata.type":"#microsoft.graph.identitySet",
+ "phone": {
+ "@odata.type": "#microsoft.graph.identity",
+ "id": "+12345678901"
+ }
+ },
+ "endpointType":"default"
+ },
+ "mediaStreams":[
+ {
+ "@odata.type":"#microsoft.graph.mediaStream",
+ "mediaType":"audio",
+ "sourceId":"1",
+ "direction":"sendReceive",
+ "serverMuted":false
+ }
+ ],
+ "isMuted":false,
+ "isInLobby":false,
+ "id":null
+ }
+ ]
+ }
+ ]
+}
+
+```
+
+>**Note:** With a `completed` status, you can expect to receive notifications about how your original peer-to-peer call has been terminated and deleted.
+ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!--
v1.0 Permission Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/permission-delete.md
- Last updated 09/10/2017 Title: Remove access to an item localization_priority: Normal
v1.0 Permission Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/permission-get.md
- Last updated 09/10/2017 Title: Get permissions localization_priority: Normal
v1.0 Permission Grant https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/permission-grant.md
- Title: Grant permission description: Grant a list of users access to use the specified link localization_priority: Normal
v1.0 Permission Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/permission-update.md
- Last updated 09/10/2017 Title: Change sharing permissions localization_priority: Normal
v1.0 Place List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/place-list.md
Content-type: application/json
"section": "documentation", "tocPath": "", "suppressions": [
- "Error: Malformed function params 'id-of-roomlist'"
] }-->
v1.0 Projectrome Get Recent Activities https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/projectrome-get-recent-activities.md
Content-Type: application/json
"keywords": "", "section": "documentation", "suppressions": [
- "Error: get_recent_activities/container/contentInfo:
- Property 'contentInfo' is of type Custom but has no custom members.",
-
- "Warning: get_recent_activities/container/visualElements/content/$schema:
- Undocumented property '$schema' [String] was not expected on resource microsoft.graph.Json.",
-
- "Warning: get_recent_activities/container/visualElements/content/body:
- Undocumented property 'body' [Collection(Object)] was not expected on resource microsoft.graph.Json.",
-
- "Warning: get_recent_activities/container/visualElements/content/type:
- Undocumented property 'type' [String] was not expected on resource microsoft.graph.Json."
- ], "tocPath": "" }-->
v1.0 Range Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/range-update.md
Content-length: 169
"keywords": "", "section": "documentation", "suppressions": [
- "Warning: /api-reference/v1.0/api/range-update.md/update_range/numberFormat:
- Inconsistent types between parameter (Collection) and table (None)",
- "Warning: /api-reference/v1.0/api/range-update.md/update_range/values:
- Inconsistent types between parameter (Collection) and table (None)",
- "Error: /api-reference/v1.0/api/range-update.md/update_range/numberFormat:
- Type mismatch between example and table. Parameter name: numberFormat; example type (Collection(Collection)) is a collection, while the table description type (microsoft.graph.Json) is not.",
- "Error: /api-reference/v1.0/api/range-update.md/update_range/values:
- Type mismatch between example and table. Parameter name: values; example type (Collection(Collection)) is a collection, while the table description type (microsoft.graph.Json) is not."
], "tocPath": "" }-->
v1.0 Serviceprincipal Addkey https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceprincipal-addkey.md
The following is an example of the response.
<!-- { "blockType": "response",
- "truncated": true
+ "truncated": true,
+ "@odata.type": "microsoft.graph.keyCredential"
} --> ```http
Content-Type: application/json
"section": "documentation", "tocPath": "", "suppressions": [
- "Error: serviceprincipal_addkey:\r\n Resource type was null or missing, so we assume there is no response to validate."
- ]
+ ]
}-->
v1.0 Shares Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/shares-get.md
- Last updated 09/10/2017 Title: Access shared items localization_priority: Normal
v1.0 Signin List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/signin-list.md
This method supports the following OData query parameters to help customize the
## Response
-If successful, this method returns a `200 OK` response code and collection of [signIn](../resources/signin.md) objects in the response body.
+If successful, this method returns a `200 OK` response code and collection of [signIn](../resources/signin.md) objects in the response body. The collection of objects is listed in descending order based on **createdDateTime**.
## Example
v1.0 Site Delete Permission https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/site-delete-permission.md
If successful, this method returns `204 No Content` response code. It does not r
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_permission"
If successful, this method returns `204 No Content` response code. It does not r
``` http DELETE https://graph.microsoft.com/v1.0/sites/{sitesId}/permissions/{permissionId} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Site Get Permission https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/site-get-permission.md
If successful, this method returns a `200 OK` response code and the [permission]
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_permission"
If successful, this method returns a `200 OK` response code and the [permission]
``` http GET https://graph.microsoft.com/v1.0/sites/{sitesId}/permissions/{permissionId} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Site Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/site-get.md
- Last updated 09/10/2017 Title: Get a SharePoint Site localization_priority: Priority
v1.0 Site Getbypath https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/site-getbypath.md
- Last updated 09/10/2017 Title: Get SharePoint site by path localization_priority: Normal
Content-Type: application/json
"keywords": "", "section": "documentation", "suppressions": [
- "Warning: Couldn't serialize request for path /sites/{var}/children/{var} into EDMX: System.InvalidOperationException: Uri path requires navigating into unknown object hierarchy: missing property 'children' on 'site'. Possible issues:
- 1) Doc bug where 'children' isn't defined on the resource. 2) Doc bug where 'children' is an example key and should instead be replaced with a placeholder like {item-id} or declared in the sampleKeys annotation. 3) Doc bug where 'site' is supposed to be an entity type, but is being treated as a complex because it (and its ancestors) are missing the keyProperty annotation
- at ApiDocs.Publishing.CSDL.CsdlWriter.ParseRequestTargetType(String requestPath, MethodCollection requestMethodCollection, EntityFramework edmx, IssueLogger issues) in D:/src/mds2/ApiDocs.Publishing/CSDL/CsdlWriter.cs:line 982
- at ApiDocs.Publishing.CSDL.CsdlWriter.ProcessRestRequestPaths(EntityFramework edmx, String[] baseUrlsToRemove, IssueLogger issues) in D:/src/mds2/ApiDocs.Publishing/CSDL/CsdlWriter.cs:line 653"
], "tocPath": "Sites/Get by path" } -->
v1.0 Site List Permissions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/site-list-permissions.md
If successful, this method returns a `200 OK` response code and a collection of
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_permission"
If successful, this method returns a `200 OK` response code and a collection of
``` http GET https://graph.microsoft.com/v1.0/sites/{sitesId}/permissions ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Site List Subsites https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/site-list-subsites.md
- Last updated 09/10/2017 Title: List the subsites for a SharePoint site localization_priority: Priority
v1.0 Site Post Permissions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/site-post-permissions.md
If successful, this method returns a `201 Created` response code and a [permissi
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_permission_from_"
Content-Type: application/json
}] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Site Search https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/site-search.md
- Last updated 09/10/2017 Title: Search for sites description: Search across a SharePoint tenant for sites that match keywords provided.
v1.0 Site Update Permission https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/site-update-permission.md
If successful, this method returns a `200 OK` response code and a [permission](.
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_permission_from_"
Content-Type: application/json
"roles": ["read"] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Subscriptions Socketio https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/subscriptions-socketio.md
- Title: "Get websocket endpoint" localization_priority: Normal ms.prod: "sharepoint"
v1.0 Table Post Rows https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/table-post-rows.md
Content-length: 45
"keywords": "", "section": "documentation", "suppressions": [
- "Error: /api-reference/v1.0/api/table-post-rows.md/tablerowcollection_add/values:
- Type mismatch between example and table. Parameter name: values; example type (Collection(Collection)) is a collection, while the table description type (microsoft.graph.Json) is not.",
- "Warning: /api-reference/v1.0/api/table-post-rows.md/tablerowcollection_add/values:
- Inconsistent types between parameter (Collection) and table (None)"
], "tocPath": "" }-->
v1.0 Tablerowcollection Add https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/tablerowcollection-add.md
Content-length: 45
"keywords": "", "section": "documentation", "suppressions": [
- "Warning: /api-reference/v1.0/api/tablerowcollection-add.md/tablerowcollection_add/values:
- Inconsistent types between parameter (Collection) and table (None)",
- "Error: /api-reference/v1.0/api/tablerowcollection-add.md/tablerowcollection_add/values:
- Type mismatch between example and table. Parameter name: values; example type (Collection(Collection)) is a collection, while the table description type (microsoft.graph.Json) is not."
], "tocPath": "" }-->
v1.0 User Findmeetingtimes https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/user-findmeetingtimes.md
Preference-Applied: outlook.timezone="Pacific Standard Time"
"keywords": "", "section": "documentation", "suppressions": [
- "Warning: /api-reference/v1.0/api/user-findmeetingtimes.md:
- Failed to parse any rows out of table with headers: |activityDomain value|Suggestions for meeting times|",
"Error: user_findmeetingtimes/meetingTimeSuggestions/member/confidence:\r\n
- Expected type Double but actual was Int64. Property: confidence, actual value: '100'",
- "Error: user_findmeetingtimes/meetingTimeSuggestions/member/confidence:\r\n
- Expected type Float but actual was Int64. Property: confidence, actual value: '100'"
+ Expected type Double but actual was Int64. Property: confidence, actual value: '100'"
], "tocPath": "" }-->
v1.0 User Getmembergroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/user-getmembergroups.md
One of the following permissions is required to call this API. To learn more, in
| Permission type | Permissions (from least to most privileged) | | :- | : |
-| Delegated (work or school account) | User.ReadBasic.All and GroupMember.Read.All, User.Read and GroupMember.Read.All, User.Read.All and GroupMember.Read.All, User.ReadBasic.All and Group.Read.All, User.Read and Group.Read.All, User.Read.All and Group.Read.All, Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.All |
+| Delegated (work or school account) | User.ReadBasic.All, User.Read, User.Read.All, Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.All |
| Delegated (personal Microsoft account) | Not supported. |
-| Application | User.Read.All and GroupMember.Read.All, User.Read.All and Group.Read.All, Directory.Read.All, Directory.ReadWrite.All |
+| Application | User.Read.All, Directory.Read.All, Directory.ReadWrite.All |
## HTTP request
v1.0 User List Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/user-list-messages.md
Namespace: microsoft.graph
Get the messages in the signed-in user's mailbox (including the Deleted Items and Clutter folders).
-Depending on the page size and mailbox data, getting messages from a mailbox can incur multiple requests. The default page size is 10 messages. To get the next page of messages, simply apply the entire URL returned in `@odata.nextLink` to the next get-messages request. This URL includes any query parameters you may have specified in the initial request.
+Depending on the page size and mailbox data, getting messages from a mailbox can incur multiple requests. The default page size is 10 messages. Use `$top` to customize the page size, within the range of 1 and 1000.
+
+To improve the operation response time, use `$select` to specify the exact properties you need; see [example 1](#example-1-list-all-messages) below. Fine-tune the values for `$select` and `$top`, especially when you must use a larger page size, as returning a page with hundreds of messages each with a full response payload may trigger the [gateway timeout](/graph/errors#http-status-codes) (HTTP 504).
+
+To get the next page of messages, simply apply the entire URL returned in `@odata.nextLink` to the next get-messages request. This URL includes any query parameters you may have specified in the initial request.
Do not try to extract the `$skip` value from the `@odata.nextLink` URL to manipulate responses. This API uses the `$skip` value to keep count of all the items it has gone through in the user's mailbox to return a page of message-type items. It's therefore possible that even in the initial response, the `$skip` value is larger than the page size. For more information, see [Paging Microsoft Graph data in your app](/graph/paging).
Do not supply a request body for this method.
If successful, this method returns a `200 OK` response code and collection of [Message](../resources/message.md) objects in the response body.
-## Example
-##### Request
+## Examples
+### Example 1: List all messages
+#### Request
This example gets the default, top 10 messages in the signed-in user's mailbox. It uses `$select` to return a subset of the properties of each message in the response. # [HTTP](#tab/http)
GET https://graph.microsoft.com/v1.0/me/messages?$select=sender,subject
-##### Response
+#### Response
Here is an example of the response. To get the next page of messages, apply the URL returned in `@odata.nextLink` to a subsequent GET request. <!-- {
v1.0 User Translateexchangeids https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/user-translateexchangeids.md
POST /users/{id|userPrincipalName}/translateExchangeIds
### exchangeIdFormat values
-| Values | Description |
+| Member | Description |
|:-|:| | entryId | The binary entry ID format used by MAPI clients. | | ewsId | The ID format used by Exchange Web Services clients. |
v1.0 User Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/user-update.md
In the request body, supply the values for relevant fields that should be update
|onPremisesImmutableId|String|This property is used to associate an on-premises Active Directory user account to their Azure AD user object. This property must be specified when creating a new user account in the Graph if you are using a federated domain for the userΓÇÖs **userPrincipalName** (UPN) property. **Important:** The **$** and **_** characters cannot be used when specifying this property. | |otherMails|String |A list of additional email addresses for the user; for example: `["bob@contoso.com", "Robert@fabrikam.com"]`.| |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".|
-|passwordProfile|[PasswordProfile](../resources/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.|
+|passwordProfile|[PasswordProfile](../resources/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. This cannot be used for federated users.|
|pastProjects|String collection|A list for the user to enumerate their past projects.| |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.| |preferredLanguage|String|The preferred language for the user. Should follow ISO 639-1 Code; for example "en-US".|
v1.0 Workbook Closesession https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/workbook-closesession.md
HTTP/1.1 204 No Content
<!-- { "type": "#page.annotation", "suppressions": [
- "Warning: close_excel_session//api-reference/v1.0/api/workbook-closesession.md:
- Request includes a non-standard header: workbook-session-id"
] }-->
v1.0 Workbook Refreshsession https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/workbook-refreshsession.md
HTTP/1.1 204 No Content
<!-- { "type": "#page.annotation", "suppressions": [
- "Warning: refresh_excel_session//api-reference/v1.0/api/workbook-refreshsession.md:
- Request includes a non-standard header: workbook-session-id"
] }-->
v1.0 Accessaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/accessaction.md
- Title: accessAction resource type description: The accessAction object provides information about accesses of an item. localization_priority: Normal
v1.0 Approle https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/approle.md
description: "Represents an application role that may be requested by a client a
localization_priority: Normal doc_type: resourcePageType ms.prod: "applications"-+ # appRole resource type
Namespace: microsoft.graph
Represents an application role that can be requested by (and granted to) a client application, or that can be used to assign an application to users or groups in a specified role.
-The **appRoles** property of the [application](application.md) and [servicePrincipal](serviceprincipal.md) entities are a collection of **appRole**.
+To add, update, or remove app roles for an application, [update the application](../api/application-update.md) for the app or service. App roles on the application entity will be available in all tenants where the application is used. To define app roles that are only applicable in your tenant (for example, app roles representing custom roles in your instance of a multi-tenant application), you can also [update the service principal](../api/serviceprincipal-update.md) for the app, to add or update app roles to the **appRoles** collection.
With [appRoleAssignments](approleassignment.md), app roles can be assigned to users, groups, or other applications' service principals.
v1.0 Azure Ad Auditlog Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/azure-ad-auditlog-overview.md
To learn more, see [Azure AD pricing](https://azure.microsoft.com/pricing/detail
{ "type": "#page.annotation", "suppressions": [
- "Error: /api-reference/bet)\r\n at ApiDoctor.Validation.DocFile.get_LinkDestinations()\r\n at ApiDoctor.Validation.DocSet.ValidateLinks(Boolean includeWarnings, String[] relativePathForFiles, IssueLogger issues, Boolean requireFilenameCaseMatch, Boolean printOrphanedFiles)"
] } -->
v1.0 Baseitem https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/baseitem.md
- Last updated 09/10/2017 Title: BaseItem localization_priority: Normal
v1.0 Booleancolumn https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/booleancolumn.md
- Last updated 09/11/2017 Title: BooleanColumn localization_priority: Normal
v1.0 Calculatedcolumn https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/calculatedcolumn.md
- Last updated 09/11/2017 Title: CalculatedColumn localization_priority: Normal
v1.0 Calendarpermission https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/calendarpermission.md
Once a sharee or delegate has been set up for a calendar, you can [update](../ap
### calendarRoleType values
-| Values | Description |
+| Member | Description |
|:--|:| | none | Calendar is not shared with the user. | | freeBusyRead | User is a sharee who can view free/busy status of the owner on the calendar. |
v1.0 Choicecolumn https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/choicecolumn.md
- Last updated 09/11/2017 Title: ChoiceColumn localization_priority: Normal
v1.0 Columnlink https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/columnLink.md
- Last updated 09/12/2017 Title: ColumnLink localization_priority: Normal
v1.0 Columndefinition https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/columndefinition.md
- Last updated 09/11/2017 Title: ColumnDefinition localization_priority: Normal
v1.0 Commentaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/commentaction.md
- Title: commentAction resource type description: The commentAction object provides information about a comment that was made on an item. localization_priority: Normal
v1.0 Contenttype https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/contentType.md
- Last updated 09/12/2017 Title: ContentType localization_priority: Normal
v1.0 Contenttypeinfo https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/contentTypeInfo.md
- Last updated 09/12/2017 Title: ContentTypeInfo localization_priority: Normal
v1.0 Contenttypeorder https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/contentTypeOrder.md
- Last updated 09/13/2017 Title: ContentTypeOrder localization_priority: Normal
v1.0 Createaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/createaction.md
- Title: createAction resource type description: The createAction object provides information about the creation of an item. localization_priority: Normal
v1.0 Currencycolumn https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/currencycolumn.md
- Last updated 09/11/2017 Title: CurrencyColumn localization_priority: Normal
v1.0 Datetimecolumn https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/datetimecolumn.md
- Last updated 09/11/2017 Title: DateTimeColumn localization_priority: Normal
v1.0 Defaultcolumnvalue https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/defaultColumnValue.md
- Last updated 09/12/2017 Title: DefaultColumnValue localization_priority: Normal
v1.0 Deleteaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/deleteaction.md
- Title: deleteAction resource type description: The deleteAction object provides information about the deletion of an item. localization_priority: Normal
v1.0 Deleted https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/deleted.md
- Last updated 09/10/2017 Title: Deleted localization_priority: Normal
v1.0 Drive https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/drive.md
- Last updated 09/10/2017 Title: Drive localization_priority: Priority
v1.0 Driverecipient https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/driverecipient.md
- Last updated 09/10/2017 Title: DriveRecipient localization_priority: Normal
v1.0 Editaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/editaction.md
- Title: editAction resource type description: The EditAction object provides information about an activity that edited an item. localization_priority: Normal
v1.0 Educationuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/educationuser.md
The following is a JSON representation of the resource.
"section": "documentation", "suppressions": [ "Error: microsoft.graph.educationUser/assignments:
- Referenced type microsoft.graph.educationAssignment is not defined in the doc set! Potential suggestion: UNKNOWN",
- "Warning: /api-reference/v1.0/resources/educationuser.md/microsoft.graph.educationUser:
- Property 'relatedContacts' found in markdown table but not in resource definition."
+ Referenced type microsoft.graph.educationAssignment is not defined in the doc set! Potential suggestion: UNKNOWN"
], "tocPath": "" }-->
v1.0 Fieldvalueset https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/fieldvalueset.md
- Last updated 09/11/2017 Title: FieldValueSet localization_priority: Normal
v1.0 Filesysteminfo https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/filesysteminfo.md
- Last updated 09/10/2017 Title: FileSystemInfo localization_priority: Normal
v1.0 Folder https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/folder.md
- Last updated 09/10/2017 Title: Folder localization_priority: Normal
v1.0 Folderview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/folderview.md
- Last updated 09/10/2017 Title: FolderView localization_priority: Normal
v1.0 Geocoordinates https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/geocoordinates.md
- Last updated 09/10/2017 Title: GeoCoordinates localization_priority: Normal
v1.0 Group https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/group.md
This resource supports:
|securityIdentifier|String|Security identifier of the group, used in Windows scenarios. <br><br>Returned by default.| |theme|String|Specifies an Microsoft 365 group's color theme. Possible values are `Teal`, `Purple`, `Green`, `Blue`, `Pink`, `Orange` or `Red`. <br><br>Returned by default. | |unseenCount|Int32|Count of conversations that have received new posts since the signed-in user last visited the group. <br><br>Returned only on $select. |
-|visibility|String| Specifies the visibility of a Microsoft 365 group. Possible values are: `Private`, `Public`, or `Hiddenmembership`; blank values are treated as public. See [group visibility options](#group-visibility-options) to learn more.<br>Visibility can be set only when a group is created; it is not editable.<br>Visibility is supported only for unified groups; it is not supported for security groups. <br><br>Returned by default.|
+|visibility|String| Specifies the group join policy and group content visibility for groups. Possible values are: `Private`, `Public`, or `Hiddenmembership`. `Hiddenmembership` can be set only for Microsoft 365 groups, when the groups are created. It can't be updated later. Other values of visibility can be updated after group creation.<br> If visibility value is not specified during group creation on Microsoft Graph, a security group is created as `Private` by default and Microsoft 365 group is `Public`. See [group visibility options](#group-visibility-options) to learn more. <br><br>Returned by default.|
### Group visibility options
Here's what each **visibility** property value means:
| Relationship | Type |Description| |:|:--|:-| |acceptedSenders|[directoryObject](directoryobject.md) collection|The list of users or groups that are allowed to create post's or calendar events in this group. If this list is non-empty then only users or groups listed here are allowed to post.|
+|appRoleAssignments|[appRoleAssignment](approleassignment.md) collection|Represents the app roles a group has been granted for an application. |
|calendar|[calendar](calendar.md)|The group's calendar. Read-only.| |calendarView|[event](event.md) collection|The calendar view for the calendar. Read-only.| |conversations|[conversation](conversation.md) collection|The group's conversations.|
v1.0 Hashes https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/hashes.md
- Last updated 09/10/2017 localization_priority: Normal Title: "Hashes resource type"
v1.0 Identity https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/identity.md
- Last updated 09/10/2017 Title: Identity localization_priority: Normal
v1.0 Identityset https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/identityset.md
- Last updated 09/10/2017 Title: IdentitySet localization_priority: Normal
v1.0 Image https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/image.md
- Last updated 09/10/2017 Title: Image localization_priority: Normal
v1.0 Incompletedata https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/incompletedata.md
- Title: incompleteData resource type description: The incompleteData facet indicates that a resource was generated with incomplete data. localization_priority: Normal
v1.0 Intune Deviceconfig Iosupdateconfiguration https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/intune-deviceconfig-iosupdateconfiguration.md
Here is a JSON representation of the resource.
<!-- { "type": "#page.annotation", "suppressions": [
- "Warning: /api-reference/v1.0/resources/intune-deviceconfig-iosupdateconfiguration.md/microsoft.graph.iosUpdateConfiguration/scheduledInstallDays:
- Inconsistent types between parameter (String) and table (Object)"
], } -->
v1.0 Intune Mam Androidmanagedappregistration https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/intune-mam-androidmanagedappregistration.md
Inherits from [managedAppRegistration](../resources/intune-mam-managedappregistr
## Relationships |Relationship|Type|Description| |:|:|:|
-|appliedPolicies|[managedAppPolicy](../resources/intune-mam-managedapppolicy.md) collection|Zero or more policys already applied on the registered app when it last synchronized with managment service. Inherited from [managedAppRegistration](../resources/intune-mam-managedappregistration.md)|
+|appliedPolicies|[managedAppPolicy](../resources/intune-mam-managedapppolicy.md) collection|Zero or more policys already applied on the registered app when it last synchronized with management service. Inherited from [managedAppRegistration](../resources/intune-mam-managedappregistration.md)|
|intendedPolicies|[managedAppPolicy](../resources/intune-mam-managedapppolicy.md) collection|Zero or more policies admin intended for the app as of now. Inherited from [managedAppRegistration](../resources/intune-mam-managedappregistration.md)| |operations|[managedAppOperation](../resources/intune-mam-managedappoperation.md) collection|Zero or more long running operations triggered on the app registration. Inherited from [managedAppRegistration](../resources/intune-mam-managedappregistration.md)|
Here is a JSON representation of the resource.
<!-- { "type": "#page.annotation", "suppressions": [
- "Warning: /api-reference/v1.0/resources/intune-mam-androidmanagedappregistration.md/microsoft.graph.androidManagedAppRegistration/appIdentifier:
- Type mismatch between example and table. Parameter name: appIdentifier; example type: (microsoft.graph.androidMobileAppIdentifier); table type: (microsoft.graph.mobileAppIdentifier)",
- "Warning: /api-reference/v1.0/resources/intune-mam-androidmanagedappregistration.md/microsoft.graph.androidManagedAppRegistration/flaggedReasons:
-
- Inconsistent types between parameter (String) and table (Object)"
], } -->
v1.0 Intune Mam Iosmanagedappregistration https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/intune-mam-iosmanagedappregistration.md
Here is a JSON representation of the resource.
<!-- { "type": "#page.annotation", "suppressions": [
- "Warning: /api-reference/v1.0/resources/intune-mam-iosmanagedappregistration.md/microsoft.graph.iosManagedAppRegistration/flaggedReasons:
- Inconsistent types between parameter (String) and table (Object)"
], } -->
v1.0 Intune Mam Managedappregistration https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/intune-mam-managedappregistration.md
The ManagedAppRegistration resource represents the details of an app, with manag
## Relationships |Relationship|Type|Description| |:|:|:|
-|appliedPolicies|[managedAppPolicy](../resources/intune-mam-managedapppolicy.md) collection|Zero or more policys already applied on the registered app when it last synchronized with managment service.|
+|appliedPolicies|[managedAppPolicy](../resources/intune-mam-managedapppolicy.md) collection|Zero or more policys already applied on the registered app when it last synchronized with management service.|
|intendedPolicies|[managedAppPolicy](../resources/intune-mam-managedapppolicy.md) collection|Zero or more policies admin intended for the app as of now.| |operations|[managedAppOperation](../resources/intune-mam-managedappoperation.md) collection|Zero or more long running operations triggered on the app registration.|
Here is a JSON representation of the resource.
<!-- { "type": "#page.annotation", "suppressions": [
- "Warning: /api-reference/v1.0/resources/intune-mam-managedappregistration.md/microsoft.graph.managedAppRegistration/flaggedReasons:
- Inconsistent types between parameter (String) and table (Object)"
], } -->
v1.0 Itemactionset https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/itemactionset.md
- Title: ItemActionSet resource type description: The itemActionSet object provides information about the actions that took place as part of an activity on an item. localization_priority: Normal
v1.0 Itemactionstat https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/itemactionstat.md
- Title: itemActionStat resource type description: The itemActionStat object provides aggregate details about an action over a period of time. localization_priority: Normal
v1.0 Itemactivity https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/itemactivity.md
- Title: itemActivity resource type description: The itemActivity object provides information about an activity that took place on an item. localization_priority: Normal
v1.0 Itemactivitystat https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/itemactivitystat.md
- Title: itemActivityStat resource type description: The ItemActivityStat object provides information about activities that took place on an item. localization_priority: Normal
v1.0 Itemactivitytimeset https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/itemactivitytimeset.md
- Title: itemActivityTimeSet resource type description: The itemActionSet object provides information about an activity that took place on an item. localization_priority: Normal
v1.0 Itemanalytics https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/itemanalytics.md
- Title: itemAnalytics resource type description: The ItemAnalytics object provides analytics about activities that took place on an item. localization_priority: Normal
v1.0 Itempreviewinfo https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/itempreviewinfo.md
- Last updated 3/16/2018 Title: ItemPreviewInfo localization_priority: Normal
v1.0 List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/list.md
- Last updated 09/11/2017 Title: List localization_priority: Priority
v1.0 Listinfo https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/listinfo.md
- Last updated 09/11/2017 Title: ListInfo localization_priority: Normal
v1.0 Lookupcolumn https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/lookupcolumn.md
- Last updated 09/11/2017 Title: LookupColumn localization_priority: Normal
v1.0 Mentionaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/mentionaction.md
- Title: mentionAction resource type description: The MentionAction object provides information about who was mentioned during an activity. localization_priority: Normal
v1.0 Moveaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/moveaction.md
- Title: moveAction resource type description: The MoveAction object provides information about an activity that moved an item. localization_priority: Normal
v1.0 Numbercolumn https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/numbercolumn.md
- Last updated 09/11/2017 Title: NumberColumn localization_priority: Normal
v1.0 Organization https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/organization.md
Here is a JSON representation of the resource.
"keywords": "", "section": "documentation", "suppressions": [
- "Warning: /api-reference/v1.0/resources/organization.md:
- Property 'businessPhones' found in resource definition for 'microsoft.graph.organization', but not described in markdown table.",
- "Warning: /api-reference/v1.0/resources/organization.md:
- Property 'onPremisesLastSyncDateTime' found in resource definition for 'microsoft.graph.organization', but not described in markdown table.",
- "Warning: /api-reference/v1.0/resources/organization.md:
- Property 'onPremisesSyncEnabled' found in resource definition for 'microsoft.graph.organization', but not described in markdown table.",
- "Warning: /api-reference/v1.0/resources/organization.md:
- Property 'securityComplianceNotificationMails' found in resource definition for 'microsoft.graph.organization', but not described in markdown table.",
- "Warning: /api-reference/v1.0/resources/organization.md:
- Property 'securityComplianceNotificationPhones' found in resource definition for 'microsoft.graph.organization', but not described in markdown table."
], "tocPath": "" }-->
v1.0 Outlookcategory https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/outlookcategory.md
Here is a JSON representation of the resource.
"keywords": "", "section": "documentation", "suppressions": [
- "Warning: /api-reference/v1.0/resources/outlookcategory.md:
- Failed to parse any rows out of table with headers: |Pre-set constant|Color mapped to in Outlook|"
], "tocPath": "" }-->
v1.0 Package https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/package.md
- Last updated 09/10/2017 Title: Package localization_priority: Normal
v1.0 Permission https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/permission.md
- Last updated 09/10/2017 Title: Permission localization_priority: Priority
Permissions with an [**invitation**][SharingInvitation] facet represent permissi
### Roles property values
-| Role | Details |
+| Value | Description |
|:|:-| | read | Provides the ability to read the metadata and contents of the item. | | write | Provides the ability to read and modify the metadata and contents of the item. |
v1.0 Photo https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/photo.md
- Last updated 09/10/2017 Title: Photo localization_priority: Normal
v1.0 Quota https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/quota.md
- Last updated 09/10/2017 Title: Quota localization_priority: Normal
v1.0 Recurrencepattern https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/recurrencepattern.md
Use the **type** property to specify the different types of **recurrencePattern*
|dayOfMonth|Int32|The day of the month on which the event occurs. Required if **type** is `absoluteMonthly` or `absoluteYearly`. | |daysOfWeek|dayOfWeek collection|A collection of the days of the week on which the event occurs. The possible values are: `sunday`, `monday`, `tuesday`, `wednesday`, `thursday`, `friday`, `saturday`. <br>If **type** is `relativeMonthly` or `relativeYearly`, and **daysOfWeek** specifies more than one day, the event falls on the first day that satisfies the pattern. <br> Required if **type** is `weekly`, `relativeMonthly`, or `relativeYearly`.| |firstDayOfWeek|dayOfWeek|The first day of the week. The possible values are: `sunday`, `monday`, `tuesday`, `wednesday`, `thursday`, `friday`, `saturday`. Default is `sunday`. Required if **type** is `weekly`. |
-|index|weekIndex|Specifies on which instance of the allowed days specified in **daysOfsWeek** the event occurs, counted from the first instance in the month. The possible values are: `first`, `second`, `third`, `fourth`, `last`. Default is `first`. Optional and used if **type** is `relativeMonthly` or `relativeYearly`. |
+|index|weekIndex|Specifies on which instance of the allowed days specified in **daysOfWeek** the event occurs, counted from the first instance in the month. The possible values are: `first`, `second`, `third`, `fourth`, `last`. Default is `first`. Optional and used if **type** is `relativeMonthly` or `relativeYearly`. |
|interval|Int32|The number of units between occurrences, where units can be in days, weeks, months, or years, depending on the **type**. Required. | |month|Int32|The month in which the event occurs. This is a number from 1 to 12.| |type|recurrencePatternType|The recurrence pattern type: `daily`, `weekly`, `absoluteMonthly`, `relativeMonthly`, `absoluteYearly`, `relativeYearly`. Required.|
v1.0 Recurrencerange https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/recurrencerange.md
Here is a JSON representation of the resource
"keywords": "", "section": "documentation", "suppressions": [
- "Warning: /api-reference/v1.0/resources/recurrencerange.md:
- Failed to parse any rows out of table with headers: | type property | Type of recurrence range | Description | Example | Required properties |"
], "tocPath": "" }-->
v1.0 Remoteitem https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/remoteitem.md
- Last updated 09/10/2017 Title: RemoteItem localization_priority: Normal
v1.0 Renameaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/renameaction.md
- Title: renameAction resource type description: The renameAction object provides information about an activity that renamed an item. localization_priority: Normal
v1.0 Restoreaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/restoreaction.md
- Title: restoreAction resource type description: The RestoreAction object provides information about an activity that restored an item. localization_priority: Normal
v1.0 Root https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/root.md
- Last updated 09/10/2017 Title: Root localization_priority: Normal
v1.0 Searchresult https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/searchresult.md
- Last updated 09/10/2017 Title: SearchResult localization_priority: Normal
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
## Relationships | Relationship | Type |Description| |:|:--|:-|
-|appRoleAssignedTo|[appRoleAssignment](approleassignment.md)|Principals (users, groups, and service principals) that are assigned to this service principal. Read-only.|
-|appRoleAssignments|[appRoleAssignment](approleassignment.md) collection|Applications that this service principal is assigned to. Read-only. Nullable.|
+|appRoleAssignedTo|[appRoleAssignment](approleassignment.md)|App role assignments for this app or service, granted to users, groups, and other service principals.|
+|appRoleAssignments|[appRoleAssignment](approleassignment.md) collection|App role assignment for another app or service, granted to this service principal.|
|claimsMappingPolicies|[claimsMappingPolicy](claimsmappingpolicy.md) collection|The claimsMappingPolicies assigned to this service principal.| |createdObjects|[directoryObject](directoryobject.md) collection|Directory objects created by this service principal. Read-only. Nullable.| |homeRealmDiscoveryPolicies|[homeRealmDiscoveryPolicy](homerealmdiscoverypolicy.md) collection|The homeRealmDiscoveryPolicies assigned to this service principal.|
v1.0 Shareaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/shareaction.md
- Title: shareAction resource type description: The shareAction object provides information about who an item was shared to in a share action. localization_priority: Normal
v1.0 Shared https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/shared.md
- Last updated 09/10/2017 Title: Shared localization_priority: Normal
v1.0 Shareddriveitem https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/shareddriveitem.md
- Last updated 09/10/2017 Title: SharedDriveItem localization_priority: Normal
v1.0 Sharepointids https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/sharepointids.md
- Last updated 09/10/2017 Title: SharePointIds localization_priority: Normal
v1.0 Sharinginvitation https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/sharinginvitation.md
- Last updated 09/10/2017 Title: SharingInvitation localization_priority: Normal
v1.0 Sharinglink https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/sharinglink.md
- Last updated 09/10/2017 Title: SharingLink localization_priority: Normal
v1.0 Site https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/site.md
- Title: site resource description: The site resource provides metadata and relationships for a Sharepoint site. localization_priority: Priority
v1.0 Sitecollection https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/sitecollection.md
- Last updated 09/10/2017 Title: SiteCollection localization_priority: Normal
v1.0 Specialfolder https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/specialfolder.md
- Last updated 09/10/2017 Title: SpecialFolder localization_priority: Normal
v1.0 Systemfacet https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/systemFacet.md
- Last updated 09/12/2017 Title: SystemFacet localization_priority: Normal
v1.0 Textcolumn https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/textcolumn.md
- Last updated 09/11/2017 Title: TextColumn localization_priority: Normal
v1.0 Thumbnail https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/thumbnail.md
- Last updated 09/10/2017 Title: Thumbnail localization_priority: Normal
v1.0 Thumbnailset https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/thumbnailset.md
- Last updated 09/10/2017 Title: ThumbnailSet localization_priority: Normal
v1.0 Uploadsession https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/uploadsession.md
- Last updated 09/10/2017 Title: UploadSession localization_priority: Normal
v1.0 User https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/user.md
Hence the type of the corresponding 3 properties remain as string type in the Pr
| Relationship | Type |Description| |:|:--|:-| |activities|[userActivity](projectrome-activity.md) collection|The user's activities across devices. Read-only. Nullable.|
+|appRoleAssignments|[appRoleAssignment](approleassignment.md) collection|Represents the app roles a user has been granted for an application. |
|calendar|[calendar](calendar.md)|The user's primary calendar. Read-only.| |calendarGroups|[calendarGroup](calendargroup.md) collection|The user's calendar groups. Read-only. Nullable.| |calendarView|[event](event.md) collection|The calendar view for the calendar. Read-only. Nullable.|
Here is a JSON representation of the resource
"description": "user resource", "keywords": "", "suppressions" : [
- "Warning: /api-reference/v1.0/resources/user.md/microsoft.graph.user:
- Property 'createdDateTime' found in markdown table but not in resource definition."
], "section": "documentation", "tocPath": ""
v1.0 Useridentity https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/useridentity.md
Here is a JSON representation of the type.
"section": "documentation", "tocPath": "", "suppressions": [
- "Error: /api-reference/bet)\r\n at ApiDoctor.Validation.DocFile.get_LinkDestinations()\r\n at ApiDoctor.Validation.DocSet.ValidateLinks(Boolean includeWarnings, String[] relativePathForFiles, IssueLogger issues, Boolean requireFilenameCaseMatch, Boolean printOrphanedFiles)"
] } -->
v1.0 Versionaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/versionaction.md
- Title: versionAction resource type description: The VersionAction object provides information about an activity that resulted in a new item version. localization_priority: Normal
v1.0 Video https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/video.md
- Last updated 09/10/2017 Title: Video localization_priority: Normal