Create a saved view

POST

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

POST

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

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

1 {
2   "view": {
3     "_id": "a1b2c3d4e5f6789012345678",
4     "spaceId": "space_987654321",
5     "definitionId": "def_123456789",
6     "name": "Customer Overview",
7     "isDefault": false,
8     "filterLogic": "(1 AND 2) OR 3",
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_123456"
34   }
35 }

Creates a saved table view for a definition within a space. Authorization: requires space:contribute on :spaceId — lacking it gives 403 (a caller without even space:read gets 404 first). Body: name (required), and optional fields[] ({ fieldKey, isVisible, width, position }), filters[] ({ fieldKey, subField?, operand, value }), sorts[] ({ fieldKey, direction }), filterLogic. Server sets isDefault/spaceId/definitionId. Invalid name/fields/operands → 422 validation_failed. Returns 201 with { view }.

Creates a saved table view for a definition within a space. Authorization: requires `space:contribute` on `:spaceId` — lacking it gives **403** (a caller without even `space:read` gets 404 first). Body: `name` (required), and optional `fields[]` (`{ fieldKey, isVisible, width, position }`), `filters[]` (`{ fieldKey, subField?, operand, value }`), `sorts[]` (`{ fieldKey, direction }`), `filterLogic`. Server sets `isDefault`/`spaceId`/`definitionId`. Invalid name/fields/operands → 422 `validation_failed`. Returns 201 with `{ view }`.

Authentication

AuthorizationBearer

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

Path parameters

spaceIdstringRequired

definitionIdstringRequired

Request

isDefault, spaceId and definitionId are server-set.

namestringRequired1-200 characters

fieldslist of objectsOptional

filterslist of objectsOptional

sortslist of objectsOptional

filterLogicstringOptional>=1 character

Response

The created view.

viewobject

Errors

403

Forbidden Error

422

Unprocessable Entity Error