Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This resource represents an item in a SharePoint list.
Column values in the list are available through the fieldValueSet dictionary.
Tasks on a listItem
The following tasks are available for listItem resources.
All examples below are relative to a list, eg: https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}.
| Common task | HTTP method |
|---|---|
| Get | GET /items/{item-id} |
| Get column values | GET /items/{item-id}?expand=fields |
| Create | POST /items |
| Delete | DELETE /items/{item-id} |
| Update | PATCH /items/{item-id} |
| Update column values | PATCH /items/{item-id}/fields |
JSON representation
Here is a JSON representation of a listItem resource.
{
"contentType": { "@odata.type": "microsoft.graph.contentTypeInfo" },
"fields": { "@odata.type": "microsoft.graph.fieldValueSet" },
"sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
/* relationships */
"activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
"driveItem": { "@odata.type": "microsoft.graph.driveItem" },
"versions": [{"@odata.type": "microsoft.graph.listItemVersion"}],
/* inherited from baseItem */
"id": "string",
"name": "name of resource",
"createdBy": { "@odata.type": "microsoft.graph.identitySet" },
"createdDateTime": "timestamp",
"description": "description of resource",
"eTag": "string",
"lastModifiedBy": { "@odata.type": "microsoft.graph.identitySet" },
"lastModifiedDateTime": "timestamp",
"parentReference": { "@odata.type": "microsoft.graph.itemReference"},
"webUrl": "url"
}
Properties
The listItem resource has the following properties.
| Property name | Type | Description |
|---|---|---|
| contentType | contentTypeInfo | The content type of this list item |
The following properties are inherited from baseItem.
| Property name | Type | Description |
|---|---|---|
| id | string | The unique identifier of the item. Read-only. |
| name | string | The name / title of the item. |
| createdBy | identitySet | Identity of the creator of this item. Read-only. |
| createdDateTime | DateTimeOffset | The date and time the item was created. Read-only. |
| description | string | The descriptive text for the item. |
| eTag | string | ETag for the item. Read-only. |
| lastModifiedBy | identitySet | Identity of the last modifier of this item. Read-only. |
| lastModifiedDateTime | DateTimeOffset | The date and time the item was last modified. Read-only. |
| parentReference | itemReference | Parent information, if the item has a parent. Read-write. |
| sharepointIds | sharepointIds | Returns identifiers useful for SharePoint REST compatibility. Read-only. |
| webUrl | string (url) | URL that displays the item in the browser. Read-only. |
Relationships
The listItem resource has the following relationships to other resources.
| Relationship name | Type | Description |
|---|---|---|
| activities | itemActivity collection | The list of recent activities that took place on this item. |
| driveItem | driveItem | For document libraries, the driveItem relationship exposes the listItem as a driveItem |
| fields | fieldValueSet | The values of the columns set on this list item. |
| versions | listItemVersion collection | The list of previous versions of the list item. |