List resource
Namespace: microsoft.graph
Important
APIs under the /beta
version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
Represents a list in a site. This resource contains the top level properties of the list, including template and field definitions.
Methods
Method | Return Type | Description |
---|---|---|
Get lists in a site | list collection | Get the collection of lists in a site. |
Create list | list | Create a new list in a site. |
Get list | list | Get the metadata for a list. |
Get recent activities | itemActivity collection | List the recent activities that took place on an item or under a hierarchy. |
Enumerate list items | listItem collection | Get the collection of listItems in a list. |
Update list item | listItem | Update the properties on a listItem. |
Delete list item | None | Delete a listItem from a list. |
Create list item | listItem | Create a new listItem in a list. |
Get websocket endpoint | subscription | Get near-real-time change notifications for a drive and list using socket.io. |
List operations | 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 of content type from site | 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. |
Properties
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. |
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. |
Relationships
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. |
subscriptions | subscription collection | The set of subscriptions on the list. |
JSON representation
The following is a JSON representation of the resource.
{
"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" },
"name": "String",
"parentReference": { "@odata.type": "microsoft.graph.itemReference" },
"sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
"system": "Boolean",
"webUrl": "String"
}
Feedback
Submit and view feedback for