quickbase-js 0.1.0-beta.8 → 0.1.0-beta.9

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 (52) hide show
  1. package/CHANGELOG.md +29 -0
  2. package/README.md +46 -130
  3. package/dist/esm/quickbase.d.ts +822 -119
  4. package/dist/esm/quickbase.js +373 -236
  5. package/dist/esm/quickbase.js.map +1 -1
  6. package/dist/esm/quickbase.min.js +1 -1
  7. package/dist/esm/quickbase.min.js.map +1 -1
  8. package/dist/umd/quickbase.umd.js +373 -236
  9. package/dist/umd/quickbase.umd.js.map +1 -1
  10. package/dist/umd/quickbase.umd.min.js +1 -1
  11. package/dist/umd/quickbase.umd.min.js.map +1 -1
  12. package/open-api/generate-unified-interface.ts +97 -17
  13. package/open-api/utils/generateJsDoc.ts +96 -0
  14. package/package.json +3 -1
  15. package/src/ThrottleBucket.ts +17 -12
  16. package/src/authorizationStrategy.ts +246 -0
  17. package/src/generated-unified/QuickbaseClient.ts +809 -119
  18. package/src/invokeMethod.ts +150 -265
  19. package/src/quickbaseClient.ts +85 -58
  20. package/src/rateLimiter.ts +25 -0
  21. package/src/tokenCache.ts +10 -26
  22. package/tests/vitest/qb/auth/mockQuickbaseServer.ts +60 -0
  23. package/tests/vitest/qb/auth/retryUserToken401.test.ts +59 -42
  24. package/tests/vitest/qb/auth/ssoTokenIntegrationWithServer.test.ts +65 -0
  25. package/tests/vitest/qb/fields/getFieldUsage.test.ts +58 -150
  26. package/tests/vitest/qb/formulas/runFormula.test.ts +96 -0
  27. package/tests/vitest/qb/tables/createRelationship.test.ts +102 -0
  28. package/tests/vitest/qb/tables/deleteRelationship.test.ts +143 -0
  29. package/tests/vitest/qb/tables/updateRelationship.test.ts +118 -145
  30. package/tests/vitest/unit/ThrottleBucket.test.ts +95 -0
  31. package/tests/vitest/unit/apps/copyApp.test.ts +133 -40
  32. package/tests/vitest/unit/apps/updateApp.test.ts +42 -11
  33. package/tests/vitest/unit/auth/fetchTempToken401.test.ts +3 -2
  34. package/tests/vitest/unit/auth/getTempToken.test.ts +42 -18
  35. package/tests/vitest/unit/auth/retryTempToken401.test.ts +46 -64
  36. package/tests/vitest/unit/auth/retryTempTokenMaxRetries.test.ts +235 -0
  37. package/tests/vitest/unit/auth/retryUserToken401.test.ts +56 -43
  38. package/tests/vitest/unit/auth/ssoTokenRefresh.test.ts +325 -0
  39. package/tests/vitest/unit/fields/createField.test.ts +180 -116
  40. package/tests/vitest/unit/fields/getFieldUsage.test.ts +17 -3
  41. package/tests/vitest/unit/fields/updateField.test.ts +12 -7
  42. package/tests/vitest/unit/formulas/runFormula.test.ts +205 -0
  43. package/tests/vitest/unit/index.ts +2 -1
  44. package/tests/vitest/unit/inferHttpMethod.test.ts +131 -0
  45. package/tests/vitest/unit/rateLimit.test.ts +4 -2
  46. package/tests/vitest/unit/tables/createRelationship.test.ts +212 -0
  47. package/tests/vitest/unit/tables/deleteRelationship.test.ts +97 -0
  48. package/tests/vitest/unit/tables/updateRelationship.test.ts +12 -10
  49. package/tests/vitest/unit/tokenLifespan.test.ts +149 -83
  50. package/tools/log-gen.ts +14 -5
  51. package/tools/log-gen.yaml +710 -268
  52. package/tests/vitest/unit/auth/retryTempTokenTwo401.test.ts +0 -81
@@ -1,359 +1,1049 @@
1
- // Generated on 2025-03-18T03:01:28.172Z
1
+ // Generated on 2025-03-20T04:14:08.516Z
2
2
  import { AddManagersToGroup200Response, AddManagersToGroupRequest, AddMembersToGroup200Response, AddMembersToGroupRequest, AddSubgroupsToGroup200Response, AddSubgroupsToGroupRequest, Audit200Response, ChangesetSolution200Response, ChangesetSolutionFromRecord200Response, CloneUserToken200Response, CopyApp200Response, CopyAppRequest, CreateApp200Response, CreateAppRequest, CreateField200Response, CreateFieldRequest, CreateRelationship200Response, CreateRelationshipRequest, CreateSolution200Response, CreateSolutionFromRecord200Response, CreateTable200Response, CreateTableRequest, DeactivateUserToken200Response, DeleteApp200Response, DeleteAppRequest, DeleteFields200Response, DeleteFieldsRequest, DeleteFile200Response, DeleteRecords200Response, DeleteRecordsRequest, DeleteRelationship200Response, DeleteTable200Response, DeleteUserToken200Response, DenyUsers200Response, DenyUsersAndGroups200Response, DenyUsersAndGroupsRequest, DenyUsersRequest, DownloadFile200Response, ExchangeSsoToken200Response, ExportSolution200Response, ExportSolutionToRecord200Response, GenerateDocument200Response, GetApp200Response, GetAppEvents200Response, GetAppTables200Response, GetField200Response, GetFieldUsage200Response, GetFields200Response, GetFieldsUsage200Response, GetRelationships200Response, GetReport200Response, GetTable200Response, GetTableReports200Response, GetTempTokenDBID200Response, GetUsers200Response, GetUsersRequest, PlatformAnalyticEventSummaries200Response, PlatformAnalyticReads200Response, RemoveManagersFromGroup200Response, RemoveManagersFromGroupRequest, RemoveMembersFromGroup200Response, RemoveMembersFromGroupRequest, RemoveSubgroupsFromGroup200Response, RemoveSubgroupsFromGroupRequest, RunFormula200Response, RunQuery200Response, RunQueryRequest, RunReport200Response, TransferUserToken200Response, UndenyUsers200Response, UndenyUsersRequest, UpdateApp200Response, UpdateAppRequest, UpdateField200Response, UpdateFieldRequest, UpdateRelationship200Response, UpdateRelationshipRequest, UpdateSolution200Response, UpdateSolutionToRecord200Response, UpdateTable200Response, UpdateTableRequest, Upsert200Response, Upsert207Response, UpsertRequest } from "../generated/models";
3
3
 
4
4
  export interface QuickbaseClient {
5
5
  /**
6
6
  * Create an app
7
- * @param params - Parameters for createApp
8
- * @returns Promise resolving to createApp response
7
+ *
8
+ * @param {Object} params _Object containing the parameters for_ createApp
9
+ * @param {CreateAppRequest} params.body _Optional parameter with properties_
10
+ * - **name** (`string`, required) _The name of the app._
11
+ * - **description** (`string`, optional) _A description for the app._
12
+ * - **assignToken** (`boolean`, required) _Whether to assign the user token._
13
+ *
14
+ * @returns {Promise<CreateApp200Response>} _Promise resolving to the createApp response with properties_
15
+ * - **name** (`string`, required) _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._
16
+ * - **description** (`string`, optional) _The description for the app. If this property is left out, the app description will be blank._
17
+ * - **created** (`string`, optional) _The time and date the app was created, in the ISO 8601 time format YYYY-MM-DDThh:mm:ss.sssZ (in UTC time zone)._
18
+ * - **updated** (`string`, optional) _The time and date the app was last updated, in the ISO 8601 time format YYYY-MM-DDThh:mm:ss.sssZ (in UTC time zone)._
19
+ * - **dateFormat** (`string`, optional) _A description of the format used when displaying date values in this app. Note that this is a browser-only parameter - see the [Field type details](../fieldInfo) page in the API Guide for how time values are returned in API calls. See [About Localizing Dates](https://help.quickbase.com/user-assistance/about_localizing_dates_numbers.html) to set the app’s date format._
20
+ * - **timeZone** (`string`, optional) _A description of the time zone used when displaying time values in this app. Note that this is a browser-only parameter - see the [Field type details](../fieldInfo) page in the portal for how time values are returned in API calls. See [Set the Time Zone for Both the Application and the Account](https://help.quickbase.com/user-assistance/application_local_timezone.html) to set the application’s time zone._
21
+ * - **memoryInfo** (`object`, optional) _Application memory info_
22
+ * - **id** (`string`, optional) _The unique identifier for this application._
23
+ * - **hasEveryoneOnTheInternet** (`boolean`, optional) _Indicates whether app includes Everyone On The Internet access. See [Sharing apps with Everyone on the Internet (EOTI).](https://help.quickbase.com/user-assistance/share_with_everyone_on_internet.html)_
24
+ * - **variables** (`{ [key: string]: any; }[]`, optional) _The app variables. See [About Application Variables](https://help.quickbase.com/user-assistance/variables.html)_
25
+ * - **dataClassification** (`string`, optional) _The Data Classification label assigned to the application. If Data Classification is not turned on, this will not be returned. If Data Classification is turned on, but application is not labeled, we return “None". Data Classification labels can be added in the Admin Console by a Realm Administrator for Platform+ plans._
26
+ * - **securityProperties** (`{ [key: string]: any; }`, optional) _Security properties of the application_
27
+ *
28
+ * @see {@link https://developer.quickbase.com/operation/createApp} Official Quickbase API documentation
9
29
  */
10
30
  createApp: (params: { body?: CreateAppRequest }) => Promise<CreateApp200Response>;
11
31
  /**
12
32
  * Get an app
13
- * @param params - Parameters for getApp
14
- * @returns Promise resolving to getApp response
33
+ *
34
+ * @param {Object} params _Object containing the parameters for_ getApp
35
+ * @param {string} params.appId _Required parameter with properties_
36
+ *
37
+ * @returns {Promise<GetApp200Response>} _Promise resolving to the getApp response with properties_
38
+ * - **ancestorId** (`string`, optional) _The id of the app from which this app was copied_
39
+ * - **name** (`string`, required) _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._
40
+ * - **description** (`string`, optional) _The description for the app. If this property is left out, the app description will be blank._
41
+ * - **created** (`string`, optional) _The time and date the app was created, in the ISO 8601 time format YYYY-MM-DDThh:mm:ss.sssZ (in UTC time zone)._
42
+ * - **updated** (`string`, optional) _The time and date the app was last updated, in the ISO 8601 time format YYYY-MM-DDThh:mm:ss.sssZ (in UTC time zone)._
43
+ * - **dateFormat** (`string`, optional) _A description of the format used when displaying date values in this app. Note that this is a browser-only parameter - see the [Field type details](../fieldInfo) page in the API Guide for how time values are returned in API calls. See [About Localizing Dates](https://help.quickbase.com/user-assistance/about_localizing_dates_numbers.html) to set the app’s date format._
44
+ * - **timeZone** (`string`, optional) _A description of the time zone used when displaying time values in this app. Note that this is a browser-only parameter - see the [Field type details](../fieldInfo) page in the portal for how time values are returned in API calls. See [Set the Time Zone for Both the Application and the Account](https://help.quickbase.com/user-assistance/application_local_timezone.html) to set the application’s time zone._
45
+ * - **memoryInfo** (`object`, optional) _Application memory info_
46
+ * - **id** (`string`, optional) _The unique identifier for this application._
47
+ * - **hasEveryoneOnTheInternet** (`boolean`, optional) _Indicates whether app includes Everyone On The Internet access. See [Sharing apps with Everyone on the Internet (EOTI).](https://help.quickbase.com/user-assistance/share_with_everyone_on_internet.html)_
48
+ * - **variables** (`{ [key: string]: any; }[]`, optional) _The app variables. See [About Application Variables](https://help.quickbase.com/user-assistance/variables.html)_
49
+ * - **dataClassification** (`string`, optional) _The Data Classification label assigned to the application. If Data Classification is not turned on, this will not be returned. If Data Classification is turned on, but application is not labeled, we return “None". Data Classification labels can be added in the Admin Console by a Realm Administrator for Platform+ plans._
50
+ * - **securityProperties** (`{ [key: string]: any; }`, optional) _Security properties of the application_
51
+ *
52
+ * @see {@link https://developer.quickbase.com/operation/getApp} Official Quickbase API documentation
15
53
  */
16
54
  getApp: (params: { appId: string }) => Promise<GetApp200Response>;
17
55
  /**
18
56
  * Update an app
19
- * @param params - Parameters for updateApp
20
- * @returns Promise resolving to updateApp response
57
+ *
58
+ * @param {Object} params _Object containing the parameters for_ updateApp
59
+ * @param {string} params.appId _Required parameter with properties_
60
+ * @param {UpdateAppRequest} params.body _Optional parameter with properties_
61
+ * - **name** (`string`, required) _The name of the app._
62
+ * - **description** (`string`, optional) _A description for the app._
63
+ * - **assignToken** (`boolean`, required) _Whether to assign the user token._
64
+ *
65
+ * @returns {Promise<UpdateApp200Response>} _Promise resolving to the updateApp response with properties_
66
+ * - **ancestorId** (`string`, optional) _The id of the app from which this app was copied_
67
+ * - **name** (`string`, required) _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._
68
+ * - **description** (`string`, optional) _The description for the app. If this property is left out, the app description will be blank._
69
+ * - **created** (`string`, optional) _The time and date the app was created, in the ISO 8601 time format YYYY-MM-DDThh:mm:ss.sssZ (in UTC time zone)._
70
+ * - **updated** (`string`, optional) _The time and date the app was last updated, in the ISO 8601 time format YYYY-MM-DDThh:mm:ss.sssZ (in UTC time zone)._
71
+ * - **dateFormat** (`string`, optional) _A description of the format used when displaying date values in this app. Note that this is a browser-only parameter - see the [Field type details](../fieldInfo) page in the API Guide for how time values are returned in API calls. See [About Localizing Dates](https://help.quickbase.com/user-assistance/about_localizing_dates_numbers.html) to set the app’s date format._
72
+ * - **timeZone** (`string`, optional) _A description of the time zone used when displaying time values in this app. Note that this is a browser-only parameter - see the [Field type details](../fieldInfo) page in the portal for how time values are returned in API calls. See [Set the Time Zone for Both the Application and the Account](https://help.quickbase.com/user-assistance/application_local_timezone.html) to set the application’s time zone._
73
+ * - **memoryInfo** (`object`, optional) _Application memory info_
74
+ * - **id** (`string`, optional) _The unique identifier for this application._
75
+ * - **hasEveryoneOnTheInternet** (`boolean`, optional) _Indicates whether app includes Everyone On The Internet access. See [Sharing apps with Everyone on the Internet (EOTI).](https://help.quickbase.com/user-assistance/share_with_everyone_on_internet.html)_
76
+ * - **variables** (`{ [key: string]: any; }[]`, optional) _The app variables. See [About Application Variables](https://help.quickbase.com/user-assistance/variables.html)_
77
+ * - **dataClassification** (`string`, optional) _The Data Classification label assigned to the application. If Data Classification is not turned on, this will not be returned. If Data Classification is turned on, but application is not labeled, we return “None". Data Classification labels can be added in the Admin Console by a Realm Administrator for Platform+ plans._
78
+ * - **securityProperties** (`{ [key: string]: any; }`, optional) _Security properties of the application_
79
+ *
80
+ * @see {@link https://developer.quickbase.com/operation/updateApp} Official Quickbase API documentation
21
81
  */
22
82
  updateApp: (params: { appId: string; body?: UpdateAppRequest }) => Promise<UpdateApp200Response>;
23
83
  /**
24
84
  * Delete an app
25
- * @param params - Parameters for deleteApp
26
- * @returns Promise resolving to deleteApp response
85
+ *
86
+ * @param {Object} params _Object containing the parameters for_ deleteApp
87
+ * @param {string} params.appId _Required parameter with properties_
88
+ * @param {DeleteAppRequest} params.body _Optional parameter with properties_
89
+ * - **name** (`string`, required) _The name of the app._
90
+ * - **description** (`string`, optional) _A description for the app._
91
+ * - **assignToken** (`boolean`, required) _Whether to assign the user token._
92
+ *
93
+ * @returns {Promise<DeleteApp200Response>} _Promise resolving to the deleteApp response with properties_
94
+ * - **deletedAppId** (`string`, optional) _An ID of deleted application._
95
+ *
96
+ * @see {@link https://developer.quickbase.com/operation/deleteApp} Official Quickbase API documentation
27
97
  */
28
98
  deleteApp: (params: { appId: string; body?: DeleteAppRequest }) => Promise<DeleteApp200Response>;
29
99
  /**
30
100
  * Get app events
31
- * @param params - Parameters for getAppEvents
32
- * @returns Promise resolving to getAppEvents response
101
+ *
102
+ * @param {Object} params _Object containing the parameters for_ getAppEvents
103
+ * @param {string} params.appId _Required parameter with properties_
104
+ *
105
+ * @returns {Promise<GetAppEvents200Response>} _Promise resolving to the getAppEvents response_
106
+ *
107
+ * @see {@link https://developer.quickbase.com/operation/getAppEvents} Official Quickbase API documentation
33
108
  */
34
109
  getAppEvents: (params: { appId: string }) => Promise<GetAppEvents200Response>;
35
110
  /**
36
111
  * Copy an app
37
- * @param params - Parameters for copyApp
38
- * @returns Promise resolving to copyApp response
112
+ *
113
+ * @param {Object} params _Object containing the parameters for_ copyApp
114
+ * @param {string} params.appId _Required parameter with properties_
115
+ * @param {CopyAppRequest} params.body _Optional parameter with properties_
116
+ * - **name** (`string`, required) _The name of the new app._
117
+ * - **description** (`string`, optional) _A description for the new app._
118
+ * - **properties** (`CopyAppRequestProperties`, optional) _Type: CopyAppRequestProperties_
119
+ *
120
+ * @returns {Promise<CopyApp200Response>} _Promise resolving to the copyApp response with properties_
121
+ * - **name** (`string`, required) _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._
122
+ * - **description** (`string`, optional) _The description for the app_
123
+ * - **created** (`string`, optional) _The time and date the app was created, in the ISO 8601 time format YYYY-MM-DDThh:mm:ss.sssZ (in UTC time zone)._
124
+ * - **updated** (`string`, optional) _The time and date the app was last updated, in the ISO 8601 time format YYYY-MM-DDThh:mm:ss.sssZ (in UTC time zone)._
125
+ * - **dateFormat** (`string`, optional) _A description of the format used when displaying date values in this app. Note that this is a browser-only parameter - see the [Field type details](../fieldInfo) page in the API Guide for how time values are returned in API calls. See [About Localizing Dates](https://help.quickbase.com/user-assistance/about_localizing_dates_numbers.html) to set the app’s date format._
126
+ * - **timeZone** (`string`, optional) _A description of the time zone used when displaying time values in this app. Note that this is a browser-only parameter - see the [Field type details](../fieldInfo) page in the portal for how time values are returned in API calls. See [Set the Time Zone for Both the Application and the Account](https://help.quickbase.com/user-assistance/application_local_timezone.html) to set the application’s time zone._
127
+ * - **id** (`string`, optional) _The unique identifier for this application._
128
+ * - **hasEveryoneOnTheInternet** (`boolean`, optional) _Indicates whether app includes Everyone On The Internet access. See [Sharing apps with Everyone on the Internet (EOTI).](https://help.quickbase.com/user-assistance/share_with_everyone_on_internet.html)_
129
+ * - **variables** (`{ [key: string]: any; }[]`, optional) _The app variables. See [About Application Variables](https://help.quickbase.com/user-assistance/variables.html)_
130
+ * - **ancestorId** (`string`, optional) _The id of the app from which this app was copied_
131
+ * - **dataClassification** (`string`, optional) _The Data Classification label assigned to the application. If Data Classification is not turned on, this will not be returned. If Data Classification is turned on, but application is not labeled, we return “None". Data Classification labels can be added in the Admin Console by a Realm Administrator for Platform+ plans._
132
+ *
133
+ * @see {@link https://developer.quickbase.com/operation/copyApp} Official Quickbase API documentation
39
134
  */
40
135
  copyApp: (params: { appId: string; body?: CopyAppRequest }) => Promise<CopyApp200Response>;
41
136
  /**
42
137
  * Create a table
43
- * @param params - Parameters for createTable
44
- * @returns Promise resolving to createTable response
138
+ *
139
+ * @param {Object} params _Object containing the parameters for_ createTable
140
+ * @param {string} params.appId _Required parameter with properties_
141
+ * @param {CreateTableRequest} params.body _Optional parameter with properties_
142
+ * - **name** (`string`, required) _The name for the table._
143
+ * - **description** (`string`, optional) _The description for the table..._
144
+ * - **singleRecordName** (`string`, optional) _The singular noun for records..._
145
+ * - **pluralRecordName** (`string`, optional) _The plural noun for records..._
146
+ *
147
+ * @returns {Promise<CreateTable200Response>} _Promise resolving to the createTable response with properties_
148
+ * - **name** (`string`, optional) _The name of the table._
149
+ * - **id** (`string`, optional) _The unique identifier (dbid) of the table._
150
+ * - **alias** (`string`, optional) _The automatically-created table alias for the table._
151
+ * - **description** (`string`, optional) _The description of the table, as configured by an application administrator._
152
+ * - **created** (`string`, optional) _The time and date when the table was created, in the ISO 8601 time format YYYY-MM-DDThh:mm:ss.sssZ (in UTC time zone)._
153
+ * - **updated** (`string`, optional) _The time and date when the table schema or data was last updated, in the ISO 8601 time format YYYY-MM-DDThh:mm:ss.sssZ (in UTC time zone)._
154
+ * - **nextRecordId** (`number`, optional) _The incremental Record ID that will be used when the next record is created, as determined when the API call was ran._
155
+ * - **nextFieldId** (`number`, optional) _The incremental Field ID that will be used when the next field is created, as determined when the API call was ran._
156
+ * - **defaultSortFieldId** (`number`, optional) _The id of the field that is configured for default sorting._
157
+ * - **defaultSortOrder** (`CreateTable200ResponseDefaultSortOrderEnum`, optional) _The configuration of the default sort order on the table._
158
+ * - **keyFieldId** (`number`, optional) _The id of the field that is configured to be the key on this table, which is usually the Quickbase Record ID._
159
+ * - **singleRecordName** (`string`, optional) _The builder-configured singular noun of the table._
160
+ * - **pluralRecordName** (`string`, optional) _The builder-configured plural noun of the table._
161
+ * - **sizeLimit** (`string`, optional) _The size limit for the table._
162
+ * - **spaceUsed** (`string`, optional) _The amount of space currently being used by the table._
163
+ * - **spaceRemaining** (`string`, optional) _The amount of space remaining for use by the table._
164
+ *
165
+ * @see {@link https://developer.quickbase.com/operation/createTable} Official Quickbase API documentation
45
166
  */
46
167
  createTable: (params: { appId: string; body?: CreateTableRequest }) => Promise<CreateTable200Response>;
47
168
  /**
48
169
  * Get tables for an app
49
- * @param params - Parameters for getAppTables
50
- * @returns Promise resolving to getAppTables response
170
+ *
171
+ * @param {Object} params _Object containing the parameters for_ getAppTables
172
+ * @param {string} params.appId _Required parameter with properties_
173
+ *
174
+ * @returns {Promise<GetAppTables200Response>} _Promise resolving to the getAppTables response_
175
+ *
176
+ * @see {@link https://developer.quickbase.com/operation/getAppTables} Official Quickbase API documentation
51
177
  */
52
178
  getAppTables: (params: { appId: string }) => Promise<GetAppTables200Response>;
53
179
  /**
54
180
  * Get a table
55
- * @param params - Parameters for getTable
56
- * @returns Promise resolving to getTable response
181
+ *
182
+ * @param {Object} params _Object containing the parameters for_ getTable
183
+ * @param {string} params.appId _Required parameter with properties_
184
+ * @param {string} params.tableId _Required parameter with properties_
185
+ *
186
+ * @returns {Promise<GetTable200Response>} _Promise resolving to the getTable response with properties_
187
+ * - **name** (`string`, optional) _The name of the table._
188
+ * - **id** (`string`, optional) _The unique identifier (dbid) of the table._
189
+ * - **alias** (`string`, optional) _The automatically-created table alias for the table._
190
+ * - **description** (`string`, optional) _The description of the table, as configured by an application administrator._
191
+ * - **created** (`string`, optional) _The time and date when the table was created, in the ISO 8601 time format YYYY-MM-DDThh:mm:ss.sssZ (in UTC time zone)._
192
+ * - **updated** (`string`, optional) _The time and date when the table schema or data was last updated, in the ISO 8601 time format YYYY-MM-DDThh:mm:ss.sssZ (in UTC time zone)._
193
+ * - **nextRecordId** (`number`, optional) _The incremental Record ID that will be used when the next record is created, as determined when the API call was ran._
194
+ * - **nextFieldId** (`number`, optional) _The incremental Field ID that will be used when the next field is created, as determined when the API call was ran._
195
+ * - **defaultSortFieldId** (`number`, optional) _The id of the field that is configured for default sorting._
196
+ * - **defaultSortOrder** (`GetTable200ResponseDefaultSortOrderEnum`, optional) _The configuration of the default sort order on the table._
197
+ * - **keyFieldId** (`number`, optional) _The id of the field that is configured to be the key on this table, which is usually the Quickbase Record ID._
198
+ * - **singleRecordName** (`string`, optional) _The builder-configured singular noun of the table._
199
+ * - **pluralRecordName** (`string`, optional) _The builder-configured plural noun of the table._
200
+ * - **sizeLimit** (`string`, optional) _The size limit for the table._
201
+ * - **spaceUsed** (`string`, optional) _The amount of space currently being used by the table._
202
+ * - **spaceRemaining** (`string`, optional) _The amount of space remaining for use by the table._
203
+ *
204
+ * @see {@link https://developer.quickbase.com/operation/getTable} Official Quickbase API documentation
57
205
  */
58
206
  getTable: (params: { appId: string; tableId: string }) => Promise<GetTable200Response>;
59
207
  /**
60
208
  * Update a table
61
- * @param params - Parameters for updateTable
62
- * @returns Promise resolving to updateTable response
209
+ *
210
+ * @param {Object} params _Object containing the parameters for_ updateTable
211
+ * @param {string} params.appId _Required parameter with properties_
212
+ * @param {string} params.tableId _Required parameter with properties_
213
+ * @param {UpdateTableRequest} params.body _Optional parameter with properties_
214
+ * - **name** (`string`, optional) _The updated name of the table._
215
+ * - **description** (`string`, optional) _The updated description for the table._
216
+ *
217
+ * @returns {Promise<UpdateTable200Response>} _Promise resolving to the updateTable response with properties_
218
+ * - **name** (`string`, optional) _The name of the table._
219
+ * - **id** (`string`, optional) _The unique identifier (dbid) of the table._
220
+ * - **alias** (`string`, optional) _The automatically-created table alias for the table._
221
+ * - **description** (`string`, optional) _The description of the table, as configured by an application administrator._
222
+ * - **created** (`string`, optional) _The time and date when the table was created, in the ISO 8601 time format YYYY-MM-DDThh:mm:ss.sssZ (in UTC time zone)._
223
+ * - **updated** (`string`, optional) _The time and date when the table schema or data was last updated, in the ISO 8601 time format YYYY-MM-DDThh:mm:ss.sssZ (in UTC time zone)._
224
+ * - **nextRecordId** (`number`, optional) _The incremental Record ID that will be used when the next record is created, as determined when the API call was ran._
225
+ * - **nextFieldId** (`number`, optional) _The incremental Field ID that will be used when the next field is created, as determined when the API call was ran._
226
+ * - **defaultSortFieldId** (`number`, optional) _The id of the field that is configured for default sorting._
227
+ * - **defaultSortOrder** (`UpdateTable200ResponseDefaultSortOrderEnum`, optional) _The configuration of the default sort order on the table._
228
+ * - **keyFieldId** (`number`, optional) _The id of the field that is configured to be the key on this table, which is usually the Quickbase Record ID._
229
+ * - **singleRecordName** (`string`, optional) _The builder-configured singular noun of the table._
230
+ * - **pluralRecordName** (`string`, optional) _The builder-configured plural noun of the table._
231
+ * - **sizeLimit** (`string`, optional) _The size limit for the table._
232
+ * - **spaceUsed** (`string`, optional) _The amount of space currently being used by the table._
233
+ * - **spaceRemaining** (`string`, optional) _The amount of space remaining for use by the table._
234
+ *
235
+ * @see {@link https://developer.quickbase.com/operation/updateTable} Official Quickbase API documentation
63
236
  */
64
237
  updateTable: (params: { appId: string; tableId: string; body?: UpdateTableRequest }) => Promise<UpdateTable200Response>;
65
238
  /**
66
239
  * Delete a table
67
- * @param params - Parameters for deleteTable
68
- * @returns Promise resolving to deleteTable response
240
+ *
241
+ * @param {Object} params _Object containing the parameters for_ deleteTable
242
+ * @param {string} params.appId _Required parameter with properties_
243
+ * @param {string} params.tableId _Required parameter with properties_
244
+ *
245
+ * @returns {Promise<DeleteTable200Response>} _Promise resolving to the deleteTable response with properties_
246
+ * - **deletedTableId** (`string`, optional) _The deleted table id._
247
+ *
248
+ * @see {@link https://developer.quickbase.com/operation/deleteTable} Official Quickbase API documentation
69
249
  */
70
250
  deleteTable: (params: { appId: string; tableId: string }) => Promise<DeleteTable200Response>;
71
251
  /**
72
252
  * Get all relationships
73
- * @param params - Parameters for getRelationships
74
- * @returns Promise resolving to getRelationships response
253
+ *
254
+ * @param {Object} params _Object containing the parameters for_ getRelationships
255
+ * @param {number} params.skip _Optional parameter with properties_
256
+ * @param {string} params.tableId _Required parameter with properties_
257
+ *
258
+ * @returns {Promise<GetRelationships200Response>} _Promise resolving to the getRelationships response with properties_
259
+ * - **relationships** (`{ [key: string]: any; }[]`, required) _The relationships in a table._
260
+ * - **metadata** (`{ [key: string]: any; }`, optional) _Additional information about the results that may be helpful._
261
+ *
262
+ * @see {@link https://developer.quickbase.com/operation/getRelationships} Official Quickbase API documentation
75
263
  */
76
264
  getRelationships: (params: { skip?: number; tableId: string }) => Promise<GetRelationships200Response>;
77
265
  /**
78
266
  * Create a relationship
79
- * @param params - Parameters for createRelationship
80
- * @returns Promise resolving to createRelationship response
267
+ *
268
+ * @param {Object} params _Object containing the parameters for_ createRelationship
269
+ * @param {string} params.tableId _Required parameter with properties_
270
+ * @param {CreateRelationshipRequest} params.body _Optional parameter with properties_
271
+ * - **parentTableId** (`string`, required) _The parent table id for the relationship._
272
+ * - **foreignKeyField** (`{ [key: string]: any; }`, optional) _Type: { [key: string]: any; }_
273
+ * - **lookupFieldIds** (`number[]`, optional) _Array of field ids..._
274
+ * - **summaryFields** (`{ [key: string]: any; }[]`, optional) _Array of summary field objects..._
275
+ *
276
+ * @returns {Promise<CreateRelationship200Response>} _Promise resolving to the createRelationship response with properties_
277
+ * - **id** (`number`, required) _The relationship id (foreign key field id)._
278
+ * - **parentTableId** (`string`, required) _The parent table id of the relationship._
279
+ * - **childTableId** (`string`, required) _The child table id of the relationship._
280
+ * - **foreignKeyField** (`{ [key: string]: any; }`, optional) _The foreign key field information._
281
+ * - **isCrossApp** (`boolean`, required) _Whether this is a cross-app relationship._
282
+ * - **lookupFields** (`{ [key: string]: any; }[]`, optional) _The lookup fields array._
283
+ * - **summaryFields** (`{ [key: string]: any; }[]`, optional) _The summary fields array._
284
+ *
285
+ * @see {@link https://developer.quickbase.com/operation/createRelationship} Official Quickbase API documentation
81
286
  */
82
287
  createRelationship: (params: { tableId: string; body?: CreateRelationshipRequest }) => Promise<CreateRelationship200Response>;
83
288
  /**
84
289
  * Update a relationship
85
- * @param params - Parameters for updateRelationship
86
- * @returns Promise resolving to updateRelationship response
290
+ *
291
+ * @param {Object} params _Object containing the parameters for_ updateRelationship
292
+ * @param {string} params.tableId _Required parameter with properties_
293
+ * @param {number} params.relationshipId _Required parameter with properties_
294
+ * @param {UpdateRelationshipRequest} params.body _Optional parameter with properties_
295
+ * - **parentTableId** (`string`, optional) _The updated parent table id..._
296
+ * - **foreignKeyField** (`{ [key: string]: any; }`, optional) _Type: { [key: string]: any; }_
297
+ * - **lookupFieldIds** (`number[]`, optional) _Updated array of field ids..._
298
+ * - **summaryFields** (`{ [key: string]: any; }[]`, optional) _Type: { [key: string]: any; }[]_
299
+ *
300
+ * @returns {Promise<UpdateRelationship200Response>} _Promise resolving to the updateRelationship response with properties_
301
+ * - **id** (`number`, required) _The relationship id (foreign key field id)._
302
+ * - **parentTableId** (`string`, required) _The parent table id of the relationship._
303
+ * - **childTableId** (`string`, required) _The child table id of the relationship._
304
+ * - **foreignKeyField** (`{ [key: string]: any; }`, optional) _The foreign key field information._
305
+ * - **isCrossApp** (`boolean`, required) _Whether this is a cross-app relationship._
306
+ * - **lookupFields** (`{ [key: string]: any; }[]`, optional) _The lookup fields array._
307
+ * - **summaryFields** (`{ [key: string]: any; }[]`, optional) _The summary fields array._
308
+ *
309
+ * @see {@link https://developer.quickbase.com/operation/updateRelationship} Official Quickbase API documentation
87
310
  */
88
311
  updateRelationship: (params: { tableId: string; relationshipId: number; body?: UpdateRelationshipRequest }) => Promise<UpdateRelationship200Response>;
89
312
  /**
90
313
  * Delete a relationship
91
- * @param params - Parameters for deleteRelationship
92
- * @returns Promise resolving to deleteRelationship response
314
+ *
315
+ * @param {Object} params _Object containing the parameters for_ deleteRelationship
316
+ * @param {string} params.tableId _Required parameter with properties_
317
+ * @param {number} params.relationshipId _Required parameter with properties_
318
+ *
319
+ * @returns {Promise<DeleteRelationship200Response>} _Promise resolving to the deleteRelationship response with properties_
320
+ * - **relationshipId** (`number`, required) _The relationship id._
321
+ *
322
+ * @see {@link https://developer.quickbase.com/operation/deleteRelationship} Official Quickbase API documentation
93
323
  */
94
324
  deleteRelationship: (params: { tableId: string; relationshipId: number }) => Promise<DeleteRelationship200Response>;
95
325
  /**
96
326
  * Get reports for a table
97
- * @param params - Parameters for getTableReports
98
- * @returns Promise resolving to getTableReports response
327
+ *
328
+ * @param {Object} params _Object containing the parameters for_ getTableReports
329
+ * @param {string} params.tableId _Required parameter with properties_
330
+ *
331
+ * @returns {Promise<GetTableReports200Response>} _Promise resolving to the getTableReports response_
332
+ *
333
+ * @see {@link https://developer.quickbase.com/operation/getTableReports} Official Quickbase API documentation
99
334
  */
100
335
  getTableReports: (params: { tableId: string }) => Promise<GetTableReports200Response>;
101
336
  /**
102
337
  * Get a report
103
- * @param params - Parameters for getReport
104
- * @returns Promise resolving to getReport response
338
+ *
339
+ * @param {Object} params _Object containing the parameters for_ getReport
340
+ * @param {string} params.tableId _Required parameter with properties_
341
+ * @param {string} params.reportId _Required parameter with properties_
342
+ *
343
+ * @returns {Promise<GetReport200Response>} _Promise resolving to the getReport response with properties_
344
+ * - **id** (`string`, optional) _The identifier of the report, unique to the table._
345
+ * - **name** (`string`, optional) _The configured name of the report._
346
+ * - **type** (`string`, optional) _The type of report in Quickbase (e.g., chart)._
347
+ * - **description** (`string`, optional) _The configured description of a report._
348
+ * - **ownerId** (`number`, optional) _Optional, showed only for personal reports. The user ID of report owner._
349
+ * - **query** (`{ [key: string]: any; }`, optional) _The query definition as configured in Quickbase that gets executed when the report is run._
350
+ * - **properties** (`{ [key: string]: any; }`, optional) _A list of properties specific to the report type. To see a detailed description of the properties for each report type, See [Report Types.](../reportTypes)_
351
+ * - **usedLast** (`string`, optional) _The instant at which a report was last used._
352
+ * - **usedCount** (`number`, optional) _The number of times a report has been used._
353
+ *
354
+ * @see {@link https://developer.quickbase.com/operation/getReport} Official Quickbase API documentation
105
355
  */
106
356
  getReport: (params: { tableId: string; reportId: string }) => Promise<GetReport200Response>;
107
357
  /**
108
358
  * Run a report
109
- * @param params - Parameters for runReport
110
- * @returns Promise resolving to runReport response
359
+ *
360
+ * @param {Object} params _Object containing the parameters for_ runReport
361
+ * @param {string} params.tableId _Required parameter with properties_
362
+ * @param {number} params.skip _Optional parameter with properties_
363
+ * @param {number} params.top _Optional parameter with properties_
364
+ * @param {string} params.reportId _Required parameter with properties_
365
+ * @param {any} params.body _Optional parameter with properties_
366
+ *
367
+ * @returns {Promise<RunReport200Response>} _Promise resolving to the runReport response with properties_
368
+ * - **fields** (`{ [key: string]: any; }[]`, optional) _An array of objects that contains limited meta-data of each field displayed in the report. This assists in building logic that depends on field types and IDs._
369
+ * - **data** (`string[]`, optional) _An array of objects that either represents the record data or summarized values, depending on the report type._
370
+ * - **metadata** (`{ [key: string]: any; }`, optional) _Additional information about the results that may be helpful. Pagination may be needed if either you specify a smaller number of results to skip than is available, or if the API automatically returns fewer results. numRecords can be compared to totalRecords to determine if further pagination is needed._
371
+ *
372
+ * @see {@link https://developer.quickbase.com/operation/runReport} Official Quickbase API documentation
111
373
  */
112
374
  runReport: (params: { tableId: string; skip?: number; top?: number; reportId: string; body?: any }) => Promise<RunReport200Response>;
113
375
  /**
114
376
  * Get fields for a table
115
- * @param params - Parameters for getFields
116
- * @returns Promise resolving to getFields response
377
+ *
378
+ * @param {Object} params _Object containing the parameters for_ getFields
379
+ * @param {string} params.tableId _Required parameter with properties_
380
+ * @param {boolean} params.includeFieldPerms _Optional parameter with properties_
381
+ *
382
+ * @returns {Promise<GetFields200Response>} _Promise resolving to the getFields response_
383
+ *
384
+ * @see {@link https://developer.quickbase.com/operation/getFields} Official Quickbase API documentation
117
385
  */
118
386
  getFields: (params: { tableId: string; includeFieldPerms?: boolean }) => Promise<GetFields200Response>;
119
387
  /**
120
388
  * Create a field
121
- * @param params - Parameters for createField
122
- * @returns Promise resolving to createField response
389
+ *
390
+ * @param {Object} params _Object containing the parameters for_ createField
391
+ * @param {string} params.tableId _Required parameter with properties_
392
+ * @param {CreateFieldRequest} params.body _Optional parameter with properties_
393
+ * - **label** (`string`, required) _The label of the field_
394
+ * - **fieldType** (`CreateFieldRequestFieldTypeEnum`, required) _The type of the field_
395
+ * - **fieldHelp** (`string`, optional) _Help text for the field_
396
+ * - **addToForms** (`boolean`, optional) _Whether to add the field to forms_
397
+ * - **permissions** (`object`, optional) _Custom permissions for the field_
398
+ * - **required** (`boolean`, optional) _Whether the field is required_
399
+ * - **unique** (`boolean`, optional) _Whether the field must have unique values_
400
+ * - **noWrap** (`boolean`, optional) _Whether text wrapping is disabled_
401
+ * - **bold** (`boolean`, optional) _Whether the field is bolded_
402
+ * - **appearsByDefault** (`boolean`, optional) _Whether the field appears by default in reports_
403
+ * - **findEnabled** (`boolean`, optional) _Whether the field is searchable_
404
+ * - **doesDataCopy** (`boolean`, optional) _Whether the field copies data_
405
+ * - **audited** (`boolean`, optional) _Whether changes to the field are audited_
406
+ * - **properties** (`CreateFieldRequestProperties`, optional) _Type: CreateFieldRequestProperties_
407
+ *
408
+ * @returns {Promise<CreateField200Response>} _Promise resolving to the createField response with properties_
409
+ * - **id** (`number`, required) _The id of the field, unique to this table._
410
+ * - **fieldType** (`string`, optional) _The type of field, as described [here](https://help.quickbase.com/user-assistance/field_types.html)._
411
+ * - **mode** (`string`, optional) _For derived fields, this will be 'lookup', 'summary', or 'formula', to indicate the type of derived field. For non-derived fields, this will be blank._
412
+ * - **label** (`string`, optional) _The label (name) of the field._
413
+ * - **noWrap** (`boolean`, optional) _Indicates if the field is configured to not wrap when displayed in the product._
414
+ * - **bold** (`boolean`, optional) _Indicates if the field is configured to display in bold in the product._
415
+ * - **required** (`boolean`, optional) _Indicates if the field is marked required._
416
+ * - **appearsByDefault** (`boolean`, optional) _Indicates if the field is marked as a default in reports._
417
+ * - **findEnabled** (`boolean`, optional) _Indicates if the field is marked as searchable._
418
+ * - **unique** (`boolean`, optional) _Indicates if the field is marked unique._
419
+ * - **doesDataCopy** (`boolean`, optional) _Indicates if the field data will copy when a user copies the record._
420
+ * - **fieldHelp** (`string`, optional) _The configured help text shown to users within the product._
421
+ * - **audited** (`boolean`, optional) _Indicates if the field is being tracked as part of Quickbase Audit Logs._
422
+ * - **properties** (`{ [key: string]: any; }`, optional) _Additional properties for the field. Please see [Field type details](../fieldInfo) page for more details on the properties for each field type._
423
+ * - **permissions** (`object[]`, optional) _Field Permissions for different roles._
424
+ *
425
+ * @see {@link https://developer.quickbase.com/operation/createField} Official Quickbase API documentation
123
426
  */
124
427
  createField: (params: { tableId: string; body?: CreateFieldRequest }) => Promise<CreateField200Response>;
125
428
  /**
126
429
  * Delete field(s)
127
- * @param params - Parameters for deleteFields
128
- * @returns Promise resolving to deleteFields response
430
+ *
431
+ * @param {Object} params _Object containing the parameters for_ deleteFields
432
+ * @param {string} params.tableId _Required parameter with properties_
433
+ * @param {DeleteFieldsRequest} params.body _Optional parameter with properties_
434
+ * - **fieldIds** (`number[]`, required) _Type: number[]_
435
+ *
436
+ * @returns {Promise<DeleteFields200Response>} _Promise resolving to the deleteFields response with properties_
437
+ * - **deletedFieldIds** (`number[]`, required) _List of field ids to were deleted._
438
+ * - **errors** (`string[]`, required) _List of errors found._
439
+ *
440
+ * @see {@link https://developer.quickbase.com/operation/deleteFields} Official Quickbase API documentation
129
441
  */
130
442
  deleteFields: (params: { tableId: string; body?: DeleteFieldsRequest }) => Promise<DeleteFields200Response>;
131
443
  /**
132
444
  * Get field
133
- * @param params - Parameters for getField
134
- * @returns Promise resolving to getField response
445
+ *
446
+ * @param {Object} params _Object containing the parameters for_ getField
447
+ * @param {string} params.tableId _Required parameter with properties_
448
+ * @param {boolean} params.includeFieldPerms _Optional parameter with properties_
449
+ * @param {number} params.fieldId _Required parameter with properties_
450
+ *
451
+ * @returns {Promise<GetField200Response>} _Promise resolving to the getField response with properties_
452
+ * - **id** (`number`, required) _The id of the field, unique to this table._
453
+ * - **fieldType** (`string`, optional) _The type of field, as described [here](https://help.quickbase.com/user-assistance/field_types.html)._
454
+ * - **mode** (`string`, optional) _For derived fields, this will be 'lookup', 'summary', or 'formula', to indicate the type of derived field. For non-derived fields, this will be blank._
455
+ * - **label** (`string`, optional) _The label (name) of the field._
456
+ * - **noWrap** (`boolean`, optional) _Indicates if the field is configured to not wrap when displayed in the product._
457
+ * - **bold** (`boolean`, optional) _Indicates if the field is configured to display in bold in the product._
458
+ * - **required** (`boolean`, optional) _Indicates if the field is marked required._
459
+ * - **appearsByDefault** (`boolean`, optional) _Indicates if the field is marked as a default in reports._
460
+ * - **findEnabled** (`boolean`, optional) _Indicates if the field is marked as searchable._
461
+ * - **unique** (`boolean`, optional) _Indicates if the field is marked unique._
462
+ * - **doesDataCopy** (`boolean`, optional) _Indicates if the field data will copy when a user copies the record._
463
+ * - **fieldHelp** (`string`, optional) _The configured help text shown to users within the product._
464
+ * - **audited** (`boolean`, optional) _Indicates if the field is being tracked as part of Quickbase Audit Logs._
465
+ * - **properties** (`{ [key: string]: any; }`, optional) _Additional properties for the field. Please see [Field type details](../fieldInfo) page for more details on the properties for each field type._
466
+ * - **permissions** (`object[]`, optional) _Field Permissions for different roles._
467
+ *
468
+ * @see {@link https://developer.quickbase.com/operation/getField} Official Quickbase API documentation
135
469
  */
136
470
  getField: (params: { tableId: string; includeFieldPerms?: boolean; fieldId: number }) => Promise<GetField200Response>;
137
471
  /**
138
472
  * Update a field
139
- * @param params - Parameters for updateField
140
- * @returns Promise resolving to updateField response
473
+ *
474
+ * @param {Object} params _Object containing the parameters for_ updateField
475
+ * @param {string} params.tableId _Required parameter with properties_
476
+ * @param {number} params.fieldId _Required parameter with properties_
477
+ * @param {UpdateFieldRequest} params.body _Optional parameter with properties_
478
+ * - **label** (`string`, required) _The label of the field_
479
+ * - **fieldType** (`UpdateFieldRequestFieldTypeEnum`, optional) _The type of the field_
480
+ * - **fieldHelp** (`string`, optional) _Help text for the field_
481
+ * - **addToForms** (`boolean`, optional) _Whether to add the field to forms_
482
+ * - **permissions** (`object`, optional) _Custom permissions for the field_
483
+ * - **required** (`boolean`, optional) _Whether the field is required_
484
+ * - **unique** (`boolean`, optional) _Whether the field must have unique values_
485
+ * - **noWrap** (`boolean`, optional) _Whether text wrapping is disabled_
486
+ * - **bold** (`boolean`, optional) _Whether the field is bolded_
487
+ * - **appearsByDefault** (`boolean`, optional) _Whether the field appears by default in reports_
488
+ * - **findEnabled** (`boolean`, optional) _Whether the field is searchable_
489
+ * - **doesDataCopy** (`boolean`, optional) _Whether the field copies data_
490
+ * - **audited** (`boolean`, optional) _Whether changes to the field are audited_
491
+ * - **properties** (`CreateFieldRequestProperties`, optional) _Type: CreateFieldRequestProperties_
492
+ *
493
+ * @returns {Promise<UpdateField200Response>} _Promise resolving to the updateField response with properties_
494
+ * - **id** (`number`, required) _The id of the field, unique to this table._
495
+ * - **fieldType** (`string`, optional) _The type of field, as described [here](https://help.quickbase.com/user-assistance/field_types.html)._
496
+ * - **mode** (`string`, optional) _For derived fields, this will be 'lookup', 'summary', or 'formula', to indicate the type of derived field. For non-derived fields, this will be blank._
497
+ * - **label** (`string`, optional) _The label (name) of the field._
498
+ * - **noWrap** (`boolean`, optional) _Indicates if the field is configured to not wrap when displayed in the product._
499
+ * - **bold** (`boolean`, optional) _Indicates if the field is configured to display in bold in the product._
500
+ * - **required** (`boolean`, optional) _Indicates if the field is marked required._
501
+ * - **appearsByDefault** (`boolean`, optional) _Indicates if the field is marked as a default in reports._
502
+ * - **findEnabled** (`boolean`, optional) _Indicates if the field is marked as searchable._
503
+ * - **unique** (`boolean`, optional) _Indicates if the field is marked unique._
504
+ * - **doesDataCopy** (`boolean`, optional) _Indicates if the field data will copy when a user copies the record._
505
+ * - **fieldHelp** (`string`, optional) _The configured help text shown to users within the product._
506
+ * - **audited** (`boolean`, optional) _Indicates if the field is being tracked as part of Quickbase Audit Logs._
507
+ * - **properties** (`{ [key: string]: any; }`, optional) _Additional properties for the field. Please see [Field type details](../fieldInfo) page for more details on the properties for each field type._
508
+ * - **permissions** (`object[]`, optional) _Field Permissions for different roles._
509
+ *
510
+ * @see {@link https://developer.quickbase.com/operation/updateField} Official Quickbase API documentation
141
511
  */
142
512
  updateField: (params: { tableId: string; fieldId: number; body?: UpdateFieldRequest }) => Promise<UpdateField200Response>;
143
513
  /**
144
514
  * Get usage for all fields
145
- * @param params - Parameters for getFieldsUsage
146
- * @returns Promise resolving to getFieldsUsage response
515
+ *
516
+ * @param {Object} params _Object containing the parameters for_ getFieldsUsage
517
+ * @param {string} params.tableId _Required parameter with properties_
518
+ * @param {number} params.skip _Optional parameter with properties_
519
+ * @param {number} params.top _Optional parameter with properties_
520
+ *
521
+ * @returns {Promise<GetFieldsUsage200Response>} _Promise resolving to the getFieldsUsage response_
522
+ *
523
+ * @see {@link https://developer.quickbase.com/operation/getFieldsUsage} Official Quickbase API documentation
147
524
  */
148
525
  getFieldsUsage: (params: { tableId: string; skip?: number; top?: number }) => Promise<GetFieldsUsage200Response>;
149
526
  /**
150
527
  * Get usage for a field
151
- * @param params - Parameters for getFieldUsage
152
- * @returns Promise resolving to getFieldUsage response
528
+ *
529
+ * @param {Object} params _Object containing the parameters for_ getFieldUsage
530
+ * @param {string} params.tableId _Required parameter with properties_
531
+ * @param {number} params.fieldId _Required parameter with properties_
532
+ *
533
+ * @returns {Promise<GetFieldUsage200Response>} _Promise resolving to the getFieldUsage response_
534
+ *
535
+ * @see {@link https://developer.quickbase.com/operation/getFieldUsage} Official Quickbase API documentation
153
536
  */
154
537
  getFieldUsage: (params: { tableId: string; fieldId: number }) => Promise<GetFieldUsage200Response>;
155
538
  /**
156
539
  * Run a formula
157
- * @param params - Parameters for runFormula
158
- * @returns Promise resolving to runFormula response
540
+ *
541
+ * @param {Object} params _Object containing the parameters for_ runFormula
542
+ * @param {{ formula?: string; rid?: number; from?: string }} params.body _Optional parameter with properties_
543
+ *
544
+ * @returns {Promise<RunFormula200Response>} _Promise resolving to the runFormula response with properties_
545
+ * - **result** (`string`, optional) _The formula execution result._
546
+ *
547
+ * @see {@link https://developer.quickbase.com/operation/runFormula} Official Quickbase API documentation
159
548
  */
160
549
  runFormula: (params: { body?: { formula?: string; rid?: number; from?: string } }) => Promise<RunFormula200Response>;
161
550
  /**
162
551
  * Insert/Update record(s)
163
- * @param params - Parameters for upsert
164
- * @returns Promise resolving to upsert response
552
+ *
553
+ * @param {Object} params _Object containing the parameters for_ upsert
554
+ * @param {UpsertRequest} params.body _Optional parameter with properties_
555
+ * - **data** (`Record[]`, optional) _Type: Record[]_
556
+ * - **to** (`string`, optional) _Type: string_
557
+ * - **fieldsToReturn** (`number[]`, optional) _Type: number[]_
558
+ *
559
+ * @returns {Promise<Upsert200Response | Upsert207Response>} _Promise resolving to the upsert response_
560
+ *
561
+ * @see {@link https://developer.quickbase.com/operation/upsert} Official Quickbase API documentation
165
562
  */
166
563
  upsert: (params: { body?: UpsertRequest }) => Promise<Upsert200Response | Upsert207Response>;
167
564
  /**
168
565
  * Delete record(s)
169
- * @param params - Parameters for deleteRecords
170
- * @returns Promise resolving to deleteRecords response
566
+ *
567
+ * @param {Object} params _Object containing the parameters for_ deleteRecords
568
+ * @param {DeleteRecordsRequest} params.body _Optional parameter with properties_
569
+ * - **from** (`string`, required) _Type: string_
570
+ * - **where** (`string`, optional) _Type: string_
571
+ *
572
+ * @returns {Promise<DeleteRecords200Response>} _Promise resolving to the deleteRecords response with properties_
573
+ * - **numberDeleted** (`number`, optional) _The number of records deleted._
574
+ *
575
+ * @see {@link https://developer.quickbase.com/operation/deleteRecords} Official Quickbase API documentation
171
576
  */
172
577
  deleteRecords: (params: { body?: DeleteRecordsRequest }) => Promise<DeleteRecords200Response>;
173
578
  /**
174
579
  * Query for data
175
- * @param params - Parameters for runQuery
176
- * @returns Promise resolving to runQuery response
580
+ *
581
+ * @param {Object} params _Object containing the parameters for_ runQuery
582
+ * @param {RunQueryRequest} params.body _Optional parameter with properties_
583
+ * - **from** (`string`, required) _The table identifier._
584
+ * - **select** (`number[]`, optional) _An array of field ids..._
585
+ * - **where** (`string`, optional) _The filter, using the Quickbase query language..._
586
+ * - **sortBy** (`RunQueryRequestSortByInner[]`, optional) _An array of field IDs and sort directions..._
587
+ * - **groupBy** (`RunQueryRequestGroupByInner[]`, optional) _An array that contains the fields to group the records by._
588
+ * - **options** (`RunQueryRequestOptions`, optional) _Type: RunQueryRequestOptions_
589
+ *
590
+ * @returns {Promise<RunQuery200Response>} _Promise resolving to the runQuery response with properties_
591
+ * - **fields** (`{ [key: string]: any; }[]`, optional) _An array of objects that contains limited meta-data of each field displayed in the report. This assists in building logic that depends on field types and IDs._
592
+ * - **data** (`string[]`, optional) _An array of objects that either represents the record data or summarized values, depending on the report type._
593
+ * - **metadata** (`{ [key: string]: any; }`, optional) _Additional information about the results that may be helpful. Pagination may be needed if either you specify a smaller number of results to skip than is available, or if the API automatically returns fewer results. numRecords can be compared to totalRecords to determine if further pagination is needed._
594
+ *
595
+ * @see {@link https://developer.quickbase.com/operation/runQuery} Official Quickbase API documentation
177
596
  */
178
597
  runQuery: (params: { body?: RunQueryRequest }) => Promise<RunQuery200Response>;
179
598
  /**
180
599
  * Get a temporary token for a dbid
181
- * @param params - Parameters for getTempTokenDBID
182
- * @returns Promise resolving to getTempTokenDBID response
600
+ *
601
+ * @param {Object} params _Object containing the parameters for_ getTempTokenDBID
602
+ * @param {string} params.dbid _Required parameter with properties_
603
+ * @param {string} params.qBAppToken _Optional parameter with properties_
604
+ *
605
+ * @returns {Promise<GetTempTokenDBID200Response>} _Promise resolving to the getTempTokenDBID response with properties_
606
+ * - **temporaryAuthorization** (`string`, optional) _Temporary authorization token._
607
+ *
608
+ * @see {@link https://developer.quickbase.com/operation/getTempTokenDBID} Official Quickbase API documentation
183
609
  */
184
610
  getTempTokenDBID: (params: { dbid: string; qBAppToken?: string }) => Promise<GetTempTokenDBID200Response>;
185
611
  /**
186
612
  * Exchange an SSO token
187
- * @param params - Parameters for exchangeSsoToken
188
- * @returns Promise resolving to exchangeSsoToken response
613
+ *
614
+ * @param {Object} params _Object containing the parameters for_ exchangeSsoToken
615
+ * @param {{ grant_type?: string; requested_token_type?: string; subject_token?: string; subject_token_type?: string }} params.body _Optional parameter with properties_
616
+ *
617
+ * @returns {Promise<ExchangeSsoToken200Response>} _Promise resolving to the exchangeSsoToken response with properties_
618
+ * - **accessToken** (`string`, optional) _The security token issued by the authorization server in response to the token exchange request. The identifier `access_token` is used for historical reasons and the issued token need not be an OAuth access token._
619
+ * - **issuedTokenType** (`ExchangeSsoToken200ResponseIssuedTokenTypeEnum`, optional) _An identifier for the representation of the issued security token._
620
+ * - **tokenType** (`"N_A"`, optional) _Will always return `N_A`_
621
+ *
622
+ * @see {@link https://developer.quickbase.com/operation/exchangeSsoToken} Official Quickbase API documentation
189
623
  */
190
624
  exchangeSsoToken: (params: { body?: { grant_type?: string; requested_token_type?: string; subject_token?: string; subject_token_type?: string } }) => Promise<ExchangeSsoToken200Response>;
191
625
  /**
192
626
  * Clone a user token
193
- * @param params - Parameters for cloneUserToken
194
- * @returns Promise resolving to cloneUserToken response
627
+ *
628
+ * @param {Object} params _Object containing the parameters for_ cloneUserToken
629
+ * @param {{ name?: string; description?: string }} params.body _Optional parameter with properties_
630
+ *
631
+ * @returns {Promise<CloneUserToken200Response>} _Promise resolving to the cloneUserToken response with properties_
632
+ * - **active** (`boolean`, optional) _Whether the user token is active._
633
+ * - **apps** (`{ [key: string]: any; }[]`, optional) _The list of apps this user token is assigned to._
634
+ * - **lastUsed** (`string`, optional) _The last date this user token was used, in the ISO 8601 time format YYYY-MM-DDThh:mm:ss.sssZ (in UTC time zone)._
635
+ * - **description** (`string`, optional) _User Token description._
636
+ * - **id** (`number`, optional) _User Token id._
637
+ * - **name** (`string`, optional) _User Token name._
638
+ * - **token** (`string`, optional) _User Token value._
639
+ *
640
+ * @see {@link https://developer.quickbase.com/operation/cloneUserToken} Official Quickbase API documentation
195
641
  */
196
642
  cloneUserToken: (params: { body?: { name?: string; description?: string } }) => Promise<CloneUserToken200Response>;
197
643
  /**
198
644
  * Transfer a user token
199
- * @param params - Parameters for transferUserToken
200
- * @returns Promise resolving to transferUserToken response
645
+ *
646
+ * @param {Object} params _Object containing the parameters for_ transferUserToken
647
+ * @param {{ id?: number; from?: string; to?: string }} params.body _Optional parameter with properties_
648
+ *
649
+ * @returns {Promise<TransferUserToken200Response>} _Promise resolving to the transferUserToken response with properties_
650
+ * - **active** (`boolean`, optional) _Whether the user token is active._
651
+ * - **apps** (`{ [key: string]: any; }[]`, optional) _The list of apps this user token is assigned to._
652
+ * - **lastUsed** (`string`, optional) _The last date this user token was used, in the ISO 8601 time format YYYY-MM-DDThh:mm:ss.sssZ (in UTC time zone)._
653
+ * - **description** (`string`, optional) _User Token description._
654
+ * - **id** (`number`, optional) _User Token id._
655
+ * - **name** (`string`, optional) _User Token name._
656
+ *
657
+ * @see {@link https://developer.quickbase.com/operation/transferUserToken} Official Quickbase API documentation
201
658
  */
202
659
  transferUserToken: (params: { body?: { id?: number; from?: string; to?: string } }) => Promise<TransferUserToken200Response>;
203
660
  /**
204
661
  * Deactivate a user token
205
- * @param params - Parameters for deactivateUserToken
206
- * @returns Promise resolving to deactivateUserToken response
662
+ *
663
+ * @param {Object} params _Object containing the parameters for_ deactivateUserToken
664
+ * No parameters
665
+ *
666
+ * @returns {Promise<DeactivateUserToken200Response>} _Promise resolving to the deactivateUserToken response with properties_
667
+ * - **id** (`number`, optional) _The user token id._
668
+ *
669
+ * @see {@link https://developer.quickbase.com/operation/deactivateUserToken} Official Quickbase API documentation
207
670
  */
208
671
  deactivateUserToken: (params: { }) => Promise<DeactivateUserToken200Response>;
209
672
  /**
210
673
  * Delete a user token
211
- * @param params - Parameters for deleteUserToken
212
- * @returns Promise resolving to deleteUserToken response
674
+ *
675
+ * @param {Object} params _Object containing the parameters for_ deleteUserToken
676
+ * No parameters
677
+ *
678
+ * @returns {Promise<DeleteUserToken200Response>} _Promise resolving to the deleteUserToken response with properties_
679
+ * - **id** (`number`, optional) _The user token id._
680
+ *
681
+ * @see {@link https://developer.quickbase.com/operation/deleteUserToken} Official Quickbase API documentation
213
682
  */
214
683
  deleteUserToken: (params: { }) => Promise<DeleteUserToken200Response>;
215
684
  /**
216
685
  * Download file
217
- * @param params - Parameters for downloadFile
218
- * @returns Promise resolving to downloadFile response
686
+ *
687
+ * @param {Object} params _Object containing the parameters for_ downloadFile
688
+ * @param {string} params.tableId _Required parameter with properties_
689
+ * @param {number} params.recordId _Required parameter with properties_
690
+ * @param {number} params.fieldId _Required parameter with properties_
691
+ * @param {number} params.versionNumber _Required parameter with properties_
692
+ *
693
+ * @returns {Promise<DownloadFile200Response>} _Promise resolving to the downloadFile response with properties_
694
+ * - **data** (`Blob`, optional) _Type: Blob_
695
+ *
696
+ * @see {@link https://developer.quickbase.com/operation/downloadFile} Official Quickbase API documentation
219
697
  */
220
698
  downloadFile: (params: { tableId: string; recordId: number; fieldId: number; versionNumber: number }) => Promise<DownloadFile200Response>;
221
699
  /**
222
700
  * Delete file
223
- * @param params - Parameters for deleteFile
224
- * @returns Promise resolving to deleteFile response
701
+ *
702
+ * @param {Object} params _Object containing the parameters for_ deleteFile
703
+ * @param {string} params.tableId _Required parameter with properties_
704
+ * @param {number} params.recordId _Required parameter with properties_
705
+ * @param {number} params.fieldId _Required parameter with properties_
706
+ * @param {number} params.versionNumber _Required parameter with properties_
707
+ *
708
+ * @returns {Promise<DeleteFile200Response>} _Promise resolving to the deleteFile response with properties_
709
+ * - **versionNumber** (`number`, optional) _The number of deleted version._
710
+ * - **fileName** (`string`, optional) _The name of file associated with deleted version._
711
+ * - **uploaded** (`string`, optional) _The timestamp when the version was originally uploaded._
712
+ * - **creator** (`{ [key: string]: any; }`, optional) _The user that uploaded version._
713
+ *
714
+ * @see {@link https://developer.quickbase.com/operation/deleteFile} Official Quickbase API documentation
225
715
  */
226
716
  deleteFile: (params: { tableId: string; recordId: number; fieldId: number; versionNumber: number }) => Promise<DeleteFile200Response>;
227
717
  /**
228
718
  * Get users
229
- * @param params - Parameters for getUsers
230
- * @returns Promise resolving to getUsers response
719
+ *
720
+ * @param {Object} params _Object containing the parameters for_ getUsers
721
+ * @param {number} params.accountId _Optional parameter with properties_
722
+ * @param {GetUsersRequest} params.body _Optional parameter with properties_
723
+ * - **userIds** (`string[]`, required) _Type: string[]_
724
+ *
725
+ * @returns {Promise<GetUsers200Response>} _Promise resolving to the getUsers response with properties_
726
+ * - **users** (`{ [key: string]: any; }[]`, required) _A list of users found in an account with the given criterias_
727
+ * - **metadata** (`{ [key: string]: any; }`, required) _Additional request information_
728
+ *
729
+ * @see {@link https://developer.quickbase.com/operation/getUsers} Official Quickbase API documentation
231
730
  */
232
731
  getUsers: (params: { accountId?: number; body?: GetUsersRequest }) => Promise<GetUsers200Response>;
233
732
  /**
234
733
  * Deny users
235
- * @param params - Parameters for denyUsers
236
- * @returns Promise resolving to denyUsers response
734
+ *
735
+ * @param {Object} params _Object containing the parameters for_ denyUsers
736
+ * @param {number} params.accountId _Optional parameter with properties_
737
+ * @param {DenyUsersRequest} params.body _Optional parameter with properties_
738
+ * - **userIds** (`string[]`, required) _Type: string[]_
739
+ *
740
+ * @returns {Promise<DenyUsers200Response>} _Promise resolving to the denyUsers response with properties_
741
+ * - **failure** (`string[]`, required) _A list of users that couldn't be denied. This also includes the ID's of users that are not valid._
742
+ * - **success** (`string[]`, required) _A list of users that have successfully been denied._
743
+ *
744
+ * @see {@link https://developer.quickbase.com/operation/denyUsers} Official Quickbase API documentation
237
745
  */
238
746
  denyUsers: (params: { accountId?: number; body?: DenyUsersRequest }) => Promise<DenyUsers200Response>;
239
747
  /**
240
748
  * Deny and remove users from groups
241
- * @param params - Parameters for denyUsersAndGroups
242
- * @returns Promise resolving to denyUsersAndGroups response
749
+ *
750
+ * @param {Object} params _Object containing the parameters for_ denyUsersAndGroups
751
+ * @param {number} params.accountId _Optional parameter with properties_
752
+ * @param {boolean} params.shouldDeleteFromGroups _Required parameter with properties_
753
+ * @param {DenyUsersAndGroupsRequest} params.body _Optional parameter with properties_
754
+ * - **userIds** (`string[]`, required) _Type: string[]_
755
+ *
756
+ * @returns {Promise<DenyUsersAndGroups200Response>} _Promise resolving to the denyUsersAndGroups response with properties_
757
+ * - **failure** (`string[]`, required) _A list of users that couldn't be denied. This also includes the ID's of users that are not valid._
758
+ * - **success** (`string[]`, required) _A list of users that have successfully been denied._
759
+ *
760
+ * @see {@link https://developer.quickbase.com/operation/denyUsersAndGroups} Official Quickbase API documentation
243
761
  */
244
762
  denyUsersAndGroups: (params: { accountId?: number; shouldDeleteFromGroups: boolean; body?: DenyUsersAndGroupsRequest }) => Promise<DenyUsersAndGroups200Response>;
245
763
  /**
246
764
  * Undeny users
247
- * @param params - Parameters for undenyUsers
248
- * @returns Promise resolving to undenyUsers response
765
+ *
766
+ * @param {Object} params _Object containing the parameters for_ undenyUsers
767
+ * @param {number} params.accountId _Optional parameter with properties_
768
+ * @param {UndenyUsersRequest} params.body _Optional parameter with properties_
769
+ * - **userIds** (`string[]`, required) _Type: string[]_
770
+ *
771
+ * @returns {Promise<UndenyUsers200Response>} _Promise resolving to the undenyUsers response with properties_
772
+ * - **failure** (`string[]`, required) _A list of users that couldn't be undenied. This also includes the ID's of users that are not valid._
773
+ * - **success** (`string[]`, required) _A list of users that have successfully been undenied._
774
+ *
775
+ * @see {@link https://developer.quickbase.com/operation/undenyUsers} Official Quickbase API documentation
249
776
  */
250
777
  undenyUsers: (params: { accountId?: number; body?: UndenyUsersRequest }) => Promise<UndenyUsers200Response>;
251
778
  /**
252
779
  * Add members
253
- * @param params - Parameters for addMembersToGroup
254
- * @returns Promise resolving to addMembersToGroup response
780
+ *
781
+ * @param {Object} params _Object containing the parameters for_ addMembersToGroup
782
+ * @param {number} params.gid _Required parameter with properties_
783
+ * @param {AddMembersToGroupRequest} params.body _Optional parameter with properties_
784
+ * - **userIds** (`string[]`, required) _Type: string[]_
785
+ *
786
+ * @returns {Promise<AddMembersToGroup200Response>} _Promise resolving to the addMembersToGroup response with properties_
787
+ * - **failure** (`string[]`, required) _A list of users that couldn’t be added to the group. This includes a list of IDs that represent invalid users and users who have already been added to the group._
788
+ * - **success** (`string[]`, required) _A list of users that have been added to the group successfully._
789
+ *
790
+ * @see {@link https://developer.quickbase.com/operation/addMembersToGroup} Official Quickbase API documentation
255
791
  */
256
792
  addMembersToGroup: (params: { gid: number; body?: AddMembersToGroupRequest }) => Promise<AddMembersToGroup200Response>;
257
793
  /**
258
794
  * Remove members
259
- * @param params - Parameters for removeMembersFromGroup
260
- * @returns Promise resolving to removeMembersFromGroup response
795
+ *
796
+ * @param {Object} params _Object containing the parameters for_ removeMembersFromGroup
797
+ * @param {number} params.gid _Required parameter with properties_
798
+ * @param {RemoveMembersFromGroupRequest} params.body _Optional parameter with properties_
799
+ * - **userIds** (`string[]`, required) _Type: string[]_
800
+ *
801
+ * @returns {Promise<RemoveMembersFromGroup200Response>} _Promise resolving to the removeMembersFromGroup response with properties_
802
+ * - **failure** (`string[]`, required) _A list of users that couldn’t be removed from the group. This includes a list of IDs that represent invalid users._
803
+ * - **success** (`string[]`, required) _A list of users that have been removed from the group successfully._
804
+ *
805
+ * @see {@link https://developer.quickbase.com/operation/removeMembersFromGroup} Official Quickbase API documentation
261
806
  */
262
807
  removeMembersFromGroup: (params: { gid: number; body?: RemoveMembersFromGroupRequest }) => Promise<RemoveMembersFromGroup200Response>;
263
808
  /**
264
809
  * Add managers
265
- * @param params - Parameters for addManagersToGroup
266
- * @returns Promise resolving to addManagersToGroup response
810
+ *
811
+ * @param {Object} params _Object containing the parameters for_ addManagersToGroup
812
+ * @param {number} params.gid _Required parameter with properties_
813
+ * @param {AddManagersToGroupRequest} params.body _Optional parameter with properties_
814
+ * - **userIds** (`string[]`, required) _Type: string[]_
815
+ *
816
+ * @returns {Promise<AddManagersToGroup200Response>} _Promise resolving to the addManagersToGroup response with properties_
817
+ * - **failure** (`string[]`, required) _A list of users that couldn’t be added to the group. This includes a list of IDs that represent invalid users and users who have already been added to the group._
818
+ * - **success** (`string[]`, required) _A list of users that have been added to the group successfully._
819
+ *
820
+ * @see {@link https://developer.quickbase.com/operation/addManagersToGroup} Official Quickbase API documentation
267
821
  */
268
822
  addManagersToGroup: (params: { gid: number; body?: AddManagersToGroupRequest }) => Promise<AddManagersToGroup200Response>;
269
823
  /**
270
824
  * Remove managers
271
- * @param params - Parameters for removeManagersFromGroup
272
- * @returns Promise resolving to removeManagersFromGroup response
825
+ *
826
+ * @param {Object} params _Object containing the parameters for_ removeManagersFromGroup
827
+ * @param {number} params.gid _Required parameter with properties_
828
+ * @param {RemoveManagersFromGroupRequest} params.body _Optional parameter with properties_
829
+ * - **userIds** (`string[]`, required) _Type: string[]_
830
+ *
831
+ * @returns {Promise<RemoveManagersFromGroup200Response>} _Promise resolving to the removeManagersFromGroup response with properties_
832
+ * - **failure** (`string[]`, required) _A list of users that couldn’t be removed from the group. This includes a list of IDs that represent invalid users._
833
+ * - **success** (`string[]`, required) _A list of users that have been removed from the group successfully._
834
+ *
835
+ * @see {@link https://developer.quickbase.com/operation/removeManagersFromGroup} Official Quickbase API documentation
273
836
  */
274
837
  removeManagersFromGroup: (params: { gid: number; body?: RemoveManagersFromGroupRequest }) => Promise<RemoveManagersFromGroup200Response>;
275
838
  /**
276
839
  * Add child groups
277
- * @param params - Parameters for addSubgroupsToGroup
278
- * @returns Promise resolving to addSubgroupsToGroup response
840
+ *
841
+ * @param {Object} params _Object containing the parameters for_ addSubgroupsToGroup
842
+ * @param {number} params.gid _Required parameter with properties_
843
+ * @param {AddSubgroupsToGroupRequest} params.body _Optional parameter with properties_
844
+ * - **userIds** (`string[]`, required) _Type: string[]_
845
+ *
846
+ * @returns {Promise<AddSubgroupsToGroup200Response>} _Promise resolving to the addSubgroupsToGroup response with properties_
847
+ * - **failure** (`string[]`, required) _A list of child groups that couldn’t be added to the group. This includes a list of IDs that represent invalid groups and groups that have already been added to the group._
848
+ * - **success** (`string[]`, required) _A list of child groups that have been added to the group successfully._
849
+ *
850
+ * @see {@link https://developer.quickbase.com/operation/addSubgroupsToGroup} Official Quickbase API documentation
279
851
  */
280
852
  addSubgroupsToGroup: (params: { gid: number; body?: AddSubgroupsToGroupRequest }) => Promise<AddSubgroupsToGroup200Response>;
281
853
  /**
282
854
  * Remove child groups
283
- * @param params - Parameters for removeSubgroupsFromGroup
284
- * @returns Promise resolving to removeSubgroupsFromGroup response
855
+ *
856
+ * @param {Object} params _Object containing the parameters for_ removeSubgroupsFromGroup
857
+ * @param {number} params.gid _Required parameter with properties_
858
+ * @param {RemoveSubgroupsFromGroupRequest} params.body _Optional parameter with properties_
859
+ * - **userIds** (`string[]`, required) _Type: string[]_
860
+ *
861
+ * @returns {Promise<RemoveSubgroupsFromGroup200Response>} _Promise resolving to the removeSubgroupsFromGroup response with properties_
862
+ * - **failure** (`string[]`, required) _A list of child groups that couldn’t be removed from the group. This includes a list of IDs that represent invalid groups._
863
+ * - **success** (`string[]`, required) _A list of child groups that have been removed from the group successfully._
864
+ *
865
+ * @see {@link https://developer.quickbase.com/operation/removeSubgroupsFromGroup} Official Quickbase API documentation
285
866
  */
286
867
  removeSubgroupsFromGroup: (params: { gid: number; body?: RemoveSubgroupsFromGroupRequest }) => Promise<RemoveSubgroupsFromGroup200Response>;
287
868
  /**
288
869
  * Get audit logs
289
- * @param params - Parameters for audit
290
- * @returns Promise resolving to audit response
870
+ *
871
+ * @param {Object} params _Object containing the parameters for_ audit
872
+ * @param {{ nextToken?: string; numRows?: number; queryId?: string; date?: string; topics?: string[] }} params.body _Optional parameter with properties_
873
+ *
874
+ * @returns {Promise<Audit200Response>} _Promise resolving to the audit response with properties_
875
+ * - **queryId** (`string`, required) _Query id of the requested audit log._
876
+ * - **events** (`{ [key: string]: any; }[]`, optional) _All events of the audit log._
877
+ * - **nextToken** (`string`, optional) _Token to fetch the next 1000 logs._
878
+ *
879
+ * @see {@link https://developer.quickbase.com/operation/audit} Official Quickbase API documentation
291
880
  */
292
881
  audit: (params: { body?: { nextToken?: string; numRows?: number; queryId?: string; date?: string; topics?: string[] } }) => Promise<Audit200Response>;
293
882
  /**
294
883
  * Get read summaries
295
- * @param params - Parameters for platformAnalyticReads
296
- * @returns Promise resolving to platformAnalyticReads response
884
+ *
885
+ * @param {Object} params _Object containing the parameters for_ platformAnalyticReads
886
+ * @param {string} params.day _Optional parameter with properties_
887
+ *
888
+ * @returns {Promise<PlatformAnalyticReads200Response>} _Promise resolving to the platformAnalyticReads response with properties_
889
+ * - **date** (`Date`, required) _The date of the requested summary._
890
+ * - **reads** (`{ [key: string]: any; }`, required) _Total reads for the specified date._
891
+ *
892
+ * @see {@link https://developer.quickbase.com/operation/platformAnalyticReads} Official Quickbase API documentation
297
893
  */
298
894
  platformAnalyticReads: (params: { day?: string }) => Promise<PlatformAnalyticReads200Response>;
299
895
  /**
300
896
  * Get event summaries
301
- * @param params - Parameters for platformAnalyticEventSummaries
302
- * @returns Promise resolving to platformAnalyticEventSummaries response
897
+ *
898
+ * @param {Object} params _Object containing the parameters for_ platformAnalyticEventSummaries
899
+ * @param {number} params.accountId _Optional parameter with properties_
900
+ * @param {{ start?: string; end?: string; groupBy?: string; nextToken?: string; where?: { id?: string; type?: string }[] }} params.body _Optional parameter with properties_
901
+ *
902
+ * @returns {Promise<PlatformAnalyticEventSummaries200Response>} _Promise resolving to the platformAnalyticEventSummaries response with properties_
903
+ * - **accountId** (`string`, required) _The ID of the account the events are associated with._
904
+ * - **start** (`Date`, required) _The start date and time of the requested summaries in ISO 8601 time format._
905
+ * - **end** (`Date`, required) _The end date and time of the requested summaries in ISO 8601 time format._
906
+ * - **groupBy** (`PlatformAnalyticEventSummaries200ResponseGroupByEnum`, required) _How the events should be grouped._
907
+ * - **where** (`PlatformAnalyticEventSummaries200ResponseWhereInner[]`, required) _Type: PlatformAnalyticEventSummaries200ResponseWhereInner[]_
908
+ * - **results** (`PlatformAnalyticEventSummaries200ResponseResultsInner[]`, required) _An array of objects that contains Application/User information and an events object with summaries by event type._
909
+ * - **metadata** (`PlatformAnalyticEventSummaries200ResponseMetadata`, optional) _Type: PlatformAnalyticEventSummaries200ResponseMetadata_
910
+ * - **totals** (`PlatformAnalyticEventSummaries200ResponseTotals`, optional) _Type: PlatformAnalyticEventSummaries200ResponseTotals_
911
+ *
912
+ * @see {@link https://developer.quickbase.com/operation/platformAnalyticEventSummaries} Official Quickbase API documentation
303
913
  */
304
914
  platformAnalyticEventSummaries: (params: { accountId?: number; body?: { start?: string; end?: string; groupBy?: string; nextToken?: string; where?: { id?: string; type?: string }[] } }) => Promise<PlatformAnalyticEventSummaries200Response>;
305
915
  /**
306
916
  * Export a solution
307
- * @param params - Parameters for exportSolution
308
- * @returns Promise resolving to exportSolution response
917
+ *
918
+ * @param {Object} params _Object containing the parameters for_ exportSolution
919
+ * @param {string} params.solutionId _Required parameter with properties_
920
+ * @param {string} params.qBLVersion _Optional parameter with properties_
921
+ *
922
+ * @returns {Promise<ExportSolution200Response>} _Promise resolving to the exportSolution response with properties_
923
+ * - **content** (`string`, optional) _Type: string_
924
+ *
925
+ * @see {@link https://developer.quickbase.com/operation/exportSolution} Official Quickbase API documentation
309
926
  */
310
927
  exportSolution: (params: { solutionId: string; qBLVersion?: string }) => Promise<ExportSolution200Response>;
311
928
  /**
312
929
  * Update a solution
313
- * @param params - Parameters for updateSolution
314
- * @returns Promise resolving to updateSolution response
930
+ *
931
+ * @param {Object} params _Object containing the parameters for_ updateSolution
932
+ * @param {string} params.solutionId _Required parameter with properties_
933
+ * @param {any} params.body _Optional parameter with properties_
934
+ * @param {boolean} params.xQBLErrorsAsSuccess _Optional parameter with properties_
935
+ *
936
+ * @returns {Promise<UpdateSolution200Response>} _Promise resolving to the updateSolution response_
937
+ *
938
+ * @see {@link https://developer.quickbase.com/operation/updateSolution} Official Quickbase API documentation
315
939
  */
316
940
  updateSolution: (params: { solutionId: string; body?: any; xQBLErrorsAsSuccess?: boolean }) => Promise<UpdateSolution200Response>;
317
941
  /**
318
942
  * Create a solution
319
- * @param params - Parameters for createSolution
320
- * @returns Promise resolving to createSolution response
943
+ *
944
+ * @param {Object} params _Object containing the parameters for_ createSolution
945
+ * @param {any} params.body _Optional parameter with properties_
946
+ * @param {boolean} params.xQBLErrorsAsSuccess _Optional parameter with properties_
947
+ *
948
+ * @returns {Promise<CreateSolution200Response>} _Promise resolving to the createSolution response_
949
+ *
950
+ * @see {@link https://developer.quickbase.com/operation/createSolution} Official Quickbase API documentation
321
951
  */
322
952
  createSolution: (params: { body?: any; xQBLErrorsAsSuccess?: boolean }) => Promise<CreateSolution200Response>;
323
953
  /**
324
954
  * Export solution to record
325
- * @param params - Parameters for exportSolutionToRecord
326
- * @returns Promise resolving to exportSolutionToRecord response
955
+ *
956
+ * @param {Object} params _Object containing the parameters for_ exportSolutionToRecord
957
+ * @param {string} params.solutionId _Required parameter with properties_
958
+ * @param {string} params.tableId _Required parameter with properties_
959
+ * @param {number} params.fieldId _Required parameter with properties_
960
+ * @param {boolean} params.xQBLErrorsAsSuccess _Optional parameter with properties_
961
+ * @param {string} params.qBLVersion _Optional parameter with properties_
962
+ *
963
+ * @returns {Promise<ExportSolutionToRecord200Response>} _Promise resolving to the exportSolutionToRecord response_
964
+ *
965
+ * @see {@link https://developer.quickbase.com/operation/exportSolutionToRecord} Official Quickbase API documentation
327
966
  */
328
967
  exportSolutionToRecord: (params: { solutionId: string; tableId: string; fieldId: number; xQBLErrorsAsSuccess?: boolean; qBLVersion?: string }) => Promise<ExportSolutionToRecord200Response>;
329
968
  /**
330
969
  * Create solution from record
331
- * @param params - Parameters for createSolutionFromRecord
332
- * @returns Promise resolving to createSolutionFromRecord response
970
+ *
971
+ * @param {Object} params _Object containing the parameters for_ createSolutionFromRecord
972
+ * @param {string} params.tableId _Required parameter with properties_
973
+ * @param {number} params.fieldId _Required parameter with properties_
974
+ * @param {number} params.recordId _Required parameter with properties_
975
+ * @param {boolean} params.xQBLErrorsAsSuccess _Optional parameter with properties_
976
+ *
977
+ * @returns {Promise<CreateSolutionFromRecord200Response>} _Promise resolving to the createSolutionFromRecord response_
978
+ *
979
+ * @see {@link https://developer.quickbase.com/operation/createSolutionFromRecord} Official Quickbase API documentation
333
980
  */
334
981
  createSolutionFromRecord: (params: { tableId: string; fieldId: number; recordId: number; xQBLErrorsAsSuccess?: boolean }) => Promise<CreateSolutionFromRecord200Response>;
335
982
  /**
336
983
  * Update solution from record
337
- * @param params - Parameters for updateSolutionToRecord
338
- * @returns Promise resolving to updateSolutionToRecord response
984
+ *
985
+ * @param {Object} params _Object containing the parameters for_ updateSolutionToRecord
986
+ * @param {string} params.solutionId _Required parameter with properties_
987
+ * @param {string} params.tableId _Required parameter with properties_
988
+ * @param {number} params.fieldId _Required parameter with properties_
989
+ * @param {number} params.recordId _Required parameter with properties_
990
+ * @param {boolean} params.xQBLErrorsAsSuccess _Optional parameter with properties_
991
+ *
992
+ * @returns {Promise<UpdateSolutionToRecord200Response>} _Promise resolving to the updateSolutionToRecord response_
993
+ *
994
+ * @see {@link https://developer.quickbase.com/operation/updateSolutionToRecord} Official Quickbase API documentation
339
995
  */
340
996
  updateSolutionToRecord: (params: { solutionId: string; tableId: string; fieldId: number; recordId: number; xQBLErrorsAsSuccess?: boolean }) => Promise<UpdateSolutionToRecord200Response>;
341
997
  /**
342
998
  * List solution changes
343
- * @param params - Parameters for changesetSolution
344
- * @returns Promise resolving to changesetSolution response
999
+ *
1000
+ * @param {Object} params _Object containing the parameters for_ changesetSolution
1001
+ * @param {string} params.solutionId _Required parameter with properties_
1002
+ * @param {any} params.body _Optional parameter with properties_
1003
+ * @param {boolean} params.xQBLErrorsAsSuccess _Optional parameter with properties_
1004
+ *
1005
+ * @returns {Promise<ChangesetSolution200Response>} _Promise resolving to the changesetSolution response_
1006
+ *
1007
+ * @see {@link https://developer.quickbase.com/operation/changesetSolution} Official Quickbase API documentation
345
1008
  */
346
1009
  changesetSolution: (params: { solutionId: string; body?: any; xQBLErrorsAsSuccess?: boolean }) => Promise<ChangesetSolution200Response>;
347
1010
  /**
348
1011
  * List solution changes from record
349
- * @param params - Parameters for changesetSolutionFromRecord
350
- * @returns Promise resolving to changesetSolutionFromRecord response
1012
+ *
1013
+ * @param {Object} params _Object containing the parameters for_ changesetSolutionFromRecord
1014
+ * @param {string} params.solutionId _Required parameter with properties_
1015
+ * @param {string} params.tableId _Required parameter with properties_
1016
+ * @param {number} params.fieldId _Required parameter with properties_
1017
+ * @param {number} params.recordId _Required parameter with properties_
1018
+ * @param {boolean} params.xQBLErrorsAsSuccess _Optional parameter with properties_
1019
+ *
1020
+ * @returns {Promise<ChangesetSolutionFromRecord200Response>} _Promise resolving to the changesetSolutionFromRecord response_
1021
+ *
1022
+ * @see {@link https://developer.quickbase.com/operation/changesetSolutionFromRecord} Official Quickbase API documentation
351
1023
  */
352
1024
  changesetSolutionFromRecord: (params: { solutionId: string; tableId: string; fieldId: number; recordId: number; xQBLErrorsAsSuccess?: boolean }) => Promise<ChangesetSolutionFromRecord200Response>;
353
1025
  /**
354
1026
  * Generate a document
355
- * @param params - Parameters for generateDocument
356
- * @returns Promise resolving to generateDocument response
1027
+ *
1028
+ * @param {Object} params _Object containing the parameters for_ generateDocument
1029
+ * @param {number} params.templateId _Required parameter with properties_
1030
+ * @param {string} params.tableId _Required parameter with properties_
1031
+ * @param {number} params.recordId _Optional parameter with properties_
1032
+ * @param {string} params.filename _Required parameter with properties_
1033
+ * @param {string} params.accept _Optional parameter with properties_
1034
+ * @param {string} params.format _Optional parameter with properties_
1035
+ * @param {string} params.margin _Optional parameter with properties_
1036
+ * @param {string} params.unit _Optional parameter with properties_
1037
+ * @param {string} params.pageSize _Optional parameter with properties_
1038
+ * @param {string} params.orientation _Optional parameter with properties_
1039
+ * @param {string} params.realm _Optional parameter with properties_
1040
+ *
1041
+ * @returns {Promise<GenerateDocument200Response>} _Promise resolving to the generateDocument response with properties_
1042
+ * - **fileName** (`string`, optional) _The file name._
1043
+ * - **data** (`string`, optional) _Base64 encoded file content._
1044
+ * - **contentType** (`string`, optional) _The document content type._
1045
+ *
1046
+ * @see {@link https://developer.quickbase.com/operation/generateDocument} Official Quickbase API documentation
357
1047
  */
358
1048
  generateDocument: (params: { templateId: number; tableId: string; recordId?: number; filename: string; accept?: string; format?: string; margin?: string; unit?: string; pageSize?: string; orientation?: string; realm?: string }) => Promise<GenerateDocument200Response>;
359
1049
  }