@caraer/client 2.0.398 → 2.0.399

package/.openapi-generator/FILES

@@ -46,6 +46,7 @@ docs/AppSettingFieldMappingStructure.md
 docs/AppSettingFieldMappingStructureItem.md
 docs/AppSettingFieldSchema.md
 docs/AppSettingOptionsSource.md
+docs/AppSettingsSection.md
 docs/AppTierDTO.md
 docs/ApplicationsApi.md
 docs/AutomationsApi.md

package/api.ts

@@ -492,6 +492,10 @@ export interface AppDTO {
      * JSON array of AppSettingFieldSchema (app-level setting field definitions)
      */
     'settingsSchema'?: Array<AppSettingFieldSchema>;
+    /**
+     * Optional UI grouping of settingsSchema fields into installer cards
+     */
+    'settingsSections'?: Array<AppSettingsSection>;
     /**
      * External OAuth providers installers can Connect (name/logo only; no secrets)
      */
@@ -1059,6 +1063,11 @@ export interface AppSettingOptionsSource {
     'searchable'?: boolean;
     'minQueryLength'?: number;
 }
+export interface AppSettingsSection {
+    'title'?: string;
+    'subtitle'?: string;
+    'settings'?: Array<string>;
+}
 /**
  * Data transfer object for a pricing tier (plan) within tiered app pricing
  */
@@ -2227,9 +2236,9 @@ export const EventRsvpRequestScopeEnum = {
 export type EventRsvpRequestScopeEnum = typeof EventRsvpRequestScopeEnum[keyof typeof EventRsvpRequestScopeEnum];
 
 export interface ExistingWidgetSummary {
+    'xproperty'?: string;
     'ymetric'?: string;
     'yproperty'?: string;
-    'xproperty'?: string;
     'title'?: string;
     'chartType'?: string;
     'xProperty'?: string;
@@ -2973,9 +2982,9 @@ export interface ModelRecord {
     'deleted'?: boolean;
     'complete'?: boolean;
     'uuid': string;
+    'user'?: PublicUserDTO;
     'properties'?: Array<FilledProperty>;
     'objects'?: { [key: string]: any | null; };
-    'user'?: PublicUserDTO;
 }
 export interface MultiLine extends PropertyFormat {
 }
@@ -4488,8 +4497,8 @@ export interface SettingField {
     'hidden'?: boolean;
     'disabled'?: boolean;
     'options'?: Array<SettingOption>;
-    'value'?: any;
     'defaultValue'?: any;
+    'value'?: any;
 }
 
 export const SettingFieldTypeEnum = {
@@ -7030,6 +7039,49 @@ export const AppInstallationRuntimeApiAxiosParamCreator = function (configuratio
                 options: localVarRequestOptions,
             };
         },
+        /**
+         * 
+         * @summary Merge COMPANY-scoped installation settings from the app runtime
+         * @param {string} appUuid 
+         * @param {Array<AppSettingFieldSchema>} appSettingFieldSchema 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        mergeCompanySettings: async (appUuid: string, appSettingFieldSchema: Array<AppSettingFieldSchema>, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'appUuid' is not null or undefined
+            assertParamExists('mergeCompanySettings', 'appUuid', appUuid)
+            // verify required parameter 'appSettingFieldSchema' is not null or undefined
+            assertParamExists('mergeCompanySettings', 'appSettingFieldSchema', appSettingFieldSchema)
+            const localVarPath = `/api/v2/apps/{appUuid}/installation/settings`
+                .replace('{appUuid}', encodeURIComponent(String(appUuid)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'PUT', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication bearerAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = serializeDataIfNeeded(appSettingFieldSchema, localVarRequestOptions, configuration)
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
         /**
          * 
          * @summary Set an encrypted secret
@@ -7417,6 +7469,20 @@ export const AppInstallationRuntimeApiFp = function(configuration?: Configuratio
             const localVarOperationServerBasePath = operationServerMap['AppInstallationRuntimeApi.listSecrets']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
+        /**
+         * 
+         * @summary Merge COMPANY-scoped installation settings from the app runtime
+         * @param {string} appUuid 
+         * @param {Array<AppSettingFieldSchema>} appSettingFieldSchema 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async mergeCompanySettings(appUuid: string, appSettingFieldSchema: Array<AppSettingFieldSchema>, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ShowResponseMapStringObject>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.mergeCompanySettings(appUuid, appSettingFieldSchema, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AppInstallationRuntimeApi.mergeCompanySettings']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
         /**
          * 
          * @summary Set an encrypted secret
@@ -7598,6 +7664,17 @@ export const AppInstallationRuntimeApiFactory = function (configuration?: Config
         listSecrets(appUuid: string, options?: RawAxiosRequestConfig): AxiosPromise<ShowResponseListString> {
             return localVarFp.listSecrets(appUuid, options).then((request) => request(axios, basePath));
         },
+        /**
+         * 
+         * @summary Merge COMPANY-scoped installation settings from the app runtime
+         * @param {string} appUuid 
+         * @param {Array<AppSettingFieldSchema>} appSettingFieldSchema 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        mergeCompanySettings(appUuid: string, appSettingFieldSchema: Array<AppSettingFieldSchema>, options?: RawAxiosRequestConfig): AxiosPromise<ShowResponseMapStringObject> {
+            return localVarFp.mergeCompanySettings(appUuid, appSettingFieldSchema, options).then((request) => request(axios, basePath));
+        },
         /**
          * 
          * @summary Set an encrypted secret
@@ -7767,6 +7844,18 @@ export class AppInstallationRuntimeApi extends BaseAPI {
         return AppInstallationRuntimeApiFp(this.configuration).listSecrets(appUuid, options).then((request) => request(this.axios, this.basePath));
     }
 
+    /**
+     * 
+     * @summary Merge COMPANY-scoped installation settings from the app runtime
+     * @param {string} appUuid 
+     * @param {Array<AppSettingFieldSchema>} appSettingFieldSchema 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public mergeCompanySettings(appUuid: string, appSettingFieldSchema: Array<AppSettingFieldSchema>, options?: RawAxiosRequestConfig) {
+        return AppInstallationRuntimeApiFp(this.configuration).mergeCompanySettings(appUuid, appSettingFieldSchema, options).then((request) => request(this.axios, this.basePath));
+    }
+
     /**
      * 
      * @summary Set an encrypted secret

package/dist/api.d.ts

@@ -485,6 +485,10 @@ export interface AppDTO {
      * JSON array of AppSettingFieldSchema (app-level setting field definitions)
      */
     'settingsSchema'?: Array<AppSettingFieldSchema>;
+    /**
+     * Optional UI grouping of settingsSchema fields into installer cards
+     */
+    'settingsSections'?: Array<AppSettingsSection>;
     /**
      * External OAuth providers installers can Connect (name/logo only; no secrets)
      */
@@ -1049,6 +1053,11 @@ export interface AppSettingOptionsSource {
     'searchable'?: boolean;
     'minQueryLength'?: number;
 }
+export interface AppSettingsSection {
+    'title'?: string;
+    'subtitle'?: string;
+    'settings'?: Array<string>;
+}
 /**
  * Data transfer object for a pricing tier (plan) within tiered app pricing
  */
@@ -2206,9 +2215,9 @@ export declare const EventRsvpRequestScopeEnum: {
 };
 export type EventRsvpRequestScopeEnum = typeof EventRsvpRequestScopeEnum[keyof typeof EventRsvpRequestScopeEnum];
 export interface ExistingWidgetSummary {
+    'xproperty'?: string;
     'ymetric'?: string;
     'yproperty'?: string;
-    'xproperty'?: string;
     'title'?: string;
     'chartType'?: string;
     'xProperty'?: string;
@@ -2966,11 +2975,11 @@ export interface ModelRecord {
     'deleted'?: boolean;
     'complete'?: boolean;
     'uuid': string;
+    'user'?: PublicUserDTO;
     'properties'?: Array<FilledProperty>;
     'objects'?: {
         [key: string]: any | null;
     };
-    'user'?: PublicUserDTO;
 }
 export interface MultiLine extends PropertyFormat {
 }
@@ -4511,8 +4520,8 @@ export interface SettingField {
     'hidden'?: boolean;
     'disabled'?: boolean;
     'options'?: Array<SettingOption>;
-    'value'?: any;
     'defaultValue'?: any;
+    'value'?: any;
 }
 export declare const SettingFieldTypeEnum: {
     readonly String: "STRING";
@@ -6600,6 +6609,15 @@ export declare const AppInstallationRuntimeApiAxiosParamCreator: (configuration?
      * @throws {RequiredError}
      */
     listSecrets: (appUuid: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     *
+     * @summary Merge COMPANY-scoped installation settings from the app runtime
+     * @param {string} appUuid
+     * @param {Array<AppSettingFieldSchema>} appSettingFieldSchema
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    mergeCompanySettings: (appUuid: string, appSettingFieldSchema: Array<AppSettingFieldSchema>, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      *
      * @summary Set an encrypted secret
@@ -6737,6 +6755,15 @@ export declare const AppInstallationRuntimeApiFp: (configuration?: Configuration
      * @throws {RequiredError}
      */
     listSecrets(appUuid: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ShowResponseListString>>;
+    /**
+     *
+     * @summary Merge COMPANY-scoped installation settings from the app runtime
+     * @param {string} appUuid
+     * @param {Array<AppSettingFieldSchema>} appSettingFieldSchema
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    mergeCompanySettings(appUuid: string, appSettingFieldSchema: Array<AppSettingFieldSchema>, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ShowResponseMapStringObject>>;
     /**
      *
      * @summary Set an encrypted secret
@@ -6874,6 +6901,15 @@ export declare const AppInstallationRuntimeApiFactory: (configuration?: Configur
      * @throws {RequiredError}
      */
     listSecrets(appUuid: string, options?: RawAxiosRequestConfig): AxiosPromise<ShowResponseListString>;
+    /**
+     *
+     * @summary Merge COMPANY-scoped installation settings from the app runtime
+     * @param {string} appUuid
+     * @param {Array<AppSettingFieldSchema>} appSettingFieldSchema
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    mergeCompanySettings(appUuid: string, appSettingFieldSchema: Array<AppSettingFieldSchema>, options?: RawAxiosRequestConfig): AxiosPromise<ShowResponseMapStringObject>;
     /**
      *
      * @summary Set an encrypted secret
@@ -7011,6 +7047,15 @@ export declare class AppInstallationRuntimeApi extends BaseAPI {
      * @throws {RequiredError}
      */
     listSecrets(appUuid: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ShowResponseListString, any, {}>>;
+    /**
+     *
+     * @summary Merge COMPANY-scoped installation settings from the app runtime
+     * @param {string} appUuid
+     * @param {Array<AppSettingFieldSchema>} appSettingFieldSchema
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    mergeCompanySettings(appUuid: string, appSettingFieldSchema: Array<AppSettingFieldSchema>, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ShowResponseMapStringObject, any, {}>>;
     /**
      *
      * @summary Set an encrypted secret

package/dist/api.js

@@ -798,6 +798,44 @@ const AppInstallationRuntimeApiAxiosParamCreator = function (configuration) {
                 options: localVarRequestOptions,
             };
         }),
+        /**
+         *
+         * @summary Merge COMPANY-scoped installation settings from the app runtime
+         * @param {string} appUuid
+         * @param {Array<AppSettingFieldSchema>} appSettingFieldSchema
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        mergeCompanySettings: (appUuid_1, appSettingFieldSchema_1, ...args_1) => __awaiter(this, [appUuid_1, appSettingFieldSchema_1, ...args_1], void 0, function* (appUuid, appSettingFieldSchema, options = {}) {
+            // verify required parameter 'appUuid' is not null or undefined
+            (0, common_1.assertParamExists)('mergeCompanySettings', 'appUuid', appUuid);
+            // verify required parameter 'appSettingFieldSchema' is not null or undefined
+            (0, common_1.assertParamExists)('mergeCompanySettings', 'appSettingFieldSchema', appSettingFieldSchema);
+            const localVarPath = `/api/v2/apps/{appUuid}/installation/settings`
+                .replace('{appUuid}', encodeURIComponent(String(appUuid)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, common_1.DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'PUT' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication bearerAuth required
+            // http bearer authentication required
+            yield (0, common_1.setBearerAuthToObject)(localVarHeaderParameter, configuration);
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
+            (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            localVarRequestOptions.data = (0, common_1.serializeDataIfNeeded)(appSettingFieldSchema, localVarRequestOptions, configuration);
+            return {
+                url: (0, common_1.toPathString)(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
         /**
          *
          * @summary Set an encrypted secret
@@ -1178,6 +1216,23 @@ const AppInstallationRuntimeApiFp = function (configuration) {
                 return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
             });
         },
+        /**
+         *
+         * @summary Merge COMPANY-scoped installation settings from the app runtime
+         * @param {string} appUuid
+         * @param {Array<AppSettingFieldSchema>} appSettingFieldSchema
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        mergeCompanySettings(appUuid, appSettingFieldSchema, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.mergeCompanySettings(appUuid, appSettingFieldSchema, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['AppInstallationRuntimeApi.mergeCompanySettings']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
         /**
          *
          * @summary Set an encrypted secret
@@ -1377,6 +1432,17 @@ const AppInstallationRuntimeApiFactory = function (configuration, basePath, axio
         listSecrets(appUuid, options) {
             return localVarFp.listSecrets(appUuid, options).then((request) => request(axios, basePath));
         },
+        /**
+         *
+         * @summary Merge COMPANY-scoped installation settings from the app runtime
+         * @param {string} appUuid
+         * @param {Array<AppSettingFieldSchema>} appSettingFieldSchema
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        mergeCompanySettings(appUuid, appSettingFieldSchema, options) {
+            return localVarFp.mergeCompanySettings(appUuid, appSettingFieldSchema, options).then((request) => request(axios, basePath));
+        },
         /**
          *
          * @summary Set an encrypted secret
@@ -1538,6 +1604,17 @@ class AppInstallationRuntimeApi extends base_1.BaseAPI {
     listSecrets(appUuid, options) {
         return (0, exports.AppInstallationRuntimeApiFp)(this.configuration).listSecrets(appUuid, options).then((request) => request(this.axios, this.basePath));
     }
+    /**
+     *
+     * @summary Merge COMPANY-scoped installation settings from the app runtime
+     * @param {string} appUuid
+     * @param {Array<AppSettingFieldSchema>} appSettingFieldSchema
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    mergeCompanySettings(appUuid, appSettingFieldSchema, options) {
+        return (0, exports.AppInstallationRuntimeApiFp)(this.configuration).mergeCompanySettings(appUuid, appSettingFieldSchema, options).then((request) => request(this.axios, this.basePath));
+    }
     /**
      *
      * @summary Set an encrypted secret

package/dist/esm/api.d.ts

@@ -485,6 +485,10 @@ export interface AppDTO {
      * JSON array of AppSettingFieldSchema (app-level setting field definitions)
      */
     'settingsSchema'?: Array<AppSettingFieldSchema>;
+    /**
+     * Optional UI grouping of settingsSchema fields into installer cards
+     */
+    'settingsSections'?: Array<AppSettingsSection>;
     /**
      * External OAuth providers installers can Connect (name/logo only; no secrets)
      */
@@ -1049,6 +1053,11 @@ export interface AppSettingOptionsSource {
     'searchable'?: boolean;
     'minQueryLength'?: number;
 }
+export interface AppSettingsSection {
+    'title'?: string;
+    'subtitle'?: string;
+    'settings'?: Array<string>;
+}
 /**
  * Data transfer object for a pricing tier (plan) within tiered app pricing
  */
@@ -2206,9 +2215,9 @@ export declare const EventRsvpRequestScopeEnum: {
 };
 export type EventRsvpRequestScopeEnum = typeof EventRsvpRequestScopeEnum[keyof typeof EventRsvpRequestScopeEnum];
 export interface ExistingWidgetSummary {
+    'xproperty'?: string;
     'ymetric'?: string;
     'yproperty'?: string;
-    'xproperty'?: string;
     'title'?: string;
     'chartType'?: string;
     'xProperty'?: string;
@@ -2966,11 +2975,11 @@ export interface ModelRecord {
     'deleted'?: boolean;
     'complete'?: boolean;
     'uuid': string;
+    'user'?: PublicUserDTO;
     'properties'?: Array<FilledProperty>;
     'objects'?: {
         [key: string]: any | null;
     };
-    'user'?: PublicUserDTO;
 }
 export interface MultiLine extends PropertyFormat {
 }
@@ -4511,8 +4520,8 @@ export interface SettingField {
     'hidden'?: boolean;
     'disabled'?: boolean;
     'options'?: Array<SettingOption>;
-    'value'?: any;
     'defaultValue'?: any;
+    'value'?: any;
 }
 export declare const SettingFieldTypeEnum: {
     readonly String: "STRING";
@@ -6600,6 +6609,15 @@ export declare const AppInstallationRuntimeApiAxiosParamCreator: (configuration?
      * @throws {RequiredError}
      */
     listSecrets: (appUuid: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     *
+     * @summary Merge COMPANY-scoped installation settings from the app runtime
+     * @param {string} appUuid
+     * @param {Array<AppSettingFieldSchema>} appSettingFieldSchema
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    mergeCompanySettings: (appUuid: string, appSettingFieldSchema: Array<AppSettingFieldSchema>, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      *
      * @summary Set an encrypted secret
@@ -6737,6 +6755,15 @@ export declare const AppInstallationRuntimeApiFp: (configuration?: Configuration
      * @throws {RequiredError}
      */
     listSecrets(appUuid: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ShowResponseListString>>;
+    /**
+     *
+     * @summary Merge COMPANY-scoped installation settings from the app runtime
+     * @param {string} appUuid
+     * @param {Array<AppSettingFieldSchema>} appSettingFieldSchema
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    mergeCompanySettings(appUuid: string, appSettingFieldSchema: Array<AppSettingFieldSchema>, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ShowResponseMapStringObject>>;
     /**
      *
      * @summary Set an encrypted secret
@@ -6874,6 +6901,15 @@ export declare const AppInstallationRuntimeApiFactory: (configuration?: Configur
      * @throws {RequiredError}
      */
     listSecrets(appUuid: string, options?: RawAxiosRequestConfig): AxiosPromise<ShowResponseListString>;
+    /**
+     *
+     * @summary Merge COMPANY-scoped installation settings from the app runtime
+     * @param {string} appUuid
+     * @param {Array<AppSettingFieldSchema>} appSettingFieldSchema
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    mergeCompanySettings(appUuid: string, appSettingFieldSchema: Array<AppSettingFieldSchema>, options?: RawAxiosRequestConfig): AxiosPromise<ShowResponseMapStringObject>;
     /**
      *
      * @summary Set an encrypted secret
@@ -7011,6 +7047,15 @@ export declare class AppInstallationRuntimeApi extends BaseAPI {
      * @throws {RequiredError}
      */
     listSecrets(appUuid: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ShowResponseListString, any, {}>>;
+    /**
+     *
+     * @summary Merge COMPANY-scoped installation settings from the app runtime
+     * @param {string} appUuid
+     * @param {Array<AppSettingFieldSchema>} appSettingFieldSchema
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    mergeCompanySettings(appUuid: string, appSettingFieldSchema: Array<AppSettingFieldSchema>, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ShowResponseMapStringObject, any, {}>>;
     /**
      *
      * @summary Set an encrypted secret

package/dist/esm/api.js

@@ -785,6 +785,44 @@ export const AppInstallationRuntimeApiAxiosParamCreator = function (configuratio
                 options: localVarRequestOptions,
             };
         }),
+        /**
+         *
+         * @summary Merge COMPANY-scoped installation settings from the app runtime
+         * @param {string} appUuid
+         * @param {Array<AppSettingFieldSchema>} appSettingFieldSchema
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        mergeCompanySettings: (appUuid_1, appSettingFieldSchema_1, ...args_1) => __awaiter(this, [appUuid_1, appSettingFieldSchema_1, ...args_1], void 0, function* (appUuid, appSettingFieldSchema, options = {}) {
+            // verify required parameter 'appUuid' is not null or undefined
+            assertParamExists('mergeCompanySettings', 'appUuid', appUuid);
+            // verify required parameter 'appSettingFieldSchema' is not null or undefined
+            assertParamExists('mergeCompanySettings', 'appSettingFieldSchema', appSettingFieldSchema);
+            const localVarPath = `/api/v2/apps/{appUuid}/installation/settings`
+                .replace('{appUuid}', encodeURIComponent(String(appUuid)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'PUT' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication bearerAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            localVarRequestOptions.data = serializeDataIfNeeded(appSettingFieldSchema, localVarRequestOptions, configuration);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
         /**
          *
          * @summary Set an encrypted secret
@@ -1164,6 +1202,23 @@ export const AppInstallationRuntimeApiFp = function (configuration) {
                 return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
             });
         },
+        /**
+         *
+         * @summary Merge COMPANY-scoped installation settings from the app runtime
+         * @param {string} appUuid
+         * @param {Array<AppSettingFieldSchema>} appSettingFieldSchema
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        mergeCompanySettings(appUuid, appSettingFieldSchema, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.mergeCompanySettings(appUuid, appSettingFieldSchema, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AppInstallationRuntimeApi.mergeCompanySettings']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
         /**
          *
          * @summary Set an encrypted secret
@@ -1362,6 +1417,17 @@ export const AppInstallationRuntimeApiFactory = function (configuration, basePat
         listSecrets(appUuid, options) {
             return localVarFp.listSecrets(appUuid, options).then((request) => request(axios, basePath));
         },
+        /**
+         *
+         * @summary Merge COMPANY-scoped installation settings from the app runtime
+         * @param {string} appUuid
+         * @param {Array<AppSettingFieldSchema>} appSettingFieldSchema
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        mergeCompanySettings(appUuid, appSettingFieldSchema, options) {
+            return localVarFp.mergeCompanySettings(appUuid, appSettingFieldSchema, options).then((request) => request(axios, basePath));
+        },
         /**
          *
          * @summary Set an encrypted secret
@@ -1522,6 +1588,17 @@ export class AppInstallationRuntimeApi extends BaseAPI {
     listSecrets(appUuid, options) {
         return AppInstallationRuntimeApiFp(this.configuration).listSecrets(appUuid, options).then((request) => request(this.axios, this.basePath));
     }
+    /**
+     *
+     * @summary Merge COMPANY-scoped installation settings from the app runtime
+     * @param {string} appUuid
+     * @param {Array<AppSettingFieldSchema>} appSettingFieldSchema
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    mergeCompanySettings(appUuid, appSettingFieldSchema, options) {
+        return AppInstallationRuntimeApiFp(this.configuration).mergeCompanySettings(appUuid, appSettingFieldSchema, options).then((request) => request(this.axios, this.basePath));
+    }
     /**
      *
      * @summary Set an encrypted secret

package/docs/AppDTO.md

@@ -27,6 +27,7 @@ Name | Type | Description | Notes
 **rotateWebhook** | [**SubscribeWebhookDTO**](SubscribeWebhookDTO.md) | Webhook triggered when the app installation token is rotated | [optional] [default to undefined]
 **updateWebhook** | [**SubscribeWebhookDTO**](SubscribeWebhookDTO.md) | Webhook triggered when an already installed app is saved again | [optional] [default to undefined]
 **settingsSchema** | [**Array<AppSettingFieldSchema>**](AppSettingFieldSchema.md) | JSON array of AppSettingFieldSchema (app-level setting field definitions) | [optional] [default to undefined]
+**settingsSections** | [**Array<AppSettingsSection>**](AppSettingsSection.md) | Optional UI grouping of settingsSchema fields into installer cards | [optional] [default to undefined]
 **externalOAuthProviders** | [**Array<AppExternalOAuthProviderSummaryDTO>**](AppExternalOAuthProviderSummaryDTO.md) | External OAuth providers installers can Connect (name/logo only; no secrets) | [optional] [default to undefined]
 **webhookRateLimitPerMinute** | **number** | Webhook rate limit per minute | [optional] [default to undefined]
 **jobRateLimitPerMinute** | **number** | App job enqueue rate limit per minute per installation | [optional] [default to undefined]
@@ -84,6 +85,7 @@ const instance: AppDTO = {
     rotateWebhook,
     updateWebhook,
     settingsSchema,
+    settingsSections,
     externalOAuthProviders,
     webhookRateLimitPerMinute,
     jobRateLimitPerMinute,

package/docs/AppInstallationRuntimeApi.md

@@ -12,6 +12,7 @@ All URIs are relative to *https://v2.api.caraer.com*
 |[**getStateKey**](#getstatekey) | **GET** /api/v2/apps/{appUuid}/installation/state/{key} | Get a single state key|
 |[**listConnections**](#listconnections) | **GET** /api/v2/apps/{appUuid}/installation/connections | List external OAuth connection status|
 |[**listSecrets**](#listsecrets) | **GET** /api/v2/apps/{appUuid}/installation/secrets | List secret names (no values)|
+|[**mergeCompanySettings**](#mergecompanysettings) | **PUT** /api/v2/apps/{appUuid}/installation/settings | Merge COMPANY-scoped installation settings from the app runtime|
 |[**putSecret**](#putsecret) | **PUT** /api/v2/apps/{appUuid}/installation/secrets/{name} | Set an encrypted secret|
 |[**putState**](#putstate) | **PUT** /api/v2/apps/{appUuid}/installation/state | Replace/merge installation state (shallow merge)|
 |[**putStateKey**](#putstatekey) | **PUT** /api/v2/apps/{appUuid}/installation/state/{key} | Put a single state key|
@@ -435,6 +436,60 @@ const { status, data } = await apiInstance.listSecrets(
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
+# **mergeCompanySettings**
+> ShowResponseMapStringObject mergeCompanySettings(appSettingFieldSchema)
+
+
+### Example
+
+```typescript
+import {
+    AppInstallationRuntimeApi,
+    Configuration
+} from '@caraer/client';
+
+const configuration = new Configuration();
+const apiInstance = new AppInstallationRuntimeApi(configuration);
+
+let appUuid: string; // (default to undefined)
+let appSettingFieldSchema: Array<AppSettingFieldSchema>; //
+
+const { status, data } = await apiInstance.mergeCompanySettings(
+    appUuid,
+    appSettingFieldSchema
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **appSettingFieldSchema** | **Array<AppSettingFieldSchema>**|  | |
+| **appUuid** | [**string**] |  | defaults to undefined|
+
+
+### Return type
+
+**ShowResponseMapStringObject**
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Merged settings map |  -  |
+|**403** | Forbidden |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
 # **putSecret**
 > SuccessResponseVoid putSecret(requestBody)
 

package/docs/AppSettingsSection.md

@@ -0,0 +1,24 @@
+# AppSettingsSection
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**title** | **string** |  | [optional] [default to undefined]
+**subtitle** | **string** |  | [optional] [default to undefined]
+**settings** | **Array<string>** |  | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { AppSettingsSection } from '@caraer/client';
+
+const instance: AppSettingsSection = {
+    title,
+    subtitle,
+    settings,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/ExistingWidgetSummary.md

@@ -5,9 +5,9 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
+**xproperty** | **string** |  | [optional] [default to undefined]
 **ymetric** | **string** |  | [optional] [default to undefined]
 **yproperty** | **string** |  | [optional] [default to undefined]
-**xproperty** | **string** |  | [optional] [default to undefined]
 **title** | **string** |  | [optional] [default to undefined]
 **chartType** | **string** |  | [optional] [default to undefined]
 **xProperty** | **string** |  | [optional] [default to undefined]
@@ -20,9 +20,9 @@ Name | Type | Description | Notes
 import { ExistingWidgetSummary } from '@caraer/client';
 
 const instance: ExistingWidgetSummary = {
+    xproperty,
     ymetric,
     yproperty,
-    xproperty,
     title,
     chartType,
     xProperty,

package/docs/Record.md

@@ -17,9 +17,9 @@ Name | Type | Description | Notes
 **deleted** | **boolean** |  | [optional] [default to undefined]
 **complete** | **boolean** |  | [optional] [default to undefined]
 **uuid** | **string** |  | [default to undefined]
+**user** | [**PublicUserDTO**](PublicUserDTO.md) |  | [optional] [default to undefined]
 **properties** | [**Array<FilledProperty>**](FilledProperty.md) |  | [optional] [default to undefined]
 **objects** | **{ [key: string]: any | null; }** |  | [optional] [default to undefined]
-**user** | [**PublicUserDTO**](PublicUserDTO.md) |  | [optional] [default to undefined]
 
 ## Example
 
@@ -39,9 +39,9 @@ const instance: ModelRecord = {
     deleted,
     complete,
     uuid,
+    user,
     properties,
     objects,
-    user,
 };
 ```
 

package/docs/SettingField.md

@@ -14,8 +14,8 @@ Name | Type | Description | Notes
 **hidden** | **boolean** |  | [optional] [default to undefined]
 **disabled** | **boolean** |  | [optional] [default to undefined]
 **_options** | [**Array<SettingOption>**](SettingOption.md) |  | [optional] [default to undefined]
-**value** | **any** |  | [optional] [default to undefined]
 **defaultValue** | **any** |  | [optional] [default to undefined]
+**value** | **any** |  | [optional] [default to undefined]
 
 ## Example
 
@@ -32,8 +32,8 @@ const instance: SettingField = {
     hidden,
     disabled,
     _options,
-    value,
     defaultValue,
+    value,
 };
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caraer/client",
-  "version": "2.0.398",
+  "version": "2.0.399",
   "description": "Generated TypeScript client for the Caraer API",
   "author": "OpenAPI-Generator Contributors",
   "repository": {