Create a list revision

post/lists/{listId}/revisions

Internal-Use Only

Creates a new revision for a list.

Creating a new revision makes the previous revision immutable, meaning that its contents cannot be changed.

If the previous revision was the deployed revision, the new revision becomes the deployed revision because it inherits its contents from the previous revision.

If the list predates the addition of list revisions, revision 1 is created the first time this endpoint is called.

Request Samples

Response Samples

201
application/vnd.sas.listdata.list.revision+json
1{
2  "id": "3659ea38-2618-4474-aeac-0bf6cfd3c322",
3  "listResourceId": "9ec45a61-774c-488e-99a0-03dfde70b966",
4  "creationTimeStamp": "2022-03-01T20:18:32Z",
5  "createdBy": "appUser1",
6  "description": "The A-list users",
7  "label": "corporate marketing",
8  "revision": 1
9}

Path Parameters

Name	Type	Required	Description
listId	string	true	A universally unique identifier for a list. Examples: "3659ea38-2618-4474-aeac-0bf6cfd3c322"

Responses

Status	Meaning	Description
201	Created	A revision was created.	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