Get a collection of list revisions

get/lists/{listId}/revisions

Returns a collection of revisions for the specified list.

Request Samples

Response Samples


1{
2  "count": 5,
3  "start": 0,
4  "limit": 2,
5  "items": [
6    {
7      "id": "3659ea38-2618-4474-aeac-0bf6cfd3c322",
8      "listResourceId": "9ec45a61-774c-488e-99a0-03dfde70b966",
9      "creationTimeStamp": "2022-03-01T20:18:32Z",
10      "createdBy": "appUser1",
11      "description": "The A-list users",
12      "label": "corporate marketing",
13      "revision": 1
14    },
15    {
16      "id": "9b967566-6dcb-427f-93b3-8b9be1a945c9",
17      "listResourceId": "9ec45a61-774c-488e-99a0-03dfde70b966",
18      "creationTimeStamp": "2022-03-02T20:18:32Z",
19      "createdBy": "appUser1",
20      "description": "The A-list users V2",
21      "label": "corporate marketing V2",
22      "revision": 2
23    }
24  ]
25}

Path Parameters

Name	Type	Required	Description
listId	string	true	A universally unique identifier for a list.

Query Parameters

Name	Type	Required	Description
filter	string<filter-criteria>	false	The filter criteria for returned items. See Filtering in REST APIs.
limit	integer	false	The maximum number of items to return. The default value is '20'.
sortBy	string<sort-criteria>	false	A sort of the returned items. See Sorting in REST APIs.
start	integer	false	A zero-based offset of the first item to return. The default value is '0'.

Responses

Status	Meaning	Description
200	OK	The request succeeded.	Headers	Schema
400	Bad Request	The request was invalid.		Schema
403	Forbidden	The user did not have the necessary permissions.		Schema
404	Not Found	No item exists at the requested path.		Schema
500	Internal Server Error	The request could not be fulfilled because of an unexpected server error.		Schema