Skip to content

listitem-update.md

Latest commit

 

History

History
127 lines (89 loc) · 4.1 KB

listitem-update.md

File metadata and controls

127 lines (89 loc) · 4.1 KB
author spgraph-docs-team
description Update the properties on a listItem.
ms.date 09/11/2017
title Update a record in a SharePoint list
ms.localizationpriority medium
ms.subservice sharepoint
doc_type apiPageType

Update an item in a list

Namespace: microsoft.graph

[!INCLUDE beta-disclaimer]

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

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

Optional request headers

Name Value Description
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.

Example

Here is an example that updates the Color and Quantity fields of the list item with new values. All other values on the listItem are left alone.

HTTP

PATCH https://graph.microsoft.com/beta/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

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

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

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