@caraer/client 2.0.574 → 2.0.575

package/api.ts

@@ -1747,33 +1747,205 @@ export interface CreateOrUpdateEnvironmentRequest {
     'webpageObjects'?: Array<CaraerObjectDTO>;
 }
 /**
- * Private app creation request with label and optional description
+ * Private app creator manifest; label is required and internal name is optional
  */
 export interface CreatePrivateAppRequest {
     /**
-     * The display label for the private app.
+     * Unique identifier for the entity
+     */
+    'uuid': string;
+    /**
+     * The name of the entity
+     */
+    'name': string;
+    /**
+     * Display label for the entity, can be different from name
      */
     'label': string;
     /**
-     * Optional description text for the app.
+     * Unix timestamp when the entity was created
      */
-    'description'?: string;
+    'createdAt'?: number;
+    /**
+     * Identifier of the user who created the entity
+     */
+    'createdBy'?: ModelRecord;
+    /**
+     * Unix timestamp when the entity was last updated
+     */
+    'updatedAt'?: number;
+    /**
+     * Identifier of the user who last updated the entity
+     */
+    'updatedBy'?: ModelRecord;
+    /**
+     * Unix timestamp when the entity was deleted (null if not deleted)
+     */
+    'deletedAt'?: number;
+    /**
+     * Identifier of the user who deleted the entity
+     */
+    'deletedBy'?: ModelRecord;
+    /**
+     * Index number for ordering entities
+     */
+    'index'?: number;
+    /**
+     * Indicates whether this app is private (only available to the creator\'s company)
+     */
+    'privateApp'?: boolean;
+    /**
+     * Whether to hide the API token field in marketplace installer UI. Defaults to true when omitted. Private apps show the key regardless.
+     */
+    'hideApiKeyField'?: boolean;
+    /**
+     * Additional details and specifications about the application
+     */
+    'details'?: AppDetailsDTO;
+    /**
+     * App bars (location-specific configuration and actions)
+     */
+    'appBars'?: Array<AppBarDTO>;
+    /**
+     * Serverless functions owned by this app
+     */
+    'serverlessFunctions'?: Array<ServerlessFunctionDTO>;
+    /**
+     * Webhook triggered when the app is installed
+     */
+    'installWebhook'?: SubscribeWebhookDTO;
+    /**
+     * Webhook triggered when the app is uninstalled
+     */
+    'uninstallWebhook'?: SubscribeWebhookDTO;
+    /**
+     * Webhook triggered when the app installation token is rotated
+     */
+    'rotateWebhook'?: SubscribeWebhookDTO;
+    /**
+     * Webhook triggered when an already installed app is saved again
+     */
+    'updateWebhook'?: SubscribeWebhookDTO;
+    /**
+     * 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)
+     */
+    'externalOAuthProviders'?: Array<AppExternalOAuthProviderSummaryDTO>;
+    /**
+     * Webhook rate limit per minute
+     */
+    'webhookRateLimitPerMinute'?: number;
+    /**
+     * App job enqueue rate limit per minute per installation
+     */
+    'jobRateLimitPerMinute'?: number;
+    /**
+     * Publish and review state for the app in the marketplace (creator view)
+     */
+    'appPublish'?: AppPublishDTO;
+    /**
+     * Installation link (company–app) with token, scopes, and per-installation settingsValues; present when includeSettings is true
+     */
+    'hasApp'?: HasAppDTO;
+    /**
+     * URL to the application\'s image or icon (derived from details.image)
+     */
+    'image'?: string;
+    /**
+     * URL where the application can be accessed (derived from details.url)
+     */
+    'url'?: string;
+    /**
+     * Category the application belongs to (derived from details.category)
+     */
+    'category'?: string;
+    /**
+     * Whether the app is installed for the current company
+     */
+    'installed'?: boolean;
+    /**
+     * Required scopes requested by the app (macro patterns or concrete scope strings).
+     */
+    'requiredScopes'?: Array<string>;
     /**
-     * Authentication method (API_KEY default, OAUTH2 for OAuth 2.0)
+     * Resolved concrete required scopes derived from requiredScopes and dynamic availableScopes.
+     */
+    'resolvedRequiredScopes'?: Array<string>;
+    /**
+     * App credentials: NONE for platform-managed installation tokens, API_KEY (legacy default), or OAUTH2
      */
     'authMethod'?: CreatePrivateAppRequestAuthMethodEnum;
     /**
-     * Registered OAuth redirect URIs (required when authMethod is OAUTH2)
+     * OAuth 2.0 client identifier (OAuth apps only)
+     */
+    'oauthClientId'?: string;
+    /**
+     * OAuth 2.0 client secret; only returned once on create or secret rotation
+     */
+    'oauthClientSecret'?: string;
+    /**
+     * Whether an OAuth client secret is stored for this app (plain value is not re-readable)
+     */
+    'oauthClientSecretConfigured'?: boolean;
+    /**
+     * Registered OAuth redirect URIs (OAuth apps only)
      */
     'oauthRedirectUris'?: Array<string>;
     /**
-     * Ignored; new private apps are always platform version 2 (async container runtime).
+     * OAuth authorization endpoint URL
+     */
+    'oauthAuthorizeUrl'?: string;
+    /**
+     * OAuth token endpoint URL
+     */
+    'oauthTokenUrl'?: string;
+    /**
+     * External URL where end users install this app (e.g. ChatGPT connector page)
+     */
+    'installUrl'?: string;
+    /**
+     * Square brandmark URL used in compact app surfaces
+     */
+    'brandmark'?: string;
+    /**
+     * Internal app description used in Caraer admin views
+     */
+    'description'?: string;
+    /**
+     * App platform version: 1 = legacy per-function Cloud Functions; 2 = one container per app
      */
     'platformVersion'?: number;
     /**
-     * Serverless runtime for the app: nodejs22 or python312. Defaults to nodejs22.
+     * Serverless runtime for platform V2 apps (nodejs22 or python312)
      */
     'runtime'?: string;
+    /**
+     * Base HTTPS URL of the V2 app container runtime
+     */
+    'runtimeBaseUrl'?: string;
+    /**
+     * Last deployed runtime revision id
+     */
+    'runtimeRevision'?: string;
+    /**
+     * V2 runtime status: PENDING, PROVISIONING, READY, FAILED
+     */
+    'runtimeStatus'?: string;
+    /**
+     * Last V2 runtime error message when FAILED
+     */
+    'runtimeError'?: string;
+    /**
+     * Monotonic generation for async runtime jobs
+     */
+    'runtimeGeneration'?: number;
 }
 
 export const CreatePrivateAppRequestAuthMethodEnum = {
@@ -5781,8 +5953,8 @@ export interface SettingField {
     'hidden'?: boolean;
     'disabled'?: boolean;
     'options'?: Array<SettingOption>;
-    'defaultValue'?: any;
     'value'?: any;
+    'defaultValue'?: any;
 }
 
 export const SettingFieldTypeEnum = {
@@ -10165,7 +10337,7 @@ export const ApplicationsApiAxiosParamCreator = function (configuration?: Config
             };
         },
         /**
-         * Creates a new private app with the provided label and optional description. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
+         * Creates a private app from its creator manifest, validating the supplied name, settings and app bars before saving. An omitted name is generated. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
          * @summary Create a private app
          * @param {CreatePrivateAppRequest} createPrivateAppRequest 
          * @param {*} [options] Override http request option.
@@ -11433,7 +11605,7 @@ export const ApplicationsApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * Creates a new private app with the provided label and optional description. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
+         * Creates a private app from its creator manifest, validating the supplied name, settings and app bars before saving. An omitted name is generated. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
          * @summary Create a private app
          * @param {CreatePrivateAppRequest} createPrivateAppRequest 
          * @param {*} [options] Override http request option.
@@ -11865,7 +12037,7 @@ export const ApplicationsApiFactory = function (configuration?: Configuration, b
             return localVarFp.createAppWebhookForApp(appUuid, subscribeWebhookDTO, options).then((request) => request(axios, basePath));
         },
         /**
-         * Creates a new private app with the provided label and optional description. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
+         * Creates a private app from its creator manifest, validating the supplied name, settings and app bars before saving. An omitted name is generated. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
          * @summary Create a private app
          * @param {CreatePrivateAppRequest} createPrivateAppRequest 
          * @param {*} [options] Override http request option.
@@ -12206,7 +12378,7 @@ export class ApplicationsApi extends BaseAPI {
     }
 
     /**
-     * Creates a new private app with the provided label and optional description. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
+     * Creates a private app from its creator manifest, validating the supplied name, settings and app bars before saving. An omitted name is generated. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
      * @summary Create a private app
      * @param {CreatePrivateAppRequest} createPrivateAppRequest 
      * @param {*} [options] Override http request option.

package/dist/api.d.ts

@@ -1745,33 +1745,205 @@ export interface CreateOrUpdateEnvironmentRequest {
     'webpageObjects'?: Array<CaraerObjectDTO>;
 }
 /**
- * Private app creation request with label and optional description
+ * Private app creator manifest; label is required and internal name is optional
  */
 export interface CreatePrivateAppRequest {
     /**
-     * The display label for the private app.
+     * Unique identifier for the entity
+     */
+    'uuid': string;
+    /**
+     * The name of the entity
+     */
+    'name': string;
+    /**
+     * Display label for the entity, can be different from name
      */
     'label': string;
     /**
-     * Optional description text for the app.
+     * Unix timestamp when the entity was created
      */
-    'description'?: string;
+    'createdAt'?: number;
+    /**
+     * Identifier of the user who created the entity
+     */
+    'createdBy'?: ModelRecord;
+    /**
+     * Unix timestamp when the entity was last updated
+     */
+    'updatedAt'?: number;
+    /**
+     * Identifier of the user who last updated the entity
+     */
+    'updatedBy'?: ModelRecord;
+    /**
+     * Unix timestamp when the entity was deleted (null if not deleted)
+     */
+    'deletedAt'?: number;
+    /**
+     * Identifier of the user who deleted the entity
+     */
+    'deletedBy'?: ModelRecord;
+    /**
+     * Index number for ordering entities
+     */
+    'index'?: number;
+    /**
+     * Indicates whether this app is private (only available to the creator\'s company)
+     */
+    'privateApp'?: boolean;
+    /**
+     * Whether to hide the API token field in marketplace installer UI. Defaults to true when omitted. Private apps show the key regardless.
+     */
+    'hideApiKeyField'?: boolean;
+    /**
+     * Additional details and specifications about the application
+     */
+    'details'?: AppDetailsDTO;
+    /**
+     * App bars (location-specific configuration and actions)
+     */
+    'appBars'?: Array<AppBarDTO>;
+    /**
+     * Serverless functions owned by this app
+     */
+    'serverlessFunctions'?: Array<ServerlessFunctionDTO>;
+    /**
+     * Webhook triggered when the app is installed
+     */
+    'installWebhook'?: SubscribeWebhookDTO;
+    /**
+     * Webhook triggered when the app is uninstalled
+     */
+    'uninstallWebhook'?: SubscribeWebhookDTO;
+    /**
+     * Webhook triggered when the app installation token is rotated
+     */
+    'rotateWebhook'?: SubscribeWebhookDTO;
+    /**
+     * Webhook triggered when an already installed app is saved again
+     */
+    'updateWebhook'?: SubscribeWebhookDTO;
+    /**
+     * 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)
+     */
+    'externalOAuthProviders'?: Array<AppExternalOAuthProviderSummaryDTO>;
+    /**
+     * Webhook rate limit per minute
+     */
+    'webhookRateLimitPerMinute'?: number;
+    /**
+     * App job enqueue rate limit per minute per installation
+     */
+    'jobRateLimitPerMinute'?: number;
+    /**
+     * Publish and review state for the app in the marketplace (creator view)
+     */
+    'appPublish'?: AppPublishDTO;
+    /**
+     * Installation link (company–app) with token, scopes, and per-installation settingsValues; present when includeSettings is true
+     */
+    'hasApp'?: HasAppDTO;
+    /**
+     * URL to the application\'s image or icon (derived from details.image)
+     */
+    'image'?: string;
+    /**
+     * URL where the application can be accessed (derived from details.url)
+     */
+    'url'?: string;
+    /**
+     * Category the application belongs to (derived from details.category)
+     */
+    'category'?: string;
+    /**
+     * Whether the app is installed for the current company
+     */
+    'installed'?: boolean;
+    /**
+     * Required scopes requested by the app (macro patterns or concrete scope strings).
+     */
+    'requiredScopes'?: Array<string>;
     /**
-     * Authentication method (API_KEY default, OAUTH2 for OAuth 2.0)
+     * Resolved concrete required scopes derived from requiredScopes and dynamic availableScopes.
+     */
+    'resolvedRequiredScopes'?: Array<string>;
+    /**
+     * App credentials: NONE for platform-managed installation tokens, API_KEY (legacy default), or OAUTH2
      */
     'authMethod'?: CreatePrivateAppRequestAuthMethodEnum;
     /**
-     * Registered OAuth redirect URIs (required when authMethod is OAUTH2)
+     * OAuth 2.0 client identifier (OAuth apps only)
+     */
+    'oauthClientId'?: string;
+    /**
+     * OAuth 2.0 client secret; only returned once on create or secret rotation
+     */
+    'oauthClientSecret'?: string;
+    /**
+     * Whether an OAuth client secret is stored for this app (plain value is not re-readable)
+     */
+    'oauthClientSecretConfigured'?: boolean;
+    /**
+     * Registered OAuth redirect URIs (OAuth apps only)
      */
     'oauthRedirectUris'?: Array<string>;
     /**
-     * Ignored; new private apps are always platform version 2 (async container runtime).
+     * OAuth authorization endpoint URL
+     */
+    'oauthAuthorizeUrl'?: string;
+    /**
+     * OAuth token endpoint URL
+     */
+    'oauthTokenUrl'?: string;
+    /**
+     * External URL where end users install this app (e.g. ChatGPT connector page)
+     */
+    'installUrl'?: string;
+    /**
+     * Square brandmark URL used in compact app surfaces
+     */
+    'brandmark'?: string;
+    /**
+     * Internal app description used in Caraer admin views
+     */
+    'description'?: string;
+    /**
+     * App platform version: 1 = legacy per-function Cloud Functions; 2 = one container per app
      */
     'platformVersion'?: number;
     /**
-     * Serverless runtime for the app: nodejs22 or python312. Defaults to nodejs22.
+     * Serverless runtime for platform V2 apps (nodejs22 or python312)
      */
     'runtime'?: string;
+    /**
+     * Base HTTPS URL of the V2 app container runtime
+     */
+    'runtimeBaseUrl'?: string;
+    /**
+     * Last deployed runtime revision id
+     */
+    'runtimeRevision'?: string;
+    /**
+     * V2 runtime status: PENDING, PROVISIONING, READY, FAILED
+     */
+    'runtimeStatus'?: string;
+    /**
+     * Last V2 runtime error message when FAILED
+     */
+    'runtimeError'?: string;
+    /**
+     * Monotonic generation for async runtime jobs
+     */
+    'runtimeGeneration'?: number;
 }
 export declare const CreatePrivateAppRequestAuthMethodEnum: {
     readonly None: "NONE";
@@ -5833,8 +6005,8 @@ export interface SettingField {
     'hidden'?: boolean;
     'disabled'?: boolean;
     'options'?: Array<SettingOption>;
-    'defaultValue'?: any;
     'value'?: any;
+    'defaultValue'?: any;
 }
 export declare const SettingFieldTypeEnum: {
     readonly String: "STRING";
@@ -9326,7 +9498,7 @@ export declare const ApplicationsApiAxiosParamCreator: (configuration?: Configur
      */
     createAppWebhookForApp: (appUuid: string, subscribeWebhookDTO: SubscribeWebhookDTO, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * Creates a new private app with the provided label and optional description. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
+     * Creates a private app from its creator manifest, validating the supplied name, settings and app bars before saving. An omitted name is generated. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
      * @summary Create a private app
      * @param {CreatePrivateAppRequest} createPrivateAppRequest
      * @param {*} [options] Override http request option.
@@ -9602,7 +9774,7 @@ export declare const ApplicationsApiFp: (configuration?: Configuration) => {
      */
     createAppWebhookForApp(appUuid: string, subscribeWebhookDTO: SubscribeWebhookDTO, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<CreateResponse>>;
     /**
-     * Creates a new private app with the provided label and optional description. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
+     * Creates a private app from its creator manifest, validating the supplied name, settings and app bars before saving. An omitted name is generated. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
      * @summary Create a private app
      * @param {CreatePrivateAppRequest} createPrivateAppRequest
      * @param {*} [options] Override http request option.
@@ -9886,7 +10058,7 @@ export declare const ApplicationsApiFactory: (configuration?: Configuration, bas
      */
     createAppWebhookForApp(appUuid: string, subscribeWebhookDTO: SubscribeWebhookDTO, options?: RawAxiosRequestConfig): AxiosPromise<CreateResponse>;
     /**
-     * Creates a new private app with the provided label and optional description. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
+     * Creates a private app from its creator manifest, validating the supplied name, settings and app bars before saving. An omitted name is generated. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
      * @summary Create a private app
      * @param {CreatePrivateAppRequest} createPrivateAppRequest
      * @param {*} [options] Override http request option.
@@ -10170,7 +10342,7 @@ export declare class ApplicationsApi extends BaseAPI {
      */
     createAppWebhookForApp(appUuid: string, subscribeWebhookDTO: SubscribeWebhookDTO, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<CreateResponse, any, {}>>;
     /**
-     * Creates a new private app with the provided label and optional description. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
+     * Creates a private app from its creator manifest, validating the supplied name, settings and app bars before saving. An omitted name is generated. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
      * @summary Create a private app
      * @param {CreatePrivateAppRequest} createPrivateAppRequest
      * @param {*} [options] Override http request option.

package/dist/api.js

@@ -1899,7 +1899,7 @@ const ApplicationsApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Creates a new private app with the provided label and optional description. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
+         * Creates a private app from its creator manifest, validating the supplied name, settings and app bars before saving. An omitted name is generated. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
          * @summary Create a private app
          * @param {CreatePrivateAppRequest} createPrivateAppRequest
          * @param {*} [options] Override http request option.
@@ -3014,7 +3014,7 @@ const ApplicationsApiFp = function (configuration) {
             });
         },
         /**
-         * Creates a new private app with the provided label and optional description. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
+         * Creates a private app from its creator manifest, validating the supplied name, settings and app bars before saving. An omitted name is generated. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
          * @summary Create a private app
          * @param {CreatePrivateAppRequest} createPrivateAppRequest
          * @param {*} [options] Override http request option.
@@ -3536,7 +3536,7 @@ const ApplicationsApiFactory = function (configuration, basePath, axios) {
             return localVarFp.createAppWebhookForApp(appUuid, subscribeWebhookDTO, options).then((request) => request(axios, basePath));
         },
         /**
-         * Creates a new private app with the provided label and optional description. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
+         * Creates a private app from its creator manifest, validating the supplied name, settings and app bars before saving. An omitted name is generated. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
          * @summary Create a private app
          * @param {CreatePrivateAppRequest} createPrivateAppRequest
          * @param {*} [options] Override http request option.
@@ -3876,7 +3876,7 @@ class ApplicationsApi extends base_1.BaseAPI {
         return (0, exports.ApplicationsApiFp)(this.configuration).createAppWebhookForApp(appUuid, subscribeWebhookDTO, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Creates a new private app with the provided label and optional description. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
+     * Creates a private app from its creator manifest, validating the supplied name, settings and app bars before saving. An omitted name is generated. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
      * @summary Create a private app
      * @param {CreatePrivateAppRequest} createPrivateAppRequest
      * @param {*} [options] Override http request option.

package/dist/esm/api.d.ts

@@ -1745,33 +1745,205 @@ export interface CreateOrUpdateEnvironmentRequest {
     'webpageObjects'?: Array<CaraerObjectDTO>;
 }
 /**
- * Private app creation request with label and optional description
+ * Private app creator manifest; label is required and internal name is optional
  */
 export interface CreatePrivateAppRequest {
     /**
-     * The display label for the private app.
+     * Unique identifier for the entity
+     */
+    'uuid': string;
+    /**
+     * The name of the entity
+     */
+    'name': string;
+    /**
+     * Display label for the entity, can be different from name
      */
     'label': string;
     /**
-     * Optional description text for the app.
+     * Unix timestamp when the entity was created
      */
-    'description'?: string;
+    'createdAt'?: number;
+    /**
+     * Identifier of the user who created the entity
+     */
+    'createdBy'?: ModelRecord;
+    /**
+     * Unix timestamp when the entity was last updated
+     */
+    'updatedAt'?: number;
+    /**
+     * Identifier of the user who last updated the entity
+     */
+    'updatedBy'?: ModelRecord;
+    /**
+     * Unix timestamp when the entity was deleted (null if not deleted)
+     */
+    'deletedAt'?: number;
+    /**
+     * Identifier of the user who deleted the entity
+     */
+    'deletedBy'?: ModelRecord;
+    /**
+     * Index number for ordering entities
+     */
+    'index'?: number;
+    /**
+     * Indicates whether this app is private (only available to the creator\'s company)
+     */
+    'privateApp'?: boolean;
+    /**
+     * Whether to hide the API token field in marketplace installer UI. Defaults to true when omitted. Private apps show the key regardless.
+     */
+    'hideApiKeyField'?: boolean;
+    /**
+     * Additional details and specifications about the application
+     */
+    'details'?: AppDetailsDTO;
+    /**
+     * App bars (location-specific configuration and actions)
+     */
+    'appBars'?: Array<AppBarDTO>;
+    /**
+     * Serverless functions owned by this app
+     */
+    'serverlessFunctions'?: Array<ServerlessFunctionDTO>;
+    /**
+     * Webhook triggered when the app is installed
+     */
+    'installWebhook'?: SubscribeWebhookDTO;
+    /**
+     * Webhook triggered when the app is uninstalled
+     */
+    'uninstallWebhook'?: SubscribeWebhookDTO;
+    /**
+     * Webhook triggered when the app installation token is rotated
+     */
+    'rotateWebhook'?: SubscribeWebhookDTO;
+    /**
+     * Webhook triggered when an already installed app is saved again
+     */
+    'updateWebhook'?: SubscribeWebhookDTO;
+    /**
+     * 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)
+     */
+    'externalOAuthProviders'?: Array<AppExternalOAuthProviderSummaryDTO>;
+    /**
+     * Webhook rate limit per minute
+     */
+    'webhookRateLimitPerMinute'?: number;
+    /**
+     * App job enqueue rate limit per minute per installation
+     */
+    'jobRateLimitPerMinute'?: number;
+    /**
+     * Publish and review state for the app in the marketplace (creator view)
+     */
+    'appPublish'?: AppPublishDTO;
+    /**
+     * Installation link (company–app) with token, scopes, and per-installation settingsValues; present when includeSettings is true
+     */
+    'hasApp'?: HasAppDTO;
+    /**
+     * URL to the application\'s image or icon (derived from details.image)
+     */
+    'image'?: string;
+    /**
+     * URL where the application can be accessed (derived from details.url)
+     */
+    'url'?: string;
+    /**
+     * Category the application belongs to (derived from details.category)
+     */
+    'category'?: string;
+    /**
+     * Whether the app is installed for the current company
+     */
+    'installed'?: boolean;
+    /**
+     * Required scopes requested by the app (macro patterns or concrete scope strings).
+     */
+    'requiredScopes'?: Array<string>;
     /**
-     * Authentication method (API_KEY default, OAUTH2 for OAuth 2.0)
+     * Resolved concrete required scopes derived from requiredScopes and dynamic availableScopes.
+     */
+    'resolvedRequiredScopes'?: Array<string>;
+    /**
+     * App credentials: NONE for platform-managed installation tokens, API_KEY (legacy default), or OAUTH2
      */
     'authMethod'?: CreatePrivateAppRequestAuthMethodEnum;
     /**
-     * Registered OAuth redirect URIs (required when authMethod is OAUTH2)
+     * OAuth 2.0 client identifier (OAuth apps only)
+     */
+    'oauthClientId'?: string;
+    /**
+     * OAuth 2.0 client secret; only returned once on create or secret rotation
+     */
+    'oauthClientSecret'?: string;
+    /**
+     * Whether an OAuth client secret is stored for this app (plain value is not re-readable)
+     */
+    'oauthClientSecretConfigured'?: boolean;
+    /**
+     * Registered OAuth redirect URIs (OAuth apps only)
      */
     'oauthRedirectUris'?: Array<string>;
     /**
-     * Ignored; new private apps are always platform version 2 (async container runtime).
+     * OAuth authorization endpoint URL
+     */
+    'oauthAuthorizeUrl'?: string;
+    /**
+     * OAuth token endpoint URL
+     */
+    'oauthTokenUrl'?: string;
+    /**
+     * External URL where end users install this app (e.g. ChatGPT connector page)
+     */
+    'installUrl'?: string;
+    /**
+     * Square brandmark URL used in compact app surfaces
+     */
+    'brandmark'?: string;
+    /**
+     * Internal app description used in Caraer admin views
+     */
+    'description'?: string;
+    /**
+     * App platform version: 1 = legacy per-function Cloud Functions; 2 = one container per app
      */
     'platformVersion'?: number;
     /**
-     * Serverless runtime for the app: nodejs22 or python312. Defaults to nodejs22.
+     * Serverless runtime for platform V2 apps (nodejs22 or python312)
      */
     'runtime'?: string;
+    /**
+     * Base HTTPS URL of the V2 app container runtime
+     */
+    'runtimeBaseUrl'?: string;
+    /**
+     * Last deployed runtime revision id
+     */
+    'runtimeRevision'?: string;
+    /**
+     * V2 runtime status: PENDING, PROVISIONING, READY, FAILED
+     */
+    'runtimeStatus'?: string;
+    /**
+     * Last V2 runtime error message when FAILED
+     */
+    'runtimeError'?: string;
+    /**
+     * Monotonic generation for async runtime jobs
+     */
+    'runtimeGeneration'?: number;
 }
 export declare const CreatePrivateAppRequestAuthMethodEnum: {
     readonly None: "NONE";
@@ -5833,8 +6005,8 @@ export interface SettingField {
     'hidden'?: boolean;
     'disabled'?: boolean;
     'options'?: Array<SettingOption>;
-    'defaultValue'?: any;
     'value'?: any;
+    'defaultValue'?: any;
 }
 export declare const SettingFieldTypeEnum: {
     readonly String: "STRING";
@@ -9326,7 +9498,7 @@ export declare const ApplicationsApiAxiosParamCreator: (configuration?: Configur
      */
     createAppWebhookForApp: (appUuid: string, subscribeWebhookDTO: SubscribeWebhookDTO, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * Creates a new private app with the provided label and optional description. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
+     * Creates a private app from its creator manifest, validating the supplied name, settings and app bars before saving. An omitted name is generated. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
      * @summary Create a private app
      * @param {CreatePrivateAppRequest} createPrivateAppRequest
      * @param {*} [options] Override http request option.
@@ -9602,7 +9774,7 @@ export declare const ApplicationsApiFp: (configuration?: Configuration) => {
      */
     createAppWebhookForApp(appUuid: string, subscribeWebhookDTO: SubscribeWebhookDTO, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<CreateResponse>>;
     /**
-     * Creates a new private app with the provided label and optional description. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
+     * Creates a private app from its creator manifest, validating the supplied name, settings and app bars before saving. An omitted name is generated. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
      * @summary Create a private app
      * @param {CreatePrivateAppRequest} createPrivateAppRequest
      * @param {*} [options] Override http request option.
@@ -9886,7 +10058,7 @@ export declare const ApplicationsApiFactory: (configuration?: Configuration, bas
      */
     createAppWebhookForApp(appUuid: string, subscribeWebhookDTO: SubscribeWebhookDTO, options?: RawAxiosRequestConfig): AxiosPromise<CreateResponse>;
     /**
-     * Creates a new private app with the provided label and optional description. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
+     * Creates a private app from its creator manifest, validating the supplied name, settings and app bars before saving. An omitted name is generated. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
      * @summary Create a private app
      * @param {CreatePrivateAppRequest} createPrivateAppRequest
      * @param {*} [options] Override http request option.
@@ -10170,7 +10342,7 @@ export declare class ApplicationsApi extends BaseAPI {
      */
     createAppWebhookForApp(appUuid: string, subscribeWebhookDTO: SubscribeWebhookDTO, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<CreateResponse, any, {}>>;
     /**
-     * Creates a new private app with the provided label and optional description. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
+     * Creates a private app from its creator manifest, validating the supplied name, settings and app bars before saving. An omitted name is generated. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
      * @summary Create a private app
      * @param {CreatePrivateAppRequest} createPrivateAppRequest
      * @param {*} [options] Override http request option.

package/dist/esm/api.js

@@ -1881,7 +1881,7 @@ export const ApplicationsApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Creates a new private app with the provided label and optional description. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
+         * Creates a private app from its creator manifest, validating the supplied name, settings and app bars before saving. An omitted name is generated. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
          * @summary Create a private app
          * @param {CreatePrivateAppRequest} createPrivateAppRequest
          * @param {*} [options] Override http request option.
@@ -2995,7 +2995,7 @@ export const ApplicationsApiFp = function (configuration) {
             });
         },
         /**
-         * Creates a new private app with the provided label and optional description. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
+         * Creates a private app from its creator manifest, validating the supplied name, settings and app bars before saving. An omitted name is generated. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
          * @summary Create a private app
          * @param {CreatePrivateAppRequest} createPrivateAppRequest
          * @param {*} [options] Override http request option.
@@ -3516,7 +3516,7 @@ export const ApplicationsApiFactory = function (configuration, basePath, axios)
             return localVarFp.createAppWebhookForApp(appUuid, subscribeWebhookDTO, options).then((request) => request(axios, basePath));
         },
         /**
-         * Creates a new private app with the provided label and optional description. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
+         * Creates a private app from its creator manifest, validating the supplied name, settings and app bars before saving. An omitted name is generated. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
          * @summary Create a private app
          * @param {CreatePrivateAppRequest} createPrivateAppRequest
          * @param {*} [options] Override http request option.
@@ -3855,7 +3855,7 @@ export class ApplicationsApi extends BaseAPI {
         return ApplicationsApiFp(this.configuration).createAppWebhookForApp(appUuid, subscribeWebhookDTO, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Creates a new private app with the provided label and optional description. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
+     * Creates a private app from its creator manifest, validating the supplied name, settings and app bars before saving. An omitted name is generated. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
      * @summary Create a private app
      * @param {CreatePrivateAppRequest} createPrivateAppRequest
      * @param {*} [options] Override http request option.

package/docs/ApplicationsApi.md

@@ -99,7 +99,7 @@ const { status, data } = await apiInstance.createAppWebhookForApp(
 # **createPrivateApp**
 > CreateResponse createPrivateApp(createPrivateAppRequest)
 
-Creates a new private app with the provided label and optional description. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
+Creates a private app from its creator manifest, validating the supplied name, settings and app bars before saving. An omitted name is generated. Private apps are automatically installed for the creating user\'s company. Returns the created app details as a CreateResponse wrapping an AppDTO.
 
 ### Example
 

package/docs/CreatePrivateAppRequest.md

@@ -1,17 +1,60 @@
 # CreatePrivateAppRequest
 
-Private app creation request with label and optional description
+Private app creator manifest; label is required and internal name is optional
 
 ## Properties
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**label** | **string** | The display label for the private app. | [default to undefined]
-**description** | **string** | Optional description text for the app. | [optional] [default to undefined]
-**authMethod** | **string** | Authentication method (API_KEY default, OAUTH2 for OAuth 2.0) | [optional] [default to undefined]
-**oauthRedirectUris** | **Array<string>** | Registered OAuth redirect URIs (required when authMethod is OAUTH2) | [optional] [default to undefined]
-**platformVersion** | **number** | Ignored; new private apps are always platform version 2 (async container runtime). | [optional] [default to undefined]
-**runtime** | **string** | Serverless runtime for the app: nodejs22 or python312. Defaults to nodejs22. | [optional] [default to undefined]
+**uuid** | **string** | Unique identifier for the entity | [default to undefined]
+**name** | **string** | The name of the entity | [default to undefined]
+**label** | **string** | Display label for the entity, can be different from name | [default to undefined]
+**createdAt** | **number** | Unix timestamp when the entity was created | [optional] [default to undefined]
+**createdBy** | [**ModelRecord**](ModelRecord.md) | Identifier of the user who created the entity | [optional] [default to undefined]
+**updatedAt** | **number** | Unix timestamp when the entity was last updated | [optional] [default to undefined]
+**updatedBy** | [**ModelRecord**](ModelRecord.md) | Identifier of the user who last updated the entity | [optional] [default to undefined]
+**deletedAt** | **number** | Unix timestamp when the entity was deleted (null if not deleted) | [optional] [default to undefined]
+**deletedBy** | [**ModelRecord**](ModelRecord.md) | Identifier of the user who deleted the entity | [optional] [default to undefined]
+**index** | **number** | Index number for ordering entities | [optional] [default to undefined]
+**privateApp** | **boolean** | Indicates whether this app is private (only available to the creator\'s company) | [optional] [default to undefined]
+**hideApiKeyField** | **boolean** | Whether to hide the API token field in marketplace installer UI. Defaults to true when omitted. Private apps show the key regardless. | [optional] [default to undefined]
+**details** | [**AppDetailsDTO**](AppDetailsDTO.md) | Additional details and specifications about the application | [optional] [default to undefined]
+**appBars** | [**Array<AppBarDTO>**](AppBarDTO.md) | App bars (location-specific configuration and actions) | [optional] [default to undefined]
+**serverlessFunctions** | [**Array<ServerlessFunctionDTO>**](ServerlessFunctionDTO.md) | Serverless functions owned by this app | [optional] [default to undefined]
+**installWebhook** | [**SubscribeWebhookDTO**](SubscribeWebhookDTO.md) | Webhook triggered when the app is installed | [optional] [default to undefined]
+**uninstallWebhook** | [**SubscribeWebhookDTO**](SubscribeWebhookDTO.md) | Webhook triggered when the app is uninstalled | [optional] [default to undefined]
+**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]
+**appPublish** | [**AppPublishDTO**](AppPublishDTO.md) | Publish and review state for the app in the marketplace (creator view) | [optional] [default to undefined]
+**hasApp** | [**HasAppDTO**](HasAppDTO.md) | Installation link (company–app) with token, scopes, and per-installation settingsValues; present when includeSettings is true | [optional] [default to undefined]
+**image** | **string** | URL to the application\'s image or icon (derived from details.image) | [optional] [default to undefined]
+**url** | **string** | URL where the application can be accessed (derived from details.url) | [optional] [default to undefined]
+**category** | **string** | Category the application belongs to (derived from details.category) | [optional] [default to undefined]
+**installed** | **boolean** | Whether the app is installed for the current company | [optional] [default to undefined]
+**requiredScopes** | **Array<string>** | Required scopes requested by the app (macro patterns or concrete scope strings). | [optional] [default to undefined]
+**resolvedRequiredScopes** | **Array<string>** | Resolved concrete required scopes derived from requiredScopes and dynamic availableScopes. | [optional] [default to undefined]
+**authMethod** | **string** | App credentials: NONE for platform-managed installation tokens, API_KEY (legacy default), or OAUTH2 | [optional] [default to undefined]
+**oauthClientId** | **string** | OAuth 2.0 client identifier (OAuth apps only) | [optional] [default to undefined]
+**oauthClientSecret** | **string** | OAuth 2.0 client secret; only returned once on create or secret rotation | [optional] [default to undefined]
+**oauthClientSecretConfigured** | **boolean** | Whether an OAuth client secret is stored for this app (plain value is not re-readable) | [optional] [default to undefined]
+**oauthRedirectUris** | **Array<string>** | Registered OAuth redirect URIs (OAuth apps only) | [optional] [default to undefined]
+**oauthAuthorizeUrl** | **string** | OAuth authorization endpoint URL | [optional] [default to undefined]
+**oauthTokenUrl** | **string** | OAuth token endpoint URL | [optional] [default to undefined]
+**installUrl** | **string** | External URL where end users install this app (e.g. ChatGPT connector page) | [optional] [default to undefined]
+**brandmark** | **string** | Square brandmark URL used in compact app surfaces | [optional] [default to undefined]
+**description** | **string** | Internal app description used in Caraer admin views | [optional] [default to undefined]
+**platformVersion** | **number** | App platform version: 1 = legacy per-function Cloud Functions; 2 = one container per app | [optional] [default to undefined]
+**runtime** | **string** | Serverless runtime for platform V2 apps (nodejs22 or python312) | [optional] [default to undefined]
+**runtimeBaseUrl** | **string** | Base HTTPS URL of the V2 app container runtime | [optional] [default to undefined]
+**runtimeRevision** | **string** | Last deployed runtime revision id | [optional] [default to undefined]
+**runtimeStatus** | **string** | V2 runtime status: PENDING, PROVISIONING, READY, FAILED | [optional] [default to undefined]
+**runtimeError** | **string** | Last V2 runtime error message when FAILED | [optional] [default to undefined]
+**runtimeGeneration** | **number** | Monotonic generation for async runtime jobs | [optional] [default to undefined]
 
 ## Example
 
@@ -19,12 +62,55 @@ Name | Type | Description | Notes
 import { CreatePrivateAppRequest } from '@caraer/client';
 
 const instance: CreatePrivateAppRequest = {
+    uuid,
+    name,
     label,
-    description,
+    createdAt,
+    createdBy,
+    updatedAt,
+    updatedBy,
+    deletedAt,
+    deletedBy,
+    index,
+    privateApp,
+    hideApiKeyField,
+    details,
+    appBars,
+    serverlessFunctions,
+    installWebhook,
+    uninstallWebhook,
+    rotateWebhook,
+    updateWebhook,
+    settingsSchema,
+    settingsSections,
+    externalOAuthProviders,
+    webhookRateLimitPerMinute,
+    jobRateLimitPerMinute,
+    appPublish,
+    hasApp,
+    image,
+    url,
+    category,
+    installed,
+    requiredScopes,
+    resolvedRequiredScopes,
     authMethod,
+    oauthClientId,
+    oauthClientSecret,
+    oauthClientSecretConfigured,
     oauthRedirectUris,
+    oauthAuthorizeUrl,
+    oauthTokenUrl,
+    installUrl,
+    brandmark,
+    description,
     platformVersion,
     runtime,
+    runtimeBaseUrl,
+    runtimeRevision,
+    runtimeStatus,
+    runtimeError,
+    runtimeGeneration,
 };
 ```
 

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]
-**defaultValue** | **any** |  | [optional] [default to undefined]
 **value** | **any** |  | [optional] [default to undefined]
+**defaultValue** | **any** |  | [optional] [default to undefined]
 
 ## Example
 
@@ -32,8 +32,8 @@ const instance: SettingField = {
     hidden,
     disabled,
     _options,
-    defaultValue,
     value,
+    defaultValue,
 };
 ```
 

package/package.json

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