Skip to content

bundle-update.md

Latest commit

 

History

History
141 lines (100 loc) · 4.63 KB

bundle-update.md

File metadata and controls

141 lines (100 loc) · 4.63 KB
author spgraph-docs-team
title Update bundle
description Update a bundle of driveItems.
ms.localizationpriority medium
ms.subservice sharepoint
doc_type apiPageType
ms.date 04/05/2024

Update bundle

Namespace: microsoft.graph

[!INCLUDE beta-disclaimer]

Update the metadata for a bundle of driveItems by ID. You can only update the following metadata:

  • Bundle name
  • Album coverImageItemId (if applicable)

Any other change requests are ignored.

[!INCLUDE national-cloud-support]

Permissions

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. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.

[!INCLUDE permissions-table]

HTTP request

PATCH /drive/items/{bundle-id}

Request headers

Name Description
Authorization Bearer {token}. Required. Learn more about authentication and authorization.
if-match eTag. Optional. If this request header is included and the eTag provided doesn't match the current eTag on the bundle, a 412 Precondition Failed response is returned.

Request body

In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that didn't change.

Response

If successful, this method returns a driveItem resource that represents the updated bundle in the response body.

Read the Error Responses article for more info about how errors are returned.

Example

This example renames a bundle.

Request

The following example shows a request.

HTTP

PATCH https://graph.microsoft.com/beta/drive/items/{bundle-id}
Content-Type: application/json

{
  "name": "Shared legal agreements"
}

C#

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Go

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Java

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

JavaScript

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PHP

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PowerShell

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Python

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Response

The following example shows the response.

Note: The response object shown here might be shortened for readability.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id": "0123456789abc",
  "name": "Shared legal agreements",
  "bundle": {
    "childCount": 3
  }
}