Skip to content

Commit 3c8a189

Browse files
DanielabomDanielabom
authored
Merge pull request #26555 from microsoftgraph/main
Merge to publish
2 parents df14287 + f698a4a commit 3c8a189

File tree

370 files changed

+5597
-687
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

370 files changed

+5597
-687
lines changed

‎api-reference/beta/api/authentication-delete-qrcodepinmethod.md

Lines changed: 90 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,90 @@
1+
---
2+
title: "Delete qrCodePinAuthenticationMethod"
3+
description: "Delete a qrCodePinAuthenticationMethod object."
4+
author: "AanjuSingh"
5+
ms.date: 04/16/2025
6+
ms.localizationpriority: medium
7+
ms.subservice: "entra-sign-in"
8+
doc_type: apiPageType
9+
---
10+
11+
# Delete qrCodePinAuthenticationMethod
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Deletes user's [qrCodePinAuthenticationMethod](../resources/qrcodepinauthenticationmethod.md) object. Once the object is deleted, it can't be retrieved. The user won't be able to sign-in with any QR codes associated with the deleted object.
18+
19+
## Permissions
20+
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
21+
22+
### Permissions acting on self
23+
24+
<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
25+
[!INCLUDE [permissions-table](../includes/permissions/authentication-delete-qrcodepinmethod-permissions.md)]
26+
27+
### Permissions acting on other users
28+
29+
<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
30+
[!INCLUDE [permissions-table](../includes/permissions/authentication-delete-qrcodepinmethod-2-permissions.md)]
31+
32+
[!INCLUDE [rbac-authentication-methods-apis-write-others](../includes/rbac-for-apis/rbac-authentication-methods-apis-write-others.md)]
33+
34+
## HTTP request
35+
36+
Delete your own QR Code + PIN authentication method.
37+
<!-- { "blockType": "ignored" } -->
38+
``` http
39+
DELETE /me/authentication/qrCodePinMethod
40+
```
41+
42+
[!INCLUDE [me-apis-sign-in-note](../includes/me-apis-sign-in-note.md)]
43+
44+
Delete another user's QR Code + PIN authentication method.
45+
<!-- { "blockType": "ignored" } -->
46+
``` http
47+
DELETE /users/{id}/authentication/qrCodePinMethod
48+
```
49+
50+
## Request headers
51+
52+
|Name|Description|
53+
|:---|:---|
54+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
55+
56+
## Request body
57+
58+
Don't supply a request body for this method.
59+
60+
## Response
61+
62+
If successful, this method returns a `204 No Content` response code.
63+
64+
## Examples
65+
66+
### Request
67+
68+
The following example shows a request.
69+
<!-- {
70+
"blockType": "request",
71+
"name": "delete_qrcodepinauthenticationmethod"
72+
}
73+
-->
74+
``` http
75+
DELETE https://graph.microsoft.com/beta/users/7c4999f7-9c25-4f8e-8b84-766eb28a1b49/authentication/qrCodePinMethod
76+
```
77+
78+
79+
### Response
80+
81+
The following example shows the response.
82+
<!-- {
83+
"blockType": "response",
84+
"truncated": true
85+
}
86+
-->
87+
``` http
88+
HTTP/1.1 204 No Content
89+
```
90+

‎api-reference/beta/api/authentication-put-qrcodepinmethod.md

Lines changed: 146 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,146 @@
1+
---
2+
title: "Create qrCodePinAuthenticationMethod"
3+
description: "Create a new qrCodePinAuthenticationMethod object."
4+
author: "AanjuSingh"
5+
ms.date: 04/16/2025
6+
ms.localizationpriority: medium
7+
ms.subservice: "entra-sign-in"
8+
doc_type: apiPageType
9+
---
10+
11+
# Create qrCodePinAuthenticationMethod
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Create a new [qrCodePinAuthenticationMethod](../resources/qrcodepinauthenticationmethod.md) object for the user. A user can have only one active QR code authentication method. A new QR code authentication can be added if an existing one expires or is deleted and is therefore unusable for sign-in. This auth method can have standard and temporary QR codes. An active QR code authentication method can have only one active standard and one temporary QR code. To create a new QR code authentication method, standard QR code, or temporary QR code, you must first [delete existing respective objects](../api/qrcode-delete.md).
18+
19+
20+
## Permissions
21+
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
22+
23+
### Permissions acting on self
24+
25+
<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
26+
[!INCLUDE [permissions-table](../includes/permissions/authentication-put-qrCodePinMethod-permissions.md)]
27+
28+
### Permissions acting on other users
29+
30+
<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
31+
[!INCLUDE [permissions-table](../includes/permissions/authentication-put-qrCodePinMethod-2-permissions.md)]
32+
33+
[!INCLUDE [rbac-authentication-methods-apis-write-others](../includes/rbac-for-apis/rbac-authentication-methods-apis-write-others.md)]
34+
35+
## HTTP request
36+
37+
Create your own QR Code + PIN authentication method.
38+
<!-- { "blockType": "ignored" } -->
39+
``` http
40+
PUT /me/authentication/qrCodePinMethod
41+
```
42+
43+
[!INCLUDE [me-apis-sign-in-note](../includes/me-apis-sign-in-note.md)]
44+
45+
Create another user's QR Code + PIN authentication method.
46+
<!-- { "blockType": "ignored" } -->
47+
``` http
48+
PUT /users/{id}/authentication/qrCodePinMethod
49+
```
50+
51+
## Request headers
52+
53+
|Name|Description|
54+
|:---|:---|
55+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
56+
|Content-Type|application/json. Required.|
57+
58+
## Request body
59+
60+
In the request body, supply a JSON representation of the [qrCodePinAuthenticationMethod](../resources/qrcodepinauthenticationmethod.md) object.
61+
62+
You can specify the following properties when creating a **qrCodePinAuthenticationMethod**.
63+
64+
|Property|Type|Description|
65+
|:---|:---|:---|
66+
|standardQRCode|[qrCode](../resources/qrcode.md)|Standard QR code is primary QR code of the user with lifetime upto 395 days (13 months). There can be only one active standard QR code for the user. A new standard QR code can be created if an existing one is expired or deleted. The **startDateTime**, when this QR code is activated, and **expireDateTime**, when this QR code is expired, are required.|
67+
|pin|[qrPin](../resources/qrpin.md)|The PIN linked to the QR Code for the user. The admin creates the temporary pin, which the user must change during sign-in. The admin can specify a custom or autogenerated PIN. Custom PIN support is only available during QR code creation only. |
68+
69+
## Response
70+
71+
If successful, this method returns a `201 Created` response code and a [qrCodePinAuthenticationMethod](../resources/qrcodepinauthenticationmethod.md) object in the response body.
72+
73+
## Examples
74+
75+
### Request
76+
77+
The following example shows a request.
78+
<!-- {
79+
"blockType": "request",
80+
"name": "create_qrcodepinauthenticationmethod_from_",
81+
"@odata.type": "microsoft.graph.qrCodePinAuthenticationMethod"
82+
}
83+
-->
84+
``` http
85+
PUT https://graph.microsoft.com/beta/users/7c4999f7-9c25-4f8e-8b84-766eb28a1b49/authentication/qrCodePinMethod
86+
Content-Type: application/json
87+
88+
{
89+
"@odata.type": "#microsoft.graph.qrCodePinAuthenticationMethod",
90+
"standardQRCode": {
91+
"expireDateTime": "2025-12-19T12:00:00Z",
92+
"startDateTime": "2025-01-01T12:00:00Z"
93+
},
94+
"pin": {
95+
"code": "09599786"
96+
}
97+
}
98+
```
99+
100+
101+
### Response
102+
103+
The following example shows the response.
104+
>**Note:** The response object shown here might be shortened for readability.
105+
<!-- {
106+
"blockType": "response",
107+
"truncated": true,
108+
"@odata.type": "microsoft.graph.qrCodePinAuthenticationMethod"
109+
}
110+
-->
111+
``` http
112+
HTTP/1.1 201 Created
113+
Content-Type: application/json
114+
115+
{
116+
"@odata.type": "#microsoft.graph.qrCodePinAuthenticationMethod",
117+
"id": "d29518d4-b99a-4c88-b40c-92fd12959724",
118+
"isUsable": false,
119+
"methodUsabilityReason": null,
120+
"standardQRCode": {
121+
"@odata.type": "#microsoft.graph.qrCode",
122+
"id": "1a253da5-3f9a-457d-bd9c-de1aab9a2e59",
123+
"expireDateTime": "2025-12-19T12:00:00Z",
124+
"startDateTime": "2025-01-01T12:00:00Z",
125+
"createdDateTime": "2025-03-05T00:03:11.1460378Z",
126+
"lastUsedDateTime": "0001-01-01T00:00:00Z",
127+
"image": {
128+
"@odata.type": "#microsoft.graph.qrCodeImageDetails",
129+
"binaryValue": "SGVsbG9Xb3JsZCE=",
130+
"version": 1,
131+
"errorCorrectionLevel": "l",
132+
"rawContent": "SGVsbG9Xb3JsZCEyTXlSYXdDb250ZW50"
133+
}
134+
},
135+
"temporaryQRCode": null,
136+
"pin": {
137+
"@odata.type": "#microsoft.graph.qrPin",
138+
"id": "a98a1084-f503-4dfd-a293-c0e93cba124a",
139+
"code": "09599786",
140+
"forceChangePinNextSignIn": true,
141+
"createdDateTime": "2025-03-05T00:03:11.3120627Z",
142+
"updatedDateTime": "2025-03-05T00:03:11.3120627Z"
143+
}
144+
}
145+
```
146+

‎api-reference/beta/api/authenticationstrengthpolicy-updateallowedcombinations.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ The following table shows the parameters that can be used with this action.
5050

5151
|Parameter|Type|Description|
5252
|:---|:---|:---|
53-
|allowedCombinations|authenticationMethodModes collection|The authentication method combinations allowed by this authentication strength policy. The possible values of this flagged enum are: `password`, `voice`, `hardwareOath`, `softwareOath`, `sms`, `fido2`, `windowsHelloForBusiness`, `microsoftAuthenticatorPush`, `deviceBasedPush`, `temporaryAccessPassOneTime`, `temporaryAccessPassMultiUse`, `email`, `x509CertificateSingleFactor`, `x509CertificateMultiFactor`, `federatedSingleFactor`, `federatedMultiFactor`, `unknownFutureValue`. For the list of allowed combinations, call the [List authenticationMethodModes](../api/authenticationstrengthroot-list-authenticationmethodmodes.md) API. Required.|
53+
|allowedCombinations|authenticationMethodModes collection|The authentication method combinations allowed by this authentication strength policy. The possible values of this flagged enum are: `password`, `voice`, `hardwareOath`, `softwareOath`, `sms`, `fido2`, `windowsHelloForBusiness`, `microsoftAuthenticatorPush`, `deviceBasedPush`, `temporaryAccessPassOneTime`, `temporaryAccessPassMultiUse`, `email`, `x509CertificateSingleFactor`, `x509CertificateMultiFactor`, `federatedSingleFactor`, `federatedMultiFactor`, `unknownFutureValue`, `qrCodePin`. Use the `Prefer: include-unknown-enum-members` request header to get the following values from this {evolvable enum}(/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `qrCodePin`. For the list of allowed combinations, call the [List authenticationMethodModes](../api/authenticationstrengthroot-list-authenticationmethodmodes.md) API. Required.|
5454

5555
## Response
5656

‎api-reference/beta/api/authenticationstrengthroot-list-authenticationmethodmodes.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -201,6 +201,11 @@ Content-Type: application/json
201201
"id": "x509CertificateMultiFactor",
202202
"displayName" : "Certificate-based authentication (multifactor)",
203203
"authenticationMethod" : "x509Certificate"
204+
},
205+
{
206+
"id": "qrCodePin",
207+
"displayName": "QR Code",
208+
"authenticationMethod": "qrCodePin"
204209
}
205210
]
206211
}
@@ -290,7 +295,8 @@ Content-Type: application/json
290295
"sms",
291296
"password",
292297
"federatedSingleFactor",
293-
"email"
298+
"email",
299+
"qrCodePin"
294300
]
295301
}
296302
```

‎api-reference/beta/api/authenticationstrengthroot-post-policies.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ You can specify the following properties when creating an **authenticationStreng
5151
|:---|:---|:---|
5252
|displayName|String|The display name of the policy to be created. Required.|
5353
|description|String|The description of the policy to be created. Optional.|
54-
|allowedCombinations|authenticationMethodModes collection|The authentication method combinations allowed by this authentication strength policy. The possible values of this flagged enum are: `password`, `voice`, `hardwareOath`, `softwareOath`, `sms`, `fido2`, `windowsHelloForBusiness`, `microsoftAuthenticatorPush`, `deviceBasedPush`, `temporaryAccessPassOneTime`, `temporaryAccessPassMultiUse`, `email`, `x509CertificateSingleFactor`, `x509CertificateMultiFactor`, `federatedSingleFactor`, `federatedMultiFactor`, `unknownFutureValue`. For the list of allowed combinations, call the [List authenticationMethodModes](../api/authenticationstrengthroot-list-authenticationmethodmodes.md) API. Required.|
54+
|allowedCombinations|authenticationMethodModes collection|The authentication method combinations allowed by this authentication strength policy. The possible values of this flagged enum are: `password`, `voice`, `hardwareOath`, `softwareOath`, `sms`, `fido2`, `windowsHelloForBusiness`, `microsoftAuthenticatorPush`, `deviceBasedPush`, `temporaryAccessPassOneTime`, `temporaryAccessPassMultiUse`, `email`, `x509CertificateSingleFactor`, `x509CertificateMultiFactor`, `federatedSingleFactor`, `federatedMultiFactor`, `unknownFutureValue`, `qrCodePin`. Use the `Prefer: include-unknown-enum-members` request header to get the following values from this {evolvable enum}(/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `qrCodePin`. For the list of allowed combinations, call the [List authenticationMethodModes](../api/authenticationstrengthroot-list-authenticationmethodmodes.md) API. Required.|
5555

5656
## Response
5757

‎api-reference/beta/api/backuprestoreroot-list-driveprotectionunits.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -97,7 +97,7 @@ GET /solutions/backupRestore/protectionUnits/microsoft.graph.driveProtectionUnit
9797
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
9898

9999
# [PowerShell](#tab/powershell)
100-
[!INCLUDE [snippet-not-available](../includes/snippets/snippet-not-available.md)]
100+
[!INCLUDE [sample-code](../includes/snippets/powershell/list-all-driveprotectionunit-powershell-snippets.md)]
101101
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
102102

103103
# [Python](#tab/python)

‎api-reference/beta/api/backuprestoreroot-list-mailboxprotectionunits.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -95,6 +95,10 @@ GET https://graph.microsoft.com/beta/solutions/backupRestore/protectionUnits/mic
9595
[!INCLUDE [sample-code](../includes/snippets/php/list-all-mailboxprotectionunit-php-snippets.md)]
9696
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
9797

98+
# [PowerShell](#tab/powershell)
99+
[!INCLUDE [sample-code](../includes/snippets/powershell/list-all-mailboxprotectionunit-powershell-snippets.md)]
100+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
101+
98102
# [Python](#tab/python)
99103
[!INCLUDE [sample-code](../includes/snippets/python/list-all-mailboxprotectionunit-python-snippets.md)]
100104
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

‎api-reference/beta/api/backuprestoreroot-list-siteprotectionunits.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -98,7 +98,7 @@ GET https://graph.microsoft.com/beta/solutions/backupRestore/protectionUnits/mic
9898
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
9999

100100
# [PowerShell](#tab/powershell)
101-
[!INCLUDE [snippet-not-available](../includes/snippets/snippet-not-available.md)]
101+
[!INCLUDE [sample-code](../includes/snippets/powershell/list-all-siteprotectionunit-powershell-snippets.md)]
102102
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
103103

104104
# [Python](#tab/python)

‎api-reference/beta/api/browsersitelist-publish.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -104,6 +104,10 @@ Content-Type: application/json
104104
[!INCLUDE [sample-code](../includes/snippets/php/browsersitelist-publish-e1-php-snippets.md)]
105105
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
106106

107+
# [PowerShell](#tab/powershell)
108+
[!INCLUDE [sample-code](../includes/snippets/powershell/browsersitelist-publish-e1-powershell-snippets.md)]
109+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
110+
107111
# [Python](#tab/python)
108112
[!INCLUDE [sample-code](../includes/snippets/python/browsersitelist-publish-e1-python-snippets.md)]
109113
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
@@ -207,6 +211,10 @@ Content-Type: application/json
207211
[!INCLUDE [sample-code](../includes/snippets/php/browsersitelist-publish-e2-php-snippets.md)]
208212
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
209213

214+
# [PowerShell](#tab/powershell)
215+
[!INCLUDE [sample-code](../includes/snippets/powershell/browsersitelist-publish-e2-powershell-snippets.md)]
216+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
217+
210218
# [Python](#tab/python)
211219
[!INCLUDE [sample-code](../includes/snippets/python/browsersitelist-publish-e2-python-snippets.md)]
212220
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

‎api-reference/beta/api/chat-sendactivitynotification.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -518,6 +518,7 @@ If you want to notify chat members with a customized icon instead of the default
518518
#### Request
519519

520520
The following example shows a request.
521+
# [HTTP](#tab/http)
521522
<!-- {
522523
"blockType": "request",
523524
"name": "chat_sendactivitynotification_6",
@@ -550,6 +551,40 @@ Content-Type: application/json
550551
}
551552
```
552553

554+
# [C#](#tab/csharp)
555+
[!INCLUDE [sample-code](../includes/snippets/csharp/chat-sendactivitynotification-6-csharp-snippets.md)]
556+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
557+
558+
# [CLI](#tab/cli)
559+
[!INCLUDE [sample-code](../includes/snippets/cli/chat-sendactivitynotification-6-cli-snippets.md)]
560+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
561+
562+
# [Go](#tab/go)
563+
[!INCLUDE [sample-code](../includes/snippets/go/chat-sendactivitynotification-6-go-snippets.md)]
564+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
565+
566+
# [Java](#tab/java)
567+
[!INCLUDE [sample-code](../includes/snippets/java/chat-sendactivitynotification-6-java-snippets.md)]
568+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
569+
570+
# [JavaScript](#tab/javascript)
571+
[!INCLUDE [sample-code](../includes/snippets/javascript/chat-sendactivitynotification-6-javascript-snippets.md)]
572+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
573+
574+
# [PHP](#tab/php)
575+
[!INCLUDE [sample-code](../includes/snippets/php/chat-sendactivitynotification-6-php-snippets.md)]
576+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
577+
578+
# [PowerShell](#tab/powershell)
579+
[!INCLUDE [sample-code](../includes/snippets/powershell/chat-sendactivitynotification-6-powershell-snippets.md)]
580+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
581+
582+
# [Python](#tab/python)
583+
[!INCLUDE [sample-code](../includes/snippets/python/chat-sendactivitynotification-6-python-snippets.md)]
584+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
585+
586+
---
587+
553588
#### Response
554589

555590
The following example shows the response.

0 commit comments

Comments
 (0)