Updates from: 01/12/2021 04:06:44
Service Microsoft Docs article Related commit history on GitHub Change details
beta https://docs.microsoft.com/en-us/graph/api/authentication-list-methods https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authentication-list-methods.md
@@ -19,11 +19,21 @@ Retrieve a list of [authentication method](../resources/authenticationmethod.md)
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 acting on self (from least to most privileged) | Permissions acting on others (from least to most privileged)|
+### 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, UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite, UserAuthenticationMethod.ReadWrite.All | UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All |
-| Delegated (personal Microsoft account) | Not supported. | Not supported. |
-| Application | Not supported. | Not supported. |
+| 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
beta https://docs.microsoft.com/en-us/graph/api/authentication-list-passwordmethods https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authentication-list-passwordmethods.md
@@ -19,17 +19,27 @@ Retrieve a list of [password authentication method](../resources/passwordauthent
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 acting on self (from least to most privileged) | Permissions acting on others (from least to most privileged)|
+### 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, UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite, UserAuthenticationMethod.ReadWrite.All | UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All |
-| Delegated (personal Microsoft account) | Not supported. | Not supported. |
-| Application | Not supported. | Not supported. |
+| 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
+* Authentication admin (only sees masked phone numbers)
## HTTP request
beta https://docs.microsoft.com/en-us/graph/api/authentication-list-phonemethods https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authentication-list-phonemethods.md
@@ -21,9 +21,9 @@ One of the following permissions is required to call this API. To learn more, in
| Permission type | Permissions acting on self (from least to most privileged) | Permissions acting on others (from least to most privileged)| |:---------------------------------------|:-------------------------|:-----------------|
-| Delegated (work or school account) | UserAuthenticationMethod.Read, UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite, UserAuthenticationMethod.ReadWrite.All | UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All |
+| Delegated (work or school account) | UserAuthenticationMethod.Read, UserAuthenticationMethod.ReadWrite | UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All |
| Delegated (personal Microsoft account) | Not supported. | Not supported. |
-| Application | Not supported. | Not supported. |
+| Application | Not applicable. | 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):
beta https://docs.microsoft.com/en-us/graph/api/authentication-post-phonemethods https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authentication-post-phonemethods.md
@@ -25,9 +25,9 @@ One of the following permissions is required to call this API. To learn more, in
| Permission type | Permissions acting on self (from least to most privileged) | Permissions acting on others (from least to most privileged)| |:---------------------------------------|:-------------------------|:-----------------|
-| Delegated (work or school account) | Not supported. | UserAuthenticationMethod.ReadWrite.All |
+| Delegated (work or school account) | UserAuthenticationMethod.ReadWrite | UserAuthenticationMethod.ReadWrite.All |
| Delegated (personal Microsoft account) | Not supported. | Not supported. |
-| Application | Not supported. | Not supported. |
+| Application | Not applicable. | 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):
beta https://docs.microsoft.com/en-us/graph/api/authenticationmethod-get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authenticationmethod-get.md
@@ -21,9 +21,9 @@ One of the following permissions is required to call this API. To learn more, in
| Permission type | Permissions acting on self (from least to most privileged) | Permissions acting on others (from least to most privileged)| |:---------------------------------------|:-------------------------|:-----------------|
-| Delegated (work or school account) | UserAuthenticationMethod.Read, UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite, UserAuthenticationMethod.ReadWrite.All | UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All |
+| Delegated (work or school account) | UserAuthenticationMethod.Read, UserAuthenticationMethod.ReadWrite | UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All |
| Delegated (personal Microsoft account) | Not supported. | Not supported. |
-| Application | Not supported. | Not supported. |
+| Application | Not applicable. | 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):
beta https://docs.microsoft.com/en-us/graph/api/cloudcommunications-getpresencesbyuserid https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/cloudcommunications-getpresencesbyuserid.md
@@ -67,7 +67,7 @@ POST https://graph.microsoft.com/beta/communications/getPresencesByUserId
Content-Type: application/json {
- "ids": ["fa8bf3dc-eca7-46b7-bad1-db199b62afc3", "66825e03-7ef5-42da-9069-724602c31f6b"]
+ "ids": ["fa8bf3dc-eca7-46b7-bad1-db199b62afc3", "66825e03-7ef5-42da-9069-724602c31f6b"]
} ``` # [C#](#tab/csharp)
@@ -107,17 +107,25 @@ Content-Length: 1574
``` ```json {
- "value": [{
- "id": "fa8bf3dc-eca7-46b7-bad1-db199b62afc3",
- "availability": "Busy",
- "activity": "InAMeeting"
- },
- {
- "id": "66825e03-7ef5-42da-9069-724602c31f6b",
- "availability": "Away",
- "activity": "Away"
- }
- ]
+ "value": [{
+ "id": "fa8bf3dc-eca7-46b7-bad1-db199b62afc3",
+ "availability": "Busy",
+ "activity": "InAMeeting",
+ "outOfOfficeSettings": {
+ "message": null,
+ "isOutOfOffice": false
+ }
+ },
+ {
+ "id": "66825e03-7ef5-42da-9069-724602c31f6b",
+ "availability": "Away",
+ "activity": "Away",
+ "outOfOfficeSettings": {
+ "message": null,
+ "isOutOfOffice": true
+ }
+ }
+ ]
} ```
beta https://docs.microsoft.com/en-us/graph/api/emailauthenticationmethod-delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/emailauthenticationmethod-delete.md
@@ -19,9 +19,9 @@ One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions acting on self (from most to least privileged)|Permissions acting on others (from least to most privileged)| |:---|:---|:--|
-|Delegated (work or school account)|Not supported.|UserAuthenticationMethod.ReadWrite.All
-|Delegated (personal Microsoft account)|Not supported.|Not supported.
-|Application|Not supported.|Not supported.
+| Delegated (work or school account) | UserAuthenticationMethod.ReadWrite | UserAuthenticationMethod.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. | Not supported. |
+| Application | Not applicable. | 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):
beta https://docs.microsoft.com/en-us/graph/api/emailauthenticationmethod-get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/emailauthenticationmethod-get.md
@@ -19,9 +19,9 @@ One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions acting on self (from most to least privileged)|Permissions acting on others (from least to most privileged)| |:---|:---|:--|
-|Delegated (work or school account)|UserAuthenticationMethod.Read, UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite, UserAuthenticationMethod.ReadWrite.All|UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All
-|Delegated (personal Microsoft account)|Not supported.|Not supported.
-|Application|Not supported.|Not supported.
+| Delegated (work or school account) | UserAuthenticationMethod.Read, UserAuthenticationMethod.ReadWrite | UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. | Not supported. |
+| Application | Not applicable. | 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):
beta https://docs.microsoft.com/en-us/graph/api/emailauthenticationmethod-list https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/emailauthenticationmethod-list.md
@@ -19,9 +19,9 @@ One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions acting on self (from most to least privileged)|Permissions acting on others (from least to most privileged)| |:---|:---|:--|
-|Delegated (work or school account)|UserAuthenticationMethod.Read, UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite, UserAuthenticationMethod.ReadWrite.All|UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All
-|Delegated (personal Microsoft account)|Not supported.|Not supported.
-|Application|Not supported.|Not supported.
+| Delegated (work or school account) | UserAuthenticationMethod.Read, UserAuthenticationMethod.ReadWrite | UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. | Not supported. |
+| Application | Not applicable. | 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):
beta https://docs.microsoft.com/en-us/graph/api/emailauthenticationmethod-post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/emailauthenticationmethod-post.md
@@ -19,9 +19,9 @@ One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions acting on self (from most to least privileged)|Permissions acting on others (from least to most privileged)| |:---|:---|:--|
-|Delegated (work or school account)|Not supported.|UserAuthenticationMethod.ReadWrite.All
-|Delegated (personal Microsoft account)|Not supported.|Not supported.
-|Application|Not supported.|Not supported.
+| Delegated (work or school account) | UserAuthenticationMethod.ReadWrite | UserAuthenticationMethod.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. | Not supported. |
+| Application | Not applicable. | 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):
beta https://docs.microsoft.com/en-us/graph/api/emailauthenticationmethod-update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/emailauthenticationmethod-update.md
@@ -19,9 +19,9 @@ One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions acting on self (from most to least privileged)|Permissions acting on others (from least to most privileged)| |:---|:---|:--|
-|Delegated (work or school account)|Not supported.|UserAuthenticationMethod.ReadWrite.All
-|Delegated (personal Microsoft account)|Not supported.|Not supported.
-|Application|Not supported.|Not supported.
+| Delegated (work or school account) | UserAuthenticationMethod.ReadWrite | UserAuthenticationMethod.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. | Not supported. |
+| Application | Not applicable. | 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):
beta https://docs.microsoft.com/en-us/graph/api/fido2authenticationmethod-delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/fido2authenticationmethod-delete.md
@@ -19,9 +19,9 @@ One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions acting on self (from most to least privileged)|Permissions acting on others (from least to most privileged)| |:---|:---|:--|
-|Delegated (work or school account)|Not supported.|UserAuthenticationMethod.ReadWrite.All
-|Delegated (personal Microsoft account)|Not supported.|Not supported.
-|Application|Not supported.|Not supported.
+| Delegated (work or school account) | UserAuthenticationMethod.ReadWrite | UserAuthenticationMethod.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. | Not supported. |
+| Application | Not applicable. | 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):
beta https://docs.microsoft.com/en-us/graph/api/fido2authenticationmethod-get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/fido2authenticationmethod-get.md
@@ -19,9 +19,9 @@ One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions acting on self (from most to least privileged)|Permissions acting on others (from least to most privileged)| |:---|:---|:--|
-|Delegated (work or school account)|UserAuthenticationMethod.Read, UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite, UserAuthenticationMethod.ReadWrite.All|UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All
-|Delegated (personal Microsoft account)|Not supported.|Not supported.
-|Application|Not supported.|Not supported.
+| Delegated (work or school account) | UserAuthenticationMethod.Read, UserAuthenticationMethod.ReadWrite | UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. | Not supported. |
+| Application | Not applicable. | 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):
beta https://docs.microsoft.com/en-us/graph/api/fido2authenticationmethod-list https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/fido2authenticationmethod-list.md
@@ -19,9 +19,9 @@ One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions acting on self (from most to least privileged)|Permissions acting on others (from least to most privileged)| |:---|:---|:--|
-|Delegated (work or school account)|UserAuthenticationMethod.Read, UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite, UserAuthenticationMethod.ReadWrite.All|UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All
-|Delegated (personal Microsoft account)|Not supported.|Not supported.
-|Application|Not supported.|Not supported.
+| Delegated (work or school account) | UserAuthenticationMethod.Read, UserAuthenticationMethod.ReadWrite | UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. | Not supported. |
+| Application | Not applicable. | 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):
beta https://docs.microsoft.com/en-us/graph/api/microsoftauthenticatorauthenticationmethod-delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/microsoftauthenticatorauthenticationmethod-delete.md new file mode 100644
@@ -0,0 +1,86 @@
+---
+title: "Delete microsoftAuthenticatorAuthenticationMethod"
+description: "Deletes a microsoftAuthenticatorAuthenticationMethod object."
+author: "mmcla"
+localization_priority: Normal
+ms.prod: "microsoft-identity-platform"
+doc_type: apiPageType
+---
+
+# Delete microsoftAuthenticatorAuthenticationMethod
+Namespace: microsoft.graph
+
+Deletes a [microsoftAuthenticatorAuthenticationMethod](../resources/microsoftauthenticatorauthenticationmethod.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.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 /me/authentication/microsoftAuthenticatorMethods/{microsoftAuthenticatorAuthenticationMethodId}
+DELETE /user/{id | userPrincipalName}/authentication/microsoftAuthenticatorMethods/{microsoftAuthenticatorAuthenticationMethodId}
+```
+
+## 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_microsoftauthenticatorauthenticationmethod"
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/beta/user/kim@contoso.com/authentication/microsoftAuthenticatorMethods/_jpuR-TGZtk6aQCLF3BQjA2
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
beta https://docs.microsoft.com/en-us/graph/api/microsoftauthenticatorauthenticationmethod-get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/microsoftauthenticatorauthenticationmethod-get.md new file mode 100644
@@ -0,0 +1,102 @@
+---
+title: "Get microsoftAuthenticatorAuthenticationMethod"
+description: "Read the properties and relationships of a microsoftAuthenticatorAuthenticationMethod object."
+author: "mmcla"
+localization_priority: Normal
+ms.prod: "microsoft-identity-platform"
+doc_type: apiPageType
+---
+
+# Get microsoftAuthenticatorAuthenticationMethod
+Namespace: microsoft.graph
+
+Read the properties and relationships of a [microsoftAuthenticatorAuthenticationMethod](../resources/microsoftauthenticatorauthenticationmethod.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 (only sees masked phone numbers)
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /me/authentication/microsoftAuthenticatorMethods/{microsoftAuthenticatorAuthenticationMethodId}
+GET /user/{id | userPrincipalName}/authentication/microsoftAuthenticatorMethods/{microsoftAuthenticatorAuthenticationMethodId}
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:---|:---|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [microsoftAuthenticatorAuthenticationMethod](../resources/microsoftauthenticatorauthenticationmethod.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_microsoftauthenticatorauthenticationmethod"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/user/anirban@contoso.com/authentication/microsoftAuthenticatorMethods/_jpuR-TGZtk6aQCLF3BQjA2
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.microsoftAuthenticatorAuthenticationMethod"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": {
+ "@odata.type": "#microsoft.graph.microsoftAuthenticatorAuthenticationMethod",
+ "id": "6803c096-c096-6803-96c0-036896c00368",
+ "displayName": "Sandeep's iPhone",
+ "deviceTag": "",
+ "phoneAppVersion": "6.5.4",
+ "createdDateTime": "2020-12-03T23:16:12Z"
+ }
+}
+```
beta https://docs.microsoft.com/en-us/graph/api/microsoftauthenticatorauthenticationmethod-list https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/microsoftauthenticatorauthenticationmethod-list.md new file mode 100644
@@ -0,0 +1,108 @@
+---
+title: "List microsoftAuthenticatorAuthenticationMethods"
+description: "Get a list of the microsoftAuthenticatorAuthenticationMethod objects and their properties."
+author: "mmcla"
+localization_priority: Normal
+ms.prod: "microsoft-identity-platform"
+doc_type: apiPageType
+---
+
+# List microsoftAuthenticatorAuthenticationMethods
+Namespace: microsoft.graph
+
+Get a list of the [microsoftAuthenticatorAuthenticationMethod](../resources/microsoftauthenticatorauthenticationmethod.md) objects and their properties.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+### 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 (only sees masked phone numbers)
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /me/authentication/microsoftAuthenticatorMethods
+GET /user/{id | userPrincipalName}/authentication/microsoftAuthenticatorMethods
+```
+
+## Optional query parameters
+
+Not supported.
+
+## 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 [microsoftAuthenticatorAuthenticationMethod](../resources/microsoftauthenticatorauthenticationmethod.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_microsoftauthenticatorauthenticationmethod"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/user/anirban@contoso.com/authentication/microsoftAuthenticatorMethods
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.microsoftAuthenticatorAuthenticationMethod)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.microsoftAuthenticatorAuthenticationMethod",
+ "id": "6803c096-c096-6803-96c0-036896c00368",
+ "displayName": "Sandeep's iPhone",
+ "deviceTag": "",
+ "phoneAppVersion": "6.5.4",
+ "createdDateTime": "2020-12-03T23:16:12Z"
+ }
+ ]
+}
+```
+
beta https://docs.microsoft.com/en-us/graph/api/passwordauthenticationmethod-get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/passwordauthenticationmethod-get.md
@@ -19,18 +19,27 @@ Retrieve the properties and relationships of a [password authentication method](
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 acting on self (from least to most privileged) | Permissions acting on others (from least to most privileged)|
+### 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, UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite, UserAuthenticationMethod.ReadWrite.All | UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All |
-| Delegated (personal Microsoft account) | Not supported. | Not supported. |
-| Application | Not supported. | Not supported. |
+| 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
+* Authentication admin (only sees masked phone numbers)
## HTTP request
beta https://docs.microsoft.com/en-us/graph/api/passwordlessmicrosoftauthenticatorauthenticationmethod-delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/passwordlessmicrosoftauthenticatorauthenticationmethod-delete.md
@@ -7,28 +7,37 @@ ms.prod: "microsoft-identity-platform"
doc_type: "apiPageType" ---
-# Delete passwordlessMicrosoftAuthenticatorAuthenticationMethod
+# Delete passwordlessMicrosoftAuthenticatorAuthenticationMethod (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Deletes a user's [Microsoft Authenticator Passwordless Phone Sign-in method](../resources/passwordlessmicrosoftauthenticatorauthenticationmethod.md) object.
-> [!NOTE]
-> Substantial schema changes are planned for APIs that manage the Microsoft Authenticator app while the APIs are in Mirosoft Graph beta. Because the calling patterns will change, we recommend that you do not take a production dependency on these APIs.
-
+> [!CAUTION]
+> The Microsoft Authenticator Passwordless Phone Sign-in method API is deprecated and will stop returning results on December 31, 2020. Please use the new [Microsoft Authenticator Authentication Method](../resources/microsoftAuthenticatorAuthenticationMethod.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 acting on self (from most to least privileged)|Permissions acting on others (from least to most privileged)|
-|:---|:---|:--|
-|Delegated (work or school account)|Not supported.|UserAuthenticationMethod.ReadWrite.All
-|Delegated (personal Microsoft account)|Not supported.|Not supported.
-|Application|Not supported.|Not supported.
+### 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
-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):
+|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
beta https://docs.microsoft.com/en-us/graph/api/passwordlessmicrosoftauthenticatorauthenticationmethod-get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/passwordlessmicrosoftauthenticatorauthenticationmethod-get.md
@@ -7,31 +7,41 @@ ms.prod: "microsoft-identity-platform"
doc_type: "apiPageType" ---
-# Get passwordlessMicrosoftAuthenticatorAuthenticationMethod
+# Get passwordlessMicrosoftAuthenticatorAuthenticationMethod (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Retrieve a user's single [Microsoft Authenticator Passwordless Phone Sign-in method](../resources/passwordlessmicrosoftauthenticatorauthenticationmethod.md) object.
-> [!NOTE]
-> Substantial schema changes are planned for APIs that manage the Microsoft Authenticator app while the APIs are in Mirosoft Graph beta. Because the calling patterns will change, we recommend that you do not take a production dependency on these APIs.
+> [!CAUTION]
+> The Microsoft Authenticator Passwordless Phone Sign-in method API is deprecated and will stop returning results on December 31, 2020. Please use the new [Microsoft Authenticator Authentication Method](../resources/microsoftAuthenticatorAuthenticationMethod.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 acting on self (from most to least privileged)|Permissions acting on others (from least to most privileged)|
-|:---|:---|:--|
-|Delegated (work or school account)|UserAuthenticationMethod.Read, UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite, UserAuthenticationMethod.ReadWrite.All|UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All
-|Delegated (personal Microsoft account)|Not supported.|Not supported.
-|Application|Not supported.|Not supported.
+### 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
-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):
+|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
+* Authentication admin (only sees masked phone numbers)
## HTTP request
beta https://docs.microsoft.com/en-us/graph/api/passwordlessmicrosoftauthenticatorauthenticationmethod-list https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/passwordlessmicrosoftauthenticatorauthenticationmethod-list.md
@@ -7,31 +7,41 @@ ms.prod: "microsoft-identity-platform"
doc_type: "apiPageType" ---
-# List passwordlessMicrosoftAuthenticatorAuthenticationMethods
+# List passwordlessMicrosoftAuthenticatorAuthenticationMethods (deprecated)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Retrieve a list of a user's [Microsoft Authenticator Passwordless Phone Sign-in method](../resources/passwordlessmicrosoftauthenticatorauthenticationmethod.md) objects and their properties.
-> [!NOTE]
-> Substantial schema changes are planned for APIs that manage the Microsoft Authenticator app while the APIs are in Mirosoft Graph beta. Because the calling patterns will change, we recommend that you do not take a production dependency on these APIs.
+> [!CAUTION]
+> The Microsoft Authenticator Passwordless Phone Sign-in method API is deprecated and will stop returning results on December 31, 2020. Please use the new [Microsoft Authenticator Authentication Method](../resources/microsoftAuthenticatorAuthenticationMethod.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 acting on self (from most to least privileged)|Permissions acting on others (from least to most privileged)|
-|:---|:---|:--|
-|Delegated (work or school account)|UserAuthenticationMethod.Read, UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite, UserAuthenticationMethod.ReadWrite.All|UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All
-|Delegated (personal Microsoft account)|Not supported.|Not supported.
-|Application|Not supported.|Not supported.
+### 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
-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):
+|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
+* Authentication admin (only sees masked phone numbers)
## HTTP request
beta https://docs.microsoft.com/en-us/graph/api/phoneauthenticationmethod-delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/phoneauthenticationmethod-delete.md
@@ -25,14 +25,23 @@ If the phone number is the user's default Azure multi-factor authentication (MFA
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 acting on self (from least to most privileged) | Permissions acting on others (from least to most privileged)|
+### 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) | Not supported. | UserAuthenticationMethod.ReadWrite.All |
-| Delegated (personal Microsoft account) | Not supported. | Not supported. |
-| Application | Not supported. | Not supported. |
+| 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
beta https://docs.microsoft.com/en-us/graph/api/phoneauthenticationmethod-disablesmssignin https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/phoneauthenticationmethod-disablesmssignin.md
@@ -21,14 +21,23 @@ Disable SMS sign-in for an existing `mobile` phone number.
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 acting on self (from least to most privileged) | Permissions acting on others (from least to most privileged)|
+### 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, UserAuthenticationMethod.ReadWrite.All | UserAuthenticationMethod.ReadWrite.All |
-| Delegated (personal Microsoft account) | Not supported. | Not supported. |
-| Application | Not supported. | Not supported. |
+| 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
beta https://docs.microsoft.com/en-us/graph/api/phoneauthenticationmethod-enablesmssignin https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/phoneauthenticationmethod-enablesmssignin.md
@@ -23,14 +23,23 @@ Enable SMS sign-in for an existing `mobile` phone number. To be successfully ena
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 acting on self (from least to most privileged) | Permissions acting on others (from least to most privileged)|
+### 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, UserAuthenticationMethod.ReadWrite.All | UserAuthenticationMethod.ReadWrite.All |
-| Delegated (personal Microsoft account) | Not supported. | Not supported. |
-| Application | Not supported. | Not supported. |
+| 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
beta https://docs.microsoft.com/en-us/graph/api/phoneauthenticationmethod-get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/phoneauthenticationmethod-get.md
@@ -19,14 +19,23 @@ Retrieve a single [phoneAuthenticationMethod](../resources/phoneauthenticationme
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 acting on self (from least to most privileged) | Permissions acting on others (from least to most privileged)|
+### 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, UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite, UserAuthenticationMethod.ReadWrite.All | UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All |
-| Delegated (personal Microsoft account) | Not supported. | Not supported. |
-| Application | Not supported. | Not supported. |
+| 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
beta https://docs.microsoft.com/en-us/graph/api/phoneauthenticationmethod-update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/phoneauthenticationmethod-update.md
@@ -23,14 +23,23 @@ If a user is enabled by policy to use SMS to sign in and the `mobile` number is
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 acting on self (from least to most privileged) | Permissions acting on others (from least to most privileged)|
+### 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) | Not supported. | UserAuthenticationMethod.ReadWrite.All |
-| Delegated (personal Microsoft account) | Not supported. | Not supported. |
-| Application | Not supported. | Not supported. |
+| 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
beta https://docs.microsoft.com/en-us/graph/api/presence-get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/presence-get.md
@@ -96,9 +96,13 @@ Content-Type: application/json
Content-Length: 1574 {
- "id": "fa8bf3dc-eca7-46b7-bad1-db199b62afc3",
- "availability": "Available",
- "activity": "Available"
+ "id": "fa8bf3dc-eca7-46b7-bad1-db199b62afc3",
+ "availability": "Available",
+ "activity": "Available",
+ "outOfOfficeSettings": {
+ "message": null,
+ "isOutOfOffice": false
+ }
} ```
@@ -150,9 +154,13 @@ Content-Type: application/json
Content-Length: 1574 {
- "id": "66825e03-7ef5-42da-9069-724602c31f6b",
- "availability": "DoNotDisturb",
- "activity": "Presenting"
+ "id": "66825e03-7ef5-42da-9069-724602c31f6b",
+ "availability": "DoNotDisturb",
+ "activity": "Presenting",
+ "outOfOfficeSettings": {
+ "message": null,
+ "isOutOfOffice": false
+ }
} ```
@@ -204,13 +212,13 @@ GET https://graph.microsoft.com/beta/communications/presences/dc74d9bb-6afe-433d
HTTP/1.1 200 OK {
- "value": [
- {
- "id": "dc74d9bb-6afe-433d-8eaa-e39d80d3a647",
- "availability": "Away",
- "activity": "BeRightBack"
- }
- ]
+ "id": "dc74d9bb-6afe-433d-8eaa-e39d80d3a647",
+ "availability": "Away",
+ "activity": "BeRightBack",
+ "outOfOfficeSettings": {
+ "message": null,
+ "isOutOfOffice": false
+ }
} ```
beta https://docs.microsoft.com/en-us/graph/api/todo-post-lists https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/todo-post-lists.md
@@ -10,6 +10,8 @@ doc_type: apiPageType
# Create todoTaskList Namespace: microsoft.graph
+[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
+ Create a new lists object. ## Permissions
beta https://docs.microsoft.com/en-us/graph/api/windowshelloforbusinessauthenticationmethod-delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowshelloforbusinessauthenticationmethod-delete.md new file mode 100644
@@ -0,0 +1,86 @@
+---
+title: "Delete windowsHelloForBusinessAuthenticationMethod"
+description: "Deletes a windowsHelloForBusinessAuthenticationMethod object."
+author: "mmcla"
+localization_priority: Normal
+ms.prod: "microsoft-identity-platform"
+doc_type: apiPageType
+---
+
+# Delete windowsHelloForBusinessAuthenticationMethod
+Namespace: microsoft.graph
+
+Deletes a [windowsHelloForBusinessAuthenticationMethod](../resources/windowshelloforbusinessauthenticationmethod.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.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 /me/authentication/windowsHelloForBusinessMethods/{windowsHelloForBusinessAuthenticationMethodId}
+DELETE /user/{id | userPrincipalName}/authentication/windowsHelloForBusinessMethods/{windowsHelloForBusinessAuthenticationMethodId}
+```
+
+## 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_windowshelloforbusinessauthenticationmethod"
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/beta/user/kim@contoso.com/authentication/windowsHelloForBusinessMethods/_jpuR-TGZtk6aQCLF3BQjA2
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
beta https://docs.microsoft.com/en-us/graph/api/windowshelloforbusinessauthenticationmethod-get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowshelloforbusinessauthenticationmethod-get.md new file mode 100644
@@ -0,0 +1,102 @@
+---
+title: "Get windowsHelloForBusinessAuthenticationMethod"
+description: "Read the properties and relationships of a windowsHelloForBusinessAuthenticationMethod object."
+author: "mmcla"
+localization_priority: Normal
+ms.prod: "microsoft-identity-platform"
+doc_type: apiPageType
+---
+
+# Get windowsHelloForBusinessAuthenticationMethod
+Namespace: microsoft.graph
+
+Read the properties and relationships of a [windowsHelloForBusinessAuthenticationMethod](../resources/windowshelloforbusinessauthenticationmethod.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 (only sees masked phone numbers)
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /me/authentication/windowsHelloForBusinessMethods/{windowsHelloForBusinessAuthenticationMethodId}
+GET /user/{id | userPrincipalName}/authentication/windowsHelloForBusinessMethods/{windowsHelloForBusinessAuthenticationMethodId}
+```
+
+## Optional query parameters
+
+Not supported.
+
+## 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 [windowsHelloForBusinessAuthenticationMethod](../resources/windowshelloforbusinessauthenticationmethod.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "get_windowshelloforbusinessauthenticationmethod"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/user/annie@contoso.com/authentication/windowsHelloForBusinessMethods/_jpuR-TGZtk6aQCLF3BQjA2
+```
+
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.windowsHelloForBusinessAuthenticationMethod"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": {
+ "@odata.type": "#microsoft.graph.windowsHelloForBusinessAuthenticationMethod",
+ "id": "b5e01f81-1f81-b5e0-811f-e0b5811fe0b5",
+ "displayName": "Jordan's Surface Book",
+ "createdDateTime": "2020-11-27T23:12:49Z",
+ "keyStrength": "normal"
+ }
+}
+```
+
beta https://docs.microsoft.com/en-us/graph/api/windowshelloforbusinessauthenticationmethod-list https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowshelloforbusinessauthenticationmethod-list.md new file mode 100644
@@ -0,0 +1,112 @@
+---
+title: "List windowsHelloForBusinessAuthenticationMethods"
+description: "Get a list of the windowsHelloForBusinessAuthenticationMethod objects and their properties."
+author: "mmcla"
+localization_priority: Normal
+ms.prod: "microsoft-identity-platform"
+doc_type: apiPageType
+---
+
+# List windowsHelloForBusinessAuthenticationMethods
+Namespace: microsoft.graph
+
+Get a list of the [windowsHelloForBusinessAuthenticationMethod](../resources/windowshelloforbusinessauthenticationmethod.md) objects and their properties.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+### 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 (only sees masked phone numbers)
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /me/authentication/windowsHelloForBusinessMethods
+GET /user/{id | userPrincipalName}/authentication/windowsHelloForBusinessMethods
+```
+
+## Optional query parameters
+
+Not supported.
+
+## 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 [windowsHelloForBusinessAuthenticationMethod](../resources/windowshelloforbusinessauthenticationmethod.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_windowshelloforbusinessauthenticationmethod"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/user/annie@contoso.com/authentication/windowsHelloForBusinessMethods
+```
++
+### Response
+**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.windowsHelloForBusinessAuthenticationMethod)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.windowsHelloForBusinessAuthenticationMethod",
+ "id": "b5e01f81-1f81-b5e0-811f-e0b5811fe0b5",
+ "displayName": "Jordan's Surface Book",
+ "createdDateTime": "2020-11-27T23:12:49Z",
+ "keyStrength": "normal"
+ },
+ {
+ "@odata.type": "#microsoft.graph.windowsHelloForBusinessAuthenticationMethod",
+ "id": "e6dab818-e68d-433e-89d5-547357870cb2",
+ "displayName": "New Surface Duo",
+ "createdDateTime": "2020-12-25T02:20:13Z",
+ "keyStrength": "normal"
+ }
+ ]
+}
+```
+
beta https://docs.microsoft.com/en-us/graph/resources/authenticationmethods-overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/authenticationmethods-overview.md
@@ -22,7 +22,7 @@ The authentication method APIs are used to manage a user's authentication method
* You can enable or disable the number for SMS sign-in. * You can reset a user's password. * You can retrieve details of a user's FIDO2 Security Key, and delete it if the user has lost the key.
-* You can retrieve details of a user's Microsoft Authenticator Passwordless Phone Sign-in registration, and delete it if the user has lost the phone.
+* You can retrieve details of a user's Microsoft Authenticator registration, and delete it if the user has lost the phone.
* You can add an email address to a user. The user can then use that email as part of the Self-Service Password Reset (SSPR) process. * You can update that email, or delete it from the user.
@@ -32,9 +32,10 @@ The authentication method APIs are used to manage a user's authentication method
|:---------------------------|:------------|:------------| |[passwordAuthenticationMethod](passwordauthenticationmethod.md)| A password is currently the default primary authentication method in Azure AD.|Reset a user's password| |[phoneAuthenticationMethod](phoneauthenticationmethod.md)|A phone can be used by a user to authenticate using [SMS or voice calls](/azure/active-directory/authentication/concept-authentication-methods#phone-options) (as allowed by policy).|See a user's authentication phone numbers. Add, update, or remove a phone number to a user. Enable or disable a primary mobile phone for SMS sign-in.|
-|[fido2authenticationmethod](fido2authenticationmethod.md)|A FIDO2 Security Key can be used by a user to sign in to Azure AD.|Delete a lost FIDO2 Security Key.|
-|[passwordlessmicrosoftauthenticatorauthenticationmethod](passwordlessmicrosoftauthenticatorauthenticationmethod.md)|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.|
+|[fido2AuthenticationMethod](fido2authenticationmethod.md)|A FIDO2 Security Key can be used by a user to sign in to Azure AD.|Delete a lost FIDO2 Security Key.|
+|[microsoftAuthenticatorAuthenticationMethod](microsoftauthenticatorauthenticationmethod.md)|Microsoft Authenticator can be used by a user to sign in or perform multi-factor authentication to Azure AD|Delete a Microsoft Authenticator 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.|
## Next steps
beta https://docs.microsoft.com/en-us/graph/resources/channelmoderationsettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/channelmoderationsettings.md
@@ -19,7 +19,7 @@ In Microsoft Teams, team owners can turn on moderation for a channel to control
- Use a channel for discussions in a class team where only the teacher can start new discussions. - Use a channel for livesite issues where new posts can be started by connectors.
-By default, moderation is `OFF`, which means that the usual channel settings apply to team owners and team members, with additional control to allow only team members or everyone including guests to start a new channel post. Setting channel moderation to `ON` allows only moderators to start new posts, with additonal control for team members.
+By default, moderation is `OFF`, which means that the usual channel settings apply to team owners and team members, with additional control to allow only team members or everyone including guests to start a new channel post. Setting channel moderation to `ON` allows only moderators to start new posts, with additional control for team members.
To support channel moderation settings via Microsoft Graph APIs:
@@ -53,4 +53,4 @@ The following is a JSON representation of the resource.
## See also -- To modify moderation settings of a channel, see example 2 in [Update channel](../api/channel-patch.md).\ No newline at end of file
+- To modify moderation settings of a channel, see example 2 in [Update channel](../api/channel-patch.md).
beta https://docs.microsoft.com/en-us/graph/resources/enums https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/enums.md
@@ -11,7 +11,15 @@ author: "MSGraphDocsvTeam"
Namespace: microsoft.graph
-### educationAddedStudentAction values
+### authenticationMethodKeyStrength values
+
+|Member|
+|:---|
+|normal|
+|weak|
+|unknown|
+
+### educationAddedStudentAction values
|Member| |:---|
beta https://docs.microsoft.com/en-us/graph/resources/microsoftauthenticatorauthenticationmethod https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/microsoftauthenticatorauthenticationmethod.md new file mode 100644
@@ -0,0 +1,58 @@
+---
+title: "microsoftAuthenticatorAuthenticationMethod resource type"
+description: "A representation of the Microsoft Authenticator app registered to a user. Microsoft Authenticator is an authentication method."
+author: "mmcla"
+localization_priority: Normal
+ms.prod: "microsoft-identity-platform"
+doc_type: resourcePageType
+---
+
+# microsoftAuthenticatorAuthenticationMethod resource type
+
+Namespace: microsoft.graph
+
+A representation of the Microsoft Authenticator app registered to a user. Microsoft Authenticator is an authentication method.
+
+Inherits from [authenticationMethod](../resources/authenticationmethod.md).
+
+## Methods
+|Method|Return type|Description|
+|:---|:---|:---|
+|[List microsoftAuthenticatorAuthenticationMethods](../api/microsoftauthenticatorauthenticationmethod-list.md)|[microsoftAuthenticatorAuthenticationMethod](../resources/microsoftauthenticatorauthenticationmethod.md) collection|Get a list of the [microsoftAuthenticatorAuthenticationMethod](../resources/microsoftauthenticatorauthenticationmethod.md) objects and their properties.|
+|[Get microsoftAuthenticatorAuthenticationMethod](../api/microsoftauthenticatorauthenticationmethod-get.md)|[microsoftAuthenticatorAuthenticationMethod](../resources/microsoftauthenticatorauthenticationmethod.md)|Read the properties and relationships of a [microsoftAuthenticatorAuthenticationMethod](../resources/microsoftauthenticatorauthenticationmethod.md) object.|
+|[Delete microsoftAuthenticatorAuthenticationMethod](../api/microsoftauthenticatorauthenticationmethod-delete.md)|None|Deletes a [microsoftAuthenticatorAuthenticationMethod](../resources/microsoftauthenticatorauthenticationmethod.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:---|:---|:---|
+|createdDateTime|DateTimeOffset|The date and time that this app was registered. This property is null if the device is not registered for passwordless Phone Sign-In.|
+|displayName|String|The name of the device on which this app is registered.|
+|id|String|A unique identifier for this authentication method. Inherited from [authenticationMethod](../resources/authenticationmethod.md)|
+|deviceTag|String|Tags containing app metadata.|
+|phoneAppVersion|String|Numerical version of this instance of the Authenticator app.|
+
+## Relationships
+|Relationship|Type|Description|
+|:---|:---|:---|
+|device|[device](../resources/device.md)|The registered device on which Microsoft Authenticator resides. This property is null if the device is not registered for passwordless Phone Sign-In.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.microsoftAuthenticatorAuthenticationMethod",
+ "baseType": "microsoft.graph.authenticationMethod",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.microsoftAuthenticatorAuthenticationMethod",
+ "id": "String (Identifier)",
+ "displayName": "String",
+ "deviceTag": "String",
+ "phoneAppVersion": "String",
+ "createdDateTime": "DateTimeOffset"
+}
+```
beta https://docs.microsoft.com/en-us/graph/resources/outofofficesettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/outofofficesettings.md new file mode 100644
@@ -0,0 +1,40 @@
+---
+title: "outOfOfficeSettings resource type"
+description: "Represents phone access information for an online meeting."
+author: "elvinyang-msft"
+localization_priority: Normal
+ms.prod: "cloud-communications"
+doc_type: resourcePageType
+---
+
+# outOfOfficeSettings resource type
+
+Namespace: microsoft.graph
+
+[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
+
+Represents the out of office settings related to the [presence](presence.md) of a user.
+
+## Properties
+
+| Property | Type | Description |
+|:--------------------|:--------|:-------------------------------------------------------------------------------|
+| message | String | The out of office message that the user configured on Outlook client (Automatic Replies (Out of Office)) or the Teams client (Schedule out of office). |
+| isOutOfOffice | Boolean | True if either:</br><ul><li>It is currently in the out of office time window configured on the Outlook or Teams client.</li><li>There is currently an event on the user's calendar that's marked as Show as Out of Office</li></ul></br>Otherwise, false. |
+
+## JSON representation
+
+The following is a JSON representation of the resource.
+
+<!-- {
+ "blockType": "resource",
+ "optionalProperties": [
+ ],
+ "@odata.type": "microsoft.graph.outOfOfficeSettings"
+}-->
+```json
+{
+ "message": "String",
+ "isOutOfOffice": "Boolean"
+}
+```
beta https://docs.microsoft.com/en-us/graph/resources/passwordlessmicrosoftauthenticatorauthenticationmethod https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/passwordlessmicrosoftauthenticatorauthenticationmethod.md
@@ -7,7 +7,7 @@ ms.prod: "microsoft-identity-platform"
doc_type: "apiPageType" ---
-# passwordlessMicrosoftAuthenticatorAuthenticationMethod resource type
+# passwordlessMicrosoftAuthenticatorAuthenticationMethod resource type (deprecated)
Namespace: microsoft.graph
@@ -15,16 +15,16 @@ Namespace: microsoft.graph
A representation of a Microsoft Authenticator Passwordless Phone Sign-in method registered to a user.
-> [!NOTE]
-> Substantial schema changes are planned for APIs that manage the Microsoft Authenticator app while the APIs are in Mirosoft Graph beta. Because the calling patterns will change, we recommend that you do not take a production dependency on these APIs.
+> [!CAUTION]
+> The Microsoft Authenticator Passwordless Phone Sign-in method API is deprecated and will stop returning results on December 31, 2020. Please use the new [Microsoft Authenticator Authentication Method](../resources/microsoftAuthenticatorAuthenticationMethod.md).
## Methods |Method|Return type|Description| |:---|:---|:---|
-|[List](../api/passwordlessmicrosoftauthenticatorauthenticationmethod-list.md)|[passwordlessMicrosoftAuthenticatorAuthenticationMethod](../resources/passwordlessmicrosoftauthenticatorauthenticationmethod.md) collection|Retrieve a list of a user's passwordlessMicrosoftAuthenticatorAuthenticationMethod objects and their properties.|
-|[Get](../api/passwordlessmicrosoftauthenticatorauthenticationmethod-get.md)|[passwordlessMicrosoftAuthenticatorAuthenticationMethod](../resources/passwordlessmicrosoftauthenticatorauthenticationmethod.md)|Read the properties and relationships of a user's passwordlessMicrosoftAuthenticatorAuthenticationMethod object.|
-|[Delete](../api/passwordlessmicrosoftauthenticatorauthenticationmethod-delete.md)|None|Deletes a user's passwordlessMicrosoftAuthenticatorAuthenticationMethod object.|
+|[List](../api/passwordlessmicrosoftauthenticatorauthenticationmethod-list.md) (deprecated)|[passwordlessMicrosoftAuthenticatorAuthenticationMethod](../resources/passwordlessmicrosoftauthenticatorauthenticationmethod.md) collection|Retrieve a list of a user's passwordlessMicrosoftAuthenticatorAuthenticationMethod objects and their properties.|
+|[Get](../api/passwordlessmicrosoftauthenticatorauthenticationmethod-get.md) (deprecated)|[passwordlessMicrosoftAuthenticatorAuthenticationMethod](../resources/passwordlessmicrosoftauthenticatorauthenticationmethod.md)|Read the properties and relationships of a user's passwordlessMicrosoftAuthenticatorAuthenticationMethod object.|
+|[Delete](../api/passwordlessmicrosoftauthenticatorauthenticationmethod-delete.md) (deprecated)|None|Deletes a user's passwordlessMicrosoftAuthenticatorAuthenticationMethod object.|
## Properties
beta https://docs.microsoft.com/en-us/graph/resources/presence https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/presence.md
@@ -31,7 +31,8 @@ This resource supports subscribing to [change notifications](/graph/webhooks).
|:--------------------|:-----------------------------------------------------|:--------------------------------------------------------------------| |id | string | The user object id | |availability | string collection | The base presence information for a user. Possible values are `Available`, `AvailableIdle`, `Away`, `BeRightBack`, `Busy`, `BusyIdle`, `DoNotDisturb`, `Offline`, `PresenceUnknown` |
-|activity | string collection | The supplemental information to a user's availability. Possible values are `Available`, `Away`, `BeRightBack`, `Busy`, `DoNotDisturb`, `InACall`, `InAConferenceCall`, `Inactive`, `InAMeeting`, `Offline`, `OffWork`, `OutOfOffice`, `PresenceUnknown`, `Presenting`, `UrgentInterruptionsOnly`. |
+|activity | string collection | The supplemental information to a user's availability. Possible values are `Available`, `Away`, `BeRightBack`, `Busy`, `DoNotDisturb`, `InACall`, `InAConferenceCall`, `Inactive`,`InAMeeting`, `Offline`, `OffWork`,`OutOfOffice`, `PresenceUnknown`,`Presenting`, `UrgentInterruptionsOnly`. |
+|outOfOfficeSettings | [outOfOfficeSettings](outOfOfficeSettings.md) | The out of office settings for a user. |
>**Note:** To learn more about the different presence states, see [User presence in Teams](/microsoftteams/presence-admins).
@@ -53,6 +54,7 @@ The following is a JSON representation of the resource.
{ "id":"string", "availability":"string",
- "activity":"string"
+ "activity":"string",
+ "outOfOfficeSettings":{"@odata.type": "#microsoft.graph.outOfOfficeSettings"}
} ```
beta https://docs.microsoft.com/en-us/graph/resources/windowshelloforbusinessauthenticationmethod https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/windowshelloforbusinessauthenticationmethod.md new file mode 100644
@@ -0,0 +1,56 @@
+---
+title: "windowsHelloForBusinessAuthenticationMethod resource type"
+description: "A representation of a Windows Hello for Business instance registered to a user. Windows Hello for Business is a sign-in authentication method."
+author: "mmcla"
+localization_priority: Normal
+ms.prod: "microsoft-identity-platform"
+doc_type: resourcePageType
+---
+
+# windowsHelloForBusinessAuthenticationMethod resource type
+
+Namespace: microsoft.graph
+
+A representation of a Windows Hello for Business authentication method registered to a user. Windows Hello for Business is a sign-in authentication method for Windows devices.
+
+Inherits from [authenticationMethod](../resources/authenticationmethod.md).
+
+## Methods
+|Method|Return type|Description|
+|:---|:---|:---|
+|[List windowsHelloForBusinessAuthenticationMethods](../api/windowshelloforbusinessauthenticationmethod-list.md)|[windowsHelloForBusinessAuthenticationMethod](../resources/windowshelloforbusinessauthenticationmethod.md) collection|Get a list of the [windowsHelloForBusinessAuthenticationMethod](../resources/windowshelloforbusinessauthenticationmethod.md) objects and their properties.|
+|[Get windowsHelloForBusinessAuthenticationMethod](../api/windowshelloforbusinessauthenticationmethod-get.md)|[windowsHelloForBusinessAuthenticationMethod](../resources/windowshelloforbusinessauthenticationmethod.md)|Read the properties and relationships of a [windowsHelloForBusinessAuthenticationMethod](../resources/windowshelloforbusinessauthenticationmethod.md) object.|
+|[Delete windowsHelloForBusinessAuthenticationMethod](../api/windowshelloforbusinessauthenticationmethod-delete.md)|None|Deletes a [windowsHelloForBusinessAuthenticationMethod](../resources/windowshelloforbusinessauthenticationmethod.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:---|:---|:---|
+|createdDateTime|DateTimeOffset|The date and time that this Windows Hello for Business key was registered.|
+|displayName|String|The name of the device on which Windows Hello for Business is registered|
+|id|String|A unique identifier for this authentication method. Inherited from [authenticationMethod](../resources/authenticationmethod.md)|
+|keyStrength|authenticationMethodKeyStrength|Key strength of this Windows Hello for Business key. Possible values are: `normal`, `weak`, `unknown`.|
+
+## Relationships
+|Relationship|Type|Description|
+|:---|:---|:---|
+|device|[device](../resources/device.md)|The registered device on which this Windows Hello for Business key resides.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.windowsHelloForBusinessAuthenticationMethod",
+ "baseType": "microsoft.graph.authenticationMethod",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.windowsHelloForBusinessAuthenticationMethod",
+ "id": "String (Identifier)",
+ "displayName": "String",
+ "createdDateTime": "String",
+ "keyStrength": {"@odata.type": "microsoft.graph.authenticationMethodKeyStrength"}
+}
+```