Skip to content

Commit 4b1ea8d

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 2967a0f + f003200 commit 4b1ea8d

6 files changed

Lines changed: 71 additions & 105 deletions

File tree

‎.github/prompts/author-api-docs/public-preview.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -324,8 +324,8 @@ When API changes involve adding new properties or relationships to an existing r
324324

325325
5. **Optional query parameters section (for GET/LIST files):**
326326
- Update the boilerplate text to specify whether all, some (which ones), or no OData query parameters are supported
327-
- Format OData query parameters in Markdown code font: `$filter`, `$select`, `$expand`, `$top`, `$orderby`, `$search`
328-
- Document supported operators for `$filter` using format: `$filter` (`eq`, `ne`)
327+
- Format OData query parameters in Markdown code font: `$filter` (`eq`, `ne`), `$select`, `$expand`, `$top`, `$orderby`, `$search`
328+
- `$filter` must include supported operators, which is a summary of callouts within all property descriptions on the resource page.
329329

330330
6. **Request headers section:**
331331
- Keep unchanged

‎api-reference/beta/api/driveitem-removeretentionlabel.md‎

Lines changed: 10 additions & 71 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ Choose the permission or permissions marked as least privileged for this API. Us
2828
[!INCLUDE [permissions-table](../includes/permissions/driveitem-removeretentionlabel-permissions.md)]
2929

3030
> [!NOTE]
31-
> * `Sites.FullControl.All` is the least privileged permission required to remove retention labels that classify the content as records.
31+
> * `Sites.FullControl.All` is the least privileged permission required to remove retention labels that classify the content as records in SharePoint Online and OneDrive.
3232
> * The removal of a *Record* retention label isn't supported when using app-only authentication. This operation requires a delegated user context.
3333
3434
[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-driveitem-permissions.md)]
@@ -60,23 +60,16 @@ Don't supply a request body for this method.
6060

6161
If successful, this method returns a `204 No Content` response code. It doesn't return anything in the response body.
6262

63-
### Error responses
64-
65-
| Error code | HTTP status | Description |
66-
|:-----------------|:------------|:-------------------------------------------------------------------|
67-
| notSupported | 400 | App-only callers aren't supported for SharePoint Embedded containers. |
68-
| accessDenied | 403 | The caller doesn't have permission to remove the retention label. |
69-
| itemNotFound | 404 | The item can't be found or is no longer accessible. |
70-
7163
## Examples
7264

7365
### Example 1: Remove the retention label from a driveItem
74-
The following example shows how to remove the retential label from a **driveItem** object.
66+
67+
The following example shows how to remove the retention label from a **driveItem** object.
68+
7569
#### Request
7670

7771
The following example shows a request.
7872

79-
# [HTTP](#tab/http)
8073
<!-- {
8174
"blockType": "request",
8275
"name": "driveItem_removeRetentionLabel",
@@ -87,35 +80,6 @@ The following example shows a request.
8780
```http
8881
DELETE https://graph.microsoft.com/beta/drives/b!t18F8ybsHUq1z3LTz8xvZqP8zaSWjkFNhsME-Fepo75dTf9vQKfeRblBZjoSQrd7/items/01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK/retentionLabel
8982
```
90-
91-
# [C#](#tab/csharp)
92-
[!INCLUDE [sample-code](../includes/snippets/csharp/driveitem-removeretentionlabel-csharp-snippets.md)]
93-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
94-
95-
# [Go](#tab/go)
96-
[!INCLUDE [sample-code](../includes/snippets/go/driveitem-removeretentionlabel-go-snippets.md)]
97-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
98-
99-
# [Java](#tab/java)
100-
[!INCLUDE [sample-code](../includes/snippets/java/driveitem-removeretentionlabel-java-snippets.md)]
101-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
102-
103-
# [JavaScript](#tab/javascript)
104-
[!INCLUDE [sample-code](../includes/snippets/javascript/driveitem-removeretentionlabel-javascript-snippets.md)]
105-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
106-
107-
# [PHP](#tab/php)
108-
[!INCLUDE [sample-code](../includes/snippets/php/driveitem-removeretentionlabel-php-snippets.md)]
109-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
110-
111-
# [PowerShell](#tab/powershell)
112-
[!INCLUDE [sample-code](../includes/snippets/powershell/driveitem-removeretentionlabel-powershell-snippets.md)]
113-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
114-
115-
# [Python](#tab/python)
116-
[!INCLUDE [sample-code](../includes/snippets/python/driveitem-removeretentionlabel-python-snippets.md)]
117-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
118-
11983
---
12084

12185
#### Response
@@ -132,10 +96,13 @@ HTTP/1.1 204 No Content
13296
```
13397

13498
### Example 2: Remove the retention label from a driveItem that fails due to insufficient permissions
99+
135100
The following example shows how to remove the retention label from a **driveItem** object that fails due to insufficient permissions.
101+
136102
#### Request
103+
137104
The following example shows a request.
138-
# [HTTP](#tab/http)
105+
139106
<!-- {
140107
"blockType": "request",
141108
"name": "driveItem_removeRetentionLabel_spe_permissions_error",
@@ -146,35 +113,6 @@ The following example shows a request.
146113
```http
147114
DELETE https://graph.microsoft.com/beta/drives/b!t18F8ybsHUq1z3LTz8xvZqP8zaSWjkFNhsME-Fepo75dTf9vQKfeRblBZjoSQrd7/items/01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK/retentionLabel
148115
```
149-
150-
# [C#](#tab/csharp)
151-
[!INCLUDE [sample-code](../includes/snippets/csharp/driveitem-removeretentionlabel-spe-permissions-error-csharp-snippets.md)]
152-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
153-
154-
# [Go](#tab/go)
155-
[!INCLUDE [sample-code](../includes/snippets/go/driveitem-removeretentionlabel-spe-permissions-error-go-snippets.md)]
156-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
157-
158-
# [Java](#tab/java)
159-
[!INCLUDE [sample-code](../includes/snippets/java/driveitem-removeretentionlabel-spe-permissions-error-java-snippets.md)]
160-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
161-
162-
# [JavaScript](#tab/javascript)
163-
[!INCLUDE [sample-code](../includes/snippets/javascript/driveitem-removeretentionlabel-spe-permissions-error-javascript-snippets.md)]
164-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
165-
166-
# [PHP](#tab/php)
167-
[!INCLUDE [sample-code](../includes/snippets/php/driveitem-removeretentionlabel-spe-permissions-error-php-snippets.md)]
168-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
169-
170-
# [PowerShell](#tab/powershell)
171-
[!INCLUDE [sample-code](../includes/snippets/powershell/driveitem-removeretentionlabel-spe-permissions-error-powershell-snippets.md)]
172-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
173-
174-
# [Python](#tab/python)
175-
[!INCLUDE [sample-code](../includes/snippets/python/driveitem-removeretentionlabel-spe-permissions-error-python-snippets.md)]
176-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
177-
178116
---
179117

180118
#### Response
@@ -191,8 +129,9 @@ Content-Type: application/json
191129
192130
{
193131
"error": {
132+
"@odata.type": "microsoft.graph.error",
194133
"code": "accessDenied",
195-
"message": "Access Denied: Do not have enough permission.",
134+
"message": "Access denied. You do not have sufficient permissions to perform this action.",
196135
"innerError": {
197136
"request-id": "12345678-1234-1234-1234-123456789012",
198137
"date": "2025-02-03T10:30:00"

‎api-reference/beta/api/identitygovernance-workflow-cancelprocessing.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,8 @@ Namespace: microsoft.graph.identityGovernance
1616

1717
Cancel one or more [workflow](../resources/identitygovernance-workflow.md) runs that are currently in `queued` or `inProgress` status. Currently limited to canceling one run per request.
1818

19+
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
20+
1921
## Permissions
2022

2123
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).

‎api-reference/beta/config/link-validation-config.json‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,7 @@
4141
"/viva",
4242
"/windows",
4343
"/windows-hardware",
44+
"/unified-secops",
4445
"/universal-print"
4546
]
4647
}

‎api-reference/v1.0/api/driveitem-removeretentionlabel.md‎

Lines changed: 55 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,18 @@
11
---
22
title: "driveItem: removeRetentionLabel"
3-
description: "Remove a retention label from a driveItem."
3+
description: "Remove the retention label from a driveItem."
44
author: "kyracatwork"
55
ms.localizationpriority: medium
66
ms.subservice: "onedrive"
77
doc_type: apiPageType
8-
ms.date: 11/06/2025
8+
ms.date: 03/20/2026
99
---
1010

1111
# driveItem: removeRetentionLabel
1212

1313
Namespace: microsoft.graph
1414

15-
Remove a retention label from a [driveItem](../resources/driveitem.md).
15+
Remove the retention label from a [driveItem](../resources/driveitem.md). This operation clears the retention label and all associated retention settings enforced on the item.
1616

1717
For information about retention labels from an administrator's perspective, see [Use retention labels to manage the lifecycle of documents stored in SharePoint](/microsoft-365/compliance/auto-apply-retention-labels-scenario).
1818

@@ -26,7 +26,8 @@ Choose the permission or permissions marked as least privileged for this API. Us
2626
[!INCLUDE [permissions-table](../includes/permissions/driveitem-removeretentionlabel-permissions.md)]
2727

2828
> [!NOTE]
29-
> `Sites.FullControl.All` is the least privileged permission required to remove retention labels that classify the content as records.
29+
> * `Sites.FullControl.All` is the least privileged permission required to remove retention labels that classify the content as records in SharePoint Online and OneDrive.
30+
> * The removal of a *Record* retention label isn't supported when using app-only authentication. This operation requires a delegated user context.
3031
3132
[!INCLUDE [app-permissions](../includes/sharepoint-embedded-app-driveitem-permissions.md)]
3233

@@ -38,6 +39,9 @@ Choose the permission or permissions marked as least privileged for this API. Us
3839
-->
3940
```http
4041
DELETE /drives/{drive-id}/items/{item-id}/retentionLabel
42+
DELETE /groups/{group-id}/drive/items/{item-id}/retentionLabel
43+
DELETE /me/drive/items/{item-id}/retentionLabel
44+
DELETE /users/{user-id}/drive/items/{item-id}/retentionLabel
4145
```
4246

4347
## Request headers
@@ -56,11 +60,14 @@ If successful, this method returns a `204 No Content` response code. It doesn't
5660

5761
## Examples
5862

59-
### Request
63+
### Example 1: Remove the retention label from a driveItem
64+
65+
The following example shows how to remove the retention label from a **driveItem** object.
66+
67+
#### Request
6068

6169
The following example shows a request.
6270

63-
# [HTTP](#tab/http)
6471
<!-- {
6572
"blockType": "request",
6673
"name": "driveItem_removeRetentionLabel",
@@ -71,46 +78,62 @@ The following example shows a request.
7178
```http
7279
DELETE https://graph.microsoft.com/v1.0/drives/b!t18F8ybsHUq1z3LTz8xvZqP8zaSWjkFNhsME-Fepo75dTf9vQKfeRblBZjoSQrd7/items/01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK/retentionLabel
7380
```
81+
---
7482

75-
# [C#](#tab/csharp)
76-
[!INCLUDE [sample-code](../includes/snippets/csharp/driveitem-removeretentionlabel-csharp-snippets.md)]
77-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
83+
#### Response
7884

79-
# [Go](#tab/go)
80-
[!INCLUDE [sample-code](../includes/snippets/go/driveitem-removeretentionlabel-go-snippets.md)]
81-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
85+
The following example shows the response.
8286

83-
# [Java](#tab/java)
84-
[!INCLUDE [sample-code](../includes/snippets/java/driveitem-removeretentionlabel-java-snippets.md)]
85-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
87+
<!-- {
88+
"blockType": "response",
89+
"truncated": true
90+
} -->
8691

87-
# [JavaScript](#tab/javascript)
88-
[!INCLUDE [sample-code](../includes/snippets/javascript/driveitem-removeretentionlabel-javascript-snippets.md)]
89-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
92+
```http
93+
HTTP/1.1 204 No Content
94+
```
9095

91-
# [PHP](#tab/php)
92-
[!INCLUDE [sample-code](../includes/snippets/php/driveitem-removeretentionlabel-php-snippets.md)]
93-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
96+
### Example 2: Remove the retention label from a driveItem that fails due to insufficient permissions
9497

95-
# [PowerShell](#tab/powershell)
96-
[!INCLUDE [sample-code](../includes/snippets/powershell/driveitem-removeretentionlabel-powershell-snippets.md)]
97-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
98+
The following example shows how to remove the retention label from a **driveItem** object that fails due to insufficient permissions.
9899

99-
# [Python](#tab/python)
100-
[!INCLUDE [sample-code](../includes/snippets/python/driveitem-removeretentionlabel-python-snippets.md)]
101-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
100+
#### Request
102101

103-
---
102+
The following example shows a request.
104103

105-
### Response
104+
<!-- {
105+
"blockType": "request",
106+
"name": "driveItem_removeRetentionLabel_insufficientPermissions",
107+
"sampleKeys": ["b!t18F8ybsHUq1z3LTz8xvZqP8zaSWjkFNhsME-Fepo75dTf9vQKfeRblBZjoSQrd7", "01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK"]
108+
}
109+
-->
106110

107-
The following example shows the response.
111+
```http
112+
DELETE https://graph.microsoft.com/v1.0/drives/b!t18F8ybsHUq1z3LTz8xvZqP8zaSWjkFNhsME-Fepo75dTf9vQKfeRblBZjoSQrd7/items/01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK/retentionLabel
113+
```
114+
---
108115

116+
#### Response
117+
The following example shows the response.
109118
<!-- {
110119
"blockType": "response",
111-
"truncated": true
120+
"truncated": true,
121+
"@odata.type": "microsoft.graph.publicError"
112122
} -->
113123

114124
```http
115-
HTTP/1.1 204 No Content
125+
HTTP/1.1 403 Forbidden
126+
Content-Type: application/json
127+
128+
{
129+
"error": {
130+
"@odata.type": "microsoft.graph.publicError",
131+
"code": "accessDenied",
132+
"message": "Access denied. You do not have sufficient permissions to perform this action.",
133+
"innerError": {
134+
"request-id": "12345678-1234-1234-1234-123456789012",
135+
"date": "2025-02-03T10:30:00"
136+
}
137+
}
138+
}
116139
```

‎api-reference/v1.0/config/link-validation-config.json‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,7 @@
4040
"/viva",
4141
"/windows",
4242
"/windows-hardware",
43+
"/unified-secops",
4344
"/universal-print"
4445
]
4546
}

0 commit comments

Comments
 (0)