Skip to content

listitem-update.md

Latest commit

 

History

History
131 lines (94 loc) · 4.27 KB

listitem-update.md

File metadata and controls

131 lines (94 loc) · 4.27 KB
author spgraph-docs-team
title Update listItem
description Update the properties on a listItem.
ms.localizationpriority high
ms.subservice sharepoint
doc_type apiPageType
ms.date 03/06/2024

Update listItem

Namespace: microsoft.graph

Update the properties on a listItem.

[!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

Update the properties on a listItem.

PATCH /sites/{site-id}/lists/{list-id}/items/{item-id}

Update column values on a listItem.

PATCH /sites/{site-id}/lists/{list-id}/items/{item-id}/fields

Request headers

Name Description
Authorization Bearer {token}. Required. Learn more about authentication and authorization.
Content-Type application/json. Required.
if-match etag. If this request header is included and the eTag provided does not match the current eTag on the item, a 412 Precondition Failed response is returned and the item will not be updated.

Request body

In the request body, supply a JSON representation of a fieldValueSet specifying the fields to update.

Response

If successful, this method returns a 200 Ok response code and a fieldValueSet in the response body for the updated list item.

Example

The following example updates the Color and Quantity fields of the list item with new values. All other values on the listItem are left alone.

Request

HTTP

PATCH https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}/items/{item-id}/fields
Content-Type: application/json

{
    "Color": "Fuchsia",
    "Quantity": 934
}

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

HTTP/1.1 200 Ok
Content-type: application/json

{
  "Name": "Widget",
  "Color": "Fuchsia",
  "Quantity": 934
}