| author | spgraph-docs-team |
|---|---|
| description | Represents a list in a site. |
| title | list resource type |
| ms.localizationpriority | medium |
| ms.subservice | sharepoint |
| doc_type | resourcePageType |
| ms.date | 07/22/2024 |
Namespace: microsoft.graph
[!INCLUDE beta-disclaimer]
Represents a list in a site. This resource contains the top level properties of the list, including template and field definitions.
| Method | Return Type | Description |
|---|---|---|
| Create | list | Create a new list in a site. |
| Get | list | Get the metadata for a list. |
| Get items | listItem collection | Get the collection of listItems in a list. |
| Get lists in a site | list collection | Get the collection of lists in a site. |
| List activities | itemActivity collection | List the recent activities that took place on a drive, list, item, or within an item hierarchy. |
| Create item | listItem | Create a new listItem in a list. |
| Update item | listItem | Update the properties on a listItem. |
| Delete item | None | Delete a listItem from a list. |
| Get websocket endpoint | subscription | Get near-real-time change notifications for a drive and list using socket.io. |
| List operations in a list | richLongRunningOperation collection | Get a list of rich long-running operations associated with a list. |
| List content types | contentType collection | Get the collection of contentType resources in a list. |
| Add copy to list | contentType | Add a copy of a contentType from a site to a list. |
| List columns | columnDefinition collection | Get the collection of columns, represented as columnDefinition objects, in a list. |
| Create column | columnDefinition | Create a column for a list with a request that specifies a columnDefinition. |
| List permissions | permission | Get a list of the permission objects associated with a list. |
| Create permission | permission | Get a list of the permission objects associated with a list. |
| Get permission | permission | Create a new permission object on a list. |
| Update permission | permission | Update a permission object on a list. |
| Delete permission | None | Delete a permission object on a list. |
| Property | Type | Description |
|---|---|---|
| createdBy | identitySet | Identity of the creator of this item. Read-only. Inherited from baseItem. |
| createdDateTime | DateTimeOffset | The date and time when the item was created. Read-only. Inherited from baseItem. |
| description | String | The descriptive text for the item. Inherited from baseItem. |
| displayName | String | The displayable title of the list. |
| eTag | String | ETag for the item. Inherited from baseItem. |
| id | String | The unique identifier of the item. Read-only. Inherited from baseItem. |
| itemCount | Int32 | The number of items in the list. Read-only. |
| lastModifiedBy | identitySet | Identity of the last modifier of this item. Read-only. Inherited from baseItem. |
| lastModifiedDateTime | DateTimeOffset | The date and time when the item was last modified. Read-only. Inherited from baseItem. |
| list | listInfo | Contains more details about the list. |
| name | String | The name of the item. Inherited from baseItem. |
| parentReference | itemReference | Parent information if the item has a parent. Read-write. Inherited from baseItem. |
| sharepointIds | sharepointIds | Returns identifiers useful for SharePoint REST compatibility. Read-only. |
| system | systemFacet | If present, indicates that the list is system-managed. Read-only. |
| webUrl | String | URL that displays the item in the browser. Read-only. Inherited from baseItem. |
| Relationship | Type | Description |
|---|---|---|
| activities | itemActivity collection | The recent activities that took place within this list. |
| columns | columnDefinition collection | The collection of field definitions for this list. |
| contentTypes | contentType collection | The collection of content types present in this list. |
| drive | drive | Allows access to the list as a drive resource with driveItems. Only present on document libraries. |
| items | listItem collection | All items contained in the list. |
| operations | richLongRunningOperation collection | The collection of long-running operations on the list. |
| permissions | permission collection | The set of permissions for the item. Read-only. Nullable. |
| subscriptions | subscription collection | The set of subscriptions on the list. |
The following JSON representation shows the resource type.
{
"createdBy": { "@odata.type": "microsoft.graph.identitySet" },
"createdDateTime": "String (timestamp)",
"description": "String",
"displayName": "String",
"eTag": "String",
"id": "String (identifier)",
"lastModifiedBy": { "@odata.type": "microsoft.graph.identitySet" },
"lastModifiedDateTime": "String (timestamp)",
"list": { "@odata.type": "microsoft.graph.listInfo" },
"itemCount": "Int32",
"name": "String",
"parentReference": { "@odata.type": "microsoft.graph.itemReference" },
"sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
"system": "Boolean",
"webUrl": "String"
}