Skip to content

Commit a08d149

Browse files
MSFT-AndreaMSFT-Andrea
authored
Merge branch 'main' into notes-api-beta-docs
2 parents 5f92d50 + d4f84be commit a08d149

542 files changed

Lines changed: 9008 additions & 1334 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/agentidentity-post.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ POST /servicePrincipals/microsoft.graph.agentIdentity
3838
| Content-Type | application/json. Required. |
3939

4040
## Request body
41-
In the request body, supply a JSON representation of a [agentIdentity](../resources/agentidentity.md) object. The request body must contain **displayName**, **agentIdentityBlueprintAppId**, and a valid **sponsor** reference.
41+
In the request body, supply a JSON representation of a [agentIdentity](../resources/agentidentity.md) object. The request body must contain **displayName**, **agentIdentityBlueprintId**, and a valid **sponsor** reference.
4242

4343
## Response
4444

@@ -82,9 +82,9 @@ Content-type: application/json
8282
"@odata.type": "#microsoft.graph.agentIdentity",
8383
"id": "59e617e5-e447-4adc-8b88-00af644d7c92",
8484
"createdByAppId": "f98c895e-6ce2-4f5b-a31b-da7e48f25daa",
85-
"displayName": "My Agent Identit",
85+
"displayName": "My Agent Identity",
8686
"servicePrincipalType": "ServiceIdentity",
8787
"tags": [],
8888
"agentIdentityBlueprintId": "65415bb1-9267-4313-bbf5-ae259732ee12"
8989
}
90-
```
90+
```

‎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: 104 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,104 @@
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+
<!-- { "blockType": "permissions", "name": "approvedclientapp_update" } -->
24+
[!INCLUDE [permissions-table](../includes/permissions/approvedclientapp-update-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+
PATCH /servicePrincipals/{id}/remoteDesktopSecurityConfiguration/approvedClientApps/{approvedClientAppId}
38+
PATCH /servicePrincipals(appId='{appId}')/remoteDesktopSecurityConfiguration/approvedClientApps/{approvedClientAppId}
39+
```
40+
41+
## Request headers
42+
43+
|Name|Description|
44+
|:---|:---|
45+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
46+
|Content-Type|application/json. Required.|
47+
48+
## Request body
49+
50+
[!INCLUDE [table-intro](../../includes/update-property-table-intro.md)]
51+
52+
53+
|Property|Type|Description|
54+
|:---|:---|:---|
55+
|displayName|String|Display name of the Client Application. Optional.|
56+
57+
58+
59+
## Response
60+
61+
If successful, this method returns a `200 OK` response code and an updated [approvedClientApp](../resources/approvedclientapp.md) object in the response body.
62+
63+
## Examples
64+
65+
### Request
66+
67+
The following example shows a request.
68+
<!-- {
69+
"blockType": "request",
70+
"name": "update_approvedclientapp"
71+
}
72+
-->
73+
``` http
74+
PATCH https://graph.microsoft.com/v1.0/servicePrincipals/00af5dfb-85da-4b41-a677-0c6b86dd34f8/remoteDesktopSecurityConfiguration/approvedClientApps/95bd8f3d-e166-c072-4e28-af935a6d237f
75+
Content-Type: application/json
76+
77+
{
78+
"@odata.type": "#microsoft.graph.approvedClientApp",
79+
"displayName": "Client App 1"
80+
}
81+
```
82+
83+
84+
### Response
85+
86+
The following example shows the response.
87+
>**Note:** The response object shown here might be shortened for readability.
88+
<!-- {
89+
"blockType": "response",
90+
"truncated": true,
91+
"@odata.type": "microsoft.graph.approvedClientApp"
92+
}
93+
-->
94+
``` http
95+
HTTP/1.1 200 OK
96+
Content-Type: application/json
97+
98+
{
99+
"@odata.type": "#microsoft.graph.approvedClientApp",
100+
"id": "95bd8f3d-e166-c072-4e28-af935a6d237f",
101+
"displayName": "Client App 1"
102+
}
103+
```
104+

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

Lines changed: 130 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,130 @@
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+
<!-- { "blockType": "permissions", "name": "azureadpremiumlicenseinsight_get" } -->
26+
[!INCLUDE [permissions-table](../includes/permissions/azureadpremiumlicenseinsight-get-permissions.md)]
27+
28+
> [!IMPORTANT]
29+
> 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.
30+
> - Application Administrator
31+
> - Cloud Application Administrator
32+
> - Global Reader
33+
> - Reports Reader
34+
> - Security Administrator
35+
> - Security Operator
36+
> - Security Reader
37+
38+
## HTTP request
39+
40+
<!-- {
41+
"blockType": "ignored"
42+
}
43+
-->
44+
``` http
45+
GET /reports/azureADPremiumLicenseInsight
46+
```
47+
48+
## Optional query parameters
49+
50+
This method supports the `$select` OData query parameter to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
51+
52+
## Request headers
53+
54+
|Name|Description|
55+
|:---|:---|
56+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
57+
58+
## Request body
59+
60+
Don't supply a request body for this method.
61+
62+
## Response
63+
64+
If successful, this method returns a `200 OK` response code and an [azureADPremiumLicenseInsight](../resources/azureadpremiumlicenseinsight.md) object in the response body.
65+
66+
## Examples
67+
68+
### Request
69+
70+
The following example shows a request.
71+
<!-- {
72+
"blockType": "request",
73+
"name": "get_azureadpremiumlicenseinsight"
74+
}
75+
-->
76+
```msgraph-interactive
77+
GET https://graph.microsoft.com/beta/reports/azureADPremiumLicenseInsight
78+
```
79+
80+
81+
### Response
82+
83+
The following example shows the response.
84+
>**Note:** The response object shown here might be shortened for readability.
85+
<!-- {
86+
"blockType": "response",
87+
"truncated": true,
88+
"@odata.type": "microsoft.graph.azureADPremiumLicenseInsight"
89+
}
90+
-->
91+
``` http
92+
HTTP/1.1 200 OK
93+
Content-Type: application/json
94+
95+
{
96+
"id": "00000000-0000-0000-0000-000000000000",
97+
"entitledP1LicenseCount": 100,
98+
"entitledP2LicenseCount": 50,
99+
"entitledTotalLicenseCount": 150,
100+
"p1FeatureUtilizations": {
101+
"conditionalAccess": {
102+
"userCount": 85
103+
},
104+
"conditionalAccessGuestUsers": {
105+
"userCount": 12
106+
}
107+
},
108+
"p2FeatureUtilizations": {
109+
"riskBasedConditionalAccess": {
110+
"userCount": 30
111+
},
112+
"riskBasedConditionalAccessGuestUsers": {
113+
"userCount": 5
114+
}
115+
},
116+
"privateAccessFeatureUtilizations": {
117+
"privateAccess": {
118+
"userCount": 20
119+
}
120+
},
121+
"internetAccessFeatureUtilizations": {
122+
"internetAccess": {
123+
"userCount": 45
124+
},
125+
"internetAccessM365": {
126+
"userCount": 38
127+
}
128+
}
129+
}
130+
```

‎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)