Update a saved view

PATCH

/spaces/:spaceId/objects/:definitionId/views/:viewId

PATCH

/spaces/:spaceId/objects/:definitionId/views/:viewId

$ curl -X PATCH https://api.cloudraker.com/spaces/spaceId/objects/definitionId/views/viewId \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{}'

1 {
2   "view": {
3     "_id": "view_9876543210abcdef",
4     "spaceId": "space_1234567890abcdef",
5     "definitionId": "def_abcdef1234567890",
6     "name": "Customer Overview",
7     "isDefault": true,
8     "filterLogic": "AND",
9     "fields": [
10       {
11         "fieldKey": "customerName",
12         "isVisible": true,
13         "width": 150,
14         "position": 1
15       }
16     ],
17     "filters": [
18       {
19         "fieldKey": "status",
20         "operand": "equals",
21         "subField": "value"
22       }
23     ],
24     "sorts": [
25       {
26         "fieldKey": "createdDate",
27         "direction": "asc",
28         "subField": "timestamp"
29       }
30     ],
31     "createdAt": "2024-01-15T09:30:00Z",
32     "updatedAt": "2024-01-15T09:30:00Z",
33     "createdBy": "user_1234abcd5678efgh"
34   }
35 }

Partially updates a saved view. Authorization: requires space:contribute on :spaceId — lacking it gives 403 (no space:read → 404). Strict body accepting any of name, fields[], filters[], sorts[], filterLogic. The seeded default view cannot be renamed → 400 default_view_not_renamable; unknown view → 404; invalid body → 422. Returns { view }.

Partially updates a saved view. Authorization: requires `space:contribute` on `:spaceId` — lacking it gives **403** (no `space:read` → 404). Strict body accepting any of `name`, `fields[]`, `filters[]`, `sorts[]`, `filterLogic`. The seeded default view cannot be renamed → 400 `default_view_not_renamable`; unknown view → 404; invalid body → 422. Returns `{ view }`.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

spaceIdstringRequired

definitionIdstringRequired

viewIdstringRequired

Request

Strict: unknown and server-controlled keys are rejected.

namestringOptional1-200 characters

fieldslist of objectsOptional

filterslist of objectsOptional

sortslist of objectsOptional

filterLogicstringOptional>=1 character

Response

The updated view.

viewobject

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error