Update a list's contents

put/lists/{listId}/contents

Internal-Use Only

Update the contents of a list synchronously via a JSON request body. An update can include the removal of list records.

A request body to update a list's contents must contain a collection of data record objects with key-value pairs that match the column definitions. To insert a record, all key and data column values are required. To update a record, all key column values are required and only the data column values that are provided are updated. To delete a record, all key column values are required.

The contents of the list can be edited only if the most recent revision is the deployed revision.

Request Samples

application/vnd.sas.collection+json
1

Response Samples

200
application/vnd.sas.listdata.list+json
1{
2  "id": "3659ea38-2618-4474-aeac-0bf6cfd3c322",
3  "version": 1,
4  "creationTimeStamp": "2022-03-01T20:18:32Z",
5  "modifiedTimeStamp": "2022-03-01T20:18:32Z",
6  "createdBy": "appUser1",
7  "modifiedBy": "appUser1",
8  "name": "list-a",
9  "description": "The A-list users",
10  "state": "developing",
11  "columns": [
12    {
13      "name": "userId",
14      "dataType": "string",
15      "position": 1,
16      "isKey": true,
17      "keyPosition": 1
18    },
19    {
20      "name": "firstName",
21      "dataType": "string",
22      "position": 2,
23      "isKey": false,
24      "keyPosition": 0
25    },
26    {
27      "name": "lastName",
28      "dataType": "string",
29      "position": 3,
30      "isKey": false,
31      "keyPosition": 0
32    },
33    {
34      "name": "salary",
35      "dataType": "number",
36      "position": 4,
37      "isKey": false,
38      "keyPosition": 0,
39      "dataMask": {
40        "name": "MaskStart",
41        "regex": ".(....$)|.",
42        "replace": "*$1",
43        "example": "****1234"
44      }
45    }
46  ],
47  "label": "corporate marketing",
48  "links": [
49    {
50      "href": "...",
51      "method": "...",
52      "rel": "...",
53      "uri": "..."
54    }
55  ]
56}

Path Parameters

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

Query Parameters

Name	Type	Required	Description
op	string	false	The operation type for the PUT method. Supported operations are 'upsert', which updates or inserts records, and 'delete', which deletes existing records. Default: upsert

Request Body

This schema defines a paginated collection of resources.

Name	Type	Required	Description
items	array [object]	false	The items on this page of the collection. Each item in this list is of a type that is listed as acceptable. Example: [{"x":"1","y":"1"},{"x":"2","y":"2"}]

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
409	Conflict	The request could not be completed due to a conflict with an existing resource.		Schema
500	Internal Server Error	The request could not be fulfilled because of an unexpected server error.		Schema