/v1/definitions/{key}/viewsSave a view of a page
Saves a view on a record page: its key (a slug), label (up to 80 characters), and the filter, sort and columnIds it restores. scope defaults to user, which is the caller's own private view; workspace makes it everyone's and needs a workspace admin. A key already used in that scope is a 409. This is the one write under a page's shape that an ordinary member may make, because a user view is theirs.
Access class: def:read.
Send request
Use the documented inputs to call this endpoint directly.
Parameters
Values are applied to the request and the example on the right.
Request body
application/jsonrequiredValues: "user" · "workspace"
Responses
the action's answer
{
"data": {
"columnIds": [
"string"
],
"crmUserId": 1,
"filter": {},
"id": "",
"key": "string",
"label": "string",
"position": 1,
"scope": "string",
"sort": {}
}
}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}