Skip to content

Commit c5e2b44

Browse files
Learn Build Service GitHub AppLearn Build Service GitHub App
Learn Build Service GitHub App
authored and
Learn Build Service GitHub App
committed
Merging changes synced from https://github.com/microsoftgraph/microsoft-graph-docs (branch live)
2 parents 723de2f + 26cf989 commit c5e2b44

File tree

195 files changed

+3076
-1063
lines changed

Some content is hidden

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

195 files changed

+3076
-1063
lines changed

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

+31
Original file line numberDiff line numberDiff line change
@@ -66,6 +66,7 @@ If successful, this method returns a `204 No Content` response code.
6666
### Request
6767

6868
The following example shows a request.
69+
# [HTTP](#tab/http)
6970
<!-- {
7071
"blockType": "request",
7172
"name": "delete_qrcodepinauthenticationmethod"
@@ -75,6 +76,36 @@ The following example shows a request.
7576
DELETE https://graph.microsoft.com/beta/users/7c4999f7-9c25-4f8e-8b84-766eb28a1b49/authentication/qrCodePinMethod
7677
```
7778

79+
# [C#](#tab/csharp)
80+
[!INCLUDE [sample-code](../includes/snippets/csharp/delete-qrcodepinauthenticationmethod-csharp-snippets.md)]
81+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
82+
83+
# [CLI](#tab/cli)
84+
[!INCLUDE [sample-code](../includes/snippets/cli/delete-qrcodepinauthenticationmethod-cli-snippets.md)]
85+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
86+
87+
# [Go](#tab/go)
88+
[!INCLUDE [sample-code](../includes/snippets/go/delete-qrcodepinauthenticationmethod-go-snippets.md)]
89+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
90+
91+
# [Java](#tab/java)
92+
[!INCLUDE [sample-code](../includes/snippets/java/delete-qrcodepinauthenticationmethod-java-snippets.md)]
93+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
94+
95+
# [JavaScript](#tab/javascript)
96+
[!INCLUDE [sample-code](../includes/snippets/javascript/delete-qrcodepinauthenticationmethod-javascript-snippets.md)]
97+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
98+
99+
# [PHP](#tab/php)
100+
[!INCLUDE [sample-code](../includes/snippets/php/delete-qrcodepinauthenticationmethod-php-snippets.md)]
101+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
102+
103+
# [Python](#tab/python)
104+
[!INCLUDE [sample-code](../includes/snippets/python/delete-qrcodepinauthenticationmethod-python-snippets.md)]
105+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
106+
107+
---
108+
78109

79110
### Response
80111

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

+9-2
Original file line numberDiff line numberDiff line change
@@ -23,12 +23,12 @@ Choose the permission or permissions marked as least privileged for this API. Us
2323
### Permissions acting on self
2424

2525
<!-- { "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)]
26+
[!INCLUDE [permissions-table](../includes/permissions/authentication-put-qrcodepinmethod-permissions.md)]
2727

2828
### Permissions acting on other users
2929

3030
<!-- { "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)]
31+
[!INCLUDE [permissions-table](../includes/permissions/authentication-put-qrcodepinmethod-2-permissions.md)]
3232

3333
[!INCLUDE [rbac-authentication-methods-apis-write-others](../includes/rbac-for-apis/rbac-authentication-methods-apis-write-others.md)]
3434

@@ -75,6 +75,7 @@ If successful, this method returns a `201 Created` response code and a [qrCodePi
7575
### Request
7676

7777
The following example shows a request.
78+
# [HTTP](#tab/http)
7879
<!-- {
7980
"blockType": "request",
8081
"name": "create_qrcodepinauthenticationmethod_from_",
@@ -97,6 +98,12 @@ Content-Type: application/json
9798
}
9899
```
99100

101+
# [JavaScript](#tab/javascript)
102+
[!INCLUDE [sample-code](../includes/snippets/javascript/create-qrcodepinauthenticationmethod-from--javascript-snippets.md)]
103+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
104+
105+
---
106+
100107

101108
### Response
102109

api-reference/beta/api/callsettings-list-delegates.md

+48
Original file line numberDiff line numberDiff line change
@@ -81,10 +81,34 @@ The following example shows a request.
8181
GET https://graph.microsoft.com/beta/me/communications/callSettings/delegates
8282
```
8383

84+
# [C#](#tab/csharp)
85+
[!INCLUDE [sample-code](../includes/snippets/csharp/list-delegationsettings-delegates-csharp-snippets.md)]
86+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
87+
88+
# [CLI](#tab/cli)
89+
[!INCLUDE [sample-code](../includes/snippets/cli/list-delegationsettings-delegates-cli-snippets.md)]
90+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
91+
92+
# [Go](#tab/go)
93+
[!INCLUDE [sample-code](../includes/snippets/go/list-delegationsettings-delegates-go-snippets.md)]
94+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
95+
96+
# [Java](#tab/java)
97+
[!INCLUDE [sample-code](../includes/snippets/java/list-delegationsettings-delegates-java-snippets.md)]
98+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
99+
84100
# [JavaScript](#tab/javascript)
85101
[!INCLUDE [sample-code](../includes/snippets/javascript/list-delegationsettings-delegates-javascript-snippets.md)]
86102
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
87103

104+
# [PHP](#tab/php)
105+
[!INCLUDE [sample-code](../includes/snippets/php/list-delegationsettings-delegates-php-snippets.md)]
106+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
107+
108+
# [Python](#tab/python)
109+
[!INCLUDE [sample-code](../includes/snippets/python/list-delegationsettings-delegates-python-snippets.md)]
110+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
111+
88112
---
89113

90114
#### Response
@@ -154,10 +178,34 @@ The following example shows a request.
154178
GET https://graph.microsoft.com/beta/me/communications/callSettings/delegates?filter=allowedActions/receiveCalls eq true
155179
```
156180

181+
# [C#](#tab/csharp)
182+
[!INCLUDE [sample-code](../includes/snippets/csharp/list-delegationsettings-delegates-receivecalls-csharp-snippets.md)]
183+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
184+
185+
# [CLI](#tab/cli)
186+
[!INCLUDE [sample-code](../includes/snippets/cli/list-delegationsettings-delegates-receivecalls-cli-snippets.md)]
187+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
188+
189+
# [Go](#tab/go)
190+
[!INCLUDE [sample-code](../includes/snippets/go/list-delegationsettings-delegates-receivecalls-go-snippets.md)]
191+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
192+
193+
# [Java](#tab/java)
194+
[!INCLUDE [sample-code](../includes/snippets/java/list-delegationsettings-delegates-receivecalls-java-snippets.md)]
195+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
196+
157197
# [JavaScript](#tab/javascript)
158198
[!INCLUDE [sample-code](../includes/snippets/javascript/list-delegationsettings-delegates-receivecalls-javascript-snippets.md)]
159199
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
160200

201+
# [PHP](#tab/php)
202+
[!INCLUDE [sample-code](../includes/snippets/php/list-delegationsettings-delegates-receivecalls-php-snippets.md)]
203+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
204+
205+
# [Python](#tab/python)
206+
[!INCLUDE [sample-code](../includes/snippets/python/list-delegationsettings-delegates-receivecalls-python-snippets.md)]
207+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
208+
161209
---
162210

163211
#### Response

api-reference/beta/api/callsettings-list-delegators.md

+48
Original file line numberDiff line numberDiff line change
@@ -80,10 +80,34 @@ The following example shows a request.
8080
GET https://graph.microsoft.com/beta/me/communications/callSettings/delegators
8181
```
8282

83+
# [C#](#tab/csharp)
84+
[!INCLUDE [sample-code](../includes/snippets/csharp/list-delegationsettings-delegators-csharp-snippets.md)]
85+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
86+
87+
# [CLI](#tab/cli)
88+
[!INCLUDE [sample-code](../includes/snippets/cli/list-delegationsettings-delegators-cli-snippets.md)]
89+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
90+
91+
# [Go](#tab/go)
92+
[!INCLUDE [sample-code](../includes/snippets/go/list-delegationsettings-delegators-go-snippets.md)]
93+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
94+
95+
# [Java](#tab/java)
96+
[!INCLUDE [sample-code](../includes/snippets/java/list-delegationsettings-delegators-java-snippets.md)]
97+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
98+
8399
# [JavaScript](#tab/javascript)
84100
[!INCLUDE [sample-code](../includes/snippets/javascript/list-delegationsettings-delegators-javascript-snippets.md)]
85101
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
86102

103+
# [PHP](#tab/php)
104+
[!INCLUDE [sample-code](../includes/snippets/php/list-delegationsettings-delegators-php-snippets.md)]
105+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
106+
107+
# [Python](#tab/python)
108+
[!INCLUDE [sample-code](../includes/snippets/python/list-delegationsettings-delegators-python-snippets.md)]
109+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
110+
87111
---
88112

89113
#### Response
@@ -153,10 +177,34 @@ The following example shows a request.
153177
GET https://graph.microsoft.com/beta/me/communications/callSettings/delegators?filter=allowedActions/makeCalls eq true
154178
```
155179

180+
# [C#](#tab/csharp)
181+
[!INCLUDE [sample-code](../includes/snippets/csharp/list-delegationsettings-delegators-filter-makecalls-csharp-snippets.md)]
182+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
183+
184+
# [CLI](#tab/cli)
185+
[!INCLUDE [sample-code](../includes/snippets/cli/list-delegationsettings-delegators-filter-makecalls-cli-snippets.md)]
186+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
187+
188+
# [Go](#tab/go)
189+
[!INCLUDE [sample-code](../includes/snippets/go/list-delegationsettings-delegators-filter-makecalls-go-snippets.md)]
190+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
191+
192+
# [Java](#tab/java)
193+
[!INCLUDE [sample-code](../includes/snippets/java/list-delegationsettings-delegators-filter-makecalls-java-snippets.md)]
194+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
195+
156196
# [JavaScript](#tab/javascript)
157197
[!INCLUDE [sample-code](../includes/snippets/javascript/list-delegationsettings-delegators-filter-makecalls-javascript-snippets.md)]
158198
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
159199

200+
# [PHP](#tab/php)
201+
[!INCLUDE [sample-code](../includes/snippets/php/list-delegationsettings-delegators-filter-makecalls-php-snippets.md)]
202+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
203+
204+
# [Python](#tab/python)
205+
[!INCLUDE [sample-code](../includes/snippets/python/list-delegationsettings-delegators-filter-makecalls-python-snippets.md)]
206+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
207+
160208
---
161209

162210
#### Response

api-reference/beta/api/cloudlicensing-usageright-get.md

+3-7
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ Get the properties and relationships of a [usageRight](../resources/cloudlicensi
1818

1919
## Permissions
2020

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).
21+
The following tables show the least privileged permission or permissions required to call this API on each supported resource type. Follow [best practices](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions) to request least privileged 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).
2222

2323
Permissions to get a **usageRight** for a user:
2424

@@ -38,12 +38,8 @@ Permissions to get a **usageRight** for a group:
3838
GET /groups/{groupId}/cloudLicensing/usageRights/{usageRightId}
3939
```
4040

41-
<!-- { "blockType": "permissions", "name": "cloudlicensing_usageright_get", "requestUrls": "GET /groups/{groupId}/cloudLicensing/usageRights/{usageRightId}" } -->
42-
|Permission type|Least privileged permissions|Higher privileged permissions|
43-
|:---|:---|:---|
44-
|Delegated (work or school account)|Group-UsageRight.Read.All|Directory.Read.All, Directory.ReadWrite.All, Group-CloudLicensing.Read, Group-CloudLicensing.Read.All, Group.Read.All, Group.ReadWrite.All, User.Read.All, User.ReadWrite.All|
45-
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
46-
|Application|Group-UsageRight.Read.All|Directory.Read.All, Directory.ReadWrite.All, Group-CloudLicensing.Read.All, Group.Read.All, Group.ReadWrite.All, User.Read.All, User.ReadWrite.All|
41+
<!-- { "blockType": "permissions", "name": "cloudlicensing_usageright_get_2", "requestUrls": ["GET /groups/{id}/cloudLicensing/usageRights/{id}"] } -->
42+
[!INCLUDE [permissions-table](../includes/permissions/cloudlicensing-usageright-get-2-permissions.md)]
4743

4844
## HTTP request
4945

api-reference/beta/api/delegationsettings-get.md

+24
Original file line numberDiff line numberDiff line change
@@ -82,10 +82,34 @@ The following example shows a request.
8282
GET https://graph.microsoft.com/beta/me/communications/callSettings/delegates/62de48e1-a72c-40db-9193-a3bd8cf167c9
8383
```
8484

85+
# [C#](#tab/csharp)
86+
[!INCLUDE [sample-code](../includes/snippets/csharp/get-delegationsettings-csharp-snippets.md)]
87+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
88+
89+
# [CLI](#tab/cli)
90+
[!INCLUDE [sample-code](../includes/snippets/cli/get-delegationsettings-cli-snippets.md)]
91+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
92+
93+
# [Go](#tab/go)
94+
[!INCLUDE [sample-code](../includes/snippets/go/get-delegationsettings-go-snippets.md)]
95+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
96+
97+
# [Java](#tab/java)
98+
[!INCLUDE [sample-code](../includes/snippets/java/get-delegationsettings-java-snippets.md)]
99+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
100+
85101
# [JavaScript](#tab/javascript)
86102
[!INCLUDE [sample-code](../includes/snippets/javascript/get-delegationsettings-javascript-snippets.md)]
87103
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
88104

105+
# [PHP](#tab/php)
106+
[!INCLUDE [sample-code](../includes/snippets/php/get-delegationsettings-php-snippets.md)]
107+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
108+
109+
# [Python](#tab/python)
110+
[!INCLUDE [sample-code](../includes/snippets/python/get-delegationsettings-python-snippets.md)]
111+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
112+
89113
---
90114

91115
### Response

api-reference/beta/api/enhancedpersonalizationsetting-get.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: "Read the properties and relationships of an enhancedPersonalizatio
44
author: "Ross-GH"
55
ms.date: 04/03/2025
66
ms.localizationpriority: medium
7-
ms.subservice: "meetings-copilot"
7+
ms.subservice: "microsoft-365-copilot"
88
doc_type: apiPageType
99
---
1010

@@ -66,7 +66,7 @@ GET https://graph.microsoft.com/beta/copilot/settings/people/enhancedpersonaliza
6666
```
6767

6868

69-
### Response body
69+
### Response
7070

7171
The following example shows the response.
7272
>**Note:** The response object shown here might be shortened for readability.
@@ -83,8 +83,8 @@ Content-Type: application/json
8383
{
8484
"value": {
8585
"@odata.type": "#microsoft.graph.enhancedPersonalizationSetting",
86-
"isEnabledInOrganization": "Boolean",
87-
"disabledForGroup": "String"
86+
"isEnabledInOrganization": true,
87+
"disabledForGroup": "edbfe4fb-ec70-4300-928f-dbb2ae86c981"
8888
}
8989
}
9090
```

api-reference/beta/api/enhancedpersonalizationsetting-update.md

+11-12
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
22
title: "Update enhancedPersonalizationSetting"
3-
description: "Update the properties of an enhancedPersonalizationSetting object with Microsoft Graph."
3+
description: "Update the properties of an enhancedPersonalizationSetting object."
44
author: "Ross-GH"
55
ms.date: 04/03/2025
66
ms.localizationpriority: medium
7-
ms.subservice: "meetings-copilot"
7+
ms.subservice: "microsoft-365-copilot"
88
doc_type: apiPageType
99
---
1010

@@ -63,34 +63,33 @@ The following example shows a request.
6363
"name": "update_enhancedpersonalizationsetting"
6464
}
6565
-->
66-
``` http
66+
```http
6767
PATCH https://graph.microsoft.com/beta/copilot/settings/people/enhancedpersonalization
6868
Content-Type: application/json
6969
7070
{
71-
"@odata.type": "#microsoft.graph.enhancedPersonalizationSetting",
72-
"isEnabledInOrganization": "Boolean",
73-
"disabledForGroup": "String"
71+
"isEnabledInOrganization": true,
72+
"disabledForGroup": "edbfe4fb-ec70-4300-928f-dbb2ae86c981"
7473
}
7574
```
7675

77-
### Response body
76+
### Response
7877

7978
The following example shows the response.
8079
>**Note:** The response object shown here might be shortened for readability.
8180
<!-- {
8281
"blockType": "response",
8382
"truncated": true,
84-
"@odata.type": "microsoft.graph.enhancedPersonalizationSetting"
83+
"@odata.type": "microsoft.graph.enhancedPersonalizationSetting",
84+
"name": "update_enhancedpersonalizationsetting"
8585
}
8686
-->
87-
``` http
87+
```http
8888
HTTP/1.1 200 OK
8989
Content-Type: application/json
9090
9191
{
92-
"@odata.type": "#microsoft.graph.enhancedPersonalizationSetting",
93-
"isEnabledInOrganization": "Boolean",
94-
"disabledForGroup": "String"
92+
"isEnabledInOrganization": true,
93+
"disabledForGroup": "edbfe4fb-ec70-4300-928f-dbb2ae86c981"
9594
}
9695
```

api-reference/beta/api/group-post-members.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -81,7 +81,7 @@ When using the `PATCH /groups/{group-id}/members` syntax, supply a JSON object t
8181
## Response
8282

8383
If successful, this method returns a `204 No Content` response code. It returns a `400 Bad Request` response code when the object is already a member of the group or is unsupported as a group member. It returns a `404 Not Found` response code when the object being added doesn't exist. It returns `403 Unauthorized` in one of the following scenarios:
84-
- You're attempting to add a member to a [group that can't be managed through Microsoft Graph](../resources/groups-overview.md#group-types-in-microsoft-entra-id-and-microsoft-graph). This API supports only security and Microsoft 365 groups.
84+
- You're attempting to add a member to a [group that can't be managed through Microsoft Graph](../resources/groups-overview.md#types-of-groups-supported-in-microsoft-graph). This API supports only security and Microsoft 365 groups.
8585
- You're attempting to add a member you don't have permissions to add. Refer to the preceding [Permissions](#permissions) section for the permissions required to add different member types.
8686
- You're attempting to add a member to a role-assignable group and you don't have the required permissions.
8787

api-reference/beta/api/networkaccess-networkaccesstraffic-get.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ Retrieve the properties and relationships of a [networkAccessTraffic](../resourc
2222

2323
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
2424

25-
<!-- { "blockType": "permissions", "name": "networkaccess_logs_list_traffic" } -->
25+
<!-- { "blockType": "permissions", "name": "networkaccess_networkaccesstraffic_get" } -->
2626
[!INCLUDE [permissions-table](../includes/permissions/networkaccess-networkaccesstraffic-get-permissions.md)]
2727

2828
## HTTP request

0 commit comments

Comments
 (0)