Skip to content

Commit 8a9278d

Browse files
authored
Merge pull request #28694 from microsoftgraph/main
Merge to publish
2 parents 61f389f + 54213db commit 8a9278d

9 files changed

Lines changed: 90 additions & 60 deletions

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

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,9 @@ GET /drive/root:/{path and filename}:/content?format={format}
4242

4343
| Parameter | Type | Description |
4444
|:----------|:-------|:---------------------------------------------------------------|
45-
| _format_ | string | Specify the format the item's content should be downloaded as. |
45+
| format | String | Specify the format the item's content should be downloaded as. |
46+
| height | Int32 | The desired height of the converted image in pixels. Required when `format=jpg`. |
47+
| width | Int32 | The desired width of the converted image in pixels. Required when `format=jpg`. |
4648

4749
The following values are valid for the **format** parameter:
4850

api-reference/beta/resources/accesspackageapprovalstage.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,16 +20,25 @@ Used for the **stages** property of approval settings in an [access package assi
2020
## Properties
2121
|Property|Type|Description|
2222
|:---|:---|:---|
23+
|approverInformationVisibility|[approverInformationVisibility](#approverinformationvisibility-values)|Indicates whether approver information is visible to the requestor. The possible values are: `default`, `notVisible`, `visible`, `unknownFutureValue`.|
2324
|durationBeforeAutomaticDenial|Duration|The number of days that a request can be pending a response before it is automatically denied.|
2425
|durationBeforeEscalation|Duration|If escalation is required, the time a request can be pending a response from a primary approver.|
25-
|escalationApprovers|[subjectSet](../resources/subjectset.md) collection|If escalation is enabled and the primary approvers do not respond before the escalation time, the escalationApprovers are the users who will be asked to approve requests. |
26+
|escalationApprovers|[subjectSet](../resources/subjectset.md) collection|If escalation is enabled and the primary approvers don't respond before the escalation time, the escalationApprovers are the users who will be asked to approve requests. |
2627
|fallbackEscalationApprovers|[subjectSet](../resources/subjectset.md) collection|The subjects, typically users, who are the fallback escalation approvers.|
2728
|fallbackPrimaryApprovers|[subjectSet](../resources/subjectset.md) collection|The subjects, typically users, who are the fallback primary approvers.|
28-
|approverInformationVisibility|[approverInformationVisibility](approverInformationVisibility.md)|Indicates whether approver information is visible to the requestor. The possible values are: `no`, `yes`, `default`, `unknownFutureValue`.|
2929
|isApproverJustificationRequired|Boolean|Indicates whether the approver is required to provide a justification for approving a request.|
3030
|isEscalationEnabled|Boolean|If `true`, then one or more **escalationApprovers** are configured in this approval stage.|
3131
|primaryApprovers|[subjectSet](../resources/subjectset.md) collection|The subjects, typically users, who will be asked to approve requests. A collection of [singleUser](singleuser.md), [groupMembers](groupmembers.md), [requestorManager](requestormanager.md), [internalSponsors](internalsponsors.md), [externalSponsors](externalsponsors.md), or [targetUserSponsors](targetusersponsors.md).|
3232

33+
### approverInformationVisibility values
34+
35+
| Member | Description |
36+
|:-------------------|:-------------------------------------------------------------------|
37+
| default | Use the default system setting for approver information visibility.|
38+
| notVisible | Approver information isn't visible to the requestor. |
39+
| visible | Approver information is visible to the requestor. |
40+
| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
41+
3342
## Relationships
3443
None.
3544

api-reference/beta/resources/approvalstage.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ In PIM, defines the settings of the approval stages in a [unifiedRoleManagementP
2323
| Property | Type | Description |
2424
| :--------------------------- | :------------------------ | :---------- |
2525
| approvalStageTimeOutInDays |Int32 | The number of days that a request can be pending a response before it is automatically denied. |
26-
| approverInformationVisibility|[approverInformationVisibility](approverInformationVisibility.md) | Indicates whether approver information is visible to the requestor. The possible values are: `no`, `yes`, `default`, `unknownFutureValue`. |
26+
| approverInformationVisibility|[approverInformationVisibility](accesspackageapprovalstage.md#approverinformationvisibility-values) | Indicates whether approver information is visible to the requestor. The possible values are: `default`, `notVisible`, `visible`, `unknownFutureValue`. |
2727
| isApproverJustificationRequired |Boolean | Indicates whether the approver is required to provide a justification for approving a request. |
2828
| isEscalationEnabled |Boolean | If true, then one or more escalation approvers are configured in this approval stage. |
2929
| escalationTimeInMinutes |Int32 | If escalation is required, the time a request can be pending a response from a primary approver. |

api-reference/beta/resources/approverinformationvisibility.md

Lines changed: 0 additions & 41 deletions
This file was deleted.

api-reference/beta/resources/enums.md

Lines changed: 0 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -969,15 +969,6 @@ Namespace: microsoft.graph
969969
| remoteDesktopToken |
970970
| refreshToken |
971971

972-
### approverInformationVisibility values
973-
974-
| Member |
975-
| ---- |
976-
| no |
977-
| yes |
978-
| default |
979-
| unknownFutureValue |
980-
981972
### protocolType values
982973

983974
| Member |

api-reference/v1.0/api/driveitem-get-content-format.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,14 +40,17 @@ GET /drive/root:/{path and filename}:/content?format={format}
4040

4141
| Parameter | Type | Description |
4242
|:----------|:-------|:---------------------------------------------------------------|
43-
| _format_ | string | Specify the format the item's content should be downloaded as. |
43+
| format | String | Specify the format the item's content should be downloaded as. |
44+
| height | Int32 | The desired height of the converted image in pixels. Required when `format=jpg`. |
45+
| width | Int32 | The desired width of the converted image in pixels. Required when `format=jpg`. |
4446

4547
### Format options
4648

4749
The following values are valid for the **format** parameter:
4850

4951
| Format value | Description | Supported source extensions
5052
|:-------------|:-----------------------------------|----------------------------
53+
| 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
5154
| 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
5255
| html | Converts the item into HTML format.| loop, fluid, wbtx, whiteboard
5356

changelog/Microsoft.FileServices.json

Lines changed: 56 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,57 @@
11
{
22
"changelog": [
3+
{
4+
"ChangeList": [
5+
{
6+
"Id": "e7a4527a-30ea-4877-9cea-e7340b1f7877",
7+
"ApiChange": "Parameter",
8+
"ChangedApiName": "height",
9+
"ChangeType": "Addition",
10+
"Description": "Added the **height** query parameter to the [API to download a file in another format](https://learn.microsoft.com/en-us/graph/api/driveitem-get-content-format?view=graph-rest-beta).",
11+
"Target": "driveItem-get-content-format"
12+
},
13+
{
14+
"Id": "e7a4527a-30ea-4877-9cea-e7340b1f7877",
15+
"ApiChange": "Parameter",
16+
"ChangedApiName": "width",
17+
"ChangeType": "Addition",
18+
"Description": "Added the **width** query parameter to the [API to download a file in another format](https://learn.microsoft.com/en-us/graph/api/driveitem-get-content-format?view=graph-rest-beta).",
19+
"Target": "driveItem-get-content-format"
20+
}
21+
],
22+
"Id": "e7a4527a-30ea-4877-9cea-e7340b1f7877",
23+
"Cloud": "Prod",
24+
"Version": "beta",
25+
"CreatedDateTime": "2026-04-17T23:41:39.1409717Z",
26+
"WorkloadArea": "Files",
27+
"SubArea": ""
28+
},
29+
{
30+
"ChangeList": [
31+
{
32+
"Id": "8d880708-d68a-4a9a-b72f-954b6b86e20b",
33+
"ApiChange": "Parameter",
34+
"ChangedApiName": "height",
35+
"ChangeType": "Addition",
36+
"Description": "Added the **height** query parameter to the [API to download a file in another format](https://learn.microsoft.com/en-us/graph/api/driveitem-get-content-format?view=graph-rest-1.0).",
37+
"Target": "driveItem-get-content-format"
38+
},
39+
{
40+
"Id": "8d880708-d68a-4a9a-b72f-954b6b86e20b",
41+
"ApiChange": "Parameter",
42+
"ChangedApiName": "width",
43+
"ChangeType": "Addition",
44+
"Description": "Added the **width** query parameter to the [API to download a file in another format](https://learn.microsoft.com/en-us/graph/api/driveitem-get-content-format?view=graph-rest-1.0).",
45+
"Target": "driveItem-get-content-format"
46+
}
47+
],
48+
"Id": "8d880708-d68a-4a9a-b72f-954b6b86e20b",
49+
"Cloud": "Prod",
50+
"Version": "v1.0",
51+
"CreatedDateTime": "2026-04-17T23:41:39.1409717Z",
52+
"WorkloadArea": "Files",
53+
"SubArea": ""
54+
},
355
{
456
"ChangeList": [
557
{
@@ -175,15 +227,15 @@
175227
"Target": "drive"
176228
},
177229
{
178-
"Id": "cfd328aa-a83a-49ed-982e-f25c37a312d2",
230+
"Id": "3f2504e0-4f89-11d3-9a0c-0305e82c3301",
179231
"ApiChange": "Annotation",
180232
"ChangedApiName": "Org.OData.Core.V1.Revisions",
181233
"ChangeType": "Deprecation",
182234
"Description": "Removed the **Org.OData.Core.V1.Revisions** resource.",
183235
"Target": "recent"
184236
},
185237
{
186-
"Id": "cfd328aa-a83a-49ed-982e-f25c37a312d2",
238+
"Id": "3f2504e0-4f89-11d3-9a0c-0305e82c3301",
187239
"ApiChange": "Annotation",
188240
"ChangedApiName": "Org.OData.Core.V1.Revisions",
189241
"ChangeType": "Deprecation",
@@ -217,15 +269,15 @@
217269
"Target": "drive"
218270
},
219271
{
220-
"Id": "f3a53290-debd-4e11-a89e-fa38a7063991",
272+
"Id": "e3a7f8c1-9d42-4b6a-8f3e-7c2d1a9b5f84",
221273
"ApiChange": "Annotation",
222274
"ChangedApiName": "Org.OData.Core.V1.Revisions",
223275
"ChangeType": "Deprecation",
224276
"Description": "Removed the **Org.OData.Core.V1.Revisions** resource.",
225277
"Target": "recent"
226278
},
227279
{
228-
"Id": "f3a53290-debd-4e11-a89e-fa38a7063991",
280+
"Id": "e3a7f8c1-9d42-4b6a-8f3e-7c2d1a9b5f84",
229281
"ApiChange": "Annotation",
230282
"ChangedApiName": "Org.OData.Core.V1.Revisions",
231283
"ChangeType": "Deprecation",

concepts/whats-new-overview.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,8 @@ For details about previous updates to Microsoft Graph, see [Microsoft Graph what
3232

3333
### Files
3434

35-
Use the [List activities](/graph/api/itemactivity-list) API to retrieve recent activities that took place on a [drive](/graph/api/resources/drive), [list](/graph/api/resources/list), item, or within an item hierarchy.
35+
- Use the **height** and **width** parameters to [download a file in another format](/graph/api/driveitem-get-content-format) when `format=jpg`.
36+
- Use the [List activities](/graph/api/itemactivity-list) API to retrieve recent activities that took place on a [drive](/graph/api/resources/drive), [list](/graph/api/resources/list), item, or within an item hierarchy.
3637

3738
### Identity and access | Governance
3839

@@ -65,6 +66,14 @@ Added the **deprecationDate** property to the [applicationTemplate](/graph/api/r
6566
- [Update](/graph/api/mailboxprotectionunit-update?view=graph-rest-beta&preserve-view=true) the **billingPolicyId** property on a [mailboxProtectionUnit](/graph/api/resources/mailboxprotectionunit?view=graph-rest-beta&preserve-view=true) object.
6667
- [Update](/graph/api/siteprotectionunit-update?view=graph-rest-beta&preserve-view=true) the **billingPolicyId** property on a [siteProtectionUnit](/graph/api/resources/siteprotectionunit?view=graph-rest-beta&preserve-view=true) object.
6768

69+
### Identity and access | Governance
70+
71+
- Use `default`, `notVisible`, and `visible` as supported values for the **approverInformationVisibility** property of the [accessPackageApprovalStage](/graph/api/resources/accesspackageapprovalstage?view=graph-rest-beta&preserve-view=true) and [approvalStage](/graph/api/resources/approvalstage?view=graph-rest-beta&preserve-view=true) resources to indicate whether approver information is visible to the requestor.
72+
73+
### Files
74+
75+
- Use the **height** and **width** query parameters on the [driveItem content conversion API](/graph/api/driveitem-get-content-format?view=graph-rest-beta&preserve-view=true) to download a file in another format when `format=jpg`.
76+
6877
### Identity and access | Identity and sign-in
6978

7079
Added the **blueprintId** and **source** agent-descriptive properties to [agentRiskDetection](/graph/api/resources/agentriskdetection?view=graph-rest-beta&preserve-view=true) and [riskyAgent](/graph/api/resources/riskyagent?view=graph-rest-beta&preserve-view=true) resources.

redirects/.openpublishing.redirection.2026-04.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,10 @@
11
{
22
"redirections": [
3+
{
4+
"source_path_from_root": "/api-reference/beta/resources/approverinformationvisibility.md",
5+
"redirect_url": "https://learn.microsoft.com/en-us/graph/api/resources/accesspackageapprovalstage?view=graph-rest-beta#approverinformationvisibility-values",
6+
"redirect_document_id": false
7+
},
38
{
49
"source_path_from_root": "/api-reference/beta/api/activities-list.md",
510
"redirect_url": "https://learn.microsoft.com/en-us/graph/api/itemactivity-list?view=graph-rest-beta",

0 commit comments

Comments
 (0)