@caraer/client 2.0.381 → 2.0.382

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (117) hide show
  1. package/.openapi-generator/FILES +72 -1
  2. package/api.ts +7888 -2480
  3. package/apps.ts +122 -0
  4. package/dist/api.d.ts +3806 -637
  5. package/dist/api.js +6088 -1935
  6. package/dist/apps.d.ts +111 -0
  7. package/dist/apps.js +9 -0
  8. package/dist/esm/api.d.ts +3806 -637
  9. package/dist/esm/api.js +6019 -1883
  10. package/dist/esm/apps.d.ts +111 -0
  11. package/dist/esm/apps.js +8 -0
  12. package/dist/esm/index.d.ts +1 -0
  13. package/dist/esm/index.js +1 -0
  14. package/dist/index.d.ts +1 -0
  15. package/dist/index.js +1 -0
  16. package/docs/AdvancedRecordQueryPlan.md +50 -0
  17. package/docs/AdvancedRecordQueryRequest.md +43 -0
  18. package/docs/AdvancedRecordQueryResponse.md +39 -0
  19. package/docs/AdvancedRecordQueryResultItem.md +32 -0
  20. package/docs/AggregateBatchRequest.md +21 -0
  21. package/docs/AggregateRequest.md +43 -0
  22. package/docs/AnalyticsAxisConfig.md +32 -0
  23. package/docs/AnalyticsComparisonMetric.md +28 -0
  24. package/docs/AnalyticsDashboardConfig.md +24 -0
  25. package/docs/AnalyticsPropertyRef.md +24 -0
  26. package/docs/AnalyticsReferenceLine.md +24 -0
  27. package/docs/AnalyticsSeriesConfig.md +20 -0
  28. package/docs/AnalyticsTrendConfig.md +22 -0
  29. package/docs/AnalyticsWidgetConfig.md +54 -0
  30. package/docs/AnalyticsWidgetStyle.md +32 -0
  31. package/docs/AppConnectionStatusDTO.md +38 -0
  32. package/docs/AppDTO.md +19 -1
  33. package/docs/AppExternalOAuthProviderDTO.md +59 -0
  34. package/docs/AppExternalOAuthProviderSummaryDTO.md +27 -0
  35. package/docs/AppInboundRouteDTO.md +49 -0
  36. package/docs/AppInstallationRuntimeApi.md +764 -0
  37. package/docs/AppOAuthStartResponseDTO.md +20 -0
  38. package/docs/AppPublishDTO.md +1 -1
  39. package/docs/AppScheduleDTO.md +47 -0
  40. package/docs/AppSettingFieldSchema.md +4 -0
  41. package/docs/AppSettingOptionsSource.md +2 -0
  42. package/docs/ApplicationsApi.md +228 -0
  43. package/docs/BillingApi.md +101 -0
  44. package/docs/BulkDeleteRecordsData.md +21 -0
  45. package/docs/BulkDeleteRecordsRequest.md +23 -0
  46. package/docs/BulkDeleteRecordsResponse.md +25 -0
  47. package/docs/BulkEditRecordErrorItem.md +27 -0
  48. package/docs/BulkEditRecordItem.md +25 -0
  49. package/docs/BulkEditRecordResultItem.md +25 -0
  50. package/docs/BulkEditRecordsData.md +21 -0
  51. package/docs/BulkEditRecordsRequest.md +21 -0
  52. package/docs/BulkEditRecordsResponse.md +25 -0
  53. package/docs/CompanyApi.md +157 -0
  54. package/docs/CreateDeveloperProjectRequest.md +25 -0
  55. package/docs/CreateDeveloperSandboxRequest.md +23 -0
  56. package/docs/CreatePrivateAppRequest.md +4 -0
  57. package/docs/CreateProjectBuildRequest.md +29 -0
  58. package/docs/CreateResponseAppExternalOAuthProviderDTO.md +23 -0
  59. package/docs/CreateResponseAppInboundRouteDTO.md +23 -0
  60. package/docs/CreateResponseAppScheduleDTO.md +23 -0
  61. package/docs/CriterionScore.md +30 -0
  62. package/docs/CrossObjectRecordSearchRequest.md +37 -0
  63. package/docs/DeleteResponseVoid.md +23 -0
  64. package/docs/DeployBuildRequest.md +23 -0
  65. package/docs/DeveloperProjectsApi.md +387 -0
  66. package/docs/DeveloperSandboxesApi.md +158 -0
  67. package/docs/DeviceApproveRequest.md +21 -0
  68. package/docs/DevicePollRequest.md +21 -0
  69. package/docs/ErrorResponse.md +2 -0
  70. package/docs/EventRsvpRequest.md +22 -0
  71. package/docs/ExistingWidgetSummary.md +34 -0
  72. package/docs/{MorphRecordRequest.md → ExtendRecordRequest.md} +5 -5
  73. package/docs/FilterItem.md +4 -0
  74. package/docs/GraphPathEvidence.md +28 -0
  75. package/docs/GraphTraversalSpec.md +32 -0
  76. package/docs/Leadscore.md +4 -0
  77. package/docs/MigrateAppToV2Request.md +21 -0
  78. package/docs/ObjectsApi.md +6 -6
  79. package/docs/PreviewDTO.md +2 -0
  80. package/docs/Progress.md +20 -0
  81. package/docs/PropertyDTO.md +4 -0
  82. package/docs/PropertyDTOFormat.md +2 -0
  83. package/docs/PropertyOption.md +2 -0
  84. package/docs/QueryEvidence.md +40 -0
  85. package/docs/Record.md +2 -2
  86. package/docs/RecordDTO.md +1 -1
  87. package/docs/RecordRelationRequestDTO.md +2 -0
  88. package/docs/RecordsApi.md +671 -75
  89. package/docs/Recurrence.md +18 -0
  90. package/docs/RefreshTokenRequest.md +21 -0
  91. package/docs/RelationEdgeRequestDTO.md +23 -0
  92. package/docs/SamplePayloadRequest.md +23 -0
  93. package/docs/SavePropertyDTO.md +5 -1
  94. package/docs/ScoreBreakdown.md +34 -0
  95. package/docs/ServerlessFunctionDTO.md +2 -0
  96. package/docs/ServerlessFunctionRefDTO.md +25 -0
  97. package/docs/ServerlessFunctionsApi.md +184 -8
  98. package/docs/ShowItem.md +2 -0
  99. package/docs/ShowResponseAppExternalOAuthProviderDTO.md +23 -0
  100. package/docs/ShowResponseAppInboundRouteDTO.md +23 -0
  101. package/docs/ShowResponseAppOAuthStartResponseDTO.md +23 -0
  102. package/docs/ShowResponseAppScheduleDTO.md +23 -0
  103. package/docs/ShowResponseListAppConnectionStatusDTO.md +23 -0
  104. package/docs/ShowResponseListString.md +23 -0
  105. package/docs/ShowResponseMapStringObject.md +23 -0
  106. package/docs/ShowResponseObject.md +23 -0
  107. package/docs/SortItem.md +2 -0
  108. package/docs/SuccessResponseListAppExternalOAuthProviderDTO.md +23 -0
  109. package/docs/SuccessResponseListAppInboundRouteDTO.md +23 -0
  110. package/docs/SuccessResponseListAppScheduleDTO.md +23 -0
  111. package/docs/SuggestAnalyticsWidgetsRequest.md +24 -0
  112. package/docs/Team.md +2 -2
  113. package/docs/TraitsApi.md +272 -0
  114. package/docs/UserRecordResponseDTO.md +1 -1
  115. package/docs/ViewDTO.md +12 -0
  116. package/index.ts +2 -0
  117. package/package.json +1 -1
@@ -5,20 +5,30 @@ All URIs are relative to *https://v2.api.caraer.com*
5
5
  |Method | HTTP request | Description|
6
6
  |------------- | ------------- | -------------|
7
7
  |[**_delete**](#_delete) | **DELETE** /api/v2/records/{uuid} | Delete a record|
8
+ |[**aggregate**](#aggregate) | **POST** /api/v2/records/aggregate | Aggregate records for analytics charts|
9
+ |[**aggregateBatch**](#aggregatebatch) | **POST** /api/v2/records/aggregate/batch | Batch aggregate records for analytics dashboards|
10
+ |[**bulkDelete**](#bulkdelete) | **POST** /api/v2/records/{objectName}/bulk-delete | Bulk delete records|
11
+ |[**bulkEdit**](#bulkedit) | **PUT** /api/v2/records/{objectName}/bulk | Bulk create or update records|
8
12
  |[**create**](#create) | **POST** /api/v2/records/{objectName} | Create a new record|
9
13
  |[**createOrUpdate**](#createorupdate) | **POST** /api/v2/records/{objectName}/createOrUpdate | Create or update a record|
10
14
  |[**createRelation**](#createrelation) | **POST** /api/v2/records/relations/{fromUuid}/{relationName}/{toUuid} | Create a relation between records|
11
15
  |[**deleteRelation**](#deleterelation) | **DELETE** /api/v2/records/relations/{fromUuid}/{relationName}/{toUuid} | Delete a relation between records|
16
+ |[**extend**](#extend) | **POST** /api/v2/records/{uuid}/extend | Extend a record|
12
17
  |[**index**](#index) | **POST** /api/v2/records/index | Fetch paginated records|
13
18
  |[**indexFlow**](#indexflow) | **POST** /api/v2/records/index/flow | Fetch records for flow view|
14
19
  |[**indexPage**](#indexpage) | **POST** /api/v2/records/index/page | Fetch records for page view|
15
20
  |[**indexTable**](#indextable) | **POST** /api/v2/records/index/table | Fetch records for table view|
16
- |[**morph**](#morph) | **POST** /api/v2/records/{uuid}/morph | Morph a record|
17
21
  |[**preview**](#preview) | **GET** /api/v2/records/{uuid}/previews/{name} | Get record preview|
22
+ |[**query**](#query) | **POST** /api/v2/records/query | Advanced graph-aware record query|
18
23
  |[**restore**](#restore) | **POST** /api/v2/records/{uuid}/restore | Restore a deleted record|
19
24
  |[**search**](#search) | **POST** /api/v2/records/search | Search records|
20
- |[**show1**](#show1) | **GET** /api/v2/records/{uuid} | Get record details|
25
+ |[**searchCrossObject**](#searchcrossobject) | **POST** /api/v2/records/search/cross-object | Search records across objects|
26
+ |[**show**](#show) | **GET** /api/v2/records/{uuid} | Get record details|
27
+ |[**showByObject**](#showbyobject) | **GET** /api/v2/records/{objectName}/{uuid} | Get record details by object|
28
+ |[**suggestAnalyticsWidgets**](#suggestanalyticswidgets) | **POST** /api/v2/records/analytics/suggest-widgets | Suggest analytics widgets with AI|
21
29
  |[**update**](#update) | **PUT** /api/v2/records/{objectName}/{uuid} | Update a record|
30
+ |[**updateByUuid**](#updatebyuuid) | **PUT** /api/v2/records/{uuid} | Update a record by UUID|
31
+ |[**updateRelationEdge**](#updaterelationedge) | **PATCH** /api/v2/records/relations/{fromUuid}/{relationName}/{toUuid} | Update relation edge properties|
22
32
 
23
33
  # **_delete**
24
34
  > SuccessResponse _delete()
@@ -76,6 +86,228 @@ const { status, data } = await apiInstance._delete(
76
86
 
77
87
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
78
88
 
89
+ # **aggregate**
90
+ > SuccessResponse aggregate(aggregateRequest)
91
+
92
+ Groups Neo4j records by property or time bucket and returns series points with optional drilldown filters.
93
+
94
+ ### Example
95
+
96
+ ```typescript
97
+ import {
98
+ RecordsApi,
99
+ Configuration,
100
+ AggregateRequest
101
+ } from '@caraer/client';
102
+
103
+ const configuration = new Configuration();
104
+ const apiInstance = new RecordsApi(configuration);
105
+
106
+ let aggregateRequest: AggregateRequest; //
107
+
108
+ const { status, data } = await apiInstance.aggregate(
109
+ aggregateRequest
110
+ );
111
+ ```
112
+
113
+ ### Parameters
114
+
115
+ |Name | Type | Description | Notes|
116
+ |------------- | ------------- | ------------- | -------------|
117
+ | **aggregateRequest** | **AggregateRequest**| | |
118
+
119
+
120
+ ### Return type
121
+
122
+ **SuccessResponse**
123
+
124
+ ### Authorization
125
+
126
+ [bearerAuth](../README.md#bearerAuth)
127
+
128
+ ### HTTP request headers
129
+
130
+ - **Content-Type**: application/json
131
+ - **Accept**: application/json
132
+
133
+
134
+ ### HTTP response details
135
+ | Status code | Description | Response headers |
136
+ |-------------|-------------|------------------|
137
+ |**200** | Aggregation completed | - |
138
+ |**400** | Invalid request | - |
139
+
140
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
141
+
142
+ # **aggregateBatch**
143
+ > SuccessResponse aggregateBatch(aggregateBatchRequest)
144
+
145
+ Runs multiple aggregation requests for dashboard widgets.
146
+
147
+ ### Example
148
+
149
+ ```typescript
150
+ import {
151
+ RecordsApi,
152
+ Configuration,
153
+ AggregateBatchRequest
154
+ } from '@caraer/client';
155
+
156
+ const configuration = new Configuration();
157
+ const apiInstance = new RecordsApi(configuration);
158
+
159
+ let aggregateBatchRequest: AggregateBatchRequest; //
160
+
161
+ const { status, data } = await apiInstance.aggregateBatch(
162
+ aggregateBatchRequest
163
+ );
164
+ ```
165
+
166
+ ### Parameters
167
+
168
+ |Name | Type | Description | Notes|
169
+ |------------- | ------------- | ------------- | -------------|
170
+ | **aggregateBatchRequest** | **AggregateBatchRequest**| | |
171
+
172
+
173
+ ### Return type
174
+
175
+ **SuccessResponse**
176
+
177
+ ### Authorization
178
+
179
+ [bearerAuth](../README.md#bearerAuth)
180
+
181
+ ### HTTP request headers
182
+
183
+ - **Content-Type**: application/json
184
+ - **Accept**: application/json
185
+
186
+
187
+ ### HTTP response details
188
+ | Status code | Description | Response headers |
189
+ |-------------|-------------|------------------|
190
+ |**200** | Batch aggregation completed | - |
191
+ |**400** | Invalid request | - |
192
+
193
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
194
+
195
+ # **bulkDelete**
196
+ > BulkDeleteRecordsResponse bulkDelete(bulkDeleteRecordsRequest)
197
+
198
+ Archives, anonymizes, or permanently deletes multiple records in one request. Returns HTTP 200 when every item succeeds. Returns HTTP 200 with per-record errors when one or more items fail; successful items are still applied and listed in data.uuids.
199
+
200
+ ### Example
201
+
202
+ ```typescript
203
+ import {
204
+ RecordsApi,
205
+ Configuration,
206
+ BulkDeleteRecordsRequest
207
+ } from '@caraer/client';
208
+
209
+ const configuration = new Configuration();
210
+ const apiInstance = new RecordsApi(configuration);
211
+
212
+ let objectName: string; // (default to undefined)
213
+ let bulkDeleteRecordsRequest: BulkDeleteRecordsRequest; //
214
+
215
+ const { status, data } = await apiInstance.bulkDelete(
216
+ objectName,
217
+ bulkDeleteRecordsRequest
218
+ );
219
+ ```
220
+
221
+ ### Parameters
222
+
223
+ |Name | Type | Description | Notes|
224
+ |------------- | ------------- | ------------- | -------------|
225
+ | **bulkDeleteRecordsRequest** | **BulkDeleteRecordsRequest**| | |
226
+ | **objectName** | [**string**] | | defaults to undefined|
227
+
228
+
229
+ ### Return type
230
+
231
+ **BulkDeleteRecordsResponse**
232
+
233
+ ### Authorization
234
+
235
+ [bearerAuth](../README.md#bearerAuth)
236
+
237
+ ### HTTP request headers
238
+
239
+ - **Content-Type**: application/json
240
+ - **Accept**: application/json
241
+
242
+
243
+ ### HTTP response details
244
+ | Status code | Description | Response headers |
245
+ |-------------|-------------|------------------|
246
+ |**200** | Bulk delete completed (possibly with per-record errors) | - |
247
+ |**400** | Invalid request | - |
248
+
249
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
250
+
251
+ # **bulkEdit**
252
+ > BulkEditRecordsResponse bulkEdit(bulkEditRecordsRequest)
253
+
254
+ Creates or updates multiple records in one request. Returns HTTP 201 when every item succeeds (no per-record errors). Returns HTTP 200 when one or more items fail validation; successful items are still persisted and listed in data.records, with failures in errors.
255
+
256
+ ### Example
257
+
258
+ ```typescript
259
+ import {
260
+ RecordsApi,
261
+ Configuration,
262
+ BulkEditRecordsRequest
263
+ } from '@caraer/client';
264
+
265
+ const configuration = new Configuration();
266
+ const apiInstance = new RecordsApi(configuration);
267
+
268
+ let objectName: string; // (default to undefined)
269
+ let bulkEditRecordsRequest: BulkEditRecordsRequest; //
270
+ let ignoreErrors: boolean; //If \'true\', allows each save to proceed while ignoring certain non-critical validation errors, when supported. (optional) (default to false)
271
+
272
+ const { status, data } = await apiInstance.bulkEdit(
273
+ objectName,
274
+ bulkEditRecordsRequest,
275
+ ignoreErrors
276
+ );
277
+ ```
278
+
279
+ ### Parameters
280
+
281
+ |Name | Type | Description | Notes|
282
+ |------------- | ------------- | ------------- | -------------|
283
+ | **bulkEditRecordsRequest** | **BulkEditRecordsRequest**| | |
284
+ | **objectName** | [**string**] | | defaults to undefined|
285
+ | **ignoreErrors** | [**boolean**] | If \'true\', allows each save to proceed while ignoring certain non-critical validation errors, when supported. | (optional) defaults to false|
286
+
287
+
288
+ ### Return type
289
+
290
+ **BulkEditRecordsResponse**
291
+
292
+ ### Authorization
293
+
294
+ [bearerAuth](../README.md#bearerAuth)
295
+
296
+ ### HTTP request headers
297
+
298
+ - **Content-Type**: application/json
299
+ - **Accept**: application/json
300
+
301
+
302
+ ### HTTP response details
303
+ | Status code | Description | Response headers |
304
+ |-------------|-------------|------------------|
305
+ |**201** | All records saved successfully | - |
306
+ |**200** | Partial success with per-record validation errors | - |
307
+ |**400** | Invalid request | - |
308
+
309
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
310
+
79
311
  # **create**
80
312
  > CreateResponse create(recordDTO)
81
313
 
@@ -95,9 +327,9 @@ const apiInstance = new RecordsApi(configuration);
95
327
 
96
328
  let objectName: string; // (default to undefined)
97
329
  let recordDTO: RecordDTO; //Record data to create
98
- let parse: boolean; //If \'true\', parses the created record to human-readable values before returning. (optional) (default to false)
330
+ let parse: 'DB' | 'HUMAN_READABLE' | 'STRUCTURED'; //Value presentation mode: omit/false/db for raw stored values; true/human_readable for display strings; structured for rich JSON (e.g. PropertyOption arrays, related records). (optional) (default to undefined)
99
331
  let ignoreErrors: boolean; //If \'true\', allows the creation to proceed while ignoring certain non-critical validation errors, when supported. (optional) (default to false)
100
- let recordReturnFormat: string; //Format of the record to return. LEGACY, USER_FRIENDLY, EXPANDED. (optional) (default to 'LEGACY')
332
+ let recordReturnFormat: 'LEGACY' | 'USER_FRIENDLY' | 'EXPANDED'; //Format of the record to return. LEGACY, USER_FRIENDLY, EXPANDED. (optional) (default to 'LEGACY')
101
333
 
102
334
  const { status, data } = await apiInstance.create(
103
335
  objectName,
@@ -114,9 +346,9 @@ const { status, data } = await apiInstance.create(
114
346
  |------------- | ------------- | ------------- | -------------|
115
347
  | **recordDTO** | **RecordDTO**| Record data to create | |
116
348
  | **objectName** | [**string**] | | defaults to undefined|
117
- | **parse** | [**boolean**] | If \'true\', parses the created record to human-readable values before returning. | (optional) defaults to false|
349
+ | **parse** | [**&#39;DB&#39; | &#39;HUMAN_READABLE&#39; | &#39;STRUCTURED&#39;**]**Array<&#39;DB&#39; &#124; &#39;HUMAN_READABLE&#39; &#124; &#39;STRUCTURED&#39;>** | Value presentation mode: omit/false/db for raw stored values; true/human_readable for display strings; structured for rich JSON (e.g. PropertyOption arrays, related records). | (optional) defaults to undefined|
118
350
  | **ignoreErrors** | [**boolean**] | If \&#39;true\&#39;, allows the creation to proceed while ignoring certain non-critical validation errors, when supported. | (optional) defaults to false|
119
- | **recordReturnFormat** | [**string**] | Format of the record to return. LEGACY, USER_FRIENDLY, EXPANDED. | (optional) defaults to 'LEGACY'|
351
+ | **recordReturnFormat** | [**&#39;LEGACY&#39; | &#39;USER_FRIENDLY&#39; | &#39;EXPANDED&#39;**]**Array<&#39;LEGACY&#39; &#124; &#39;USER_FRIENDLY&#39; &#124; &#39;EXPANDED&#39;>** | Format of the record to return. LEGACY, USER_FRIENDLY, EXPANDED. | (optional) defaults to 'LEGACY'|
120
352
 
121
353
 
122
354
  ### Return type
@@ -161,9 +393,9 @@ const apiInstance = new RecordsApi(configuration);
161
393
 
162
394
  let objectName: string; // (default to undefined)
163
395
  let recordDTO: RecordDTO; //Record data to create or update
164
- let parse: boolean; // (optional) (default to false)
396
+ let parse: 'DB' | 'HUMAN_READABLE' | 'STRUCTURED'; //Value presentation mode: omit/false/db for raw stored values; true/human_readable for display strings; structured for rich JSON (e.g. PropertyOption arrays, related records). (optional) (default to undefined)
165
397
  let ignoreErrors: boolean; // (optional) (default to false)
166
- let recordReturnFormat: string; //Format of the record to return. LEGACY, USER_FRIENDLY, EXPANDED. (optional) (default to 'LEGACY')
398
+ let recordReturnFormat: 'LEGACY' | 'USER_FRIENDLY' | 'EXPANDED'; //Format of the record to return. LEGACY, USER_FRIENDLY, EXPANDED. (optional) (default to 'LEGACY')
167
399
 
168
400
  const { status, data } = await apiInstance.createOrUpdate(
169
401
  objectName,
@@ -180,9 +412,9 @@ const { status, data } = await apiInstance.createOrUpdate(
180
412
  |------------- | ------------- | ------------- | -------------|
181
413
  | **recordDTO** | **RecordDTO**| Record data to create or update | |
182
414
  | **objectName** | [**string**] | | defaults to undefined|
183
- | **parse** | [**boolean**] | | (optional) defaults to false|
415
+ | **parse** | [**&#39;DB&#39; | &#39;HUMAN_READABLE&#39; | &#39;STRUCTURED&#39;**]**Array<&#39;DB&#39; &#124; &#39;HUMAN_READABLE&#39; &#124; &#39;STRUCTURED&#39;>** | Value presentation mode: omit/false/db for raw stored values; true/human_readable for display strings; structured for rich JSON (e.g. PropertyOption arrays, related records). | (optional) defaults to undefined|
184
416
  | **ignoreErrors** | [**boolean**] | | (optional) defaults to false|
185
- | **recordReturnFormat** | [**string**] | Format of the record to return. LEGACY, USER_FRIENDLY, EXPANDED. | (optional) defaults to 'LEGACY'|
417
+ | **recordReturnFormat** | [**&#39;LEGACY&#39; | &#39;USER_FRIENDLY&#39; | &#39;EXPANDED&#39;**]**Array<&#39;LEGACY&#39; &#124; &#39;USER_FRIENDLY&#39; &#124; &#39;EXPANDED&#39;>** | Format of the record to return. LEGACY, USER_FRIENDLY, EXPANDED. | (optional) defaults to 'LEGACY'|
186
418
 
187
419
 
188
420
  ### Return type
@@ -219,7 +451,8 @@ Creates a relation between two records identified by their UUIDs using the provi
219
451
  ```typescript
220
452
  import {
221
453
  RecordsApi,
222
- Configuration
454
+ Configuration,
455
+ RelationEdgeRequestDTO
223
456
  } from '@caraer/client';
224
457
 
225
458
  const configuration = new Configuration();
@@ -229,12 +462,14 @@ let fromUuid: string; // (default to undefined)
229
462
  let relationName: string; // (default to undefined)
230
463
  let toUuid: string; // (default to undefined)
231
464
  let primary: object; //When \'true\', marks the created relation as primary. Defaults to \'false\'. (optional) (default to undefined)
465
+ let relationEdgeRequestDTO: RelationEdgeRequestDTO; // (optional)
232
466
 
233
467
  const { status, data } = await apiInstance.createRelation(
234
468
  fromUuid,
235
469
  relationName,
236
470
  toUuid,
237
- primary
471
+ primary,
472
+ relationEdgeRequestDTO
238
473
  );
239
474
  ```
240
475
 
@@ -242,6 +477,7 @@ const { status, data } = await apiInstance.createRelation(
242
477
 
243
478
  |Name | Type | Description | Notes|
244
479
  |------------- | ------------- | ------------- | -------------|
480
+ | **relationEdgeRequestDTO** | **RelationEdgeRequestDTO**| | |
245
481
  | **fromUuid** | [**string**] | | defaults to undefined|
246
482
  | **relationName** | [**string**] | | defaults to undefined|
247
483
  | **toUuid** | [**string**] | | defaults to undefined|
@@ -258,7 +494,7 @@ const { status, data } = await apiInstance.createRelation(
258
494
 
259
495
  ### HTTP request headers
260
496
 
261
- - **Content-Type**: Not defined
497
+ - **Content-Type**: application/json
262
498
  - **Accept**: application/json
263
499
 
264
500
 
@@ -330,6 +566,69 @@ const { status, data } = await apiInstance.deleteRelation(
330
566
 
331
567
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
332
568
 
569
+ # **extend**
570
+ > SuccessResponse extend(extendRecordRequest)
571
+
572
+ Extends a record identified by its UUID to one or more objects. You can use this to move a record or add it to another object so it\'ll be visible in the new object.Returns a SuccessResponse confirming that the record has been extended.
573
+
574
+ ### Example
575
+
576
+ ```typescript
577
+ import {
578
+ RecordsApi,
579
+ Configuration,
580
+ ExtendRecordRequest
581
+ } from '@caraer/client';
582
+
583
+ const configuration = new Configuration();
584
+ const apiInstance = new RecordsApi(configuration);
585
+
586
+ let uuid: string; // (default to undefined)
587
+ let extendRecordRequest: ExtendRecordRequest; //
588
+ let recordReturnFormat: 'LEGACY' | 'USER_FRIENDLY' | 'EXPANDED'; //Format of the record to return. LEGACY, USER_FRIENDLY, EXPANDED. (optional) (default to 'LEGACY')
589
+ let parse: 'DB' | 'HUMAN_READABLE' | 'STRUCTURED'; //Value presentation mode: omit/false/db for raw stored values; true/human_readable for display strings; structured for rich JSON (e.g. PropertyOption arrays, related records). (optional) (default to undefined)
590
+
591
+ const { status, data } = await apiInstance.extend(
592
+ uuid,
593
+ extendRecordRequest,
594
+ recordReturnFormat,
595
+ parse
596
+ );
597
+ ```
598
+
599
+ ### Parameters
600
+
601
+ |Name | Type | Description | Notes|
602
+ |------------- | ------------- | ------------- | -------------|
603
+ | **extendRecordRequest** | **ExtendRecordRequest**| | |
604
+ | **uuid** | [**string**] | | defaults to undefined|
605
+ | **recordReturnFormat** | [**&#39;LEGACY&#39; | &#39;USER_FRIENDLY&#39; | &#39;EXPANDED&#39;**]**Array<&#39;LEGACY&#39; &#124; &#39;USER_FRIENDLY&#39; &#124; &#39;EXPANDED&#39;>** | Format of the record to return. LEGACY, USER_FRIENDLY, EXPANDED. | (optional) defaults to 'LEGACY'|
606
+ | **parse** | [**&#39;DB&#39; | &#39;HUMAN_READABLE&#39; | &#39;STRUCTURED&#39;**]**Array<&#39;DB&#39; &#124; &#39;HUMAN_READABLE&#39; &#124; &#39;STRUCTURED&#39;>** | Value presentation mode: omit/false/db for raw stored values; true/human_readable for display strings; structured for rich JSON (e.g. PropertyOption arrays, related records). | (optional) defaults to undefined|
607
+
608
+
609
+ ### Return type
610
+
611
+ **SuccessResponse**
612
+
613
+ ### Authorization
614
+
615
+ [bearerAuth](../README.md#bearerAuth)
616
+
617
+ ### HTTP request headers
618
+
619
+ - **Content-Type**: application/json
620
+ - **Accept**: application/json
621
+
622
+
623
+ ### HTTP response details
624
+ | Status code | Description | Response headers |
625
+ |-------------|-------------|------------------|
626
+ |**200** | Record extended successfully | - |
627
+ |**404** | Record not found | - |
628
+ |**500** | Internal server error | - |
629
+
630
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
631
+
333
632
  # **index**
334
633
  > PaginationResponse index(body)
335
634
 
@@ -347,10 +646,10 @@ const configuration = new Configuration();
347
646
  const apiInstance = new RecordsApi(configuration);
348
647
 
349
648
  let body: string; //Pagination request for records
350
- let parse: boolean; //If set to \'true\', records are parsed to human-readable values (for example, unix timestamps are formatted as dates). (optional) (default to undefined)
649
+ let parse: 'DB' | 'HUMAN_READABLE' | 'STRUCTURED'; //Value presentation mode: omit/false/db for raw stored values; true/human_readable for display strings; structured for rich JSON (e.g. PropertyOption arrays, related records). (optional) (default to undefined)
351
650
  let archived: boolean; //When \'true\', archived records are returned instead of active records. Defaults to \'false\'. (optional) (default to false)
352
651
  let relatedRecordUuid: string; //UUID of a record used for relation-aware filtering. If supplied and the request body contains a filter, that filter will be smartened based on this related record. If no filter is supplied, a default filter will be applied that returns all records related in any way (any relation) to this record. (optional) (default to undefined)
353
- let recordReturnFormat: string; //Format of the records to return. LEGACY, USER_FRIENDLY, EXPANDED. (optional) (default to 'LEGACY')
652
+ let recordReturnFormat: 'LEGACY' | 'USER_FRIENDLY' | 'EXPANDED'; //Format of the records to return. LEGACY, USER_FRIENDLY, EXPANDED. (optional) (default to 'LEGACY')
354
653
 
355
654
  const { status, data } = await apiInstance.index(
356
655
  body,
@@ -366,10 +665,10 @@ const { status, data } = await apiInstance.index(
366
665
  |Name | Type | Description | Notes|
367
666
  |------------- | ------------- | ------------- | -------------|
368
667
  | **body** | **string**| Pagination request for records | |
369
- | **parse** | [**boolean**] | If set to \&#39;true\&#39;, records are parsed to human-readable values (for example, unix timestamps are formatted as dates). | (optional) defaults to undefined|
668
+ | **parse** | [**&#39;DB&#39; | &#39;HUMAN_READABLE&#39; | &#39;STRUCTURED&#39;**]**Array<&#39;DB&#39; &#124; &#39;HUMAN_READABLE&#39; &#124; &#39;STRUCTURED&#39;>** | Value presentation mode: omit/false/db for raw stored values; true/human_readable for display strings; structured for rich JSON (e.g. PropertyOption arrays, related records). | (optional) defaults to undefined|
370
669
  | **archived** | [**boolean**] | When \&#39;true\&#39;, archived records are returned instead of active records. Defaults to \&#39;false\&#39;. | (optional) defaults to false|
371
670
  | **relatedRecordUuid** | [**string**] | UUID of a record used for relation-aware filtering. If supplied and the request body contains a filter, that filter will be smartened based on this related record. If no filter is supplied, a default filter will be applied that returns all records related in any way (any relation) to this record. | (optional) defaults to undefined|
372
- | **recordReturnFormat** | [**string**] | Format of the records to return. LEGACY, USER_FRIENDLY, EXPANDED. | (optional) defaults to 'LEGACY'|
671
+ | **recordReturnFormat** | [**&#39;LEGACY&#39; | &#39;USER_FRIENDLY&#39; | &#39;EXPANDED&#39;**]**Array<&#39;LEGACY&#39; &#124; &#39;USER_FRIENDLY&#39; &#124; &#39;EXPANDED&#39;>** | Format of the records to return. LEGACY, USER_FRIENDLY, EXPANDED. | (optional) defaults to 'LEGACY'|
373
672
 
374
673
 
375
674
  ### Return type
@@ -413,7 +712,7 @@ const apiInstance = new RecordsApi(configuration);
413
712
 
414
713
  let body: string; //Pagination request for flow view
415
714
  let relatedRecordUuid: string; //UUID of a record used for relation-aware filtering. If supplied and the request body contains a filter, that filter will be smartened based on this related record. If no filter is supplied, a default filter will be applied that returns all records related in any way (any relation) to this record. (optional) (default to undefined)
416
- let parse: boolean; //Whether to parse the record before returning it. (optional) (default to undefined)
715
+ let parse: 'DB' | 'HUMAN_READABLE' | 'STRUCTURED'; //Value presentation mode: omit/false/db for raw stored values; true/human_readable for display strings; structured for rich JSON (e.g. PropertyOption arrays, related records). (optional) (default to undefined)
417
716
 
418
717
  const { status, data } = await apiInstance.indexFlow(
419
718
  body,
@@ -428,7 +727,7 @@ const { status, data } = await apiInstance.indexFlow(
428
727
  |------------- | ------------- | ------------- | -------------|
429
728
  | **body** | **string**| Pagination request for flow view | |
430
729
  | **relatedRecordUuid** | [**string**] | UUID of a record used for relation-aware filtering. If supplied and the request body contains a filter, that filter will be smartened based on this related record. If no filter is supplied, a default filter will be applied that returns all records related in any way (any relation) to this record. | (optional) defaults to undefined|
431
- | **parse** | [**boolean**] | Whether to parse the record before returning it. | (optional) defaults to undefined|
730
+ | **parse** | [**&#39;DB&#39; | &#39;HUMAN_READABLE&#39; | &#39;STRUCTURED&#39;**]**Array<&#39;DB&#39; &#124; &#39;HUMAN_READABLE&#39; &#124; &#39;STRUCTURED&#39;>** | Value presentation mode: omit/false/db for raw stored values; true/human_readable for display strings; structured for rich JSON (e.g. PropertyOption arrays, related records). | (optional) defaults to undefined|
432
731
 
433
732
 
434
733
  ### Return type
@@ -576,32 +875,31 @@ const { status, data } = await apiInstance.indexTable(
576
875
 
577
876
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
578
877
 
579
- # **morph**
580
- > SuccessResponse morph(morphRecordRequest)
878
+ # **preview**
879
+ > ShowResponse preview()
581
880
 
582
- Morphs a record identified by its UUID to one or more objects. You can use this to move a record or add it to another object so it\'ll be visible in the new object.Returns a SuccessResponse confirming that the record has been morphed.
881
+ Retrieves a preview for a record specified by its UUID and preview name. Returns a ShowResponse containing the preview data.
583
882
 
584
883
  ### Example
585
884
 
586
885
  ```typescript
587
886
  import {
588
887
  RecordsApi,
589
- Configuration,
590
- MorphRecordRequest
888
+ Configuration
591
889
  } from '@caraer/client';
592
890
 
593
891
  const configuration = new Configuration();
594
892
  const apiInstance = new RecordsApi(configuration);
595
893
 
596
894
  let uuid: string; // (default to undefined)
597
- let morphRecordRequest: MorphRecordRequest; //
598
- let recordReturnFormat: string; //Format of the record to return. LEGACY, USER_FRIENDLY, EXPANDED. (optional) (default to 'LEGACY')
599
- let parse: boolean; //Whether to parse the record before returning it. (optional) (default to undefined)
895
+ let name: string; // (default to undefined)
896
+ let object: string; //Optional object name used to resolve the record before building the preview. (optional) (default to undefined)
897
+ let parse: 'DB' | 'HUMAN_READABLE' | 'STRUCTURED'; //Value presentation mode: omit/false/db for raw stored values; true/human_readable for display strings; structured for rich JSON (e.g. PropertyOption arrays, related records). (optional) (default to undefined)
600
898
 
601
- const { status, data } = await apiInstance.morph(
899
+ const { status, data } = await apiInstance.preview(
602
900
  uuid,
603
- morphRecordRequest,
604
- recordReturnFormat,
901
+ name,
902
+ object,
605
903
  parse
606
904
  );
607
905
  ```
@@ -610,15 +908,15 @@ const { status, data } = await apiInstance.morph(
610
908
 
611
909
  |Name | Type | Description | Notes|
612
910
  |------------- | ------------- | ------------- | -------------|
613
- | **morphRecordRequest** | **MorphRecordRequest**| | |
614
911
  | **uuid** | [**string**] | | defaults to undefined|
615
- | **recordReturnFormat** | [**string**] | Format of the record to return. LEGACY, USER_FRIENDLY, EXPANDED. | (optional) defaults to 'LEGACY'|
616
- | **parse** | [**boolean**] | Whether to parse the record before returning it. | (optional) defaults to undefined|
912
+ | **name** | [**string**] | | defaults to undefined|
913
+ | **object** | [**string**] | Optional object name used to resolve the record before building the preview. | (optional) defaults to undefined|
914
+ | **parse** | [**&#39;DB&#39; | &#39;HUMAN_READABLE&#39; | &#39;STRUCTURED&#39;**]**Array<&#39;DB&#39; &#124; &#39;HUMAN_READABLE&#39; &#124; &#39;STRUCTURED&#39;>** | Value presentation mode: omit/false/db for raw stored values; true/human_readable for display strings; structured for rich JSON (e.g. PropertyOption arrays, related records). | (optional) defaults to undefined|
617
915
 
618
916
 
619
917
  ### Return type
620
918
 
621
- **SuccessResponse**
919
+ **ShowResponse**
622
920
 
623
921
  ### Authorization
624
922
 
@@ -626,45 +924,39 @@ const { status, data } = await apiInstance.morph(
626
924
 
627
925
  ### HTTP request headers
628
926
 
629
- - **Content-Type**: application/json
927
+ - **Content-Type**: Not defined
630
928
  - **Accept**: application/json
631
929
 
632
930
 
633
931
  ### HTTP response details
634
932
  | Status code | Description | Response headers |
635
933
  |-------------|-------------|------------------|
636
- |**200** | Record morphed successfully | - |
637
- |**404** | Record not found | - |
638
- |**500** | Internal server error | - |
934
+ |**200** | Preview retrieved successfully | - |
935
+ |**404** | Record or preview not found | - |
639
936
 
640
937
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
641
938
 
642
- # **preview**
643
- > ShowResponse preview()
939
+ # **query**
940
+ > AdvancedRecordQueryResponse query(advancedRecordQueryRequest)
644
941
 
645
- Retrieves a preview for a record specified by its UUID and preview name. Returns a ShowResponse containing the preview data.
942
+ Executes a two-pass GraphRAG query using natural language or a declarative plan. Returns records with scores and graph evidence.
646
943
 
647
944
  ### Example
648
945
 
649
946
  ```typescript
650
947
  import {
651
948
  RecordsApi,
652
- Configuration
949
+ Configuration,
950
+ AdvancedRecordQueryRequest
653
951
  } from '@caraer/client';
654
952
 
655
953
  const configuration = new Configuration();
656
954
  const apiInstance = new RecordsApi(configuration);
657
955
 
658
- let uuid: string; // (default to undefined)
659
- let name: string; // (default to undefined)
660
- let object: string; //Optional object name used to resolve the record before building the preview. (optional) (default to undefined)
661
- let parse: boolean; //Whether to parse the record before returning it. (optional) (default to undefined)
956
+ let advancedRecordQueryRequest: AdvancedRecordQueryRequest; //
662
957
 
663
- const { status, data } = await apiInstance.preview(
664
- uuid,
665
- name,
666
- object,
667
- parse
958
+ const { status, data } = await apiInstance.query(
959
+ advancedRecordQueryRequest
668
960
  );
669
961
  ```
670
962
 
@@ -672,15 +964,12 @@ const { status, data } = await apiInstance.preview(
672
964
 
673
965
  |Name | Type | Description | Notes|
674
966
  |------------- | ------------- | ------------- | -------------|
675
- | **uuid** | [**string**] | | defaults to undefined|
676
- | **name** | [**string**] | | defaults to undefined|
677
- | **object** | [**string**] | Optional object name used to resolve the record before building the preview. | (optional) defaults to undefined|
678
- | **parse** | [**boolean**] | Whether to parse the record before returning it. | (optional) defaults to undefined|
967
+ | **advancedRecordQueryRequest** | **AdvancedRecordQueryRequest**| | |
679
968
 
680
969
 
681
970
  ### Return type
682
971
 
683
- **ShowResponse**
972
+ **AdvancedRecordQueryResponse**
684
973
 
685
974
  ### Authorization
686
975
 
@@ -688,15 +977,15 @@ const { status, data } = await apiInstance.preview(
688
977
 
689
978
  ### HTTP request headers
690
979
 
691
- - **Content-Type**: Not defined
980
+ - **Content-Type**: application/json
692
981
  - **Accept**: application/json
693
982
 
694
983
 
695
984
  ### HTTP response details
696
985
  | Status code | Description | Response headers |
697
986
  |-------------|-------------|------------------|
698
- |**200** | Preview retrieved successfully | - |
699
- |**404** | Record or preview not found | - |
987
+ |**200** | Query completed successfully | - |
988
+ |**400** | Invalid query request | - |
700
989
 
701
990
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
702
991
 
@@ -771,8 +1060,8 @@ const apiInstance = new RecordsApi(configuration);
771
1060
 
772
1061
  let body: string; //Search criteria
773
1062
  let archived: boolean; //When set to \'true\', includes soft-deleted records in the search results. (optional) (default to false)
774
- let parse: boolean; //If \'true\', parses returned records to human-readable values. (optional) (default to false)
775
- let recordReturnFormat: string; //Format of the records to return. LEGACY, USER_FRIENDLY, EXPANDED. (optional) (default to 'LEGACY')
1063
+ let parse: 'DB' | 'HUMAN_READABLE' | 'STRUCTURED'; //Value presentation mode: omit/false/db for raw stored values; true/human_readable for display strings; structured for rich JSON (e.g. PropertyOption arrays, related records). (optional) (default to undefined)
1064
+ let recordReturnFormat: 'LEGACY' | 'USER_FRIENDLY' | 'EXPANDED'; //Format of the records to return. LEGACY, USER_FRIENDLY, EXPANDED. (optional) (default to 'LEGACY')
776
1065
 
777
1066
  const { status, data } = await apiInstance.search(
778
1067
  body,
@@ -788,8 +1077,8 @@ const { status, data } = await apiInstance.search(
788
1077
  |------------- | ------------- | ------------- | -------------|
789
1078
  | **body** | **string**| Search criteria | |
790
1079
  | **archived** | [**boolean**] | When set to \&#39;true\&#39;, includes soft-deleted records in the search results. | (optional) defaults to false|
791
- | **parse** | [**boolean**] | If \&#39;true\&#39;, parses returned records to human-readable values. | (optional) defaults to false|
792
- | **recordReturnFormat** | [**string**] | Format of the records to return. LEGACY, USER_FRIENDLY, EXPANDED. | (optional) defaults to 'LEGACY'|
1080
+ | **parse** | [**&#39;DB&#39; | &#39;HUMAN_READABLE&#39; | &#39;STRUCTURED&#39;**]**Array<&#39;DB&#39; &#124; &#39;HUMAN_READABLE&#39; &#124; &#39;STRUCTURED&#39;>** | Value presentation mode: omit/false/db for raw stored values; true/human_readable for display strings; structured for rich JSON (e.g. PropertyOption arrays, related records). | (optional) defaults to undefined|
1081
+ | **recordReturnFormat** | [**&#39;LEGACY&#39; | &#39;USER_FRIENDLY&#39; | &#39;EXPANDED&#39;**]**Array<&#39;LEGACY&#39; &#124; &#39;USER_FRIENDLY&#39; &#124; &#39;EXPANDED&#39;>** | Format of the records to return. LEGACY, USER_FRIENDLY, EXPANDED. | (optional) defaults to 'LEGACY'|
793
1082
 
794
1083
 
795
1084
  ### Return type
@@ -815,10 +1104,69 @@ const { status, data } = await apiInstance.search(
815
1104
 
816
1105
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
817
1106
 
818
- # **show1**
819
- > ShowResponse show1()
1107
+ # **searchCrossObject**
1108
+ > PaginationResponse searchCrossObject(crossObjectRecordSearchRequest)
1109
+
1110
+ Searches records across multiple object types in one request. Use fromObjectUuid + relationName to limit to relation target objects (e.g. event attendees), or objectUuids for an explicit list, or omit both to search all company objects (capped). Returns preview-shaped results suitable for relation pickers.
1111
+
1112
+ ### Example
1113
+
1114
+ ```typescript
1115
+ import {
1116
+ RecordsApi,
1117
+ Configuration,
1118
+ CrossObjectRecordSearchRequest
1119
+ } from '@caraer/client';
1120
+
1121
+ const configuration = new Configuration();
1122
+ const apiInstance = new RecordsApi(configuration);
1123
+
1124
+ let crossObjectRecordSearchRequest: CrossObjectRecordSearchRequest; //
1125
+ let archived: boolean; //When true, includes archived records. (optional) (default to false)
1126
+ let parse: 'DB' | 'HUMAN_READABLE' | 'STRUCTURED'; //Parse property values for display. (optional) (default to undefined)
1127
+
1128
+ const { status, data } = await apiInstance.searchCrossObject(
1129
+ crossObjectRecordSearchRequest,
1130
+ archived,
1131
+ parse
1132
+ );
1133
+ ```
1134
+
1135
+ ### Parameters
1136
+
1137
+ |Name | Type | Description | Notes|
1138
+ |------------- | ------------- | ------------- | -------------|
1139
+ | **crossObjectRecordSearchRequest** | **CrossObjectRecordSearchRequest**| | |
1140
+ | **archived** | [**boolean**] | When true, includes archived records. | (optional) defaults to false|
1141
+ | **parse** | [**&#39;DB&#39; | &#39;HUMAN_READABLE&#39; | &#39;STRUCTURED&#39;**]**Array<&#39;DB&#39; &#124; &#39;HUMAN_READABLE&#39; &#124; &#39;STRUCTURED&#39;>** | Parse property values for display. | (optional) defaults to undefined|
1142
+
1143
+
1144
+ ### Return type
1145
+
1146
+ **PaginationResponse**
1147
+
1148
+ ### Authorization
1149
+
1150
+ [bearerAuth](../README.md#bearerAuth)
1151
+
1152
+ ### HTTP request headers
1153
+
1154
+ - **Content-Type**: application/json
1155
+ - **Accept**: application/json
1156
+
1157
+
1158
+ ### HTTP response details
1159
+ | Status code | Description | Response headers |
1160
+ |-------------|-------------|------------------|
1161
+ |**200** | Search completed successfully | - |
1162
+ |**400** | Invalid search parameters | - |
1163
+
1164
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
1165
+
1166
+ # **show**
1167
+ > ShowResponse show()
820
1168
 
821
- Retrieves detailed information about a record by its UUID. Returns a ShowResponse containing the record details.
1169
+ Retrieves detailed information about a record by its UUID. Returns a ShowResponse containing the record details. Prefer GET /{objectName}/{uuid} when the object context is known.
822
1170
 
823
1171
  ### Example
824
1172
 
@@ -833,11 +1181,11 @@ const apiInstance = new RecordsApi(configuration);
833
1181
 
834
1182
  let uuid: string; // (default to undefined)
835
1183
  let object: string; //Optional object name to resolve the record in a specific object context. (optional) (default to undefined)
836
- let recordReturnFormat: string; //Format of the record to return. LEGACY, USER_FRIENDLY, EXPANDED. (optional) (default to 'LEGACY')
837
- let parse: boolean; //Whether to parse the record before returning it. (optional) (default to undefined)
1184
+ let recordReturnFormat: 'LEGACY' | 'USER_FRIENDLY' | 'EXPANDED'; //Format of the record to return. LEGACY, USER_FRIENDLY, EXPANDED. (optional) (default to 'LEGACY')
1185
+ let parse: 'DB' | 'HUMAN_READABLE' | 'STRUCTURED'; //Value presentation mode: omit/false/db for raw stored values; true/human_readable for display strings; structured for rich JSON (e.g. PropertyOption arrays, related records). (optional) (default to undefined)
838
1186
  let fields: string; //Comma-separated property names to include (for example: name,status). When omitted, all properties are returned. (optional) (default to undefined)
839
1187
 
840
- const { status, data } = await apiInstance.show1(
1188
+ const { status, data } = await apiInstance.show(
841
1189
  uuid,
842
1190
  object,
843
1191
  recordReturnFormat,
@@ -852,8 +1200,8 @@ const { status, data } = await apiInstance.show1(
852
1200
  |------------- | ------------- | ------------- | -------------|
853
1201
  | **uuid** | [**string**] | | defaults to undefined|
854
1202
  | **object** | [**string**] | Optional object name to resolve the record in a specific object context. | (optional) defaults to undefined|
855
- | **recordReturnFormat** | [**string**] | Format of the record to return. LEGACY, USER_FRIENDLY, EXPANDED. | (optional) defaults to 'LEGACY'|
856
- | **parse** | [**boolean**] | Whether to parse the record before returning it. | (optional) defaults to undefined|
1203
+ | **recordReturnFormat** | [**&#39;LEGACY&#39; | &#39;USER_FRIENDLY&#39; | &#39;EXPANDED&#39;**]**Array<&#39;LEGACY&#39; &#124; &#39;USER_FRIENDLY&#39; &#124; &#39;EXPANDED&#39;>** | Format of the record to return. LEGACY, USER_FRIENDLY, EXPANDED. | (optional) defaults to 'LEGACY'|
1204
+ | **parse** | [**&#39;DB&#39; | &#39;HUMAN_READABLE&#39; | &#39;STRUCTURED&#39;**]**Array<&#39;DB&#39; &#124; &#39;HUMAN_READABLE&#39; &#124; &#39;STRUCTURED&#39;>** | Value presentation mode: omit/false/db for raw stored values; true/human_readable for display strings; structured for rich JSON (e.g. PropertyOption arrays, related records). | (optional) defaults to undefined|
857
1205
  | **fields** | [**string**] | Comma-separated property names to include (for example: name,status). When omitted, all properties are returned. | (optional) defaults to undefined|
858
1206
 
859
1207
 
@@ -879,6 +1227,121 @@ const { status, data } = await apiInstance.show1(
879
1227
 
880
1228
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
881
1229
 
1230
+ # **showByObject**
1231
+ > ShowResponse showByObject()
1232
+
1233
+ Retrieves a record by object name and UUID. Same response as GET /{uuid}?object={objectName}.
1234
+
1235
+ ### Example
1236
+
1237
+ ```typescript
1238
+ import {
1239
+ RecordsApi,
1240
+ Configuration
1241
+ } from '@caraer/client';
1242
+
1243
+ const configuration = new Configuration();
1244
+ const apiInstance = new RecordsApi(configuration);
1245
+
1246
+ let objectName: string; // (default to undefined)
1247
+ let uuid: string; // (default to undefined)
1248
+ let recordReturnFormat: 'LEGACY' | 'USER_FRIENDLY' | 'EXPANDED'; //Format of the record to return. LEGACY, USER_FRIENDLY, EXPANDED. (optional) (default to 'LEGACY')
1249
+ let parse: 'DB' | 'HUMAN_READABLE' | 'STRUCTURED'; //Value presentation mode: omit/false/db for raw stored values; true/human_readable for display strings; structured for rich JSON (e.g. PropertyOption arrays, related records). (optional) (default to undefined)
1250
+
1251
+ const { status, data } = await apiInstance.showByObject(
1252
+ objectName,
1253
+ uuid,
1254
+ recordReturnFormat,
1255
+ parse
1256
+ );
1257
+ ```
1258
+
1259
+ ### Parameters
1260
+
1261
+ |Name | Type | Description | Notes|
1262
+ |------------- | ------------- | ------------- | -------------|
1263
+ | **objectName** | [**string**] | | defaults to undefined|
1264
+ | **uuid** | [**string**] | | defaults to undefined|
1265
+ | **recordReturnFormat** | [**&#39;LEGACY&#39; | &#39;USER_FRIENDLY&#39; | &#39;EXPANDED&#39;**]**Array<&#39;LEGACY&#39; &#124; &#39;USER_FRIENDLY&#39; &#124; &#39;EXPANDED&#39;>** | Format of the record to return. LEGACY, USER_FRIENDLY, EXPANDED. | (optional) defaults to 'LEGACY'|
1266
+ | **parse** | [**&#39;DB&#39; | &#39;HUMAN_READABLE&#39; | &#39;STRUCTURED&#39;**]**Array<&#39;DB&#39; &#124; &#39;HUMAN_READABLE&#39; &#124; &#39;STRUCTURED&#39;>** | Value presentation mode: omit/false/db for raw stored values; true/human_readable for display strings; structured for rich JSON (e.g. PropertyOption arrays, related records). | (optional) defaults to undefined|
1267
+
1268
+
1269
+ ### Return type
1270
+
1271
+ **ShowResponse**
1272
+
1273
+ ### Authorization
1274
+
1275
+ [bearerAuth](../README.md#bearerAuth)
1276
+
1277
+ ### HTTP request headers
1278
+
1279
+ - **Content-Type**: Not defined
1280
+ - **Accept**: application/json
1281
+
1282
+
1283
+ ### HTTP response details
1284
+ | Status code | Description | Response headers |
1285
+ |-------------|-------------|------------------|
1286
+ |**200** | Record retrieved successfully | - |
1287
+ |**404** | Record not found | - |
1288
+
1289
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
1290
+
1291
+ # **suggestAnalyticsWidgets**
1292
+ > SuccessResponse suggestAnalyticsWidgets(suggestAnalyticsWidgetsRequest)
1293
+
1294
+ Uses structured OpenAI output plus schema validation to propose dashboard charts for an object. Returns an empty list when AI is unavailable.
1295
+
1296
+ ### Example
1297
+
1298
+ ```typescript
1299
+ import {
1300
+ RecordsApi,
1301
+ Configuration,
1302
+ SuggestAnalyticsWidgetsRequest
1303
+ } from '@caraer/client';
1304
+
1305
+ const configuration = new Configuration();
1306
+ const apiInstance = new RecordsApi(configuration);
1307
+
1308
+ let suggestAnalyticsWidgetsRequest: SuggestAnalyticsWidgetsRequest; //
1309
+
1310
+ const { status, data } = await apiInstance.suggestAnalyticsWidgets(
1311
+ suggestAnalyticsWidgetsRequest
1312
+ );
1313
+ ```
1314
+
1315
+ ### Parameters
1316
+
1317
+ |Name | Type | Description | Notes|
1318
+ |------------- | ------------- | ------------- | -------------|
1319
+ | **suggestAnalyticsWidgetsRequest** | **SuggestAnalyticsWidgetsRequest**| | |
1320
+
1321
+
1322
+ ### Return type
1323
+
1324
+ **SuccessResponse**
1325
+
1326
+ ### Authorization
1327
+
1328
+ [bearerAuth](../README.md#bearerAuth)
1329
+
1330
+ ### HTTP request headers
1331
+
1332
+ - **Content-Type**: application/json
1333
+ - **Accept**: application/json
1334
+
1335
+
1336
+ ### HTTP response details
1337
+ | Status code | Description | Response headers |
1338
+ |-------------|-------------|------------------|
1339
+ |**200** | Suggestions generated (may be empty) | - |
1340
+ |**400** | Invalid request | - |
1341
+ |**404** | Object not found | - |
1342
+
1343
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
1344
+
882
1345
  # **update**
883
1346
  > UpdateResponse update(recordDTO)
884
1347
 
@@ -899,9 +1362,9 @@ const apiInstance = new RecordsApi(configuration);
899
1362
  let uuid: string; // (default to undefined)
900
1363
  let objectName: string; // (default to undefined)
901
1364
  let recordDTO: RecordDTO; //Record data to update
902
- let parse: boolean; //If \'true\', parses the updated record to human-readable values before returning. (optional) (default to false)
1365
+ let parse: 'DB' | 'HUMAN_READABLE' | 'STRUCTURED'; //Value presentation mode: omit/false/db for raw stored values; true/human_readable for display strings; structured for rich JSON (e.g. PropertyOption arrays, related records). (optional) (default to undefined)
903
1366
  let ignoreErrors: boolean; //If \'true\', allows the update to proceed while ignoring certain non-critical validation errors, when supported. (optional) (default to false)
904
- let recordReturnFormat: string; //Format of the record to return. LEGACY, USER_FRIENDLY, EXPANDED. (optional) (default to 'LEGACY')
1367
+ let recordReturnFormat: 'LEGACY' | 'USER_FRIENDLY' | 'EXPANDED'; //Format of the record to return. LEGACY, USER_FRIENDLY, EXPANDED. (optional) (default to 'LEGACY')
905
1368
 
906
1369
  const { status, data } = await apiInstance.update(
907
1370
  uuid,
@@ -920,9 +1383,79 @@ const { status, data } = await apiInstance.update(
920
1383
  | **recordDTO** | **RecordDTO**| Record data to update | |
921
1384
  | **uuid** | [**string**] | | defaults to undefined|
922
1385
  | **objectName** | [**string**] | | defaults to undefined|
923
- | **parse** | [**boolean**] | If \&#39;true\&#39;, parses the updated record to human-readable values before returning. | (optional) defaults to false|
1386
+ | **parse** | [**&#39;DB&#39; | &#39;HUMAN_READABLE&#39; | &#39;STRUCTURED&#39;**]**Array<&#39;DB&#39; &#124; &#39;HUMAN_READABLE&#39; &#124; &#39;STRUCTURED&#39;>** | Value presentation mode: omit/false/db for raw stored values; true/human_readable for display strings; structured for rich JSON (e.g. PropertyOption arrays, related records). | (optional) defaults to undefined|
1387
+ | **ignoreErrors** | [**boolean**] | If \&#39;true\&#39;, allows the update to proceed while ignoring certain non-critical validation errors, when supported. | (optional) defaults to false|
1388
+ | **recordReturnFormat** | [**&#39;LEGACY&#39; | &#39;USER_FRIENDLY&#39; | &#39;EXPANDED&#39;**]**Array<&#39;LEGACY&#39; &#124; &#39;USER_FRIENDLY&#39; &#124; &#39;EXPANDED&#39;>** | Format of the record to return. LEGACY, USER_FRIENDLY, EXPANDED. | (optional) defaults to 'LEGACY'|
1389
+
1390
+
1391
+ ### Return type
1392
+
1393
+ **UpdateResponse**
1394
+
1395
+ ### Authorization
1396
+
1397
+ [bearerAuth](../README.md#bearerAuth)
1398
+
1399
+ ### HTTP request headers
1400
+
1401
+ - **Content-Type**: application/json
1402
+ - **Accept**: application/json
1403
+
1404
+
1405
+ ### HTTP response details
1406
+ | Status code | Description | Response headers |
1407
+ |-------------|-------------|------------------|
1408
+ |**200** | Record updated successfully | - |
1409
+ |**400** | Invalid input data | - |
1410
+ |**404** | Record not found | - |
1411
+ |**500** | Internal server error | - |
1412
+
1413
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
1414
+
1415
+ # **updateByUuid**
1416
+ > UpdateResponse updateByUuid(recordDTO)
1417
+
1418
+ Updates a record identified by UUID. Optional object query param resolves the object context (same as GET /{uuid}?object=...). When omitted, the record\'s current/primary object is used. Prefer PUT /{objectName}/{uuid} when the object context is known.
1419
+
1420
+ ### Example
1421
+
1422
+ ```typescript
1423
+ import {
1424
+ RecordsApi,
1425
+ Configuration,
1426
+ RecordDTO
1427
+ } from '@caraer/client';
1428
+
1429
+ const configuration = new Configuration();
1430
+ const apiInstance = new RecordsApi(configuration);
1431
+
1432
+ let uuid: string; // (default to undefined)
1433
+ let recordDTO: RecordDTO; //
1434
+ let object: string; //Optional object name to resolve the record in a specific object context. (optional) (default to undefined)
1435
+ let parse: 'DB' | 'HUMAN_READABLE' | 'STRUCTURED'; //Value presentation mode: omit/false/db for raw stored values; true/human_readable for display strings; structured for rich JSON (e.g. PropertyOption arrays, related records). (optional) (default to undefined)
1436
+ let ignoreErrors: boolean; //If \'true\', allows the update to proceed while ignoring certain non-critical validation errors, when supported. (optional) (default to false)
1437
+ let recordReturnFormat: 'LEGACY' | 'USER_FRIENDLY' | 'EXPANDED'; //Format of the record to return. LEGACY, USER_FRIENDLY, EXPANDED. (optional) (default to 'LEGACY')
1438
+
1439
+ const { status, data } = await apiInstance.updateByUuid(
1440
+ uuid,
1441
+ recordDTO,
1442
+ object,
1443
+ parse,
1444
+ ignoreErrors,
1445
+ recordReturnFormat
1446
+ );
1447
+ ```
1448
+
1449
+ ### Parameters
1450
+
1451
+ |Name | Type | Description | Notes|
1452
+ |------------- | ------------- | ------------- | -------------|
1453
+ | **recordDTO** | **RecordDTO**| | |
1454
+ | **uuid** | [**string**] | | defaults to undefined|
1455
+ | **object** | [**string**] | Optional object name to resolve the record in a specific object context. | (optional) defaults to undefined|
1456
+ | **parse** | [**&#39;DB&#39; | &#39;HUMAN_READABLE&#39; | &#39;STRUCTURED&#39;**]**Array<&#39;DB&#39; &#124; &#39;HUMAN_READABLE&#39; &#124; &#39;STRUCTURED&#39;>** | Value presentation mode: omit/false/db for raw stored values; true/human_readable for display strings; structured for rich JSON (e.g. PropertyOption arrays, related records). | (optional) defaults to undefined|
924
1457
  | **ignoreErrors** | [**boolean**] | If \&#39;true\&#39;, allows the update to proceed while ignoring certain non-critical validation errors, when supported. | (optional) defaults to false|
925
- | **recordReturnFormat** | [**string**] | Format of the record to return. LEGACY, USER_FRIENDLY, EXPANDED. | (optional) defaults to 'LEGACY'|
1458
+ | **recordReturnFormat** | [**&#39;LEGACY&#39; | &#39;USER_FRIENDLY&#39; | &#39;EXPANDED&#39;**]**Array<&#39;LEGACY&#39; &#124; &#39;USER_FRIENDLY&#39; &#124; &#39;EXPANDED&#39;>** | Format of the record to return. LEGACY, USER_FRIENDLY, EXPANDED. | (optional) defaults to 'LEGACY'|
926
1459
 
927
1460
 
928
1461
  ### Return type
@@ -949,3 +1482,66 @@ const { status, data } = await apiInstance.update(
949
1482
 
950
1483
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
951
1484
 
1485
+ # **updateRelationEdge**
1486
+ > SuccessResponse updateRelationEdge(relationEdgeRequestDTO)
1487
+
1488
+ Patches values stored on an existing relation edge. Only keys present in edgeProperties are written; a null value clears a key.
1489
+
1490
+ ### Example
1491
+
1492
+ ```typescript
1493
+ import {
1494
+ RecordsApi,
1495
+ Configuration,
1496
+ RelationEdgeRequestDTO
1497
+ } from '@caraer/client';
1498
+
1499
+ const configuration = new Configuration();
1500
+ const apiInstance = new RecordsApi(configuration);
1501
+
1502
+ let fromUuid: string; // (default to undefined)
1503
+ let relationName: string; // (default to undefined)
1504
+ let toUuid: string; // (default to undefined)
1505
+ let relationEdgeRequestDTO: RelationEdgeRequestDTO; //
1506
+
1507
+ const { status, data } = await apiInstance.updateRelationEdge(
1508
+ fromUuid,
1509
+ relationName,
1510
+ toUuid,
1511
+ relationEdgeRequestDTO
1512
+ );
1513
+ ```
1514
+
1515
+ ### Parameters
1516
+
1517
+ |Name | Type | Description | Notes|
1518
+ |------------- | ------------- | ------------- | -------------|
1519
+ | **relationEdgeRequestDTO** | **RelationEdgeRequestDTO**| | |
1520
+ | **fromUuid** | [**string**] | | defaults to undefined|
1521
+ | **relationName** | [**string**] | | defaults to undefined|
1522
+ | **toUuid** | [**string**] | | defaults to undefined|
1523
+
1524
+
1525
+ ### Return type
1526
+
1527
+ **SuccessResponse**
1528
+
1529
+ ### Authorization
1530
+
1531
+ [bearerAuth](../README.md#bearerAuth)
1532
+
1533
+ ### HTTP request headers
1534
+
1535
+ - **Content-Type**: application/json
1536
+ - **Accept**: application/json
1537
+
1538
+
1539
+ ### HTTP response details
1540
+ | Status code | Description | Response headers |
1541
+ |-------------|-------------|------------------|
1542
+ |**200** | Relation updated successfully | - |
1543
+ |**400** | Unknown or invalid edge property | - |
1544
+ |**404** | One or more entities not found | - |
1545
+
1546
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
1547
+