@cosmotech/api-ts 4.0.0-dev9 → 5.0.0-beta4

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 (106) hide show
  1. package/.openapi-generator/FILES +96 -0
  2. package/.openapi-generator/VERSION +1 -0
  3. package/.openapi-generator-ignore +23 -0
  4. package/LICENSE +1 -1
  5. package/README.md +212 -2
  6. package/api.ts +4896 -4560
  7. package/base.ts +2 -2
  8. package/common.ts +1 -1
  9. package/configuration.ts +7 -2
  10. package/dist/api.d.ts +3303 -2892
  11. package/dist/api.js +4182 -4367
  12. package/dist/base.d.ts +1 -1
  13. package/dist/base.js +2 -2
  14. package/dist/common.d.ts +2 -2
  15. package/dist/common.js +1 -1
  16. package/dist/configuration.d.ts +1 -1
  17. package/dist/configuration.js +14 -2
  18. package/dist/index.d.ts +1 -1
  19. package/dist/index.js +1 -1
  20. package/docs/AboutInfo.md +21 -0
  21. package/docs/AboutInfoVersion.md +33 -0
  22. package/docs/ComponentRolePermissions.md +23 -0
  23. package/docs/ContainerResourceSizeInfo.md +23 -0
  24. package/docs/ContainerResourceSizing.md +23 -0
  25. package/docs/CreateInfo.md +24 -0
  26. package/docs/CreatedRun.md +21 -0
  27. package/docs/Dataset.md +39 -0
  28. package/docs/DatasetAccessControl.md +23 -0
  29. package/docs/DatasetApi.md +1289 -0
  30. package/docs/DatasetCreateRequest.md +31 -0
  31. package/docs/DatasetPart.md +41 -0
  32. package/docs/DatasetPartCreateRequest.md +29 -0
  33. package/docs/DatasetPartTypeEnum.md +11 -0
  34. package/docs/DatasetPartUpdateRequest.md +25 -0
  35. package/docs/DatasetRole.md +21 -0
  36. package/docs/DatasetSecurity.md +23 -0
  37. package/docs/DatasetUpdateRequest.md +29 -0
  38. package/docs/EditInfo.md +22 -0
  39. package/docs/LastRunInfo.md +23 -0
  40. package/docs/MetaApi.md +51 -0
  41. package/docs/Organization.md +29 -0
  42. package/docs/OrganizationAccessControl.md +23 -0
  43. package/docs/OrganizationApi.md +758 -0
  44. package/docs/OrganizationCreateRequest.md +23 -0
  45. package/docs/OrganizationEditInfo.md +22 -0
  46. package/docs/OrganizationRole.md +21 -0
  47. package/docs/OrganizationSecurity.md +23 -0
  48. package/docs/OrganizationUpdateRequest.md +21 -0
  49. package/docs/QueryResult.md +21 -0
  50. package/docs/ResourceSizeInfo.md +23 -0
  51. package/docs/Run.md +55 -0
  52. package/docs/RunApi.md +442 -0
  53. package/docs/RunContainer.md +41 -0
  54. package/docs/RunData.md +25 -0
  55. package/docs/RunDataQuery.md +21 -0
  56. package/docs/RunEditInfo.md +22 -0
  57. package/docs/RunResourceRequested.md +23 -0
  58. package/docs/RunState.md +17 -0
  59. package/docs/RunStatus.md +49 -0
  60. package/docs/RunStatusNode.md +43 -0
  61. package/docs/RunTemplate.md +37 -0
  62. package/docs/RunTemplateCreateRequest.md +37 -0
  63. package/docs/RunTemplateParameter.md +37 -0
  64. package/docs/RunTemplateParameterCreateRequest.md +37 -0
  65. package/docs/RunTemplateParameterGroup.md +33 -0
  66. package/docs/RunTemplateParameterGroupCreateRequest.md +33 -0
  67. package/docs/RunTemplateParameterGroupUpdateRequest.md +31 -0
  68. package/docs/RunTemplateParameterUpdateRequest.md +35 -0
  69. package/docs/RunTemplateParameterValue.md +25 -0
  70. package/docs/RunTemplateResourceSizing.md +23 -0
  71. package/docs/RunTemplateUpdateRequest.md +35 -0
  72. package/docs/Runner.md +61 -0
  73. package/docs/RunnerAccessControl.md +23 -0
  74. package/docs/RunnerApi.md +908 -0
  75. package/docs/RunnerCreateRequest.md +45 -0
  76. package/docs/RunnerEditInfo.md +22 -0
  77. package/docs/RunnerResourceSizing.md +23 -0
  78. package/docs/RunnerRole.md +21 -0
  79. package/docs/RunnerRunTemplateParameterValue.md +27 -0
  80. package/docs/RunnerSecurity.md +23 -0
  81. package/docs/RunnerUpdateRequest.md +39 -0
  82. package/docs/RunnerValidationStatus.md +15 -0
  83. package/docs/SendRunDataRequest.md +23 -0
  84. package/docs/Solution.md +53 -0
  85. package/docs/SolutionAccessControl.md +23 -0
  86. package/docs/SolutionApi.md +1870 -0
  87. package/docs/SolutionCreateRequest.md +43 -0
  88. package/docs/SolutionEditInfo.md +22 -0
  89. package/docs/SolutionFile.md +21 -0
  90. package/docs/SolutionRole.md +21 -0
  91. package/docs/SolutionSecurity.md +23 -0
  92. package/docs/SolutionUpdateRequest.md +41 -0
  93. package/docs/Workspace.md +45 -0
  94. package/docs/WorkspaceAccessControl.md +23 -0
  95. package/docs/WorkspaceApi.md +1044 -0
  96. package/docs/WorkspaceCreateRequest.md +37 -0
  97. package/docs/WorkspaceEditInfo.md +22 -0
  98. package/docs/WorkspaceFile.md +21 -0
  99. package/docs/WorkspaceRole.md +21 -0
  100. package/docs/WorkspaceSecurity.md +23 -0
  101. package/docs/WorkspaceSolution.md +25 -0
  102. package/docs/WorkspaceUpdateRequest.md +33 -0
  103. package/docs/WorkspaceWebApp.md +25 -0
  104. package/index.ts +1 -1
  105. package/package.json +1 -1
  106. package/scripts/git_push.sh +1 -1
@@ -0,0 +1,1289 @@
1
+ # DatasetApi
2
+
3
+ All URIs are relative to *http://localhost:8080*
4
+
5
+ |Method | HTTP request | Description|
6
+ |------------- | ------------- | -------------|
7
+ |[**createDataset**](#createdataset) | **POST** /organizations/{organization_id}/workspaces/{workspace_id}/datasets | Create a Dataset|
8
+ |[**createDatasetAccessControl**](#createdatasetaccesscontrol) | **POST** /organizations/{organization_id}/workspaces/{workspace_id}/datasets/{dataset_id}/security/access | Add a control access to the Dataset|
9
+ |[**createDatasetPart**](#createdatasetpart) | **POST** /organizations/{organization_id}/workspaces/{workspace_id}/datasets/{dataset_id}/parts | Create a data part of a Dataset|
10
+ |[**deleteDataset**](#deletedataset) | **DELETE** /organizations/{organization_id}/workspaces/{workspace_id}/datasets/{dataset_id} | Delete a Dataset|
11
+ |[**deleteDatasetAccessControl**](#deletedatasetaccesscontrol) | **DELETE** /organizations/{organization_id}/workspaces/{workspace_id}/datasets/{dataset_id}/security/access/{identity_id} | Remove the specified access from the given Dataset|
12
+ |[**deleteDatasetPart**](#deletedatasetpart) | **DELETE** /organizations/{organization_id}/workspaces/{workspace_id}/datasets/{dataset_id}/parts/{dataset_part_id} | Delete a Dataset part|
13
+ |[**downloadDatasetPart**](#downloaddatasetpart) | **GET** /organizations/{organization_id}/workspaces/{workspace_id}/datasets/{dataset_id}/parts/{dataset_part_id}/download | Download data from a dataset part|
14
+ |[**getDataset**](#getdataset) | **GET** /organizations/{organization_id}/workspaces/{workspace_id}/datasets/{dataset_id} | Retrieve a Dataset|
15
+ |[**getDatasetAccessControl**](#getdatasetaccesscontrol) | **GET** /organizations/{organization_id}/workspaces/{workspace_id}/datasets/{dataset_id}/security/access/{identity_id} | Get a control access for the Dataset|
16
+ |[**getDatasetPart**](#getdatasetpart) | **GET** /organizations/{organization_id}/workspaces/{workspace_id}/datasets/{dataset_id}/parts/{dataset_part_id} | Retrieve a data part of a Dataset|
17
+ |[**listDatasetParts**](#listdatasetparts) | **GET** /organizations/{organization_id}/workspaces/{workspace_id}/datasets/{dataset_id}/parts | Retrieve all dataset parts of a Dataset|
18
+ |[**listDatasetSecurityUsers**](#listdatasetsecurityusers) | **GET** /organizations/{organization_id}/workspaces/{workspace_id}/datasets/{dataset_id}/security/users | Get the Dataset security users list|
19
+ |[**listDatasets**](#listdatasets) | **GET** /organizations/{organization_id}/workspaces/{workspace_id}/datasets | Retrieve a list of defined Dataset|
20
+ |[**queryData**](#querydata) | **GET** /organizations/{organization_id}/workspaces/{workspace_id}/datasets/{dataset_id}/parts/{dataset_part_id}/query | Get data of a Dataset|
21
+ |[**replaceDatasetPart**](#replacedatasetpart) | **PUT** /organizations/{organization_id}/workspaces/{workspace_id}/datasets/{dataset_id}/parts/{dataset_part_id} | Replace existing dataset parts of a Dataset|
22
+ |[**searchDatasetParts**](#searchdatasetparts) | **POST** /organizations/{organization_id}/workspaces/{workspace_id}/datasets/{dataset_id}/parts/search | Search Dataset parts by tags|
23
+ |[**searchDatasets**](#searchdatasets) | **POST** /organizations/{organization_id}/workspaces/{workspace_id}/datasets/search | Search Datasets by tags|
24
+ |[**updateDataset**](#updatedataset) | **PATCH** /organizations/{organization_id}/workspaces/{workspace_id}/datasets/{dataset_id} | Update a Dataset|
25
+ |[**updateDatasetAccessControl**](#updatedatasetaccesscontrol) | **PATCH** /organizations/{organization_id}/workspaces/{workspace_id}/datasets/{dataset_id}/security/access/{identity_id} | Update the specified access to User for a Dataset|
26
+ |[**updateDatasetDefaultSecurity**](#updatedatasetdefaultsecurity) | **PATCH** /organizations/{organization_id}/workspaces/{workspace_id}/datasets/{dataset_id}/security/default | Set the Dataset default security|
27
+
28
+ # **createDataset**
29
+ > Dataset createDataset()
30
+
31
+
32
+ ### Example
33
+
34
+ ```typescript
35
+ import {
36
+ DatasetApi,
37
+ Configuration,
38
+ DatasetCreateRequest
39
+ } from '@cosmotech/api-ts';
40
+
41
+ const configuration = new Configuration();
42
+ const apiInstance = new DatasetApi(configuration);
43
+
44
+ let organizationId: string; //the Organization identifier (default to undefined)
45
+ let workspaceId: string; //the Workspace identifier (default to undefined)
46
+ let datasetCreateRequest: DatasetCreateRequest; // (default to undefined)
47
+ let files: Array<File>; //Notes: - Each parts defined in dataset should have a file defined in this list - Please ensure that upload files order match with data parts list defined - First file uploaded will match with first dataset parts and so on (optional) (default to undefined)
48
+
49
+ const { status, data } = await apiInstance.createDataset(
50
+ organizationId,
51
+ workspaceId,
52
+ datasetCreateRequest,
53
+ files
54
+ );
55
+ ```
56
+
57
+ ### Parameters
58
+
59
+ |Name | Type | Description | Notes|
60
+ |------------- | ------------- | ------------- | -------------|
61
+ | **organizationId** | [**string**] | the Organization identifier | defaults to undefined|
62
+ | **workspaceId** | [**string**] | the Workspace identifier | defaults to undefined|
63
+ | **datasetCreateRequest** | **DatasetCreateRequest** | | defaults to undefined|
64
+ | **files** | **Array&lt;File&gt;** | Notes: - Each parts defined in dataset should have a file defined in this list - Please ensure that upload files order match with data parts list defined - First file uploaded will match with first dataset parts and so on | (optional) defaults to undefined|
65
+
66
+
67
+ ### Return type
68
+
69
+ **Dataset**
70
+
71
+ ### Authorization
72
+
73
+ [oAuth2AuthCode](../README.md#oAuth2AuthCode)
74
+
75
+ ### HTTP request headers
76
+
77
+ - **Content-Type**: multipart/form-data
78
+ - **Accept**: application/json, application/yaml
79
+
80
+
81
+ ### HTTP response details
82
+ | Status code | Description | Response headers |
83
+ |-------------|-------------|------------------|
84
+ |**201** | Dataset successfully created | - |
85
+ |**400** | Bad request | - |
86
+ |**403** | Insufficient permissions on organization or workspace or dataset | - |
87
+ |**404** | Organization or workspace specified is not found | - |
88
+
89
+ [[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)
90
+
91
+ # **createDatasetAccessControl**
92
+ > DatasetAccessControl createDatasetAccessControl(datasetAccessControl)
93
+
94
+
95
+ ### Example
96
+
97
+ ```typescript
98
+ import {
99
+ DatasetApi,
100
+ Configuration,
101
+ DatasetAccessControl
102
+ } from '@cosmotech/api-ts';
103
+
104
+ const configuration = new Configuration();
105
+ const apiInstance = new DatasetApi(configuration);
106
+
107
+ let organizationId: string; //the Organization identifier (default to undefined)
108
+ let workspaceId: string; //the Workspace identifier (default to undefined)
109
+ let datasetId: string; //the Dataset identifier (default to undefined)
110
+ let datasetAccessControl: DatasetAccessControl; //the new Dataset security access to add.
111
+
112
+ const { status, data } = await apiInstance.createDatasetAccessControl(
113
+ organizationId,
114
+ workspaceId,
115
+ datasetId,
116
+ datasetAccessControl
117
+ );
118
+ ```
119
+
120
+ ### Parameters
121
+
122
+ |Name | Type | Description | Notes|
123
+ |------------- | ------------- | ------------- | -------------|
124
+ | **datasetAccessControl** | **DatasetAccessControl**| the new Dataset security access to add. | |
125
+ | **organizationId** | [**string**] | the Organization identifier | defaults to undefined|
126
+ | **workspaceId** | [**string**] | the Workspace identifier | defaults to undefined|
127
+ | **datasetId** | [**string**] | the Dataset identifier | defaults to undefined|
128
+
129
+
130
+ ### Return type
131
+
132
+ **DatasetAccessControl**
133
+
134
+ ### Authorization
135
+
136
+ [oAuth2AuthCode](../README.md#oAuth2AuthCode)
137
+
138
+ ### HTTP request headers
139
+
140
+ - **Content-Type**: application/json, application/yaml
141
+ - **Accept**: application/json, application/yaml
142
+
143
+
144
+ ### HTTP response details
145
+ | Status code | Description | Response headers |
146
+ |-------------|-------------|------------------|
147
+ |**201** | The Dataset access | - |
148
+ |**404** | the Dataset specified is unknown or you don\&#39;t have access to it | - |
149
+
150
+ [[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)
151
+
152
+ # **createDatasetPart**
153
+ > DatasetPart createDatasetPart()
154
+
155
+
156
+ ### Example
157
+
158
+ ```typescript
159
+ import {
160
+ DatasetApi,
161
+ Configuration,
162
+ DatasetPartCreateRequest
163
+ } from '@cosmotech/api-ts';
164
+
165
+ const configuration = new Configuration();
166
+ const apiInstance = new DatasetApi(configuration);
167
+
168
+ let organizationId: string; //the Organization identifier (default to undefined)
169
+ let workspaceId: string; //the Workspace identifier (default to undefined)
170
+ let datasetId: string; //the Dataset identifier (default to undefined)
171
+ let file: File; //Data file to upload (default to undefined)
172
+ let datasetPartCreateRequest: DatasetPartCreateRequest; // (default to undefined)
173
+
174
+ const { status, data } = await apiInstance.createDatasetPart(
175
+ organizationId,
176
+ workspaceId,
177
+ datasetId,
178
+ file,
179
+ datasetPartCreateRequest
180
+ );
181
+ ```
182
+
183
+ ### Parameters
184
+
185
+ |Name | Type | Description | Notes|
186
+ |------------- | ------------- | ------------- | -------------|
187
+ | **organizationId** | [**string**] | the Organization identifier | defaults to undefined|
188
+ | **workspaceId** | [**string**] | the Workspace identifier | defaults to undefined|
189
+ | **datasetId** | [**string**] | the Dataset identifier | defaults to undefined|
190
+ | **file** | [**File**] | Data file to upload | defaults to undefined|
191
+ | **datasetPartCreateRequest** | **DatasetPartCreateRequest** | | defaults to undefined|
192
+
193
+
194
+ ### Return type
195
+
196
+ **DatasetPart**
197
+
198
+ ### Authorization
199
+
200
+ [oAuth2AuthCode](../README.md#oAuth2AuthCode)
201
+
202
+ ### HTTP request headers
203
+
204
+ - **Content-Type**: multipart/form-data
205
+ - **Accept**: application/json, application/yaml
206
+
207
+
208
+ ### HTTP response details
209
+ | Status code | Description | Response headers |
210
+ |-------------|-------------|------------------|
211
+ |**201** | Dataset part successfully created | - |
212
+ |**400** | Bad request - Dataset part cannot be created | - |
213
+ |**403** | Insufficient permissions on organization or workspace or dataset | - |
214
+ |**404** | Dataset specified is not found | - |
215
+
216
+ [[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)
217
+
218
+ # **deleteDataset**
219
+ > deleteDataset()
220
+
221
+ Delete a dataset
222
+
223
+ ### Example
224
+
225
+ ```typescript
226
+ import {
227
+ DatasetApi,
228
+ Configuration
229
+ } from '@cosmotech/api-ts';
230
+
231
+ const configuration = new Configuration();
232
+ const apiInstance = new DatasetApi(configuration);
233
+
234
+ let organizationId: string; //the Organization identifier (default to undefined)
235
+ let workspaceId: string; //the Workspace identifier (default to undefined)
236
+ let datasetId: string; //the Dataset identifier (default to undefined)
237
+
238
+ const { status, data } = await apiInstance.deleteDataset(
239
+ organizationId,
240
+ workspaceId,
241
+ datasetId
242
+ );
243
+ ```
244
+
245
+ ### Parameters
246
+
247
+ |Name | Type | Description | Notes|
248
+ |------------- | ------------- | ------------- | -------------|
249
+ | **organizationId** | [**string**] | the Organization identifier | defaults to undefined|
250
+ | **workspaceId** | [**string**] | the Workspace identifier | defaults to undefined|
251
+ | **datasetId** | [**string**] | the Dataset identifier | defaults to undefined|
252
+
253
+
254
+ ### Return type
255
+
256
+ void (empty response body)
257
+
258
+ ### Authorization
259
+
260
+ [oAuth2AuthCode](../README.md#oAuth2AuthCode)
261
+
262
+ ### HTTP request headers
263
+
264
+ - **Content-Type**: Not defined
265
+ - **Accept**: Not defined
266
+
267
+
268
+ ### HTTP response details
269
+ | Status code | Description | Response headers |
270
+ |-------------|-------------|------------------|
271
+ |**204** | Dataset successfully deleted | - |
272
+ |**403** | Insufficient permissions on organization or workspace or dataset | - |
273
+ |**404** | Organization or workspace or dataset specified is not found | - |
274
+
275
+ [[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)
276
+
277
+ # **deleteDatasetAccessControl**
278
+ > deleteDatasetAccessControl()
279
+
280
+
281
+ ### Example
282
+
283
+ ```typescript
284
+ import {
285
+ DatasetApi,
286
+ Configuration
287
+ } from '@cosmotech/api-ts';
288
+
289
+ const configuration = new Configuration();
290
+ const apiInstance = new DatasetApi(configuration);
291
+
292
+ let organizationId: string; //the Organization identifier (default to undefined)
293
+ let workspaceId: string; //the Workspace identifier (default to undefined)
294
+ let datasetId: string; //the Dataset identifier (default to undefined)
295
+ let identityId: string; //the User identifier (default to undefined)
296
+
297
+ const { status, data } = await apiInstance.deleteDatasetAccessControl(
298
+ organizationId,
299
+ workspaceId,
300
+ datasetId,
301
+ identityId
302
+ );
303
+ ```
304
+
305
+ ### Parameters
306
+
307
+ |Name | Type | Description | Notes|
308
+ |------------- | ------------- | ------------- | -------------|
309
+ | **organizationId** | [**string**] | the Organization identifier | defaults to undefined|
310
+ | **workspaceId** | [**string**] | the Workspace identifier | defaults to undefined|
311
+ | **datasetId** | [**string**] | the Dataset identifier | defaults to undefined|
312
+ | **identityId** | [**string**] | the User identifier | defaults to undefined|
313
+
314
+
315
+ ### Return type
316
+
317
+ void (empty response body)
318
+
319
+ ### Authorization
320
+
321
+ [oAuth2AuthCode](../README.md#oAuth2AuthCode)
322
+
323
+ ### HTTP request headers
324
+
325
+ - **Content-Type**: Not defined
326
+ - **Accept**: Not defined
327
+
328
+
329
+ ### HTTP response details
330
+ | Status code | Description | Response headers |
331
+ |-------------|-------------|------------------|
332
+ |**204** | Request succeeded | - |
333
+ |**404** | The Dataset or the user specified is unknown or you don\&#39;t have access to them | - |
334
+
335
+ [[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)
336
+
337
+ # **deleteDatasetPart**
338
+ > deleteDatasetPart()
339
+
340
+ Delete a dataset part
341
+
342
+ ### Example
343
+
344
+ ```typescript
345
+ import {
346
+ DatasetApi,
347
+ Configuration
348
+ } from '@cosmotech/api-ts';
349
+
350
+ const configuration = new Configuration();
351
+ const apiInstance = new DatasetApi(configuration);
352
+
353
+ let organizationId: string; //the Organization identifier (default to undefined)
354
+ let workspaceId: string; //the Workspace identifier (default to undefined)
355
+ let datasetId: string; //the Dataset identifier (default to undefined)
356
+ let datasetPartId: string; //the Dataset part identifier (default to undefined)
357
+
358
+ const { status, data } = await apiInstance.deleteDatasetPart(
359
+ organizationId,
360
+ workspaceId,
361
+ datasetId,
362
+ datasetPartId
363
+ );
364
+ ```
365
+
366
+ ### Parameters
367
+
368
+ |Name | Type | Description | Notes|
369
+ |------------- | ------------- | ------------- | -------------|
370
+ | **organizationId** | [**string**] | the Organization identifier | defaults to undefined|
371
+ | **workspaceId** | [**string**] | the Workspace identifier | defaults to undefined|
372
+ | **datasetId** | [**string**] | the Dataset identifier | defaults to undefined|
373
+ | **datasetPartId** | [**string**] | the Dataset part identifier | defaults to undefined|
374
+
375
+
376
+ ### Return type
377
+
378
+ void (empty response body)
379
+
380
+ ### Authorization
381
+
382
+ [oAuth2AuthCode](../README.md#oAuth2AuthCode)
383
+
384
+ ### HTTP request headers
385
+
386
+ - **Content-Type**: Not defined
387
+ - **Accept**: Not defined
388
+
389
+
390
+ ### HTTP response details
391
+ | Status code | Description | Response headers |
392
+ |-------------|-------------|------------------|
393
+ |**204** | Dataset part successfully deleted | - |
394
+ |**403** | Insufficient permissions on organization or workspace or dataset | - |
395
+ |**404** | Dataset part specified is not found | - |
396
+
397
+ [[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)
398
+
399
+ # **downloadDatasetPart**
400
+ > File downloadDatasetPart()
401
+
402
+
403
+ ### Example
404
+
405
+ ```typescript
406
+ import {
407
+ DatasetApi,
408
+ Configuration
409
+ } from '@cosmotech/api-ts';
410
+
411
+ const configuration = new Configuration();
412
+ const apiInstance = new DatasetApi(configuration);
413
+
414
+ let organizationId: string; //the Organization identifier (default to undefined)
415
+ let workspaceId: string; //the Workspace identifier (default to undefined)
416
+ let datasetId: string; //the Dataset identifier (default to undefined)
417
+ let datasetPartId: string; //the Dataset part identifier (default to undefined)
418
+
419
+ const { status, data } = await apiInstance.downloadDatasetPart(
420
+ organizationId,
421
+ workspaceId,
422
+ datasetId,
423
+ datasetPartId
424
+ );
425
+ ```
426
+
427
+ ### Parameters
428
+
429
+ |Name | Type | Description | Notes|
430
+ |------------- | ------------- | ------------- | -------------|
431
+ | **organizationId** | [**string**] | the Organization identifier | defaults to undefined|
432
+ | **workspaceId** | [**string**] | the Workspace identifier | defaults to undefined|
433
+ | **datasetId** | [**string**] | the Dataset identifier | defaults to undefined|
434
+ | **datasetPartId** | [**string**] | the Dataset part identifier | defaults to undefined|
435
+
436
+
437
+ ### Return type
438
+
439
+ **File**
440
+
441
+ ### Authorization
442
+
443
+ [oAuth2AuthCode](../README.md#oAuth2AuthCode)
444
+
445
+ ### HTTP request headers
446
+
447
+ - **Content-Type**: Not defined
448
+ - **Accept**: application/octet-stream
449
+
450
+
451
+ ### HTTP response details
452
+ | Status code | Description | Response headers |
453
+ |-------------|-------------|------------------|
454
+ |**200** | Dataset part successfully downloaded | - |
455
+ |**403** | Insufficient permissions on organization or workspace or dataset | - |
456
+ |**404** | Dataset part specified is not found | - |
457
+
458
+ [[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)
459
+
460
+ # **getDataset**
461
+ > Dataset getDataset()
462
+
463
+ Retrieve a dataset
464
+
465
+ ### Example
466
+
467
+ ```typescript
468
+ import {
469
+ DatasetApi,
470
+ Configuration
471
+ } from '@cosmotech/api-ts';
472
+
473
+ const configuration = new Configuration();
474
+ const apiInstance = new DatasetApi(configuration);
475
+
476
+ let organizationId: string; //the Organization identifier (default to undefined)
477
+ let workspaceId: string; //the Workspace identifier (default to undefined)
478
+ let datasetId: string; //the Dataset identifier (default to undefined)
479
+
480
+ const { status, data } = await apiInstance.getDataset(
481
+ organizationId,
482
+ workspaceId,
483
+ datasetId
484
+ );
485
+ ```
486
+
487
+ ### Parameters
488
+
489
+ |Name | Type | Description | Notes|
490
+ |------------- | ------------- | ------------- | -------------|
491
+ | **organizationId** | [**string**] | the Organization identifier | defaults to undefined|
492
+ | **workspaceId** | [**string**] | the Workspace identifier | defaults to undefined|
493
+ | **datasetId** | [**string**] | the Dataset identifier | defaults to undefined|
494
+
495
+
496
+ ### Return type
497
+
498
+ **Dataset**
499
+
500
+ ### Authorization
501
+
502
+ [oAuth2AuthCode](../README.md#oAuth2AuthCode)
503
+
504
+ ### HTTP request headers
505
+
506
+ - **Content-Type**: Not defined
507
+ - **Accept**: application/json, application/yaml
508
+
509
+
510
+ ### HTTP response details
511
+ | Status code | Description | Response headers |
512
+ |-------------|-------------|------------------|
513
+ |**200** | Dataset successfully retrieved | - |
514
+ |**403** | Insufficient permissions on organization or workspace or dataset | - |
515
+ |**404** | Organization or workspace or dataset specified is not found | - |
516
+
517
+ [[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)
518
+
519
+ # **getDatasetAccessControl**
520
+ > DatasetAccessControl getDatasetAccessControl()
521
+
522
+
523
+ ### Example
524
+
525
+ ```typescript
526
+ import {
527
+ DatasetApi,
528
+ Configuration
529
+ } from '@cosmotech/api-ts';
530
+
531
+ const configuration = new Configuration();
532
+ const apiInstance = new DatasetApi(configuration);
533
+
534
+ let organizationId: string; //the Organization identifier (default to undefined)
535
+ let workspaceId: string; //the Workspace identifier (default to undefined)
536
+ let datasetId: string; //the Dataset identifier (default to undefined)
537
+ let identityId: string; //the User identifier (default to undefined)
538
+
539
+ const { status, data } = await apiInstance.getDatasetAccessControl(
540
+ organizationId,
541
+ workspaceId,
542
+ datasetId,
543
+ identityId
544
+ );
545
+ ```
546
+
547
+ ### Parameters
548
+
549
+ |Name | Type | Description | Notes|
550
+ |------------- | ------------- | ------------- | -------------|
551
+ | **organizationId** | [**string**] | the Organization identifier | defaults to undefined|
552
+ | **workspaceId** | [**string**] | the Workspace identifier | defaults to undefined|
553
+ | **datasetId** | [**string**] | the Dataset identifier | defaults to undefined|
554
+ | **identityId** | [**string**] | the User identifier | defaults to undefined|
555
+
556
+
557
+ ### Return type
558
+
559
+ **DatasetAccessControl**
560
+
561
+ ### Authorization
562
+
563
+ [oAuth2AuthCode](../README.md#oAuth2AuthCode)
564
+
565
+ ### HTTP request headers
566
+
567
+ - **Content-Type**: Not defined
568
+ - **Accept**: application/json, application/yaml
569
+
570
+
571
+ ### HTTP response details
572
+ | Status code | Description | Response headers |
573
+ |-------------|-------------|------------------|
574
+ |**200** | The Dataset access | - |
575
+ |**404** | The Dataset or user specified is unknown or you don\&#39;t have access to it | - |
576
+
577
+ [[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
+
579
+ # **getDatasetPart**
580
+ > DatasetPart getDatasetPart()
581
+
582
+
583
+ ### Example
584
+
585
+ ```typescript
586
+ import {
587
+ DatasetApi,
588
+ Configuration
589
+ } from '@cosmotech/api-ts';
590
+
591
+ const configuration = new Configuration();
592
+ const apiInstance = new DatasetApi(configuration);
593
+
594
+ let organizationId: string; //the Organization identifier (default to undefined)
595
+ let workspaceId: string; //the Workspace identifier (default to undefined)
596
+ let datasetId: string; //the Dataset identifier (default to undefined)
597
+ let datasetPartId: string; //the Dataset part identifier (default to undefined)
598
+
599
+ const { status, data } = await apiInstance.getDatasetPart(
600
+ organizationId,
601
+ workspaceId,
602
+ datasetId,
603
+ datasetPartId
604
+ );
605
+ ```
606
+
607
+ ### Parameters
608
+
609
+ |Name | Type | Description | Notes|
610
+ |------------- | ------------- | ------------- | -------------|
611
+ | **organizationId** | [**string**] | the Organization identifier | defaults to undefined|
612
+ | **workspaceId** | [**string**] | the Workspace identifier | defaults to undefined|
613
+ | **datasetId** | [**string**] | the Dataset identifier | defaults to undefined|
614
+ | **datasetPartId** | [**string**] | the Dataset part identifier | defaults to undefined|
615
+
616
+
617
+ ### Return type
618
+
619
+ **DatasetPart**
620
+
621
+ ### Authorization
622
+
623
+ [oAuth2AuthCode](../README.md#oAuth2AuthCode)
624
+
625
+ ### HTTP request headers
626
+
627
+ - **Content-Type**: Not defined
628
+ - **Accept**: application/json, application/yaml
629
+
630
+
631
+ ### HTTP response details
632
+ | Status code | Description | Response headers |
633
+ |-------------|-------------|------------------|
634
+ |**200** | Dataset part successfully retrieved | - |
635
+ |**403** | Insufficient permissions on organization or workspace or dataset | - |
636
+ |**404** | Dataset part specified is not found | - |
637
+
638
+ [[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)
639
+
640
+ # **listDatasetParts**
641
+ > Array<DatasetPart> listDatasetParts()
642
+
643
+
644
+ ### Example
645
+
646
+ ```typescript
647
+ import {
648
+ DatasetApi,
649
+ Configuration
650
+ } from '@cosmotech/api-ts';
651
+
652
+ const configuration = new Configuration();
653
+ const apiInstance = new DatasetApi(configuration);
654
+
655
+ let organizationId: string; //the Organization identifier (default to undefined)
656
+ let workspaceId: string; //the Workspace identifier (default to undefined)
657
+ let datasetId: string; //the Dataset identifier (default to undefined)
658
+ let page: number; //Page number to query (first page is at index 0) (optional) (default to undefined)
659
+ let size: number; //Amount of result by page (optional) (default to undefined)
660
+
661
+ const { status, data } = await apiInstance.listDatasetParts(
662
+ organizationId,
663
+ workspaceId,
664
+ datasetId,
665
+ page,
666
+ size
667
+ );
668
+ ```
669
+
670
+ ### Parameters
671
+
672
+ |Name | Type | Description | Notes|
673
+ |------------- | ------------- | ------------- | -------------|
674
+ | **organizationId** | [**string**] | the Organization identifier | defaults to undefined|
675
+ | **workspaceId** | [**string**] | the Workspace identifier | defaults to undefined|
676
+ | **datasetId** | [**string**] | the Dataset identifier | defaults to undefined|
677
+ | **page** | [**number**] | Page number to query (first page is at index 0) | (optional) defaults to undefined|
678
+ | **size** | [**number**] | Amount of result by page | (optional) defaults to undefined|
679
+
680
+
681
+ ### Return type
682
+
683
+ **Array<DatasetPart>**
684
+
685
+ ### Authorization
686
+
687
+ [oAuth2AuthCode](../README.md#oAuth2AuthCode)
688
+
689
+ ### HTTP request headers
690
+
691
+ - **Content-Type**: Not defined
692
+ - **Accept**: application/json, application/yaml
693
+
694
+
695
+ ### HTTP response details
696
+ | Status code | Description | Response headers |
697
+ |-------------|-------------|------------------|
698
+ |**200** | List of dataset parts | - |
699
+ |**403** | Insufficient permissions on organization or workspace or dataset | - |
700
+ |**404** | Dataset specified is not found | - |
701
+ |**422** | Targeted dataset do not support requests | - |
702
+
703
+ [[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)
704
+
705
+ # **listDatasetSecurityUsers**
706
+ > Array<string> listDatasetSecurityUsers()
707
+
708
+
709
+ ### Example
710
+
711
+ ```typescript
712
+ import {
713
+ DatasetApi,
714
+ Configuration
715
+ } from '@cosmotech/api-ts';
716
+
717
+ const configuration = new Configuration();
718
+ const apiInstance = new DatasetApi(configuration);
719
+
720
+ let organizationId: string; //the Organization identifier (default to undefined)
721
+ let workspaceId: string; //the Workspace identifier (default to undefined)
722
+ let datasetId: string; //the Dataset identifier (default to undefined)
723
+
724
+ const { status, data } = await apiInstance.listDatasetSecurityUsers(
725
+ organizationId,
726
+ workspaceId,
727
+ datasetId
728
+ );
729
+ ```
730
+
731
+ ### Parameters
732
+
733
+ |Name | Type | Description | Notes|
734
+ |------------- | ------------- | ------------- | -------------|
735
+ | **organizationId** | [**string**] | the Organization identifier | defaults to undefined|
736
+ | **workspaceId** | [**string**] | the Workspace identifier | defaults to undefined|
737
+ | **datasetId** | [**string**] | the Dataset identifier | defaults to undefined|
738
+
739
+
740
+ ### Return type
741
+
742
+ **Array<string>**
743
+
744
+ ### Authorization
745
+
746
+ [oAuth2AuthCode](../README.md#oAuth2AuthCode)
747
+
748
+ ### HTTP request headers
749
+
750
+ - **Content-Type**: Not defined
751
+ - **Accept**: application/json
752
+
753
+
754
+ ### HTTP response details
755
+ | Status code | Description | Response headers |
756
+ |-------------|-------------|------------------|
757
+ |**200** | The Dataset security users list | - |
758
+ |**404** | the Dataset or the User specified is unknown or you don\&#39;t have access to them | - |
759
+
760
+ [[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)
761
+
762
+ # **listDatasets**
763
+ > Array<Dataset> listDatasets()
764
+
765
+ List all datasets
766
+
767
+ ### Example
768
+
769
+ ```typescript
770
+ import {
771
+ DatasetApi,
772
+ Configuration
773
+ } from '@cosmotech/api-ts';
774
+
775
+ const configuration = new Configuration();
776
+ const apiInstance = new DatasetApi(configuration);
777
+
778
+ let organizationId: string; //the Organization identifier (default to undefined)
779
+ let workspaceId: string; //the Workspace identifier (default to undefined)
780
+ let page: number; //Page number to query (first page is at index 0) (optional) (default to undefined)
781
+ let size: number; //Amount of result by page (optional) (default to undefined)
782
+
783
+ const { status, data } = await apiInstance.listDatasets(
784
+ organizationId,
785
+ workspaceId,
786
+ page,
787
+ size
788
+ );
789
+ ```
790
+
791
+ ### Parameters
792
+
793
+ |Name | Type | Description | Notes|
794
+ |------------- | ------------- | ------------- | -------------|
795
+ | **organizationId** | [**string**] | the Organization identifier | defaults to undefined|
796
+ | **workspaceId** | [**string**] | the Workspace identifier | defaults to undefined|
797
+ | **page** | [**number**] | Page number to query (first page is at index 0) | (optional) defaults to undefined|
798
+ | **size** | [**number**] | Amount of result by page | (optional) defaults to undefined|
799
+
800
+
801
+ ### Return type
802
+
803
+ **Array<Dataset>**
804
+
805
+ ### Authorization
806
+
807
+ [oAuth2AuthCode](../README.md#oAuth2AuthCode)
808
+
809
+ ### HTTP request headers
810
+
811
+ - **Content-Type**: Not defined
812
+ - **Accept**: application/json, application/yaml
813
+
814
+
815
+ ### HTTP response details
816
+ | Status code | Description | Response headers |
817
+ |-------------|-------------|------------------|
818
+ |**200** | Datasets successfully retrieved | - |
819
+ |**403** | Insufficient permissions on organization or workspace or dataset | - |
820
+ |**404** | Organization or workspace or dataset specified is not found | - |
821
+
822
+ [[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)
823
+
824
+ # **queryData**
825
+ > Array<object> queryData()
826
+
827
+
828
+ ### Example
829
+
830
+ ```typescript
831
+ import {
832
+ DatasetApi,
833
+ Configuration
834
+ } from '@cosmotech/api-ts';
835
+
836
+ const configuration = new Configuration();
837
+ const apiInstance = new DatasetApi(configuration);
838
+
839
+ let organizationId: string; //the Organization identifier (default to undefined)
840
+ let workspaceId: string; //the Workspace identifier (default to undefined)
841
+ let datasetId: string; //the Dataset identifier (default to undefined)
842
+ let datasetPartId: string; //the Dataset part identifier (default to undefined)
843
+ let filters: Array<string>; //Property names that should be part of the response data. You can specify a property name like: - id - stock - quantity - ... (optional) (default to undefined)
844
+ let sums: Array<string>; //Property names to sum by (optional) (default to undefined)
845
+ let counts: Array<string>; //Property names to count by (optional) (default to undefined)
846
+ let offset: number; //The query offset (optional) (default to undefined)
847
+ let limit: number; //The query limit (optional) (default to undefined)
848
+
849
+ const { status, data } = await apiInstance.queryData(
850
+ organizationId,
851
+ workspaceId,
852
+ datasetId,
853
+ datasetPartId,
854
+ filters,
855
+ sums,
856
+ counts,
857
+ offset,
858
+ limit
859
+ );
860
+ ```
861
+
862
+ ### Parameters
863
+
864
+ |Name | Type | Description | Notes|
865
+ |------------- | ------------- | ------------- | -------------|
866
+ | **organizationId** | [**string**] | the Organization identifier | defaults to undefined|
867
+ | **workspaceId** | [**string**] | the Workspace identifier | defaults to undefined|
868
+ | **datasetId** | [**string**] | the Dataset identifier | defaults to undefined|
869
+ | **datasetPartId** | [**string**] | the Dataset part identifier | defaults to undefined|
870
+ | **filters** | **Array&lt;string&gt;** | Property names that should be part of the response data. You can specify a property name like: - id - stock - quantity - ... | (optional) defaults to undefined|
871
+ | **sums** | **Array&lt;string&gt;** | Property names to sum by | (optional) defaults to undefined|
872
+ | **counts** | **Array&lt;string&gt;** | Property names to count by | (optional) defaults to undefined|
873
+ | **offset** | [**number**] | The query offset | (optional) defaults to undefined|
874
+ | **limit** | [**number**] | The query limit | (optional) defaults to undefined|
875
+
876
+
877
+ ### Return type
878
+
879
+ **Array<object>**
880
+
881
+ ### Authorization
882
+
883
+ [oAuth2AuthCode](../README.md#oAuth2AuthCode)
884
+
885
+ ### HTTP request headers
886
+
887
+ - **Content-Type**: Not defined
888
+ - **Accept**: application/json, application/yaml
889
+
890
+
891
+ ### HTTP response details
892
+ | Status code | Description | Response headers |
893
+ |-------------|-------------|------------------|
894
+ |**200** | Data related to provided information | - |
895
+ |**400** | Bad request - Data cannot be retrieved from provided information | - |
896
+ |**403** | Insufficient permissions on organization or workspace or dataset | - |
897
+ |**404** | Dataset specified is not found or you don\&#39;t have access to it | - |
898
+ |**422** | Targeted dataset do not support requests | - |
899
+
900
+ [[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)
901
+
902
+ # **replaceDatasetPart**
903
+ > DatasetPart replaceDatasetPart()
904
+
905
+
906
+ ### Example
907
+
908
+ ```typescript
909
+ import {
910
+ DatasetApi,
911
+ Configuration,
912
+ DatasetPartUpdateRequest
913
+ } from '@cosmotech/api-ts';
914
+
915
+ const configuration = new Configuration();
916
+ const apiInstance = new DatasetApi(configuration);
917
+
918
+ let organizationId: string; //the Organization identifier (default to undefined)
919
+ let workspaceId: string; //the Workspace identifier (default to undefined)
920
+ let datasetId: string; //the Dataset identifier (default to undefined)
921
+ let datasetPartId: string; //the Dataset part identifier (default to undefined)
922
+ let file: File; //Data file to upload (default to undefined)
923
+ let datasetPartUpdateRequest: DatasetPartUpdateRequest; // (optional) (default to undefined)
924
+
925
+ const { status, data } = await apiInstance.replaceDatasetPart(
926
+ organizationId,
927
+ workspaceId,
928
+ datasetId,
929
+ datasetPartId,
930
+ file,
931
+ datasetPartUpdateRequest
932
+ );
933
+ ```
934
+
935
+ ### Parameters
936
+
937
+ |Name | Type | Description | Notes|
938
+ |------------- | ------------- | ------------- | -------------|
939
+ | **organizationId** | [**string**] | the Organization identifier | defaults to undefined|
940
+ | **workspaceId** | [**string**] | the Workspace identifier | defaults to undefined|
941
+ | **datasetId** | [**string**] | the Dataset identifier | defaults to undefined|
942
+ | **datasetPartId** | [**string**] | the Dataset part identifier | defaults to undefined|
943
+ | **file** | [**File**] | Data file to upload | defaults to undefined|
944
+ | **datasetPartUpdateRequest** | **DatasetPartUpdateRequest** | | (optional) defaults to undefined|
945
+
946
+
947
+ ### Return type
948
+
949
+ **DatasetPart**
950
+
951
+ ### Authorization
952
+
953
+ [oAuth2AuthCode](../README.md#oAuth2AuthCode)
954
+
955
+ ### HTTP request headers
956
+
957
+ - **Content-Type**: multipart/form-data
958
+ - **Accept**: application/json, application/yaml
959
+
960
+
961
+ ### HTTP response details
962
+ | Status code | Description | Response headers |
963
+ |-------------|-------------|------------------|
964
+ |**200** | Dataset part successfully replaced | - |
965
+ |**403** | Insufficient permissions on organization or workspace or dataset | - |
966
+ |**404** | Dataset part specified is not found | - |
967
+ |**422** | Targeted dataset do not support requests | - |
968
+
969
+ [[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)
970
+
971
+ # **searchDatasetParts**
972
+ > Array<DatasetPart> searchDatasetParts(requestBody)
973
+
974
+
975
+ ### Example
976
+
977
+ ```typescript
978
+ import {
979
+ DatasetApi,
980
+ Configuration
981
+ } from '@cosmotech/api-ts';
982
+
983
+ const configuration = new Configuration();
984
+ const apiInstance = new DatasetApi(configuration);
985
+
986
+ let organizationId: string; //the Organization identifier (default to undefined)
987
+ let workspaceId: string; //the Workspace identifier (default to undefined)
988
+ let datasetId: string; //the Dataset identifier (default to undefined)
989
+ let requestBody: Array<string>; //the Dataset parts search parameters
990
+ let page: number; //Page number to query (first page is at index 0) (optional) (default to undefined)
991
+ let size: number; //Amount of result by page (optional) (default to undefined)
992
+
993
+ const { status, data } = await apiInstance.searchDatasetParts(
994
+ organizationId,
995
+ workspaceId,
996
+ datasetId,
997
+ requestBody,
998
+ page,
999
+ size
1000
+ );
1001
+ ```
1002
+
1003
+ ### Parameters
1004
+
1005
+ |Name | Type | Description | Notes|
1006
+ |------------- | ------------- | ------------- | -------------|
1007
+ | **requestBody** | **Array<string>**| the Dataset parts search parameters | |
1008
+ | **organizationId** | [**string**] | the Organization identifier | defaults to undefined|
1009
+ | **workspaceId** | [**string**] | the Workspace identifier | defaults to undefined|
1010
+ | **datasetId** | [**string**] | the Dataset identifier | defaults to undefined|
1011
+ | **page** | [**number**] | Page number to query (first page is at index 0) | (optional) defaults to undefined|
1012
+ | **size** | [**number**] | Amount of result by page | (optional) defaults to undefined|
1013
+
1014
+
1015
+ ### Return type
1016
+
1017
+ **Array<DatasetPart>**
1018
+
1019
+ ### Authorization
1020
+
1021
+ [oAuth2AuthCode](../README.md#oAuth2AuthCode)
1022
+
1023
+ ### HTTP request headers
1024
+
1025
+ - **Content-Type**: application/json, application/yaml
1026
+ - **Accept**: application/json
1027
+
1028
+
1029
+ ### HTTP response details
1030
+ | Status code | Description | Response headers |
1031
+ |-------------|-------------|------------------|
1032
+ |**200** | Dataset part list containing tags | - |
1033
+
1034
+ [[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)
1035
+
1036
+ # **searchDatasets**
1037
+ > Array<Dataset> searchDatasets(requestBody)
1038
+
1039
+
1040
+ ### Example
1041
+
1042
+ ```typescript
1043
+ import {
1044
+ DatasetApi,
1045
+ Configuration
1046
+ } from '@cosmotech/api-ts';
1047
+
1048
+ const configuration = new Configuration();
1049
+ const apiInstance = new DatasetApi(configuration);
1050
+
1051
+ let organizationId: string; //the Organization identifier (default to undefined)
1052
+ let workspaceId: string; //the Workspace identifier (default to undefined)
1053
+ let requestBody: Array<string>; //the Dataset search parameters
1054
+ let page: number; //Page number to query (first page is at index 0) (optional) (default to undefined)
1055
+ let size: number; //Amount of result by page (optional) (default to undefined)
1056
+
1057
+ const { status, data } = await apiInstance.searchDatasets(
1058
+ organizationId,
1059
+ workspaceId,
1060
+ requestBody,
1061
+ page,
1062
+ size
1063
+ );
1064
+ ```
1065
+
1066
+ ### Parameters
1067
+
1068
+ |Name | Type | Description | Notes|
1069
+ |------------- | ------------- | ------------- | -------------|
1070
+ | **requestBody** | **Array<string>**| the Dataset search parameters | |
1071
+ | **organizationId** | [**string**] | the Organization identifier | defaults to undefined|
1072
+ | **workspaceId** | [**string**] | the Workspace identifier | defaults to undefined|
1073
+ | **page** | [**number**] | Page number to query (first page is at index 0) | (optional) defaults to undefined|
1074
+ | **size** | [**number**] | Amount of result by page | (optional) defaults to undefined|
1075
+
1076
+
1077
+ ### Return type
1078
+
1079
+ **Array<Dataset>**
1080
+
1081
+ ### Authorization
1082
+
1083
+ [oAuth2AuthCode](../README.md#oAuth2AuthCode)
1084
+
1085
+ ### HTTP request headers
1086
+
1087
+ - **Content-Type**: application/json, application/yaml
1088
+ - **Accept**: application/json
1089
+
1090
+
1091
+ ### HTTP response details
1092
+ | Status code | Description | Response headers |
1093
+ |-------------|-------------|------------------|
1094
+ |**200** | Dataset list containing tags | - |
1095
+
1096
+ [[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)
1097
+
1098
+ # **updateDataset**
1099
+ > Dataset updateDataset()
1100
+
1101
+ Update a dataset
1102
+
1103
+ ### Example
1104
+
1105
+ ```typescript
1106
+ import {
1107
+ DatasetApi,
1108
+ Configuration,
1109
+ DatasetUpdateRequest
1110
+ } from '@cosmotech/api-ts';
1111
+
1112
+ const configuration = new Configuration();
1113
+ const apiInstance = new DatasetApi(configuration);
1114
+
1115
+ let organizationId: string; //the Organization identifier (default to undefined)
1116
+ let workspaceId: string; //the Workspace identifier (default to undefined)
1117
+ let datasetId: string; //the Dataset identifier (default to undefined)
1118
+ let datasetUpdateRequest: DatasetUpdateRequest; // (default to undefined)
1119
+ let files: Array<File>; //Notes: - Each parts defined in dataset should have a file defined in this list - Please ensure that upload files order match with data parts list defined - First file uploaded will match with first dataset parts and so on (optional) (default to undefined)
1120
+
1121
+ const { status, data } = await apiInstance.updateDataset(
1122
+ organizationId,
1123
+ workspaceId,
1124
+ datasetId,
1125
+ datasetUpdateRequest,
1126
+ files
1127
+ );
1128
+ ```
1129
+
1130
+ ### Parameters
1131
+
1132
+ |Name | Type | Description | Notes|
1133
+ |------------- | ------------- | ------------- | -------------|
1134
+ | **organizationId** | [**string**] | the Organization identifier | defaults to undefined|
1135
+ | **workspaceId** | [**string**] | the Workspace identifier | defaults to undefined|
1136
+ | **datasetId** | [**string**] | the Dataset identifier | defaults to undefined|
1137
+ | **datasetUpdateRequest** | **DatasetUpdateRequest** | | defaults to undefined|
1138
+ | **files** | **Array&lt;File&gt;** | Notes: - Each parts defined in dataset should have a file defined in this list - Please ensure that upload files order match with data parts list defined - First file uploaded will match with first dataset parts and so on | (optional) defaults to undefined|
1139
+
1140
+
1141
+ ### Return type
1142
+
1143
+ **Dataset**
1144
+
1145
+ ### Authorization
1146
+
1147
+ [oAuth2AuthCode](../README.md#oAuth2AuthCode)
1148
+
1149
+ ### HTTP request headers
1150
+
1151
+ - **Content-Type**: multipart/form-data
1152
+ - **Accept**: application/json, application/yaml
1153
+
1154
+
1155
+ ### HTTP response details
1156
+ | Status code | Description | Response headers |
1157
+ |-------------|-------------|------------------|
1158
+ |**200** | Dataset successfully updated | - |
1159
+ |**400** | Bad request | - |
1160
+ |**403** | Insufficient permissions on organization or workspace or dataset | - |
1161
+ |**404** | Organization or workspace or dataset specified is not found | - |
1162
+
1163
+ [[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)
1164
+
1165
+ # **updateDatasetAccessControl**
1166
+ > DatasetAccessControl updateDatasetAccessControl(datasetRole)
1167
+
1168
+
1169
+ ### Example
1170
+
1171
+ ```typescript
1172
+ import {
1173
+ DatasetApi,
1174
+ Configuration,
1175
+ DatasetRole
1176
+ } from '@cosmotech/api-ts';
1177
+
1178
+ const configuration = new Configuration();
1179
+ const apiInstance = new DatasetApi(configuration);
1180
+
1181
+ let organizationId: string; //the Organization identifier (default to undefined)
1182
+ let workspaceId: string; //the Workspace identifier (default to undefined)
1183
+ let datasetId: string; //the Dataset identifier (default to undefined)
1184
+ let identityId: string; //the User identifier (default to undefined)
1185
+ let datasetRole: DatasetRole; //The new Dataset Access Control
1186
+
1187
+ const { status, data } = await apiInstance.updateDatasetAccessControl(
1188
+ organizationId,
1189
+ workspaceId,
1190
+ datasetId,
1191
+ identityId,
1192
+ datasetRole
1193
+ );
1194
+ ```
1195
+
1196
+ ### Parameters
1197
+
1198
+ |Name | Type | Description | Notes|
1199
+ |------------- | ------------- | ------------- | -------------|
1200
+ | **datasetRole** | **DatasetRole**| The new Dataset Access Control | |
1201
+ | **organizationId** | [**string**] | the Organization identifier | defaults to undefined|
1202
+ | **workspaceId** | [**string**] | the Workspace identifier | defaults to undefined|
1203
+ | **datasetId** | [**string**] | the Dataset identifier | defaults to undefined|
1204
+ | **identityId** | [**string**] | the User identifier | defaults to undefined|
1205
+
1206
+
1207
+ ### Return type
1208
+
1209
+ **DatasetAccessControl**
1210
+
1211
+ ### Authorization
1212
+
1213
+ [oAuth2AuthCode](../README.md#oAuth2AuthCode)
1214
+
1215
+ ### HTTP request headers
1216
+
1217
+ - **Content-Type**: application/json, application/yaml
1218
+ - **Accept**: application/json, application/yaml
1219
+
1220
+
1221
+ ### HTTP response details
1222
+ | Status code | Description | Response headers |
1223
+ |-------------|-------------|------------------|
1224
+ |**200** | The Dataset access | - |
1225
+ |**404** | The Dataset specified is unknown or you don\&#39;t have access to it | - |
1226
+
1227
+ [[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)
1228
+
1229
+ # **updateDatasetDefaultSecurity**
1230
+ > DatasetSecurity updateDatasetDefaultSecurity(datasetRole)
1231
+
1232
+
1233
+ ### Example
1234
+
1235
+ ```typescript
1236
+ import {
1237
+ DatasetApi,
1238
+ Configuration,
1239
+ DatasetRole
1240
+ } from '@cosmotech/api-ts';
1241
+
1242
+ const configuration = new Configuration();
1243
+ const apiInstance = new DatasetApi(configuration);
1244
+
1245
+ let organizationId: string; //the Organization identifier (default to undefined)
1246
+ let workspaceId: string; //the Workspace identifier (default to undefined)
1247
+ let datasetId: string; //the Dataset identifier (default to undefined)
1248
+ let datasetRole: DatasetRole; //This change the dataset default security. The default security is the role assigned to any person not on the Access Control List. If the default security is None, then nobody outside of the ACL can access the dataset.
1249
+
1250
+ const { status, data } = await apiInstance.updateDatasetDefaultSecurity(
1251
+ organizationId,
1252
+ workspaceId,
1253
+ datasetId,
1254
+ datasetRole
1255
+ );
1256
+ ```
1257
+
1258
+ ### Parameters
1259
+
1260
+ |Name | Type | Description | Notes|
1261
+ |------------- | ------------- | ------------- | -------------|
1262
+ | **datasetRole** | **DatasetRole**| This change the dataset default security. The default security is the role assigned to any person not on the Access Control List. If the default security is None, then nobody outside of the ACL can access the dataset. | |
1263
+ | **organizationId** | [**string**] | the Organization identifier | defaults to undefined|
1264
+ | **workspaceId** | [**string**] | the Workspace identifier | defaults to undefined|
1265
+ | **datasetId** | [**string**] | the Dataset identifier | defaults to undefined|
1266
+
1267
+
1268
+ ### Return type
1269
+
1270
+ **DatasetSecurity**
1271
+
1272
+ ### Authorization
1273
+
1274
+ [oAuth2AuthCode](../README.md#oAuth2AuthCode)
1275
+
1276
+ ### HTTP request headers
1277
+
1278
+ - **Content-Type**: application/json, application/yaml
1279
+ - **Accept**: application/json
1280
+
1281
+
1282
+ ### HTTP response details
1283
+ | Status code | Description | Response headers |
1284
+ |-------------|-------------|------------------|
1285
+ |**201** | The Dataset default visibility | - |
1286
+ |**404** | the Dataset specified is unknown or you don\&#39;t have access to it | - |
1287
+
1288
+ [[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)
1289
+