List library data objects

GET

/data-objects

GET

/data-objects

1 curl https:/https://api/data-objects \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json"

1 {
2   "definitions": [
3     {
4       "_id": "64b8f9a2e4b0c123456789ab",
5       "scope": "library",
6       "templateId": null,
7       "projectId": null,
8       "nameSingular": "Task",
9       "namePlural": "Tasks",
10       "labelSingular": "Task",
11       "labelPlural": "Tasks",
12       "description": "A unit of work to be completed within a project.",
13       "icon": "check_circle",
14       "color": "#4A90E2",
15       "labelFieldKey": "title",
16       "fields": [
17         {
18           "key": "title",
19           "type": "string",
20           "required": true,
21           "description": "The title of the task."
22         },
23         {
24           "key": "dueDate",
25           "type": "date",
26           "required": false,
27           "description": "The due date for the task."
28         },
29         {
30           "key": "completed",
31           "type": "boolean",
32           "required": false,
33           "description": "Whether the task is completed."
34         }
35       ],
36       "fieldGroups": [
37         {
38           "name": "General",
39           "fields": [
40             "title",
41             "dueDate"
42           ]
43         },
44         {
45           "name": "Status",
46           "fields": [
47             "completed"
48           ]
49         }
50       ],
51       "version": 3,
52       "archivedAt": null,
53       "createdAt": "2024-06-10T09:15:00Z",
54       "updatedAt": "2024-06-15T12:00:00Z",
55       "createdBy": "user_9876543210",
56       "cardinality": {
57         "min": 0,
58         "max": null
59       }
60     }
61   ]
62 }

Lists org-shared (library-scope) object definitions. Requires data-object:read.

Authentication

AuthorizationBearer

WorkOS session JWT or an organization API key, sent as Authorization: Bearer <token>.

Query parameters

archivedbooleanOptional

Include archived definitions when true.

Response

The library object definitions.

definitionslist of objects

Errors

401

Unauthorized Error

403

Forbidden Error