Skip to content

Commit 552cdf3

Browse files
learn-build-service-prod[bot]learn-build-service-prod[bot]
authored
Merge pull request #28683 from microsoftgraph/main
Auto Publish – main to live - 2026-04-17 00:30 UTC
2 parents 1ced79b + 4d23a24 commit 552cdf3

389 files changed

Lines changed: 2704 additions & 768 deletions

File tree

Some content is hidden

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

‎.github/policies/resourceManagement.yml‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -127,6 +127,9 @@ configuration:
127127
When the updates in this PR are ready for external customers to use, please replace the **do not merge** label with **ready to merge**.
128128
129129
130+
If this PR includes schema-related changes, verify that the updates are visible in the metadata endpoint before merging: [https://graph.microsoft.com/beta/$metadata](https://graph.microsoft.com/beta/$metadata) for `beta` changes, or [https://graph.microsoft.com/v1.0/$metadata](https://graph.microsoft.com/v1.0/$metadata) for `v1.0` changes.
131+
132+
130133
Check the content review workflow [here](https://eng.ms/cid/27dee76c-3a60-4e65-8fdf-08ea849b3498/fid/3a993b6c9d547e46f59d8d7851f191c38bbbea6ead01253dc62fcdd8101a1ff9).
131134
- removeLabel:
132135
label: content review in progress

‎api-reference/beta/api/approvedclientapp-get.md‎

Lines changed: 88 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,88 @@
1+
---
2+
title: "Get approvedClientApp"
3+
description: "Read the properties and relationships of a approvedClientApp object for the remoteDesktopSecurityConfiguration object on the servicePrincipal."
4+
author: "mjsantani"
5+
ms.localizationpriority: medium
6+
ms.subservice: "entra-applications"
7+
doc_type: apiPageType
8+
ms.date: 01/02/2026
9+
---
10+
11+
# Get approvedClientApp
12+
Namespace: microsoft.graph
13+
14+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
15+
16+
Read the properties and relationships of a [approvedClientApp](../resources/approvedclientapp.md) object for the [remoteDesktopSecurityConfiguration](../resources/remotedesktopsecurityconfiguration.md) object on a servicePrincipal.
17+
18+
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
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+
<!-- { "blockType": "permissions", "name": "approvedclientapp_get" } -->
24+
[!INCLUDE [permissions-table](../includes/permissions/approvedclientapp-get-permissions.md)]
25+
26+
[!INCLUDE [rbac-remote-desktop-security-config-apis](../includes/rbac-for-apis/rbac-remote-desktop-security-config-apis.md)]
27+
28+
## HTTP request
29+
30+
You can address the service principal using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in app registrations in the Microsoft Entra admin center.
31+
32+
<!-- {
33+
"blockType": "ignored"
34+
}
35+
-->
36+
``` http
37+
GET /servicePrincipals/{id}/remoteDesktopSecurityConfiguration/approvedClientApps/{approvedClientAppId}
38+
GET /servicePrincipals(appId='{appId}')/remoteDesktopSecurityConfiguration/approvedClientApps/{approvedClientAppId}
39+
```
40+
41+
## Optional query parameters
42+
43+
This method supports the `$select` OData query parameter to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
44+
45+
## Request headers
46+
|Name|Description|
47+
|:---|:---|
48+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
49+
50+
## Request body
51+
Don't supply a request body for this method.
52+
53+
## Response
54+
55+
If successful, this method returns a `200 OK` response code and a [approvedClientApp](../resources/approvedclientapp.md) object in the response body.
56+
57+
## Examples
58+
59+
### Request
60+
The following example shows a request.
61+
<!-- {
62+
"blockType": "request",
63+
"name": "get_approvedclientapp"
64+
}
65+
-->
66+
``` http
67+
GET https://graph.microsoft.com/beta/servicePrincipals/00af5dfb-85da-4b41-a677-0c6b86dd34f8/remoteDesktopSecurityConfiguration/approvedClientApps/cd57c330-a543-4249-9486-c1c257341de6
68+
```
69+
70+
### Response
71+
The following example shows the response.
72+
>**Note:** The response object shown here might be shortened for readability.
73+
<!-- {
74+
"blockType": "response",
75+
"truncated": true,
76+
"@odata.type": "microsoft.graph.approvedClientApp"
77+
}
78+
-->
79+
``` http
80+
HTTP/1.1 200 OK
81+
Content-Type: application/json
82+
83+
{
84+
"@odata.type": "#microsoft.graph.approvedClientApp",
85+
"id": "cd57c330-a543-4249-9486-c1c257341de6",
86+
"displayName": "Client App 1"
87+
}
88+
```

‎api-reference/beta/api/approvedclientapp-update.md‎

Lines changed: 108 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,108 @@
1+
---
2+
title: "Update approvedClientApp"
3+
description: "Update the properties of an approvedClientApp object for the remoteDesktopSecurityConfiguration object."
4+
author: "mjsantani"
5+
ms.date: 11/11/2025
6+
ms.localizationpriority: medium
7+
ms.subservice: "entra-applications"
8+
doc_type: apiPageType
9+
---
10+
11+
# Update approvedClientApp
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Update the properties of an [approvedClientApp](../resources/approvedclientapp.md) object for a [remotedesktopsecurityconfiguration](../resources/remotedesktopsecurityconfiguration.md).
18+
19+
## Permissions
20+
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+
<!-- {
24+
"blockType": "permissions",
25+
"name": "approvedclientapp-update-permissions"
26+
}
27+
-->
28+
[!INCLUDE [permissions-table](../includes/permissions/approvedclientapp-update-permissions.md)]
29+
30+
[!INCLUDE [rbac-remote-desktop-security-config-apis](../includes/rbac-for-apis/rbac-remote-desktop-security-config-apis.md)]
31+
32+
## HTTP request
33+
34+
You can address the service principal using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in app registrations in the Microsoft Entra admin center.
35+
36+
<!-- {
37+
"blockType": "ignored"
38+
}
39+
-->
40+
``` http
41+
PATCH /servicePrincipals/{id}/remoteDesktopSecurityConfiguration/approvedClientApps/{approvedClientAppId}
42+
PATCH /servicePrincipals(appId='{appId}')/remoteDesktopSecurityConfiguration/approvedClientApps/{approvedClientAppId}
43+
```
44+
45+
## Request headers
46+
47+
|Name|Description|
48+
|:---|:---|
49+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
50+
|Content-Type|application/json. Required.|
51+
52+
## Request body
53+
54+
[!INCLUDE [table-intro](../../includes/update-property-table-intro.md)]
55+
56+
57+
|Property|Type|Description|
58+
|:---|:---|:---|
59+
|displayName|String|Display name of the Client Application. Optional.|
60+
61+
62+
63+
## Response
64+
65+
If successful, this method returns a `200 OK` response code and an updated [approvedClientApp](../resources/approvedclientapp.md) object in the response body.
66+
67+
## Examples
68+
69+
### Request
70+
71+
The following example shows a request.
72+
<!-- {
73+
"blockType": "request",
74+
"name": "update_approvedclientapp"
75+
}
76+
-->
77+
``` http
78+
PATCH https://graph.microsoft.com/v1.0/servicePrincipals/00af5dfb-85da-4b41-a677-0c6b86dd34f8/remoteDesktopSecurityConfiguration/approvedClientApps/95bd8f3d-e166-c072-4e28-af935a6d237f
79+
Content-Type: application/json
80+
81+
{
82+
"@odata.type": "#microsoft.graph.approvedClientApp",
83+
"displayName": "Client App 1"
84+
}
85+
```
86+
87+
88+
### Response
89+
90+
The following example shows the response.
91+
>**Note:** The response object shown here might be shortened for readability.
92+
<!-- {
93+
"blockType": "response",
94+
"truncated": true,
95+
"@odata.type": "microsoft.graph.approvedClientApp"
96+
}
97+
-->
98+
``` http
99+
HTTP/1.1 200 OK
100+
Content-Type: application/json
101+
102+
{
103+
"@odata.type": "#microsoft.graph.approvedClientApp",
104+
"id": "95bd8f3d-e166-c072-4e28-af935a6d237f",
105+
"displayName": "Client App 1"
106+
}
107+
```
108+

‎api-reference/beta/api/azureadpremiumlicenseinsight-get.md‎

Lines changed: 134 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,134 @@
1+
---
2+
title: "Get azureADPremiumLicenseInsight"
3+
description: "Get the premium license utilization insight for the tenant."
4+
author: "sanchariroy"
5+
ms.date: 03/13/2026
6+
ms.localizationpriority: medium
7+
ms.subservice: "entra-monitoring-health"
8+
doc_type: apiPageType
9+
---
10+
11+
# Get azureADPremiumLicenseInsight
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Get the premium license utilization insight for the tenant. This API returns data about how many premium licenses are entitled and how the associated P1 and P2 features are being used. The calling tenant must have at least one Microsoft Entra ID P1 or P2 license. Tenants without a premium license receive a `403 Forbidden` response with the `missingLicense` error code.
18+
19+
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
20+
21+
## Permissions
22+
23+
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).
24+
25+
<!-- {
26+
"blockType": "permissions",
27+
"name": "azureadpremiumlicenseinsight-get-permissions"
28+
}
29+
-->
30+
[!INCLUDE [permissions-table](../includes/permissions/azureadpremiumlicenseinsight-get-permissions.md)]
31+
32+
> [!IMPORTANT]
33+
> In delegated scenarios with work or school accounts, the signed-in user must be assigned a supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) or a custom role with a supported role permission. The following least privileged roles are supported for this operation.
34+
> - Application Administrator
35+
> - Cloud Application Administrator
36+
> - Global Reader
37+
> - Reports Reader
38+
> - Security Administrator
39+
> - Security Operator
40+
> - Security Reader
41+
42+
## HTTP request
43+
44+
<!-- {
45+
"blockType": "ignored"
46+
}
47+
-->
48+
``` http
49+
GET /reports/azureADPremiumLicenseInsight
50+
```
51+
52+
## Optional query parameters
53+
54+
This method supports the `$select` OData query parameter to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
55+
56+
## Request headers
57+
58+
|Name|Description|
59+
|:---|:---|
60+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
61+
62+
## Request body
63+
64+
Don't supply a request body for this method.
65+
66+
## Response
67+
68+
If successful, this method returns a `200 OK` response code and an [azureADPremiumLicenseInsight](../resources/azureadpremiumlicenseinsight.md) object in the response body.
69+
70+
## Examples
71+
72+
### Request
73+
74+
The following example shows a request.
75+
<!-- {
76+
"blockType": "request",
77+
"name": "get_azureadpremiumlicenseinsight"
78+
}
79+
-->
80+
```msgraph-interactive
81+
GET https://graph.microsoft.com/beta/reports/azureADPremiumLicenseInsight
82+
```
83+
84+
85+
### Response
86+
87+
The following example shows the response.
88+
>**Note:** The response object shown here might be shortened for readability.
89+
<!-- {
90+
"blockType": "response",
91+
"truncated": true,
92+
"@odata.type": "microsoft.graph.azureADPremiumLicenseInsight"
93+
}
94+
-->
95+
``` http
96+
HTTP/1.1 200 OK
97+
Content-Type: application/json
98+
99+
{
100+
"id": "00000000-0000-0000-0000-000000000000",
101+
"entitledP1LicenseCount": 100,
102+
"entitledP2LicenseCount": 50,
103+
"entitledTotalLicenseCount": 150,
104+
"p1FeatureUtilizations": {
105+
"conditionalAccess": {
106+
"userCount": 85
107+
},
108+
"conditionalAccessGuestUsers": {
109+
"userCount": 12
110+
}
111+
},
112+
"p2FeatureUtilizations": {
113+
"riskBasedConditionalAccess": {
114+
"userCount": 30
115+
},
116+
"riskBasedConditionalAccessGuestUsers": {
117+
"userCount": 5
118+
}
119+
},
120+
"privateAccessFeatureUtilizations": {
121+
"privateAccess": {
122+
"userCount": 20
123+
}
124+
},
125+
"internetAccessFeatureUtilizations": {
126+
"internetAccess": {
127+
"userCount": 45
128+
},
129+
"internetAccessM365": {
130+
"userCount": 38
131+
}
132+
}
133+
}
134+
```

‎api-reference/beta/api/driveitem-get-content-format.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ The following values are valid for the **format** parameter:
4949
| Value | Description | Supported source extensions
5050
|:------|:-----------------------------------|---------------------------------
5151
| glb | Converts the item into GLB format | cool, fbx, obj, ply, stl, 3mf
52-
| html | Converts the item into HTML format | eml, md, msg
52+
| html | Converts the item into HTML format | loop, fluid, wbtx, whiteboard
5353
| jpg | Converts the item into JPG format | 3g2, 3gp, 3gp2, 3gpp, 3mf, ai, arw, asf, avi, bas, bash, bat, bmp, c, cbl, cmd, cool, cpp, cr2, crw, cs, css, csv, cur, dcm, dcm30, dic, dicm, dicom, dng, doc, docx, dwg, eml, epi, eps, epsf, epsi, epub, erf, fbx, fppx, gif, glb, h, hcp, heic, heif, htm, html, ico, icon, java, jfif, jpeg, jpg, js, json, key, log, m2ts, m4a, m4v, markdown, md, mef, mov, movie, mp3, mp4, mp4v, mrw, msg, mts, nef, nrw, numbers, obj, odp, odt, ogg, orf, pages, pano, pdf, pef, php, pict, pl, ply, png, pot, potm, potx, pps, ppsx, ppsxm, ppt, pptm, pptx, ps, ps1, psb, psd, py, raw, rb, rtf, rw1, rw2, sh, sketch, sql, sr2, stl, tif, tiff, ts, txt, vb, webm, wma, wmv, xaml, xbm, xcf, xd, xml, xpm, yaml, yml
5454
| pdf | Converts the item into PDF format | doc, docx, dot, dotx, dotm, dsn, dwg, eml, epub, fluidframework, form, htm, html, loop, loot, markdown, md, msg, note, odp, ods, odt, page, pps, ppsx, ppt, pptx, pulse, rtf, task, tif, tiff, wbtx, whiteboard, xls, xlsm, xlsx
5555

‎api-reference/beta/api/filestorage-list-deletedcontainers.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -115,7 +115,7 @@ Content-Type: application/json
115115
"@odata.type": "#microsoft.graph.fileStorageContainer",
116116
"id": "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z",
117117
"displayName": "My File Storage Container",
118-
"createdDateTime": "2021-11-24T15:41:52.347Z",
118+
"createdDateTime": "2021-11-24T15:41:52.347Z"
119119
}
120120
]
121121
}

‎api-reference/beta/api/filestoragecontainer-restore.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -114,7 +114,7 @@ Content-Type: application/json
114114
"id": "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z",
115115
"displayName": "My Application Storage Container",
116116
"containerTypeId": "91710488-5756-407f-9046-fbe5f0b4de73",
117-
"createdDateTime": "2021-11-24T15:41:52.347Z",
117+
"createdDateTime": "2021-11-24T15:41:52.347Z"
118118
}
119119
```
120120

0 commit comments

Comments
 (0)