quickbase-js 2.2.2 → 2.4.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.
- package/README.md +107 -1129
- package/dist/auth/ticket.d.ts.map +1 -1
- package/dist/auth/ticket.js +4 -3
- package/dist/auth/ticket.js.map +1 -1
- package/dist/client/request.d.ts +4 -0
- package/dist/client/request.d.ts.map +1 -1
- package/dist/client/request.js +15 -3
- package/dist/client/request.js.map +1 -1
- package/dist/core/errors.d.ts +64 -0
- package/dist/core/errors.d.ts.map +1 -1
- package/dist/core/errors.js +64 -0
- package/dist/core/errors.js.map +1 -1
- package/dist/core/index.d.ts +1 -1
- package/dist/core/index.d.ts.map +1 -1
- package/dist/core/index.js +1 -1
- package/dist/core/index.js.map +1 -1
- package/dist/generated/client.d.ts +2 -0
- package/dist/generated/client.d.ts.map +1 -1
- package/dist/generated/client.js +272 -116
- package/dist/generated/client.js.map +1 -1
- package/dist/generated/types.d.ts +2880 -2122
- package/dist/generated/types.d.ts.map +1 -1
- package/dist/generated/types.js +0 -2
- package/dist/generated/types.js.map +1 -1
- package/dist/index.d.ts +2 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -2
- package/dist/index.js.map +1 -1
- package/dist/quickbase.esm.js +3 -3
- package/dist/quickbase.esm.js.map +3 -3
- package/dist/quickbase.min.js +3 -3
- package/dist/quickbase.min.js.map +3 -3
- package/dist/xml/errors.d.ts +21 -14
- package/dist/xml/errors.d.ts.map +1 -1
- package/dist/xml/errors.js +36 -22
- package/dist/xml/errors.js.map +1 -1
- package/dist/xml/index.d.ts +13 -1
- package/dist/xml/index.d.ts.map +1 -1
- package/dist/xml/index.js +28 -3
- package/dist/xml/index.js.map +1 -1
- package/package.json +4 -5
package/dist/generated/client.js
CHANGED
|
@@ -17,9 +17,9 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
17
17
|
*
|
|
18
18
|
* @param body - Request body
|
|
19
19
|
* @param body.assignToken - Set to true if you would like to assign the app to the user token you used to create the application. The default is false. (optional)
|
|
20
|
-
* @param body.variables - The app variables. A maximum of 10 variables can be inserted at a time. See [About Application Variables](https://help.quickbase.com/
|
|
20
|
+
* @param body.variables - The app variables. A maximum of 10 variables can be inserted at a time. See [About Application Variables](https://help.quickbase.com/docs/creating-and-using-application-variables) (optional)
|
|
21
21
|
* @param body.name - The app name. You are allowed to create multiple apps with the same name, in the same realm, because they will have different dbid values. We urge you to be careful about doing this.
|
|
22
|
-
* @param body.securityProperties -
|
|
22
|
+
* @param body.securityProperties - Security properties of the application (optional)
|
|
23
23
|
* @param body.description - The description for the app. If this property is left out, the app description will be blank. (optional)
|
|
24
24
|
*
|
|
25
25
|
* @returns Success
|
|
@@ -58,7 +58,7 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
58
58
|
* @param params.appId - The unique identifier of an app
|
|
59
59
|
*
|
|
60
60
|
* @param body - Request body (optional)
|
|
61
|
-
* @param body.variables - The app variables. A maximum of 10 variables can be
|
|
61
|
+
* @param body.variables - The app variables. A maximum of 10 variables can be inserted at a time. See [About Application Variables](https://help.quickbase.com/docs/creating-and-using-application-variables) (optional)
|
|
62
62
|
* @param body.name - The name for the app. (optional)
|
|
63
63
|
* @param body.securityProperties - Security properties of the application (optional)
|
|
64
64
|
* @param body.description - The description for the app. (optional)
|
|
@@ -135,6 +135,23 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
135
135
|
body,
|
|
136
136
|
});
|
|
137
137
|
},
|
|
138
|
+
/**
|
|
139
|
+
* Get app roles
|
|
140
|
+
*
|
|
141
|
+
* Retrieves all of the roles for an application. Requires admin access to an app.
|
|
142
|
+
*
|
|
143
|
+
* @param params.appId - The unique identifier of an app
|
|
144
|
+
*
|
|
145
|
+
* @returns Success
|
|
146
|
+
*
|
|
147
|
+
* @see https://developer.quickbase.com/operation/getRoles
|
|
148
|
+
*/
|
|
149
|
+
getRoles(params) {
|
|
150
|
+
return request({
|
|
151
|
+
method: 'GET',
|
|
152
|
+
path: `/apps/${params.appId}/roles`,
|
|
153
|
+
});
|
|
154
|
+
},
|
|
138
155
|
/**
|
|
139
156
|
* Get tables for an app
|
|
140
157
|
*
|
|
@@ -276,13 +293,13 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
276
293
|
*
|
|
277
294
|
* Creates a relationship in a table as well as lookup/summary fields. Relationships can only be created for tables within the same app.
|
|
278
295
|
*
|
|
279
|
-
* @param params.tableId - The unique identifier (dbid) of the
|
|
296
|
+
* @param params.tableId - The unique identifier (dbid) of the child table.
|
|
280
297
|
*
|
|
281
298
|
* @param body - Request body
|
|
282
|
-
* @param body.summaryFields - Array of summary field objects which will turn into summary fields in the parent table. When you specify the 'COUNT' accumulation type, you have to specify 0 as the summaryFid (or not set it in the request). 'DISTINCT-COUNT' requires that summaryFid be set to an actual fid. (optional)
|
|
283
|
-
* @param body.lookupFieldIds - Array of field ids in the parent table that will become lookup fields in the child table. (optional)
|
|
284
299
|
* @param body.parentTableId - The parent table id for the relationship.
|
|
285
|
-
* @param body.foreignKeyField - This property is optional.
|
|
300
|
+
* @param body.foreignKeyField - This property is optional. If it is not provided, the foreign key field will be created with the label 'Related <record>', where <record> is the name of a record in the parent table. (optional)
|
|
301
|
+
* @param body.summaryFields - An array of objects, each representing a configuration of one field from the child table, that will become summary fields on the parent table. When you specify the 'COUNT' accumulation type, you have to specify 0 as the summaryFid (or not set it in the request). 'DISTINCT-COUNT' requires that summaryFid be set to an actual fid. (optional)
|
|
302
|
+
* @param body.lookupFieldIds - An array of field IDs in the parent table that will become lookup fields in the child table. (optional)
|
|
286
303
|
*
|
|
287
304
|
* @returns Success
|
|
288
305
|
*
|
|
@@ -300,12 +317,12 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
300
317
|
*
|
|
301
318
|
* Use this endpoint to add lookup fields and summary fields to an existing relationship. Updating a relationship will not delete existing lookup/summary fields.
|
|
302
319
|
*
|
|
303
|
-
* @param params.tableId - The unique identifier (dbid) of the
|
|
320
|
+
* @param params.tableId - The unique identifier (dbid) of the child table.
|
|
304
321
|
* @param params.relationshipId - The relationship id. This is the field id of the reference field on the child table.
|
|
305
322
|
*
|
|
306
323
|
* @param body - Request body (optional)
|
|
307
324
|
* @param body.summaryFields - An array of objects, each representing a configuration of one field from the child table, that will become summary fields on the parent table. When you specify the 'COUNT' accumulation type, you have to specify 0 as the summaryFid (or not set it in the request). 'DISTINCT-COUNT' requires that summaryFid be set to an actual fid. (optional)
|
|
308
|
-
* @param body.lookupFieldIds - An array of field
|
|
325
|
+
* @param body.lookupFieldIds - An array of field IDs in the parent table that will become lookup fields in the child table. (optional)
|
|
309
326
|
*
|
|
310
327
|
* @returns Success
|
|
311
328
|
*
|
|
@@ -323,7 +340,7 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
323
340
|
*
|
|
324
341
|
* Use this endpoint to delete an entire relationship, including all lookup and summary fields. The reference field in the relationship will not be deleted.
|
|
325
342
|
*
|
|
326
|
-
* @param params.tableId - The unique identifier (dbid) of the
|
|
343
|
+
* @param params.tableId - The unique identifier (dbid) of the child table.
|
|
327
344
|
* @param params.relationshipId - The relationship id. This is the field id of the reference field on the child table.
|
|
328
345
|
*
|
|
329
346
|
* @returns Success
|
|
@@ -341,7 +358,7 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
341
358
|
*
|
|
342
359
|
* Get the schema (properties) of all reports for a table. If the user running the API is an application administrator, the API will also return all personal reports with owner's user id.
|
|
343
360
|
*
|
|
344
|
-
* @param params.tableId - The unique identifier of the table.
|
|
361
|
+
* @param params.tableId - The unique identifier (dbid) of the table.
|
|
345
362
|
*
|
|
346
363
|
* @returns Success
|
|
347
364
|
*
|
|
@@ -359,7 +376,7 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
359
376
|
*
|
|
360
377
|
* Get the schema (properties) of an individual report.
|
|
361
378
|
*
|
|
362
|
-
* @param params.tableId - The unique identifier of table.
|
|
379
|
+
* @param params.tableId - The unique identifier (dbid) of the table.
|
|
363
380
|
* @param params.reportId - The identifier of the report, unique to the table.
|
|
364
381
|
*
|
|
365
382
|
* @returns Success
|
|
@@ -378,44 +395,28 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
378
395
|
*
|
|
379
396
|
* Runs a report, based on an ID and returns the underlying data associated with it. The format of the data will vary based on the report type. Reports that focus on record-level data (table, calendar, etc.) return the individual records. Aggregate reports (summary, chart) will return the summarized information as configured in the report. UI-specific elements are not returned, such as totals, averages and visualizations. Returns data with intelligent pagination based on the approximate size of each record. The metadata object will include the necessary information to iterate over the response and gather more data.
|
|
380
397
|
*
|
|
381
|
-
* @param params.tableId - The identifier of the table
|
|
398
|
+
* @param params.tableId - The unique identifier (dbid) of the table.
|
|
382
399
|
* @param params.skip - The number of records to skip. You can set this value when paginating through a set of results. (optional)
|
|
383
400
|
* @param params.top - The maximum number of records to return. You can override the default Quickbase pagination to get more or fewer results. If your requested value here exceeds the dynamic maximums, we will return a subset of results and the rest can be gathered in subsequent API calls. (optional)
|
|
384
401
|
* @param params.reportId - The identifier of the report, unique to the table.
|
|
385
402
|
*
|
|
386
|
-
* @param body - Request body (optional)
|
|
387
|
-
*
|
|
388
403
|
* @returns Success
|
|
389
404
|
*
|
|
390
405
|
* @see https://developer.quickbase.com/operation/runReport
|
|
391
406
|
*/
|
|
392
|
-
runReport(params
|
|
407
|
+
runReport(params) {
|
|
393
408
|
const executor = () => {
|
|
394
409
|
return request({
|
|
395
410
|
method: 'POST',
|
|
396
411
|
path: `/reports/${params.reportId}/run`,
|
|
397
412
|
query: { tableId: params.tableId, skip: params.skip, top: params.top },
|
|
398
|
-
body,
|
|
399
413
|
});
|
|
400
414
|
};
|
|
401
415
|
const paginatedExecutor = (paginationParams) => {
|
|
402
|
-
const bodyRecord = body;
|
|
403
|
-
const paginatedBody = paginationParams.skip !== undefined || paginationParams.nextPageToken || paginationParams.nextToken
|
|
404
|
-
? {
|
|
405
|
-
...(bodyRecord || {}),
|
|
406
|
-
options: {
|
|
407
|
-
...(bodyRecord?.options || {}),
|
|
408
|
-
...(paginationParams.skip !== undefined ? { skip: paginationParams.skip } : {}),
|
|
409
|
-
},
|
|
410
|
-
...(paginationParams.nextPageToken ? { nextPageToken: paginationParams.nextPageToken } : {}),
|
|
411
|
-
...(paginationParams.nextToken ? { nextToken: paginationParams.nextToken } : {}),
|
|
412
|
-
}
|
|
413
|
-
: body;
|
|
414
416
|
return request({
|
|
415
417
|
method: 'POST',
|
|
416
418
|
path: `/reports/${params.reportId}/run`,
|
|
417
|
-
query: { tableId: params.tableId, skip: params.skip, top: params.top },
|
|
418
|
-
body: paginatedBody,
|
|
419
|
+
query: { tableId: params.tableId, skip: params.skip, top: params.top, ...paginationParams },
|
|
419
420
|
});
|
|
420
421
|
};
|
|
421
422
|
return createPaginatedRequest(executor, { paginatedExecutor, autoPaginate });
|
|
@@ -444,15 +445,15 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
444
445
|
*
|
|
445
446
|
* Creates a field within a table, including the custom permissions of that field.
|
|
446
447
|
*
|
|
447
|
-
* @param params.tableId - The unique identifier of the table.
|
|
448
|
+
* @param params.tableId - The unique identifier (dbid) of the table.
|
|
448
449
|
*
|
|
449
450
|
* @param body - Request body
|
|
450
|
-
* @param body.audited - Indicates if the field is being tracked as part of Quickbase Audit Logs. You can only set this property to "true" if the app has audit logs enabled. See Enable data change logs under [Quickbase Audit Logs](https://help.quickbase.com/
|
|
451
|
+
* @param body.audited - Indicates if the field is being tracked as part of Quickbase Audit Logs. You can only set this property to "true" if the app has audit logs enabled. See Enable data change logs under [Quickbase Audit Logs](https://help.quickbase.com/docs/audit-logs). Defaults to false. (optional)
|
|
451
452
|
* @param body.fieldHelp - The configured help text shown to users within the product. (optional)
|
|
452
453
|
* @param body.bold - Indicates if the field is configured to display in bold in the product. Defaults to false. (optional)
|
|
453
454
|
* @param body.properties - Specific field properties. (optional)
|
|
454
455
|
* @param body.appearsByDefault - Indicates if the field is marked as a default in reports. Defaults to true. (optional)
|
|
455
|
-
* @param body.fieldType - The [field types](https://help.quickbase.com/
|
|
456
|
+
* @param body.fieldType - The [field types](https://help.quickbase.com/docs/field-types), click on any of the field type links for more info.
|
|
456
457
|
* @param body.permissions - Field Permissions for different roles. (optional)
|
|
457
458
|
* @param body.addToForms - Whether the field you are adding should appear on forms. Defaults to false. (optional)
|
|
458
459
|
* @param body.label - The label (name) of the field.
|
|
@@ -476,10 +477,10 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
476
477
|
*
|
|
477
478
|
* Deletes one or many fields in a table, based on field id. This will also permanently delete any data or calculations in that field.
|
|
478
479
|
*
|
|
479
|
-
* @param params.tableId - The unique identifier of the table.
|
|
480
|
+
* @param params.tableId - The unique identifier (dbid) of the table.
|
|
480
481
|
*
|
|
481
482
|
* @param body - Request body
|
|
482
|
-
* @param body.fieldIds - List of field
|
|
483
|
+
* @param body.fieldIds - List of field IDs to be deleted.
|
|
483
484
|
*
|
|
484
485
|
* @returns Success
|
|
485
486
|
*
|
|
@@ -517,9 +518,9 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
517
518
|
/**
|
|
518
519
|
* Update a field
|
|
519
520
|
*
|
|
520
|
-
* Updates the properties and custom permissions of a field. The attempt to update certain properties might cause existing data to no longer obey the field
|
|
521
|
+
* Updates the properties and custom permissions of a field. The attempt to update certain properties might cause existing data to no longer obey the field's new properties and may be rejected. See the descriptions of required, unique, and choices, below, for specific situations. Any properties of the field that you do not specify in the request body will remain unchanged.
|
|
521
522
|
*
|
|
522
|
-
* @param params.tableId - The unique identifier of the table.
|
|
523
|
+
* @param params.tableId - The unique identifier (dbid) of the table.
|
|
523
524
|
* @param params.fieldId - The unique identifier (fid) of the field.
|
|
524
525
|
*
|
|
525
526
|
* @param body - Request body (optional)
|
|
@@ -615,12 +616,12 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
615
616
|
**Note:** This endpoint supports a maximum payload size of 40MB.
|
|
616
617
|
*
|
|
617
618
|
* @param body - Request body
|
|
618
|
-
* @param body.to - The
|
|
619
|
-
* @param body.data - Record data array, where each record contains key-value mappings of fields to be defined/updated and their values.
|
|
619
|
+
* @param body.to - The unique identifier (dbid) of the table.
|
|
620
|
+
* @param body.data - Record data array, where each record contains key-value mappings of fields to be defined/updated and their values.
|
|
620
621
|
* @param body.mergeFieldId - The merge field id. (optional)
|
|
621
|
-
* @param body.fieldsToReturn - Specify an array of field
|
|
622
|
+
* @param body.fieldsToReturn - Specify an array of field IDs that will return data for any updates or added record. Record ID (FID 3) is always returned if any field ID is requested. (optional)
|
|
622
623
|
*
|
|
623
|
-
* @returns
|
|
624
|
+
* @returns The response
|
|
624
625
|
*
|
|
625
626
|
* @see https://developer.quickbase.com/operation/upsert
|
|
626
627
|
*/
|
|
@@ -659,8 +660,8 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
659
660
|
* Deletes record(s) in a table based on a query. Alternatively, all records in the table can be deleted.
|
|
660
661
|
*
|
|
661
662
|
* @param body - Request body
|
|
662
|
-
* @param body.from - The unique identifier of the table.
|
|
663
|
-
* @param body.where - The filter to delete records. To delete all records specify a filter that will include all records, for example {3.GT.0} where 3 is the ID of the Record ID field.
|
|
663
|
+
* @param body.from - The unique identifier (dbid) of the table.
|
|
664
|
+
* @param body.where - The filter to delete records. To delete all records specify a filter that will include all records, for example {3.GT.0} where 3 is the ID of the Record ID field. Or supply a JSON array of Record IDs.
|
|
664
665
|
*
|
|
665
666
|
* @returns Successful delete records response.
|
|
666
667
|
*
|
|
@@ -680,11 +681,11 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
680
681
|
*
|
|
681
682
|
* @param body - Request body
|
|
682
683
|
* @param body.options - Additional query options. (optional)
|
|
683
|
-
* @param body.where - The filter, using the Quickbase query language, which determines the records to return. If this parameter is omitted, the query will return all records. (optional)
|
|
684
|
+
* @param body.where - The filter, using the Quickbase query language, which determines the records to return. Or supply a JSON array of Record IDs. If this parameter is omitted, the query will return all records. (optional)
|
|
684
685
|
* @param body.groupBy - An array that contains the fields to group the records by. (optional)
|
|
685
|
-
* @param body.sortBy -
|
|
686
|
-
* @param body.select - An array of field
|
|
687
|
-
* @param body.from - The
|
|
686
|
+
* @param body.sortBy - The sortBy (optional)
|
|
687
|
+
* @param body.select - An array of field IDs for the fields that should be returned in the response. If empty, the default columns on the table will be returned. (optional)
|
|
688
|
+
* @param body.from - The unique identifier (dbid) of the table.
|
|
688
689
|
*
|
|
689
690
|
* @returns Success
|
|
690
691
|
*
|
|
@@ -719,6 +720,30 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
719
720
|
};
|
|
720
721
|
return createPaginatedRequest(executor, { paginatedExecutor, autoPaginate });
|
|
721
722
|
},
|
|
723
|
+
/**
|
|
724
|
+
* Get records modified since
|
|
725
|
+
*
|
|
726
|
+
* Checks for record changes on the current table and crawls the record dependency graph based on a provided field list. This determines if records on the table changed after the provided timestamp, when factoring in their dependencies. This API requires app admin permissions and only reviews lookup and summary fields in [supported relationships](https://helpv2.quickbase.com/hc/en-us/articles/4570306993940-Limits-in-Quickbase#:~:text=on%20scalar%20fields-,Summary%20fields,-Text%20summary%20fields).
|
|
727
|
+
To return deleted records for the current table, 'Index record changes' must be enabled.
|
|
728
|
+
Dependent tables only evaluate current records, and deleted records are not supported.
|
|
729
|
+
*
|
|
730
|
+
* @param body - Request body (optional)
|
|
731
|
+
* @param body.after - A timestamp, formatted in ISO-8601 UTC, representing the date and time to search.
|
|
732
|
+
* @param body.fieldList - List of field IDs. Each field is crawled across the entire record dependency graph to find its source record's date modified. If one is not provided, only the current table will be referenced. (optional)
|
|
733
|
+
* @param body.includeDetails - When true, the individual record IDs and timestamps will be returned. If false, only the count of changes will be returned. (optional)
|
|
734
|
+
* @param body.from - The unique identifier (dbid) of the table.
|
|
735
|
+
*
|
|
736
|
+
* @returns Success
|
|
737
|
+
*
|
|
738
|
+
* @see https://developer.quickbase.com/operation/recordsModifiedSince
|
|
739
|
+
*/
|
|
740
|
+
recordsModifiedSince(body) {
|
|
741
|
+
return request({
|
|
742
|
+
method: 'POST',
|
|
743
|
+
path: '/records/modifiedSince',
|
|
744
|
+
body,
|
|
745
|
+
});
|
|
746
|
+
},
|
|
722
747
|
/**
|
|
723
748
|
* Get a temporary token for a dbid
|
|
724
749
|
*
|
|
@@ -767,7 +792,7 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
767
792
|
* @param body.name - The new name for the cloned user token. (optional)
|
|
768
793
|
* @param body.description - The description for the cloned user token. (optional)
|
|
769
794
|
*
|
|
770
|
-
* @returns
|
|
795
|
+
* @returns The response
|
|
771
796
|
*
|
|
772
797
|
* @see https://developer.quickbase.com/operation/cloneUserToken
|
|
773
798
|
*/
|
|
@@ -781,14 +806,14 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
781
806
|
/**
|
|
782
807
|
* Transfer a user token
|
|
783
808
|
*
|
|
784
|
-
* Transfers the specified user token. Application associations will remain intact. For security, permissions must manually be reconciled.
|
|
809
|
+
* Transfers the specified user token. Application associations will remain intact. For security, permissions must manually be reconciled. Only realm or account admins can use this API.
|
|
785
810
|
*
|
|
786
811
|
* @param body - Request body
|
|
787
|
-
* @param body.id - The id of the user token to transfer
|
|
788
|
-
* @param body.from - The id of the user to transfer the user token from
|
|
789
|
-
* @param body.to - The id of the user to transfer the user token to
|
|
812
|
+
* @param body.id - The id of the user token to transfer
|
|
813
|
+
* @param body.from - The id of the user to transfer the user token from
|
|
814
|
+
* @param body.to - The id of the user to transfer the user token to
|
|
790
815
|
*
|
|
791
|
-
* @returns
|
|
816
|
+
* @returns The response
|
|
792
817
|
*
|
|
793
818
|
* @see https://developer.quickbase.com/operation/transferUserToken
|
|
794
819
|
*/
|
|
@@ -804,7 +829,7 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
804
829
|
*
|
|
805
830
|
* Deactivates the authenticated user token. Once this is done, the user token must be reactivated in the user interface.
|
|
806
831
|
*
|
|
807
|
-
* @returns
|
|
832
|
+
* @returns The response
|
|
808
833
|
*
|
|
809
834
|
* @see https://developer.quickbase.com/operation/deactivateUserToken
|
|
810
835
|
*/
|
|
@@ -819,7 +844,7 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
819
844
|
*
|
|
820
845
|
* Deletes the authenticated user token. This is not reversible.
|
|
821
846
|
*
|
|
822
|
-
* @returns
|
|
847
|
+
* @returns The response
|
|
823
848
|
*
|
|
824
849
|
* @see https://developer.quickbase.com/operation/deleteUserToken
|
|
825
850
|
*/
|
|
@@ -834,9 +859,9 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
834
859
|
*
|
|
835
860
|
* Downloads the file attachment, with the file attachment content encoded in base64 format. The API response returns the file name in the `Content-Disposition` header. Meta-data about files can be retrieved from the /records and /reports endpoints, where applicable. Use those endpoints to get the necessary information to fetch files.
|
|
836
861
|
*
|
|
837
|
-
* @param params.tableId - The unique identifier of the table.
|
|
862
|
+
* @param params.tableId - The unique identifier (dbid) of the table.
|
|
838
863
|
* @param params.recordId - The unique identifier of the record.
|
|
839
|
-
* @param params.fieldId - The unique identifier of the field.
|
|
864
|
+
* @param params.fieldId - The unique identifier (fid) of the field.
|
|
840
865
|
* @param params.versionNumber - The file attachment version number.
|
|
841
866
|
*
|
|
842
867
|
* @returns Success
|
|
@@ -847,6 +872,7 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
847
872
|
return request({
|
|
848
873
|
method: 'GET',
|
|
849
874
|
path: `/files/${params.tableId}/${params.recordId}/${params.fieldId}/${params.versionNumber}`,
|
|
875
|
+
responseType: 'text',
|
|
850
876
|
});
|
|
851
877
|
},
|
|
852
878
|
/**
|
|
@@ -854,10 +880,10 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
854
880
|
*
|
|
855
881
|
* Deletes one file attachment version. Meta-data about files can be retrieved from the /records and /reports endpoints, where applicable. Use those endpoints to get the necessary information to delete file versions.
|
|
856
882
|
*
|
|
857
|
-
* @param params.tableId - The unique identifier of the table.
|
|
883
|
+
* @param params.tableId - The unique identifier (dbid) of the table.
|
|
858
884
|
* @param params.recordId - The unique identifier of the record.
|
|
859
|
-
* @param params.fieldId - The unique identifier of the field.
|
|
860
|
-
* @param params.versionNumber - The file attachment version number.
|
|
885
|
+
* @param params.fieldId - The unique identifier (fid) of the field.
|
|
886
|
+
* @param params.versionNumber - The file attachment version number. Passing versionNumber 0 will delete the most recent version.
|
|
861
887
|
*
|
|
862
888
|
* @returns Successfully Deleted the File Attachment
|
|
863
889
|
*
|
|
@@ -872,7 +898,7 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
872
898
|
/**
|
|
873
899
|
* Get users
|
|
874
900
|
*
|
|
875
|
-
* Get all users in an account or narrowed down list of users filtered by email(s). The returned users may be paginated depending on the user count. The count of the returned users may vary. When `nextPageToken` value in the response is not empty, that indicates that there are more results to be returned, you can use this value to get the next result set ('page').
|
|
901
|
+
* Get all users in an account or narrowed down list of users filtered by email(s). The returned users may be paginated depending on the user count. The count of the returned users may vary. When `nextPageToken` value in the response is not empty, that indicates that there are more results to be returned, you can use this value to get the next result set ('page'). Only realm or account admins can use this API.
|
|
876
902
|
*
|
|
877
903
|
* @param params.accountId - The account id being used to get users. If no value is specified, the first account associated with the requesting user token is chosen. (optional)
|
|
878
904
|
*
|
|
@@ -919,17 +945,20 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
919
945
|
/**
|
|
920
946
|
* Deny users
|
|
921
947
|
*
|
|
922
|
-
* Denies users access to the realm but leaves them listed in groups they have been added to.
|
|
948
|
+
* Denies users access to the realm but leaves them listed in groups they have been added to. Only realm or account admins can use this API.
|
|
923
949
|
*
|
|
924
950
|
* @param params.accountId - The account id being used to deny users. If no value is specified, the first account associated with the requesting user token is chosen. (optional)
|
|
925
951
|
*
|
|
926
|
-
* @param body -
|
|
952
|
+
* @param body - A list of user IDs that need to be denied.
|
|
927
953
|
*
|
|
928
954
|
* @returns Success
|
|
929
955
|
*
|
|
930
956
|
* @see https://developer.quickbase.com/operation/denyUsers
|
|
931
957
|
*/
|
|
932
|
-
denyUsers(
|
|
958
|
+
denyUsers(paramsOrBody, maybeBody) {
|
|
959
|
+
const [params, body] = maybeBody === undefined
|
|
960
|
+
? [{}, paramsOrBody]
|
|
961
|
+
: [paramsOrBody, maybeBody];
|
|
933
962
|
return request({
|
|
934
963
|
method: 'PUT',
|
|
935
964
|
path: '/users/deny',
|
|
@@ -940,12 +969,12 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
940
969
|
/**
|
|
941
970
|
* Deny and remove users from groups
|
|
942
971
|
*
|
|
943
|
-
* Denies users access to the realm and allows you to remove them from groups.
|
|
972
|
+
* Denies users access to the realm and allows you to remove them from groups. Only realm or account admins can use this API.
|
|
944
973
|
*
|
|
945
974
|
* @param params.accountId - The account id being used to deny users. If no value is specified, the first account associated with the requesting user token is chosen. (optional)
|
|
946
975
|
* @param params.shouldDeleteFromGroups - Specifies if the users should also be removed from all groups.
|
|
947
976
|
*
|
|
948
|
-
* @param body -
|
|
977
|
+
* @param body - A list of user IDs that need to be denied.
|
|
949
978
|
*
|
|
950
979
|
* @returns Success
|
|
951
980
|
*
|
|
@@ -962,17 +991,20 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
962
991
|
/**
|
|
963
992
|
* Undeny users
|
|
964
993
|
*
|
|
965
|
-
* Grants users that have previously been denied access to the realm.
|
|
994
|
+
* Grants users that have previously been denied access to the realm. Only realm or account admins can use this API.
|
|
966
995
|
*
|
|
967
996
|
* @param params.accountId - The account id being used to undeny users. If no value is specified, the first account associated with the requesting user token is chosen. (optional)
|
|
968
997
|
*
|
|
969
|
-
* @param body -
|
|
998
|
+
* @param body - A list of user IDs that need to be undenied.
|
|
970
999
|
*
|
|
971
1000
|
* @returns Success
|
|
972
1001
|
*
|
|
973
1002
|
* @see https://developer.quickbase.com/operation/undenyUsers
|
|
974
1003
|
*/
|
|
975
|
-
undenyUsers(
|
|
1004
|
+
undenyUsers(paramsOrBody, maybeBody) {
|
|
1005
|
+
const [params, body] = maybeBody === undefined
|
|
1006
|
+
? [{}, paramsOrBody]
|
|
1007
|
+
: [paramsOrBody, maybeBody];
|
|
976
1008
|
return request({
|
|
977
1009
|
method: 'PUT',
|
|
978
1010
|
path: '/users/undeny',
|
|
@@ -980,6 +1012,25 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
980
1012
|
body,
|
|
981
1013
|
});
|
|
982
1014
|
},
|
|
1015
|
+
/**
|
|
1016
|
+
* Get apps for a user
|
|
1017
|
+
*
|
|
1018
|
+
* Returns a list of applications that a specific user has access to within an account. Only account admins can use this API.
|
|
1019
|
+
*
|
|
1020
|
+
* @param params.userId - The unique identifier of the user, including the hashed value (for example, 59913288.d772).
|
|
1021
|
+
* @param params.accountId - The account id used to scope the request.
|
|
1022
|
+
*
|
|
1023
|
+
* @returns Success
|
|
1024
|
+
*
|
|
1025
|
+
* @see https://developer.quickbase.com/operation/getUserApps
|
|
1026
|
+
*/
|
|
1027
|
+
getUserApps(params) {
|
|
1028
|
+
return request({
|
|
1029
|
+
method: 'GET',
|
|
1030
|
+
path: `/users/${params.userId}/apps`,
|
|
1031
|
+
query: { accountId: params.accountId },
|
|
1032
|
+
});
|
|
1033
|
+
},
|
|
983
1034
|
/**
|
|
984
1035
|
* Add members
|
|
985
1036
|
*
|
|
@@ -987,7 +1038,7 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
987
1038
|
*
|
|
988
1039
|
* @param params.gid - This is the ID of the group being modified.
|
|
989
1040
|
*
|
|
990
|
-
* @param body -
|
|
1041
|
+
* @param body - A list of user IDs that will be added to a group.
|
|
991
1042
|
*
|
|
992
1043
|
* @returns Success
|
|
993
1044
|
*
|
|
@@ -1007,7 +1058,7 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
1007
1058
|
*
|
|
1008
1059
|
* @param params.gid - This is the ID of the group being modified.
|
|
1009
1060
|
*
|
|
1010
|
-
* @param body -
|
|
1061
|
+
* @param body - A list of user IDs that will be removed from a group.
|
|
1011
1062
|
*
|
|
1012
1063
|
* @returns Success
|
|
1013
1064
|
*
|
|
@@ -1027,7 +1078,7 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
1027
1078
|
*
|
|
1028
1079
|
* @param params.gid - This is the ID of the group being modified.
|
|
1029
1080
|
*
|
|
1030
|
-
* @param body -
|
|
1081
|
+
* @param body - A list of user IDs that will be added to a group.
|
|
1031
1082
|
*
|
|
1032
1083
|
* @returns Success
|
|
1033
1084
|
*
|
|
@@ -1047,7 +1098,7 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
1047
1098
|
*
|
|
1048
1099
|
* @param params.gid - This is the ID of the group being modified.
|
|
1049
1100
|
*
|
|
1050
|
-
* @param body -
|
|
1101
|
+
* @param body - A list of user IDs that will be removed from a group.
|
|
1051
1102
|
*
|
|
1052
1103
|
* @returns Success
|
|
1053
1104
|
*
|
|
@@ -1067,7 +1118,7 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
1067
1118
|
*
|
|
1068
1119
|
* @param params.gid - This is the ID of the group being modified.
|
|
1069
1120
|
*
|
|
1070
|
-
* @param body -
|
|
1121
|
+
* @param body - A list of group IDs that will be added to a group.
|
|
1071
1122
|
*
|
|
1072
1123
|
* @returns Success
|
|
1073
1124
|
*
|
|
@@ -1087,7 +1138,7 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
1087
1138
|
*
|
|
1088
1139
|
* @param params.gid - This is the ID of the group being modified.
|
|
1089
1140
|
*
|
|
1090
|
-
* @param body -
|
|
1141
|
+
* @param body - A list of group IDs that will be removed from a group.
|
|
1091
1142
|
*
|
|
1092
1143
|
* @returns Success
|
|
1093
1144
|
*
|
|
@@ -1130,7 +1181,7 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
1130
1181
|
* Get user read and integration read summaries for any day in the past.
|
|
1131
1182
|
**Note:** This API is available for enterprise users only.
|
|
1132
1183
|
*
|
|
1133
|
-
* @param params.day - The date for which read summaries need to be fetched. This must be date-time only, as YYYY-MM-DD, and a valid date in the past.
|
|
1184
|
+
* @param params.day - The date for which read summaries need to be fetched. This must be date-time only, as YYYY-MM-DD, and a valid date in the past.
|
|
1134
1185
|
*
|
|
1135
1186
|
* @returns Summaries returned succesfully
|
|
1136
1187
|
*
|
|
@@ -1147,15 +1198,15 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
1147
1198
|
* Get event summaries
|
|
1148
1199
|
*
|
|
1149
1200
|
* Get event summaries for any span of days up to one year and excluding future dates.
|
|
1150
|
-
**Note:** This API is available for enterprise users only. Data is updated hourly
|
|
1201
|
+
**Note:** This API is available for enterprise users only. Data is updated hourly. To ensure accuracy, query dates should be at least one hour in the past. Transactional rate limits are 100 per hour.
|
|
1151
1202
|
*
|
|
1152
1203
|
* @param params.accountId - The ID of the account to query. If no value is specified, the first account matching the provided domain is chosen. (optional)
|
|
1153
1204
|
*
|
|
1154
1205
|
* @param body - Request body (optional)
|
|
1155
|
-
* @param body.start -
|
|
1156
|
-
* @param body.end -
|
|
1206
|
+
* @param body.start - Supply whole-hour timestamps (YYYY-MM-DDTHH:00:00Z) to ensure the boundary hour is included in results. Summary data is available in hourly chunks only. Timestamps are evaluated in UTC; if your timestamp includes a timezone offset, confirm which UTC hour it maps to. Example: A start of 2:00 PM UTC includes the 2:00 PM bucket. A sub-hour value like 2:15 PM UTC does not.
|
|
1207
|
+
* @param body.end - Supply whole-hour timestamps (YYYY-MM-DDTHH:00:00Z) to ensure results stop at your intended boundary. Summary data is available in hourly chunks only. Timestamps are evaluated in UTC; if your timestamp includes a timezone offset, confirm which UTC hour it maps to. Example: An end of 3:00 PM UTC returns data through the end of the 3:00 PM bucket. A sub-hour value like 2:33 PM UTC returns the full 2:00 PM bucket instead.
|
|
1208
|
+
* @param body.nextToken - A pagination token from a previous response made using the same parameters. Used to fetch the next page. (optional)
|
|
1157
1209
|
* @param body.groupBy - How the events should be grouped.
|
|
1158
|
-
* @param body.nextToken - A pagination token from a previous response. Used to fetch the next page. (optional)
|
|
1159
1210
|
* @param body.where - A list of items to filter events by. Only events which match ALL criteria will be included in the results. (optional)
|
|
1160
1211
|
*
|
|
1161
1212
|
* @returns Event summaries returned succesfully
|
|
@@ -1193,13 +1244,40 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
1193
1244
|
};
|
|
1194
1245
|
return createPaginatedRequest(executor, { paginatedExecutor, autoPaginate });
|
|
1195
1246
|
},
|
|
1247
|
+
/**
|
|
1248
|
+
* Generate a document
|
|
1249
|
+
*
|
|
1250
|
+
* Generates a document from a template. After changing a template, allow up to 15 minutes for documents generated via the API to reflect the changes. This feature is only available on business or enterprise plans.
|
|
1251
|
+
*
|
|
1252
|
+
* @param params.tableId - The unique identifier (dbid) of the table.
|
|
1253
|
+
* @param params.recordId - The ID of the record (optional)
|
|
1254
|
+
* @param params.filename - File name for the downloaded file (optional)
|
|
1255
|
+
* @param params.templateId - This is the ID of document template.
|
|
1256
|
+
* @param params.format - The format of the file that is returned. Default is "pdf". (optional)
|
|
1257
|
+
* @param params.margin - Margin formatted as top right bottom left, separated by spaces. Add to override the value set in the template builder. (optional)
|
|
1258
|
+
* @param params.unit - Unit of measurement for the margin. Default is "in". Add to override the value set in the template builder. (optional)
|
|
1259
|
+
* @param params.pageSize - Page size. Default is "A4". Add to override the value set in the template builder. (optional)
|
|
1260
|
+
* @param params.orientation - Page orientation. Default is "portrait". Add to override the value set in the template builder. (optional)
|
|
1261
|
+
* @param params.realm - Your Quickbase domain, for example demo.quickbase.com (optional)
|
|
1262
|
+
*
|
|
1263
|
+
* @returns Success
|
|
1264
|
+
*
|
|
1265
|
+
* @see https://developer.quickbase.com/operation/generateDocument
|
|
1266
|
+
*/
|
|
1267
|
+
generateDocument(params) {
|
|
1268
|
+
return request({
|
|
1269
|
+
method: 'GET',
|
|
1270
|
+
path: `/docTemplates/${params.templateId}/generate`,
|
|
1271
|
+
query: { tableId: params.tableId, recordId: params.recordId, filename: params.filename, format: params.format, margin: params.margin, unit: params.unit, pageSize: params.pageSize, orientation: params.orientation, realm: params.realm },
|
|
1272
|
+
});
|
|
1273
|
+
},
|
|
1196
1274
|
/**
|
|
1197
1275
|
* Export a solution
|
|
1198
1276
|
*
|
|
1199
|
-
* Returns the QBL for the specified solution. Learn more about [QBL syntax](https://help.quickbase.com/
|
|
1200
|
-
|
|
1277
|
+
* Returns the QBL for the specified solution. Learn more about [QBL syntax](https://help.quickbase.com/docs/qbl-definition-structure-and-syntax).
|
|
1278
|
+
We are releasing schema coverage for QBL in stages. See [what's supported today](https://help.quickbase.com/docs/qbl-versions) in our QBL documentation.
|
|
1201
1279
|
*
|
|
1202
|
-
* @param params.solutionId - The unique identifier of
|
|
1280
|
+
* @param params.solutionId - The unique identifier (UUID) or the alias of the solution.
|
|
1203
1281
|
*
|
|
1204
1282
|
* @returns Success
|
|
1205
1283
|
*
|
|
@@ -1209,17 +1287,18 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
1209
1287
|
return request({
|
|
1210
1288
|
method: 'GET',
|
|
1211
1289
|
path: `/solutions/${params.solutionId}`,
|
|
1290
|
+
responseType: 'text',
|
|
1212
1291
|
});
|
|
1213
1292
|
},
|
|
1214
1293
|
/**
|
|
1215
1294
|
* Update a solution
|
|
1216
1295
|
*
|
|
1217
1296
|
* Updates the solution using the provided QBL. Learn more about [QBL syntax](https://help.quickbase.com/hc/en-us/articles/24845511223828-What-is-QBL).
|
|
1218
|
-
|
|
1297
|
+
We are releasing schema coverage for QBL in stages. See [what's supported today](https://helpv2.quickbase.com/hc/en-us/sections/26699387198228-QBL-Versions) in our QBL documentation.
|
|
1219
1298
|
*
|
|
1220
|
-
* @param params.solutionId - The unique identifier of
|
|
1299
|
+
* @param params.solutionId - The unique identifier (UUID) or the alias of the solution.
|
|
1221
1300
|
*
|
|
1222
|
-
* @param body - The QBL to be used for the update.
|
|
1301
|
+
* @param body - The QBL to be used for the update.
|
|
1223
1302
|
*
|
|
1224
1303
|
* @returns Success
|
|
1225
1304
|
*
|
|
@@ -1230,13 +1309,16 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
1230
1309
|
method: 'PUT',
|
|
1231
1310
|
path: `/solutions/${params.solutionId}`,
|
|
1232
1311
|
body,
|
|
1312
|
+
bodyType: 'application/x-yaml',
|
|
1233
1313
|
});
|
|
1234
1314
|
},
|
|
1235
1315
|
/**
|
|
1236
1316
|
* Create a solution
|
|
1237
1317
|
*
|
|
1238
1318
|
* Creates a solution using the provided QBL. Learn more about [QBL syntax](https://help.quickbase.com/hc/en-us/articles/24845511223828-What-is-QBL).
|
|
1239
|
-
|
|
1319
|
+
We are releasing schema coverage for QBL in stages. See [what's supported today](https://helpv2.quickbase.com/hc/en-us/sections/26699387198228-QBL-Versions) in our QBL documentation.
|
|
1320
|
+
*
|
|
1321
|
+
* @param params.alias - An optional alias to identify the solution. This can be used instead of the UUID in subsequent API calls. (optional)
|
|
1240
1322
|
*
|
|
1241
1323
|
* @param body - The QBL to be used for the create.
|
|
1242
1324
|
*
|
|
@@ -1244,20 +1326,25 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
1244
1326
|
*
|
|
1245
1327
|
* @see https://developer.quickbase.com/operation/createSolution
|
|
1246
1328
|
*/
|
|
1247
|
-
createSolution(
|
|
1329
|
+
createSolution(paramsOrBody, maybeBody) {
|
|
1330
|
+
const [params, body] = maybeBody === undefined
|
|
1331
|
+
? [{}, paramsOrBody]
|
|
1332
|
+
: [paramsOrBody, maybeBody];
|
|
1248
1333
|
return request({
|
|
1249
1334
|
method: 'POST',
|
|
1250
1335
|
path: '/solutions',
|
|
1336
|
+
query: { alias: params.alias },
|
|
1251
1337
|
body,
|
|
1338
|
+
bodyType: 'application/x-yaml',
|
|
1252
1339
|
});
|
|
1253
1340
|
},
|
|
1254
1341
|
/**
|
|
1255
1342
|
* Export solution to record
|
|
1256
1343
|
*
|
|
1257
1344
|
* Exports the solution and outputs the resulting QBL in a new record in the specified table. The QBL will be saved to a file in the file attachment field that is specified. The table cannot have any required fields besides the file attachment field.
|
|
1258
|
-
We are releasing schema coverage for QBL in stages. See [what's supported today](https://helpv2.quickbase.com/hc/en-us/
|
|
1345
|
+
We are releasing schema coverage for QBL in stages. See [what's supported today](https://helpv2.quickbase.com/hc/en-us/sections/26699387198228-QBL-Versions) in our QBL documentation.
|
|
1259
1346
|
*
|
|
1260
|
-
* @param params.solutionId - The unique identifier of the solution.
|
|
1347
|
+
* @param params.solutionId - The unique identifier (UUID) or the alias of the solution.
|
|
1261
1348
|
* @param params.tableId - The unique identifier (dbid) of the table.
|
|
1262
1349
|
* @param params.fieldId - The unique identifier (fid) of the field. It needs to be a file attachment field.
|
|
1263
1350
|
*
|
|
@@ -1276,8 +1363,9 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
1276
1363
|
* Create solution from record
|
|
1277
1364
|
*
|
|
1278
1365
|
* Creates a solution using the QBL from the specified record.
|
|
1279
|
-
We are releasing schema coverage for QBL in stages. See [what's supported today](https://helpv2.quickbase.com/hc/en-us/
|
|
1366
|
+
We are releasing schema coverage for QBL in stages. See [what's supported today](https://helpv2.quickbase.com/hc/en-us/sections/26699387198228-QBL-Versions) in our QBL documentation.
|
|
1280
1367
|
*
|
|
1368
|
+
* @param params.alias - An optional alias to identify the solution. This can be used instead of the UUID in subsequent API calls. (optional)
|
|
1281
1369
|
* @param params.tableId - The unique identifier (dbid) of the table.
|
|
1282
1370
|
* @param params.fieldId - The unique identifier (fid) of the field. It needs to be a file attachment field.
|
|
1283
1371
|
* @param params.recordId - The unique identifier of the record.
|
|
@@ -1290,16 +1378,16 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
1290
1378
|
return request({
|
|
1291
1379
|
method: 'GET',
|
|
1292
1380
|
path: '/solutions/fromrecord',
|
|
1293
|
-
query: { tableId: params.tableId, fieldId: params.fieldId, recordId: params.recordId },
|
|
1381
|
+
query: { alias: params.alias, tableId: params.tableId, fieldId: params.fieldId, recordId: params.recordId },
|
|
1294
1382
|
});
|
|
1295
1383
|
},
|
|
1296
1384
|
/**
|
|
1297
1385
|
* Update solution from record
|
|
1298
1386
|
*
|
|
1299
1387
|
* Updates a solution using the QBL from the specified record.
|
|
1300
|
-
We are releasing schema coverage for QBL in stages. See [what's supported today](https://helpv2.quickbase.com/hc/en-us/
|
|
1388
|
+
We are releasing schema coverage for QBL in stages. See [what's supported today](https://helpv2.quickbase.com/hc/en-us/sections/26699387198228-QBL-Versions) in our QBL documentation.
|
|
1301
1389
|
*
|
|
1302
|
-
* @param params.solutionId - The unique identifier of the solution.
|
|
1390
|
+
* @param params.solutionId - The unique identifier (UUID) or the alias of the solution.
|
|
1303
1391
|
* @param params.tableId - The unique identifier (dbid) of the table.
|
|
1304
1392
|
* @param params.fieldId - The unique identifier (fid) of the field. It needs to be a file attachment field.
|
|
1305
1393
|
* @param params.recordId - The unique identifier of the record.
|
|
@@ -1318,10 +1406,10 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
1318
1406
|
/**
|
|
1319
1407
|
* List solution changes
|
|
1320
1408
|
*
|
|
1321
|
-
* Returns a list of changes that would occur if the provided QBL were to be applied. Learn more about [QBL syntax](https://help.quickbase.com/hc/en-us/articles/24845511223828-What-is-QBL).
|
|
1322
|
-
|
|
1409
|
+
* Returns a list of changes that would occur if the provided QBL were to be applied to the solution, without actually making those changes. This is useful for validating changes or previewing the impact before updating a solution. Learn more about [QBL syntax](https://help.quickbase.com/hc/en-us/articles/24845511223828-What-is-QBL).
|
|
1410
|
+
We are releasing schema coverage for QBL in stages. See [what's supported today](https://helpv2.quickbase.com/hc/en-us/sections/26699387198228-QBL-Versions) in our QBL documentation.
|
|
1323
1411
|
*
|
|
1324
|
-
* @param params.solutionId - The unique identifier of the solution.
|
|
1412
|
+
* @param params.solutionId - The unique identifier (UUID) or the alias of the solution.
|
|
1325
1413
|
*
|
|
1326
1414
|
* @param body - The QBL to be used for the changeset.
|
|
1327
1415
|
*
|
|
@@ -1334,15 +1422,16 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
1334
1422
|
method: 'PUT',
|
|
1335
1423
|
path: `/solutions/${params.solutionId}/changeset`,
|
|
1336
1424
|
body,
|
|
1425
|
+
bodyType: 'application/x-yaml',
|
|
1337
1426
|
});
|
|
1338
1427
|
},
|
|
1339
1428
|
/**
|
|
1340
1429
|
* List solution changes from record
|
|
1341
1430
|
*
|
|
1342
1431
|
* Returns a list of changes that would occur if the QBL from the provided record were to be applied.
|
|
1343
|
-
We are releasing schema coverage for QBL in stages. See [what's supported today](https://helpv2.quickbase.com/hc/en-us/
|
|
1432
|
+
We are releasing schema coverage for QBL in stages. See [what's supported today](https://helpv2.quickbase.com/hc/en-us/sections/26699387198228-QBL-Versions) in our QBL documentation.
|
|
1344
1433
|
*
|
|
1345
|
-
* @param params.solutionId - The unique identifier of the solution.
|
|
1434
|
+
* @param params.solutionId - The unique identifier (UUID) or the alias of the solution.
|
|
1346
1435
|
* @param params.tableId - The unique identifier (dbid) of the table.
|
|
1347
1436
|
* @param params.fieldId - The unique identifier (fid) of the field. It needs to be a file attachment field.
|
|
1348
1437
|
* @param params.recordId - The unique identifier of the record.
|
|
@@ -1359,30 +1448,97 @@ export function createApiMethods(request, autoPaginate = false) {
|
|
|
1359
1448
|
});
|
|
1360
1449
|
},
|
|
1361
1450
|
/**
|
|
1362
|
-
*
|
|
1451
|
+
* Get solution information
|
|
1363
1452
|
*
|
|
1364
|
-
*
|
|
1453
|
+
* Returns the metadata and resource information for a solution, including both real and logical IDs of apps and pipelines contained within the solution. This endpoint provides programmatic access to solution structure information.
|
|
1365
1454
|
*
|
|
1366
|
-
* @param params.
|
|
1367
|
-
* @param params.tableId - The unique identifier of the table.
|
|
1368
|
-
* @param params.recordId - The ID of the record (optional)
|
|
1369
|
-
* @param params.filename - File name for the downloaded file
|
|
1370
|
-
* @param params.format - The format of the file that is returned. Default is "pdf". (optional)
|
|
1371
|
-
* @param params.margin - Margin formatted as top right bottom left, separated by spaces. Add to override the value set in the template builder. (optional)
|
|
1372
|
-
* @param params.unit - Unit of measurement for the margin. Default is "in". Add to override the value set in the template builder. (optional)
|
|
1373
|
-
* @param params.pageSize - Page size. Default is "A4". Add to override the value set in the template builder. (optional)
|
|
1374
|
-
* @param params.orientation - Page orientation. Default is "portrait". Add to override the value set in the template builder. (optional)
|
|
1375
|
-
* @param params.realm - Your Quickbase domain, for example demo.quickbase.com (optional)
|
|
1455
|
+
* @param params.solutionId - The unique identifier (UUID) or the alias of the solution.
|
|
1376
1456
|
*
|
|
1377
1457
|
* @returns Success
|
|
1378
1458
|
*
|
|
1379
|
-
* @see https://developer.quickbase.com/operation/
|
|
1459
|
+
* @see https://developer.quickbase.com/operation/getSolutionPublic
|
|
1380
1460
|
*/
|
|
1381
|
-
|
|
1461
|
+
getSolutionPublic(params) {
|
|
1382
1462
|
return request({
|
|
1383
1463
|
method: 'GET',
|
|
1384
|
-
path: `/
|
|
1385
|
-
|
|
1464
|
+
path: `/solutions/${params.solutionId}/resources`,
|
|
1465
|
+
});
|
|
1466
|
+
},
|
|
1467
|
+
/**
|
|
1468
|
+
* Get trustees for an app
|
|
1469
|
+
*
|
|
1470
|
+
* Returns the list of trustees for a specific application. Trustees include users, groups and email domain groups.
|
|
1471
|
+
*
|
|
1472
|
+
* @param params.appId - The unique identifier of an app
|
|
1473
|
+
*
|
|
1474
|
+
* @returns Success
|
|
1475
|
+
*
|
|
1476
|
+
* @see https://developer.quickbase.com/operation/getTrustees
|
|
1477
|
+
*/
|
|
1478
|
+
getTrustees(params) {
|
|
1479
|
+
return request({
|
|
1480
|
+
method: 'GET',
|
|
1481
|
+
path: `/app/${params.appId}/trustees`,
|
|
1482
|
+
});
|
|
1483
|
+
},
|
|
1484
|
+
/**
|
|
1485
|
+
* Add trustees to an app
|
|
1486
|
+
*
|
|
1487
|
+
* Add trustees to the specified application. Trustees include users, groups and email domain groups.
|
|
1488
|
+
*
|
|
1489
|
+
* @param params.appId - The unique identifier of an app
|
|
1490
|
+
*
|
|
1491
|
+
* @param body - Request body (optional)
|
|
1492
|
+
*
|
|
1493
|
+
* @returns Success
|
|
1494
|
+
*
|
|
1495
|
+
* @see https://developer.quickbase.com/operation/addTrustees
|
|
1496
|
+
*/
|
|
1497
|
+
addTrustees(params, body) {
|
|
1498
|
+
return request({
|
|
1499
|
+
method: 'POST',
|
|
1500
|
+
path: `/app/${params.appId}/trustees`,
|
|
1501
|
+
body,
|
|
1502
|
+
});
|
|
1503
|
+
},
|
|
1504
|
+
/**
|
|
1505
|
+
* Remove trustees from an app
|
|
1506
|
+
*
|
|
1507
|
+
* Remove trustees from the specified application. Trustees include users, groups and email domain groups.
|
|
1508
|
+
*
|
|
1509
|
+
* @param params.appId - The unique identifier of an app
|
|
1510
|
+
*
|
|
1511
|
+
* @param body - Request body (optional)
|
|
1512
|
+
*
|
|
1513
|
+
* @returns Success
|
|
1514
|
+
*
|
|
1515
|
+
* @see https://developer.quickbase.com/operation/removeTrustees
|
|
1516
|
+
*/
|
|
1517
|
+
removeTrustees(params, body) {
|
|
1518
|
+
return request({
|
|
1519
|
+
method: 'DELETE',
|
|
1520
|
+
path: `/app/${params.appId}/trustees`,
|
|
1521
|
+
body,
|
|
1522
|
+
});
|
|
1523
|
+
},
|
|
1524
|
+
/**
|
|
1525
|
+
* Update trustees of an app
|
|
1526
|
+
*
|
|
1527
|
+
* Update trustees for the specified application. Trustees include users, groups and email domain groups.
|
|
1528
|
+
*
|
|
1529
|
+
* @param params.appId - The unique identifier of an app
|
|
1530
|
+
*
|
|
1531
|
+
* @param body - Request body (optional)
|
|
1532
|
+
*
|
|
1533
|
+
* @returns Success
|
|
1534
|
+
*
|
|
1535
|
+
* @see https://developer.quickbase.com/operation/updateTrustees
|
|
1536
|
+
*/
|
|
1537
|
+
updateTrustees(params, body) {
|
|
1538
|
+
return request({
|
|
1539
|
+
method: 'PATCH',
|
|
1540
|
+
path: `/app/${params.appId}/trustees`,
|
|
1541
|
+
body,
|
|
1386
1542
|
});
|
|
1387
1543
|
},
|
|
1388
1544
|
};
|