@connectedxm/admin-sdk 13.1.0 → 13.3.0

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.
@@ -0,0 +1,123 @@
1
+ # ExportsApi
2
+
3
+ All URIs are relative to *https://admin-api.connected.dev*
4
+
5
+ |Method | HTTP request | Description|
6
+ |------------- | ------------- | -------------|
7
+ |[**getExport**](#getexport) | **GET** /exports/{exportId} | Get a single export|
8
+ |[**getExports**](#getexports) | **GET** /exports | List data exports|
9
+
10
+ # **getExport**
11
+ > GetExport200Response getExport()
12
+
13
+ Returns the status, message and download link of a single data export job by its ID; requires organization-level read access. A report export\'s download link is null unless the caller can read that report.
14
+
15
+ ### Example
16
+
17
+ ```typescript
18
+ import {
19
+ ExportsApi,
20
+ Configuration
21
+ } from '@connectedxm/admin-sdk';
22
+
23
+ const configuration = new Configuration();
24
+ const apiInstance = new ExportsApi(configuration);
25
+
26
+ let exportId: string; //The export identifier (default to undefined)
27
+
28
+ const { status, data } = await apiInstance.getExport(
29
+ exportId
30
+ );
31
+ ```
32
+
33
+ ### Parameters
34
+
35
+ |Name | Type | Description | Notes|
36
+ |------------- | ------------- | ------------- | -------------|
37
+ | **exportId** | [**string**] | The export identifier | defaults to undefined|
38
+
39
+
40
+ ### Return type
41
+
42
+ **GetExport200Response**
43
+
44
+ ### Authorization
45
+
46
+ [ApiKeyAuth](../README.md#ApiKeyAuth), [OrganizationId](../README.md#OrganizationId)
47
+
48
+ ### HTTP request headers
49
+
50
+ - **Content-Type**: Not defined
51
+ - **Accept**: application/json
52
+
53
+
54
+ ### HTTP response details
55
+ | Status code | Description | Response headers |
56
+ |-------------|-------------|------------------|
57
+ |**200** | Successful response | - |
58
+
59
+ [[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)
60
+
61
+ # **getExports**
62
+ > GetExports200Response getExports()
63
+
64
+ Returns a paginated list of the organization\'s data export jobs, newest first, optionally filtered by status and searchable by export type; requires organization-level read access. A report export\'s download link is null unless the caller can read that report.
65
+
66
+ ### Example
67
+
68
+ ```typescript
69
+ import {
70
+ ExportsApi,
71
+ Configuration
72
+ } from '@connectedxm/admin-sdk';
73
+
74
+ const configuration = new Configuration();
75
+ const apiInstance = new ExportsApi(configuration);
76
+
77
+ let status: ExportStatus; //Filter by status (optional) (default to undefined)
78
+ let page: number; //Page number (optional) (default to 1)
79
+ let pageSize: number; //Number of items per page (optional) (default to 25)
80
+ let orderBy: string; //Field to order by (optional) (default to undefined)
81
+ let search: string; //Search query (optional) (default to undefined)
82
+
83
+ const { status, data } = await apiInstance.getExports(
84
+ status,
85
+ page,
86
+ pageSize,
87
+ orderBy,
88
+ search
89
+ );
90
+ ```
91
+
92
+ ### Parameters
93
+
94
+ |Name | Type | Description | Notes|
95
+ |------------- | ------------- | ------------- | -------------|
96
+ | **status** | **ExportStatus** | Filter by status | (optional) defaults to undefined|
97
+ | **page** | [**number**] | Page number | (optional) defaults to 1|
98
+ | **pageSize** | [**number**] | Number of items per page | (optional) defaults to 25|
99
+ | **orderBy** | [**string**] | Field to order by | (optional) defaults to undefined|
100
+ | **search** | [**string**] | Search query | (optional) defaults to undefined|
101
+
102
+
103
+ ### Return type
104
+
105
+ **GetExports200Response**
106
+
107
+ ### Authorization
108
+
109
+ [ApiKeyAuth](../README.md#ApiKeyAuth), [OrganizationId](../README.md#OrganizationId)
110
+
111
+ ### HTTP request headers
112
+
113
+ - **Content-Type**: Not defined
114
+ - **Accept**: application/json
115
+
116
+
117
+ ### HTTP response details
118
+ | Status code | Description | Response headers |
119
+ |-------------|-------------|------------------|
120
+ |**200** | Successful response | - |
121
+
122
+ [[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)
123
+
@@ -0,0 +1,24 @@
1
+ # GetExport200Response
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **status** | **string** | | [default to undefined]
9
+ **message** | **string** | | [default to undefined]
10
+ **data** | [**Export**](Export.md) | | [default to undefined]
11
+
12
+ ## Example
13
+
14
+ ```typescript
15
+ import { GetExport200Response } from '@connectedxm/admin-sdk';
16
+
17
+ const instance: GetExport200Response = {
18
+ status,
19
+ message,
20
+ data,
21
+ };
22
+ ```
23
+
24
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,26 @@
1
+ # GetExports200Response
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **status** | **string** | | [default to undefined]
9
+ **message** | **string** | | [default to undefined]
10
+ **data** | [**Array<Export>**](Export.md) | | [default to undefined]
11
+ **count** | **number** | | [optional] [default to undefined]
12
+
13
+ ## Example
14
+
15
+ ```typescript
16
+ import { GetExports200Response } from '@connectedxm/admin-sdk';
17
+
18
+ const instance: GetExports200Response = {
19
+ status,
20
+ message,
21
+ data,
22
+ count,
23
+ };
24
+ ```
25
+
26
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,24 @@
1
+ # GetReportExport200Response
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **status** | **string** | | [default to undefined]
9
+ **message** | **string** | | [default to undefined]
10
+ **data** | [**ReportExport**](ReportExport.md) | | [default to undefined]
11
+
12
+ ## Example
13
+
14
+ ```typescript
15
+ import { GetReportExport200Response } from '@connectedxm/admin-sdk';
16
+
17
+ const instance: GetReportExport200Response = {
18
+ status,
19
+ message,
20
+ data,
21
+ };
22
+ ```
23
+
24
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,32 @@
1
+ # ReportExport
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **id** | **string** | | [default to undefined]
9
+ **status** | [**ExportStatus**](ExportStatus.md) | | [default to undefined]
10
+ **standard** | **string** | | [default to undefined]
11
+ **message** | **string** | | [default to undefined]
12
+ **downloadUrl** | **string** | | [default to undefined]
13
+ **expiration** | **string** | | [default to undefined]
14
+ **createdAt** | **string** | | [default to undefined]
15
+
16
+ ## Example
17
+
18
+ ```typescript
19
+ import { ReportExport } from '@connectedxm/admin-sdk';
20
+
21
+ const instance: ReportExport = {
22
+ id,
23
+ status,
24
+ standard,
25
+ message,
26
+ downloadUrl,
27
+ expiration,
28
+ createdAt,
29
+ };
30
+ ```
31
+
32
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -7,11 +7,13 @@ All URIs are relative to *https://admin-api.connected.dev*
7
7
  |[**createCustomReport**](#createcustomreport) | **POST** /reports/{standard} | Create a custom report from a standard report|
8
8
  |[**deleteCustomReport**](#deletecustomreport) | **DELETE** /reports/custom/{reportId} | Delete a custom report|
9
9
  |[**deleteCustomReportSchedule**](#deletecustomreportschedule) | **DELETE** /reports/custom/{reportId}/schedule | Delete a custom report\'s schedule|
10
+ |[**downloadReport**](#downloadreport) | **POST** /reports/{standard}/download | Build a standard report as a downloadable CSV|
10
11
  |[**exportCustomReport**](#exportcustomreport) | **POST** /reports/custom/{reportId}/export | Export a custom report|
11
12
  |[**getCustomReport**](#getcustomreport) | **GET** /reports/custom/{reportId} | Get a custom report\'s configuration|
12
13
  |[**getCustomReportSchedule**](#getcustomreportschedule) | **GET** /reports/custom/{reportId}/schedule | Get a custom report\'s send schedule|
13
14
  |[**getCustomReports**](#getcustomreports) | **GET** /reports/custom | List an organization\'s custom reports|
14
15
  |[**getReport**](#getreport) | **GET** /reports/{standard} | Run a standard report and fetch all its rows|
16
+ |[**getReportExport**](#getreportexport) | **GET** /reports/exports/{exportId} | Get the status of a report download|
15
17
  |[**getReports**](#getreports) | **GET** /reports | List available standard reports|
16
18
  |[**updateCustomReport**](#updatecustomreport) | **PUT** /reports/custom/{reportId} | Update a custom report|
17
19
  |[**upsertCustomReportSchedule**](#upsertcustomreportschedule) | **POST** /reports/custom/{reportId}/schedule | Create or update a custom report\'s schedule|
@@ -166,6 +168,61 @@ const { status, data } = await apiInstance.deleteCustomReportSchedule(
166
168
  - **Accept**: application/json
167
169
 
168
170
 
171
+ ### HTTP response details
172
+ | Status code | Description | Response headers |
173
+ |-------------|-------------|------------------|
174
+ |**200** | Successful response | - |
175
+
176
+ [[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)
177
+
178
+ # **downloadReport**
179
+ > DownloadReport200Response downloadReport(reportFilters)
180
+
181
+ Starts an asynchronous server-side build of every row and column of a standard report and returns a pending export; poll the export by ID until it resolves with a signed CSV download link valid for 24 hours. Requires read permission on the reports resource plus the domain permissions declared by the standard report.
182
+
183
+ ### Example
184
+
185
+ ```typescript
186
+ import {
187
+ ReportsApi,
188
+ Configuration,
189
+ ReportFilters
190
+ } from '@connectedxm/admin-sdk';
191
+
192
+ const configuration = new Configuration();
193
+ const apiInstance = new ReportsApi(configuration);
194
+
195
+ let standard: string; //The standard identifier (default to undefined)
196
+ let reportFilters: ReportFilters; //
197
+
198
+ const { status, data } = await apiInstance.downloadReport(
199
+ standard,
200
+ reportFilters
201
+ );
202
+ ```
203
+
204
+ ### Parameters
205
+
206
+ |Name | Type | Description | Notes|
207
+ |------------- | ------------- | ------------- | -------------|
208
+ | **reportFilters** | **ReportFilters**| | |
209
+ | **standard** | [**string**] | The standard identifier | defaults to undefined|
210
+
211
+
212
+ ### Return type
213
+
214
+ **DownloadReport200Response**
215
+
216
+ ### Authorization
217
+
218
+ [ApiKeyAuth](../README.md#ApiKeyAuth), [OrganizationId](../README.md#OrganizationId)
219
+
220
+ ### HTTP request headers
221
+
222
+ - **Content-Type**: application/json
223
+ - **Accept**: application/json
224
+
225
+
169
226
  ### HTTP response details
170
227
  | Status code | Description | Response headers |
171
228
  |-------------|-------------|------------------|
@@ -500,6 +557,57 @@ const { status, data } = await apiInstance.getReport(
500
557
  - **Accept**: application/json
501
558
 
502
559
 
560
+ ### HTTP response details
561
+ | Status code | Description | Response headers |
562
+ |-------------|-------------|------------------|
563
+ |**200** | Successful response | - |
564
+
565
+ [[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)
566
+
567
+ # **getReportExport**
568
+ > GetReportExport200Response getReportExport()
569
+
570
+ Retrieves a report download started with DownloadReport: its status (pending, resolved or failed), the signed CSV download link and its expiration once resolved, or the reason it failed. Requires read permission on the reports resource plus the domain permissions declared by the standard report.
571
+
572
+ ### Example
573
+
574
+ ```typescript
575
+ import {
576
+ ReportsApi,
577
+ Configuration
578
+ } from '@connectedxm/admin-sdk';
579
+
580
+ const configuration = new Configuration();
581
+ const apiInstance = new ReportsApi(configuration);
582
+
583
+ let exportId: string; //The export identifier (default to undefined)
584
+
585
+ const { status, data } = await apiInstance.getReportExport(
586
+ exportId
587
+ );
588
+ ```
589
+
590
+ ### Parameters
591
+
592
+ |Name | Type | Description | Notes|
593
+ |------------- | ------------- | ------------- | -------------|
594
+ | **exportId** | [**string**] | The export identifier | defaults to undefined|
595
+
596
+
597
+ ### Return type
598
+
599
+ **GetReportExport200Response**
600
+
601
+ ### Authorization
602
+
603
+ [ApiKeyAuth](../README.md#ApiKeyAuth), [OrganizationId](../README.md#OrganizationId)
604
+
605
+ ### HTTP request headers
606
+
607
+ - **Content-Type**: Not defined
608
+ - **Accept**: application/json
609
+
610
+
503
611
  ### HTTP response details
504
612
  | Status code | Description | Response headers |
505
613
  |-------------|-------------|------------------|
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@connectedxm/admin-sdk",
3
- "version": "13.1.0",
3
+ "version": "13.3.0",
4
4
  "description": "OpenAPI client for @connectedxm/admin-sdk",
5
5
  "author": "OpenAPI-Generator Contributors",
6
6
  "repository": {