List saved views for a definition in a space

GET

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

GET

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

$ curl https://api.cloudraker.com/spaces/spaceId/objects/definitionId/views \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json"

1 {
2   "default": {
3     "_id": "view_8f3a2b1c9d4e",
4     "spaceId": "space_12345",
5     "definitionId": "def_67890",
6     "name": "Default View",
7     "isDefault": true,
8     "filterLogic": "AND",
9     "fields": [
10       {
11         "fieldKey": "customerName",
12         "isVisible": true,
13         "width": 200,
14         "position": 1
15       },
16       {
17         "fieldKey": "orderDate",
18         "isVisible": true,
19         "width": 150,
20         "position": 2
21       },
22       {
23         "fieldKey": "orderTotal",
24         "isVisible": true,
25         "width": 120,
26         "position": 3
27       }
28     ],
29     "filters": [
30       {
31         "fieldKey": "status",
32         "operand": "equals",
33         "subField": null,
34         "value": "active"
35       }
36     ],
37     "sorts": [
38       {
39         "fieldKey": "orderDate",
40         "direction": "desc",
41         "subField": null
42       }
43     ],
44     "createdAt": "2024-01-15T09:30:00Z",
45     "updatedAt": "2024-01-15T09:30:00Z",
46     "createdBy": "user_98765"
47   },
48   "views": [
49     {
50       "_id": "view_9a7b3c4d5e6f",
51       "spaceId": "space_12345",
52       "definitionId": "def_67890",
53       "name": "Recent Orders",
54       "isDefault": false,
55       "filterLogic": "OR",
56       "fields": [
57         {
58           "fieldKey": "customerName",
59           "isVisible": true,
60           "width": 180,
61           "position": 1
62         },
63         {
64           "fieldKey": "orderDate",
65           "isVisible": true,
66           "width": 160,
67           "position": 2
68         },
69         {
70           "fieldKey": "orderStatus",
71           "isVisible": true,
72           "width": 130,
73           "position": 3
74         }
75       ],
76       "filters": [
77         {
78           "fieldKey": "orderDate",
79           "operand": "greater_than",
80           "subField": null,
81           "value": "2024-01-01"
82         }
83       ],
84       "sorts": [
85         {
86           "fieldKey": "orderDate",
87           "direction": "desc",
88           "subField": null
89         }
90       ],
91       "createdAt": "2024-02-10T11:45:00Z",
92       "updatedAt": "2024-02-12T08:20:00Z",
93       "createdBy": "user_12345"
94     }
95   ]
96 }

Lists the saved table views (stored filters/sorts/column layout) for a definition within a space. Authorization: requires space:read on :spaceId — lacking it gives 404 (leak-guard). A per-space default view is lazily seeded on first read, so the response { default, views } always contains a default; views is the full list (including the default).

Lists the saved table views (stored filters/sorts/column layout) for a definition within a space. Authorization: requires `space:read` on `:spaceId` — lacking it gives **404** (leak-guard). A per-space default view is lazily seeded on first read, so the response `{ default, views }` always contains a `default`; `views` is the full list (including the default).

Authentication

AuthorizationBearer

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

Path parameters

spaceIdstringRequired

definitionIdstringRequired

Response

The saved views, including the seeded default.

defaultobject

viewslist of objects

Errors

404

Not Found Error