@caraer/client 2.0.574 → 2.0.576

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/api.ts CHANGED
@@ -1526,6 +1526,10 @@ export interface CompanyDTO {
1526
1526
  * Index number for ordering entities
1527
1527
  */
1528
1528
  'index'?: number;
1529
+ /**
1530
+ * The company\'s canonical subdomain, independent of website settings.
1531
+ */
1532
+ 'subdomain'?: string;
1529
1533
  /**
1530
1534
  * The details of the company.
1531
1535
  */
@@ -1747,33 +1751,205 @@ export interface CreateOrUpdateEnvironmentRequest {
1747
1751
  'webpageObjects'?: Array<CaraerObjectDTO>;
1748
1752
  }
1749
1753
  /**
1750
- * Private app creation request with label and optional description
1754
+ * Private app creator manifest; label is required and internal name is optional
1751
1755
  */
1752
1756
  export interface CreatePrivateAppRequest {
1753
1757
  /**
1754
- * The display label for the private app.
1758
+ * Unique identifier for the entity
1759
+ */
1760
+ 'uuid': string;
1761
+ /**
1762
+ * The name of the entity
1763
+ */
1764
+ 'name': string;
1765
+ /**
1766
+ * Display label for the entity, can be different from name
1755
1767
  */
1756
1768
  'label': string;
1757
1769
  /**
1758
- * Optional description text for the app.
1770
+ * Unix timestamp when the entity was created
1759
1771
  */
1760
- 'description'?: string;
1772
+ 'createdAt'?: number;
1773
+ /**
1774
+ * Identifier of the user who created the entity
1775
+ */
1776
+ 'createdBy'?: ModelRecord;
1777
+ /**
1778
+ * Unix timestamp when the entity was last updated
1779
+ */
1780
+ 'updatedAt'?: number;
1781
+ /**
1782
+ * Identifier of the user who last updated the entity
1783
+ */
1784
+ 'updatedBy'?: ModelRecord;
1785
+ /**
1786
+ * Unix timestamp when the entity was deleted (null if not deleted)
1787
+ */
1788
+ 'deletedAt'?: number;
1789
+ /**
1790
+ * Identifier of the user who deleted the entity
1791
+ */
1792
+ 'deletedBy'?: ModelRecord;
1793
+ /**
1794
+ * Index number for ordering entities
1795
+ */
1796
+ 'index'?: number;
1797
+ /**
1798
+ * Indicates whether this app is private (only available to the creator\'s company)
1799
+ */
1800
+ 'privateApp'?: boolean;
1801
+ /**
1802
+ * Whether to hide the API token field in marketplace installer UI. Defaults to true when omitted. Private apps show the key regardless.
1803
+ */
1804
+ 'hideApiKeyField'?: boolean;
1761
1805
  /**
1762
- * Authentication method (API_KEY default, OAUTH2 for OAuth 2.0)
1806
+ * Additional details and specifications about the application
1807
+ */
1808
+ 'details'?: AppDetailsDTO;
1809
+ /**
1810
+ * App bars (location-specific configuration and actions)
1811
+ */
1812
+ 'appBars'?: Array<AppBarDTO>;
1813
+ /**
1814
+ * Serverless functions owned by this app
1815
+ */
1816
+ 'serverlessFunctions'?: Array<ServerlessFunctionDTO>;
1817
+ /**
1818
+ * Webhook triggered when the app is installed
1819
+ */
1820
+ 'installWebhook'?: SubscribeWebhookDTO;
1821
+ /**
1822
+ * Webhook triggered when the app is uninstalled
1823
+ */
1824
+ 'uninstallWebhook'?: SubscribeWebhookDTO;
1825
+ /**
1826
+ * Webhook triggered when the app installation token is rotated
1827
+ */
1828
+ 'rotateWebhook'?: SubscribeWebhookDTO;
1829
+ /**
1830
+ * Webhook triggered when an already installed app is saved again
1831
+ */
1832
+ 'updateWebhook'?: SubscribeWebhookDTO;
1833
+ /**
1834
+ * JSON array of AppSettingFieldSchema (app-level setting field definitions)
1835
+ */
1836
+ 'settingsSchema'?: Array<AppSettingFieldSchema>;
1837
+ /**
1838
+ * Optional UI grouping of settingsSchema fields into installer cards
1839
+ */
1840
+ 'settingsSections'?: Array<AppSettingsSection>;
1841
+ /**
1842
+ * External OAuth providers installers can Connect (name/logo only; no secrets)
1843
+ */
1844
+ 'externalOAuthProviders'?: Array<AppExternalOAuthProviderSummaryDTO>;
1845
+ /**
1846
+ * Webhook rate limit per minute
1847
+ */
1848
+ 'webhookRateLimitPerMinute'?: number;
1849
+ /**
1850
+ * App job enqueue rate limit per minute per installation
1851
+ */
1852
+ 'jobRateLimitPerMinute'?: number;
1853
+ /**
1854
+ * Publish and review state for the app in the marketplace (creator view)
1855
+ */
1856
+ 'appPublish'?: AppPublishDTO;
1857
+ /**
1858
+ * Installation link (company–app) with token, scopes, and per-installation settingsValues; present when includeSettings is true
1859
+ */
1860
+ 'hasApp'?: HasAppDTO;
1861
+ /**
1862
+ * URL to the application\'s image or icon (derived from details.image)
1863
+ */
1864
+ 'image'?: string;
1865
+ /**
1866
+ * URL where the application can be accessed (derived from details.url)
1867
+ */
1868
+ 'url'?: string;
1869
+ /**
1870
+ * Category the application belongs to (derived from details.category)
1871
+ */
1872
+ 'category'?: string;
1873
+ /**
1874
+ * Whether the app is installed for the current company
1875
+ */
1876
+ 'installed'?: boolean;
1877
+ /**
1878
+ * Required scopes requested by the app (macro patterns or concrete scope strings).
1879
+ */
1880
+ 'requiredScopes'?: Array<string>;
1881
+ /**
1882
+ * Resolved concrete required scopes derived from requiredScopes and dynamic availableScopes.
1883
+ */
1884
+ 'resolvedRequiredScopes'?: Array<string>;
1885
+ /**
1886
+ * App credentials: NONE for platform-managed installation tokens, API_KEY (legacy default), or OAUTH2
1763
1887
  */
1764
1888
  'authMethod'?: CreatePrivateAppRequestAuthMethodEnum;
1765
1889
  /**
1766
- * Registered OAuth redirect URIs (required when authMethod is OAUTH2)
1890
+ * OAuth 2.0 client identifier (OAuth apps only)
1891
+ */
1892
+ 'oauthClientId'?: string;
1893
+ /**
1894
+ * OAuth 2.0 client secret; only returned once on create or secret rotation
1895
+ */
1896
+ 'oauthClientSecret'?: string;
1897
+ /**
1898
+ * Whether an OAuth client secret is stored for this app (plain value is not re-readable)
1899
+ */
1900
+ 'oauthClientSecretConfigured'?: boolean;
1901
+ /**
1902
+ * Registered OAuth redirect URIs (OAuth apps only)
1767
1903
  */
1768
1904
  'oauthRedirectUris'?: Array<string>;
1769
1905
  /**
1770
- * Ignored; new private apps are always platform version 2 (async container runtime).
1906
+ * OAuth authorization endpoint URL
1907
+ */
1908
+ 'oauthAuthorizeUrl'?: string;
1909
+ /**
1910
+ * OAuth token endpoint URL
1911
+ */
1912
+ 'oauthTokenUrl'?: string;
1913
+ /**
1914
+ * External URL where end users install this app (e.g. ChatGPT connector page)
1915
+ */
1916
+ 'installUrl'?: string;
1917
+ /**
1918
+ * Square brandmark URL used in compact app surfaces
1919
+ */
1920
+ 'brandmark'?: string;
1921
+ /**
1922
+ * Internal app description used in Caraer admin views
1923
+ */
1924
+ 'description'?: string;
1925
+ /**
1926
+ * App platform version: 1 = legacy per-function Cloud Functions; 2 = one container per app
1771
1927
  */
1772
1928
  'platformVersion'?: number;
1773
1929
  /**
1774
- * Serverless runtime for the app: nodejs22 or python312. Defaults to nodejs22.
1930
+ * Serverless runtime for platform V2 apps (nodejs22 or python312)
1775
1931
  */
1776
1932
  'runtime'?: string;
1933
+ /**
1934
+ * Base HTTPS URL of the V2 app container runtime
1935
+ */
1936
+ 'runtimeBaseUrl'?: string;
1937
+ /**
1938
+ * Last deployed runtime revision id
1939
+ */
1940
+ 'runtimeRevision'?: string;
1941
+ /**
1942
+ * V2 runtime status: PENDING, PROVISIONING, READY, FAILED
1943
+ */
1944
+ 'runtimeStatus'?: string;
1945
+ /**
1946
+ * Last V2 runtime error message when FAILED
1947
+ */
1948
+ 'runtimeError'?: string;
1949
+ /**
1950
+ * Monotonic generation for async runtime jobs
1951
+ */
1952
+ 'runtimeGeneration'?: number;
1777
1953
  }
1778
1954
 
1779
1955
  export const CreatePrivateAppRequestAuthMethodEnum = {
@@ -2597,8 +2773,8 @@ export type EventRsvpRequestScopeEnum = typeof EventRsvpRequestScopeEnum[keyof t
2597
2773
 
2598
2774
  export interface ExistingWidgetSummary {
2599
2775
  'yproperty'?: string;
2600
- 'ymetric'?: string;
2601
2776
  'xproperty'?: string;
2777
+ 'ymetric'?: string;
2602
2778
  'title'?: string;
2603
2779
  'chartType'?: string;
2604
2780
  'xProperty'?: string;
@@ -5781,8 +5957,8 @@ export interface SettingField {
5781
5957
  'hidden'?: boolean;
5782
5958
  'disabled'?: boolean;
5783
5959
  'options'?: Array<SettingOption>;
5784
- 'defaultValue'?: any;
5785
5960
  'value'?: any;
5961
+ 'defaultValue'?: any;
5786
5962
  }
5787
5963
 
5788
5964
  export const SettingFieldTypeEnum = {
@@ -10165,7 +10341,7 @@ export const ApplicationsApiAxiosParamCreator = function (configuration?: Config
10165
10341
  };
10166
10342
  },
10167
10343
  /**
10168
- * 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.
10344
+ * 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.
10169
10345
  * @summary Create a private app
10170
10346
  * @param {CreatePrivateAppRequest} createPrivateAppRequest
10171
10347
  * @param {*} [options] Override http request option.
@@ -11433,7 +11609,7 @@ export const ApplicationsApiFp = function(configuration?: Configuration) {
11433
11609
  return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
11434
11610
  },
11435
11611
  /**
11436
- * 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.
11612
+ * 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.
11437
11613
  * @summary Create a private app
11438
11614
  * @param {CreatePrivateAppRequest} createPrivateAppRequest
11439
11615
  * @param {*} [options] Override http request option.
@@ -11865,7 +12041,7 @@ export const ApplicationsApiFactory = function (configuration?: Configuration, b
11865
12041
  return localVarFp.createAppWebhookForApp(appUuid, subscribeWebhookDTO, options).then((request) => request(axios, basePath));
11866
12042
  },
11867
12043
  /**
11868
- * 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.
12044
+ * 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.
11869
12045
  * @summary Create a private app
11870
12046
  * @param {CreatePrivateAppRequest} createPrivateAppRequest
11871
12047
  * @param {*} [options] Override http request option.
@@ -12206,7 +12382,7 @@ export class ApplicationsApi extends BaseAPI {
12206
12382
  }
12207
12383
 
12208
12384
  /**
12209
- * 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.
12385
+ * 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.
12210
12386
  * @summary Create a private app
12211
12387
  * @param {CreatePrivateAppRequest} createPrivateAppRequest
12212
12388
  * @param {*} [options] Override http request option.
package/dist/api.d.ts CHANGED
@@ -1524,6 +1524,10 @@ export interface CompanyDTO {
1524
1524
  * Index number for ordering entities
1525
1525
  */
1526
1526
  'index'?: number;
1527
+ /**
1528
+ * The company\'s canonical subdomain, independent of website settings.
1529
+ */
1530
+ 'subdomain'?: string;
1527
1531
  /**
1528
1532
  * The details of the company.
1529
1533
  */
@@ -1745,33 +1749,205 @@ export interface CreateOrUpdateEnvironmentRequest {
1745
1749
  'webpageObjects'?: Array<CaraerObjectDTO>;
1746
1750
  }
1747
1751
  /**
1748
- * Private app creation request with label and optional description
1752
+ * Private app creator manifest; label is required and internal name is optional
1749
1753
  */
1750
1754
  export interface CreatePrivateAppRequest {
1751
1755
  /**
1752
- * The display label for the private app.
1756
+ * Unique identifier for the entity
1757
+ */
1758
+ 'uuid': string;
1759
+ /**
1760
+ * The name of the entity
1761
+ */
1762
+ 'name': string;
1763
+ /**
1764
+ * Display label for the entity, can be different from name
1753
1765
  */
1754
1766
  'label': string;
1755
1767
  /**
1756
- * Optional description text for the app.
1768
+ * Unix timestamp when the entity was created
1757
1769
  */
1758
- 'description'?: string;
1770
+ 'createdAt'?: number;
1771
+ /**
1772
+ * Identifier of the user who created the entity
1773
+ */
1774
+ 'createdBy'?: ModelRecord;
1775
+ /**
1776
+ * Unix timestamp when the entity was last updated
1777
+ */
1778
+ 'updatedAt'?: number;
1779
+ /**
1780
+ * Identifier of the user who last updated the entity
1781
+ */
1782
+ 'updatedBy'?: ModelRecord;
1783
+ /**
1784
+ * Unix timestamp when the entity was deleted (null if not deleted)
1785
+ */
1786
+ 'deletedAt'?: number;
1787
+ /**
1788
+ * Identifier of the user who deleted the entity
1789
+ */
1790
+ 'deletedBy'?: ModelRecord;
1791
+ /**
1792
+ * Index number for ordering entities
1793
+ */
1794
+ 'index'?: number;
1795
+ /**
1796
+ * Indicates whether this app is private (only available to the creator\'s company)
1797
+ */
1798
+ 'privateApp'?: boolean;
1799
+ /**
1800
+ * Whether to hide the API token field in marketplace installer UI. Defaults to true when omitted. Private apps show the key regardless.
1801
+ */
1802
+ 'hideApiKeyField'?: boolean;
1759
1803
  /**
1760
- * Authentication method (API_KEY default, OAUTH2 for OAuth 2.0)
1804
+ * Additional details and specifications about the application
1805
+ */
1806
+ 'details'?: AppDetailsDTO;
1807
+ /**
1808
+ * App bars (location-specific configuration and actions)
1809
+ */
1810
+ 'appBars'?: Array<AppBarDTO>;
1811
+ /**
1812
+ * Serverless functions owned by this app
1813
+ */
1814
+ 'serverlessFunctions'?: Array<ServerlessFunctionDTO>;
1815
+ /**
1816
+ * Webhook triggered when the app is installed
1817
+ */
1818
+ 'installWebhook'?: SubscribeWebhookDTO;
1819
+ /**
1820
+ * Webhook triggered when the app is uninstalled
1821
+ */
1822
+ 'uninstallWebhook'?: SubscribeWebhookDTO;
1823
+ /**
1824
+ * Webhook triggered when the app installation token is rotated
1825
+ */
1826
+ 'rotateWebhook'?: SubscribeWebhookDTO;
1827
+ /**
1828
+ * Webhook triggered when an already installed app is saved again
1829
+ */
1830
+ 'updateWebhook'?: SubscribeWebhookDTO;
1831
+ /**
1832
+ * JSON array of AppSettingFieldSchema (app-level setting field definitions)
1833
+ */
1834
+ 'settingsSchema'?: Array<AppSettingFieldSchema>;
1835
+ /**
1836
+ * Optional UI grouping of settingsSchema fields into installer cards
1837
+ */
1838
+ 'settingsSections'?: Array<AppSettingsSection>;
1839
+ /**
1840
+ * External OAuth providers installers can Connect (name/logo only; no secrets)
1841
+ */
1842
+ 'externalOAuthProviders'?: Array<AppExternalOAuthProviderSummaryDTO>;
1843
+ /**
1844
+ * Webhook rate limit per minute
1845
+ */
1846
+ 'webhookRateLimitPerMinute'?: number;
1847
+ /**
1848
+ * App job enqueue rate limit per minute per installation
1849
+ */
1850
+ 'jobRateLimitPerMinute'?: number;
1851
+ /**
1852
+ * Publish and review state for the app in the marketplace (creator view)
1853
+ */
1854
+ 'appPublish'?: AppPublishDTO;
1855
+ /**
1856
+ * Installation link (company–app) with token, scopes, and per-installation settingsValues; present when includeSettings is true
1857
+ */
1858
+ 'hasApp'?: HasAppDTO;
1859
+ /**
1860
+ * URL to the application\'s image or icon (derived from details.image)
1861
+ */
1862
+ 'image'?: string;
1863
+ /**
1864
+ * URL where the application can be accessed (derived from details.url)
1865
+ */
1866
+ 'url'?: string;
1867
+ /**
1868
+ * Category the application belongs to (derived from details.category)
1869
+ */
1870
+ 'category'?: string;
1871
+ /**
1872
+ * Whether the app is installed for the current company
1873
+ */
1874
+ 'installed'?: boolean;
1875
+ /**
1876
+ * Required scopes requested by the app (macro patterns or concrete scope strings).
1877
+ */
1878
+ 'requiredScopes'?: Array<string>;
1879
+ /**
1880
+ * Resolved concrete required scopes derived from requiredScopes and dynamic availableScopes.
1881
+ */
1882
+ 'resolvedRequiredScopes'?: Array<string>;
1883
+ /**
1884
+ * App credentials: NONE for platform-managed installation tokens, API_KEY (legacy default), or OAUTH2
1761
1885
  */
1762
1886
  'authMethod'?: CreatePrivateAppRequestAuthMethodEnum;
1763
1887
  /**
1764
- * Registered OAuth redirect URIs (required when authMethod is OAUTH2)
1888
+ * OAuth 2.0 client identifier (OAuth apps only)
1889
+ */
1890
+ 'oauthClientId'?: string;
1891
+ /**
1892
+ * OAuth 2.0 client secret; only returned once on create or secret rotation
1893
+ */
1894
+ 'oauthClientSecret'?: string;
1895
+ /**
1896
+ * Whether an OAuth client secret is stored for this app (plain value is not re-readable)
1897
+ */
1898
+ 'oauthClientSecretConfigured'?: boolean;
1899
+ /**
1900
+ * Registered OAuth redirect URIs (OAuth apps only)
1765
1901
  */
1766
1902
  'oauthRedirectUris'?: Array<string>;
1767
1903
  /**
1768
- * Ignored; new private apps are always platform version 2 (async container runtime).
1904
+ * OAuth authorization endpoint URL
1905
+ */
1906
+ 'oauthAuthorizeUrl'?: string;
1907
+ /**
1908
+ * OAuth token endpoint URL
1909
+ */
1910
+ 'oauthTokenUrl'?: string;
1911
+ /**
1912
+ * External URL where end users install this app (e.g. ChatGPT connector page)
1913
+ */
1914
+ 'installUrl'?: string;
1915
+ /**
1916
+ * Square brandmark URL used in compact app surfaces
1917
+ */
1918
+ 'brandmark'?: string;
1919
+ /**
1920
+ * Internal app description used in Caraer admin views
1921
+ */
1922
+ 'description'?: string;
1923
+ /**
1924
+ * App platform version: 1 = legacy per-function Cloud Functions; 2 = one container per app
1769
1925
  */
1770
1926
  'platformVersion'?: number;
1771
1927
  /**
1772
- * Serverless runtime for the app: nodejs22 or python312. Defaults to nodejs22.
1928
+ * Serverless runtime for platform V2 apps (nodejs22 or python312)
1773
1929
  */
1774
1930
  'runtime'?: string;
1931
+ /**
1932
+ * Base HTTPS URL of the V2 app container runtime
1933
+ */
1934
+ 'runtimeBaseUrl'?: string;
1935
+ /**
1936
+ * Last deployed runtime revision id
1937
+ */
1938
+ 'runtimeRevision'?: string;
1939
+ /**
1940
+ * V2 runtime status: PENDING, PROVISIONING, READY, FAILED
1941
+ */
1942
+ 'runtimeStatus'?: string;
1943
+ /**
1944
+ * Last V2 runtime error message when FAILED
1945
+ */
1946
+ 'runtimeError'?: string;
1947
+ /**
1948
+ * Monotonic generation for async runtime jobs
1949
+ */
1950
+ 'runtimeGeneration'?: number;
1775
1951
  }
1776
1952
  export declare const CreatePrivateAppRequestAuthMethodEnum: {
1777
1953
  readonly None: "NONE";
@@ -2587,8 +2763,8 @@ export declare const EventRsvpRequestScopeEnum: {
2587
2763
  export type EventRsvpRequestScopeEnum = typeof EventRsvpRequestScopeEnum[keyof typeof EventRsvpRequestScopeEnum];
2588
2764
  export interface ExistingWidgetSummary {
2589
2765
  'yproperty'?: string;
2590
- 'ymetric'?: string;
2591
2766
  'xproperty'?: string;
2767
+ 'ymetric'?: string;
2592
2768
  'title'?: string;
2593
2769
  'chartType'?: string;
2594
2770
  'xProperty'?: string;
@@ -5833,8 +6009,8 @@ export interface SettingField {
5833
6009
  'hidden'?: boolean;
5834
6010
  'disabled'?: boolean;
5835
6011
  'options'?: Array<SettingOption>;
5836
- 'defaultValue'?: any;
5837
6012
  'value'?: any;
6013
+ 'defaultValue'?: any;
5838
6014
  }
5839
6015
  export declare const SettingFieldTypeEnum: {
5840
6016
  readonly String: "STRING";
@@ -9326,7 +9502,7 @@ export declare const ApplicationsApiAxiosParamCreator: (configuration?: Configur
9326
9502
  */
9327
9503
  createAppWebhookForApp: (appUuid: string, subscribeWebhookDTO: SubscribeWebhookDTO, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
9328
9504
  /**
9329
- * 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.
9505
+ * 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.
9330
9506
  * @summary Create a private app
9331
9507
  * @param {CreatePrivateAppRequest} createPrivateAppRequest
9332
9508
  * @param {*} [options] Override http request option.
@@ -9602,7 +9778,7 @@ export declare const ApplicationsApiFp: (configuration?: Configuration) => {
9602
9778
  */
9603
9779
  createAppWebhookForApp(appUuid: string, subscribeWebhookDTO: SubscribeWebhookDTO, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<CreateResponse>>;
9604
9780
  /**
9605
- * 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.
9781
+ * 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.
9606
9782
  * @summary Create a private app
9607
9783
  * @param {CreatePrivateAppRequest} createPrivateAppRequest
9608
9784
  * @param {*} [options] Override http request option.
@@ -9886,7 +10062,7 @@ export declare const ApplicationsApiFactory: (configuration?: Configuration, bas
9886
10062
  */
9887
10063
  createAppWebhookForApp(appUuid: string, subscribeWebhookDTO: SubscribeWebhookDTO, options?: RawAxiosRequestConfig): AxiosPromise<CreateResponse>;
9888
10064
  /**
9889
- * 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.
10065
+ * 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.
9890
10066
  * @summary Create a private app
9891
10067
  * @param {CreatePrivateAppRequest} createPrivateAppRequest
9892
10068
  * @param {*} [options] Override http request option.
@@ -10170,7 +10346,7 @@ export declare class ApplicationsApi extends BaseAPI {
10170
10346
  */
10171
10347
  createAppWebhookForApp(appUuid: string, subscribeWebhookDTO: SubscribeWebhookDTO, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<CreateResponse, any, {}>>;
10172
10348
  /**
10173
- * 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.
10349
+ * 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.
10174
10350
  * @summary Create a private app
10175
10351
  * @param {CreatePrivateAppRequest} createPrivateAppRequest
10176
10352
  * @param {*} [options] Override http request option.
package/dist/api.js CHANGED
@@ -1899,7 +1899,7 @@ const ApplicationsApiAxiosParamCreator = function (configuration) {
1899
1899
  };
1900
1900
  }),
1901
1901
  /**
1902
- * 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.
1902
+ * 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.
1903
1903
  * @summary Create a private app
1904
1904
  * @param {CreatePrivateAppRequest} createPrivateAppRequest
1905
1905
  * @param {*} [options] Override http request option.
@@ -3014,7 +3014,7 @@ const ApplicationsApiFp = function (configuration) {
3014
3014
  });
3015
3015
  },
3016
3016
  /**
3017
- * 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.
3017
+ * 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.
3018
3018
  * @summary Create a private app
3019
3019
  * @param {CreatePrivateAppRequest} createPrivateAppRequest
3020
3020
  * @param {*} [options] Override http request option.
@@ -3536,7 +3536,7 @@ const ApplicationsApiFactory = function (configuration, basePath, axios) {
3536
3536
  return localVarFp.createAppWebhookForApp(appUuid, subscribeWebhookDTO, options).then((request) => request(axios, basePath));
3537
3537
  },
3538
3538
  /**
3539
- * 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.
3539
+ * 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.
3540
3540
  * @summary Create a private app
3541
3541
  * @param {CreatePrivateAppRequest} createPrivateAppRequest
3542
3542
  * @param {*} [options] Override http request option.
@@ -3876,7 +3876,7 @@ class ApplicationsApi extends base_1.BaseAPI {
3876
3876
  return (0, exports.ApplicationsApiFp)(this.configuration).createAppWebhookForApp(appUuid, subscribeWebhookDTO, options).then((request) => request(this.axios, this.basePath));
3877
3877
  }
3878
3878
  /**
3879
- * 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.
3879
+ * 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.
3880
3880
  * @summary Create a private app
3881
3881
  * @param {CreatePrivateAppRequest} createPrivateAppRequest
3882
3882
  * @param {*} [options] Override http request option.
package/dist/esm/api.d.ts CHANGED
@@ -1524,6 +1524,10 @@ export interface CompanyDTO {
1524
1524
  * Index number for ordering entities
1525
1525
  */
1526
1526
  'index'?: number;
1527
+ /**
1528
+ * The company\'s canonical subdomain, independent of website settings.
1529
+ */
1530
+ 'subdomain'?: string;
1527
1531
  /**
1528
1532
  * The details of the company.
1529
1533
  */
@@ -1745,33 +1749,205 @@ export interface CreateOrUpdateEnvironmentRequest {
1745
1749
  'webpageObjects'?: Array<CaraerObjectDTO>;
1746
1750
  }
1747
1751
  /**
1748
- * Private app creation request with label and optional description
1752
+ * Private app creator manifest; label is required and internal name is optional
1749
1753
  */
1750
1754
  export interface CreatePrivateAppRequest {
1751
1755
  /**
1752
- * The display label for the private app.
1756
+ * Unique identifier for the entity
1757
+ */
1758
+ 'uuid': string;
1759
+ /**
1760
+ * The name of the entity
1761
+ */
1762
+ 'name': string;
1763
+ /**
1764
+ * Display label for the entity, can be different from name
1753
1765
  */
1754
1766
  'label': string;
1755
1767
  /**
1756
- * Optional description text for the app.
1768
+ * Unix timestamp when the entity was created
1757
1769
  */
1758
- 'description'?: string;
1770
+ 'createdAt'?: number;
1771
+ /**
1772
+ * Identifier of the user who created the entity
1773
+ */
1774
+ 'createdBy'?: ModelRecord;
1775
+ /**
1776
+ * Unix timestamp when the entity was last updated
1777
+ */
1778
+ 'updatedAt'?: number;
1779
+ /**
1780
+ * Identifier of the user who last updated the entity
1781
+ */
1782
+ 'updatedBy'?: ModelRecord;
1783
+ /**
1784
+ * Unix timestamp when the entity was deleted (null if not deleted)
1785
+ */
1786
+ 'deletedAt'?: number;
1787
+ /**
1788
+ * Identifier of the user who deleted the entity
1789
+ */
1790
+ 'deletedBy'?: ModelRecord;
1791
+ /**
1792
+ * Index number for ordering entities
1793
+ */
1794
+ 'index'?: number;
1795
+ /**
1796
+ * Indicates whether this app is private (only available to the creator\'s company)
1797
+ */
1798
+ 'privateApp'?: boolean;
1799
+ /**
1800
+ * Whether to hide the API token field in marketplace installer UI. Defaults to true when omitted. Private apps show the key regardless.
1801
+ */
1802
+ 'hideApiKeyField'?: boolean;
1759
1803
  /**
1760
- * Authentication method (API_KEY default, OAUTH2 for OAuth 2.0)
1804
+ * Additional details and specifications about the application
1805
+ */
1806
+ 'details'?: AppDetailsDTO;
1807
+ /**
1808
+ * App bars (location-specific configuration and actions)
1809
+ */
1810
+ 'appBars'?: Array<AppBarDTO>;
1811
+ /**
1812
+ * Serverless functions owned by this app
1813
+ */
1814
+ 'serverlessFunctions'?: Array<ServerlessFunctionDTO>;
1815
+ /**
1816
+ * Webhook triggered when the app is installed
1817
+ */
1818
+ 'installWebhook'?: SubscribeWebhookDTO;
1819
+ /**
1820
+ * Webhook triggered when the app is uninstalled
1821
+ */
1822
+ 'uninstallWebhook'?: SubscribeWebhookDTO;
1823
+ /**
1824
+ * Webhook triggered when the app installation token is rotated
1825
+ */
1826
+ 'rotateWebhook'?: SubscribeWebhookDTO;
1827
+ /**
1828
+ * Webhook triggered when an already installed app is saved again
1829
+ */
1830
+ 'updateWebhook'?: SubscribeWebhookDTO;
1831
+ /**
1832
+ * JSON array of AppSettingFieldSchema (app-level setting field definitions)
1833
+ */
1834
+ 'settingsSchema'?: Array<AppSettingFieldSchema>;
1835
+ /**
1836
+ * Optional UI grouping of settingsSchema fields into installer cards
1837
+ */
1838
+ 'settingsSections'?: Array<AppSettingsSection>;
1839
+ /**
1840
+ * External OAuth providers installers can Connect (name/logo only; no secrets)
1841
+ */
1842
+ 'externalOAuthProviders'?: Array<AppExternalOAuthProviderSummaryDTO>;
1843
+ /**
1844
+ * Webhook rate limit per minute
1845
+ */
1846
+ 'webhookRateLimitPerMinute'?: number;
1847
+ /**
1848
+ * App job enqueue rate limit per minute per installation
1849
+ */
1850
+ 'jobRateLimitPerMinute'?: number;
1851
+ /**
1852
+ * Publish and review state for the app in the marketplace (creator view)
1853
+ */
1854
+ 'appPublish'?: AppPublishDTO;
1855
+ /**
1856
+ * Installation link (company–app) with token, scopes, and per-installation settingsValues; present when includeSettings is true
1857
+ */
1858
+ 'hasApp'?: HasAppDTO;
1859
+ /**
1860
+ * URL to the application\'s image or icon (derived from details.image)
1861
+ */
1862
+ 'image'?: string;
1863
+ /**
1864
+ * URL where the application can be accessed (derived from details.url)
1865
+ */
1866
+ 'url'?: string;
1867
+ /**
1868
+ * Category the application belongs to (derived from details.category)
1869
+ */
1870
+ 'category'?: string;
1871
+ /**
1872
+ * Whether the app is installed for the current company
1873
+ */
1874
+ 'installed'?: boolean;
1875
+ /**
1876
+ * Required scopes requested by the app (macro patterns or concrete scope strings).
1877
+ */
1878
+ 'requiredScopes'?: Array<string>;
1879
+ /**
1880
+ * Resolved concrete required scopes derived from requiredScopes and dynamic availableScopes.
1881
+ */
1882
+ 'resolvedRequiredScopes'?: Array<string>;
1883
+ /**
1884
+ * App credentials: NONE for platform-managed installation tokens, API_KEY (legacy default), or OAUTH2
1761
1885
  */
1762
1886
  'authMethod'?: CreatePrivateAppRequestAuthMethodEnum;
1763
1887
  /**
1764
- * Registered OAuth redirect URIs (required when authMethod is OAUTH2)
1888
+ * OAuth 2.0 client identifier (OAuth apps only)
1889
+ */
1890
+ 'oauthClientId'?: string;
1891
+ /**
1892
+ * OAuth 2.0 client secret; only returned once on create or secret rotation
1893
+ */
1894
+ 'oauthClientSecret'?: string;
1895
+ /**
1896
+ * Whether an OAuth client secret is stored for this app (plain value is not re-readable)
1897
+ */
1898
+ 'oauthClientSecretConfigured'?: boolean;
1899
+ /**
1900
+ * Registered OAuth redirect URIs (OAuth apps only)
1765
1901
  */
1766
1902
  'oauthRedirectUris'?: Array<string>;
1767
1903
  /**
1768
- * Ignored; new private apps are always platform version 2 (async container runtime).
1904
+ * OAuth authorization endpoint URL
1905
+ */
1906
+ 'oauthAuthorizeUrl'?: string;
1907
+ /**
1908
+ * OAuth token endpoint URL
1909
+ */
1910
+ 'oauthTokenUrl'?: string;
1911
+ /**
1912
+ * External URL where end users install this app (e.g. ChatGPT connector page)
1913
+ */
1914
+ 'installUrl'?: string;
1915
+ /**
1916
+ * Square brandmark URL used in compact app surfaces
1917
+ */
1918
+ 'brandmark'?: string;
1919
+ /**
1920
+ * Internal app description used in Caraer admin views
1921
+ */
1922
+ 'description'?: string;
1923
+ /**
1924
+ * App platform version: 1 = legacy per-function Cloud Functions; 2 = one container per app
1769
1925
  */
1770
1926
  'platformVersion'?: number;
1771
1927
  /**
1772
- * Serverless runtime for the app: nodejs22 or python312. Defaults to nodejs22.
1928
+ * Serverless runtime for platform V2 apps (nodejs22 or python312)
1773
1929
  */
1774
1930
  'runtime'?: string;
1931
+ /**
1932
+ * Base HTTPS URL of the V2 app container runtime
1933
+ */
1934
+ 'runtimeBaseUrl'?: string;
1935
+ /**
1936
+ * Last deployed runtime revision id
1937
+ */
1938
+ 'runtimeRevision'?: string;
1939
+ /**
1940
+ * V2 runtime status: PENDING, PROVISIONING, READY, FAILED
1941
+ */
1942
+ 'runtimeStatus'?: string;
1943
+ /**
1944
+ * Last V2 runtime error message when FAILED
1945
+ */
1946
+ 'runtimeError'?: string;
1947
+ /**
1948
+ * Monotonic generation for async runtime jobs
1949
+ */
1950
+ 'runtimeGeneration'?: number;
1775
1951
  }
1776
1952
  export declare const CreatePrivateAppRequestAuthMethodEnum: {
1777
1953
  readonly None: "NONE";
@@ -2587,8 +2763,8 @@ export declare const EventRsvpRequestScopeEnum: {
2587
2763
  export type EventRsvpRequestScopeEnum = typeof EventRsvpRequestScopeEnum[keyof typeof EventRsvpRequestScopeEnum];
2588
2764
  export interface ExistingWidgetSummary {
2589
2765
  'yproperty'?: string;
2590
- 'ymetric'?: string;
2591
2766
  'xproperty'?: string;
2767
+ 'ymetric'?: string;
2592
2768
  'title'?: string;
2593
2769
  'chartType'?: string;
2594
2770
  'xProperty'?: string;
@@ -5833,8 +6009,8 @@ export interface SettingField {
5833
6009
  'hidden'?: boolean;
5834
6010
  'disabled'?: boolean;
5835
6011
  'options'?: Array<SettingOption>;
5836
- 'defaultValue'?: any;
5837
6012
  'value'?: any;
6013
+ 'defaultValue'?: any;
5838
6014
  }
5839
6015
  export declare const SettingFieldTypeEnum: {
5840
6016
  readonly String: "STRING";
@@ -9326,7 +9502,7 @@ export declare const ApplicationsApiAxiosParamCreator: (configuration?: Configur
9326
9502
  */
9327
9503
  createAppWebhookForApp: (appUuid: string, subscribeWebhookDTO: SubscribeWebhookDTO, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
9328
9504
  /**
9329
- * 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.
9505
+ * 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.
9330
9506
  * @summary Create a private app
9331
9507
  * @param {CreatePrivateAppRequest} createPrivateAppRequest
9332
9508
  * @param {*} [options] Override http request option.
@@ -9602,7 +9778,7 @@ export declare const ApplicationsApiFp: (configuration?: Configuration) => {
9602
9778
  */
9603
9779
  createAppWebhookForApp(appUuid: string, subscribeWebhookDTO: SubscribeWebhookDTO, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<CreateResponse>>;
9604
9780
  /**
9605
- * 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.
9781
+ * 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.
9606
9782
  * @summary Create a private app
9607
9783
  * @param {CreatePrivateAppRequest} createPrivateAppRequest
9608
9784
  * @param {*} [options] Override http request option.
@@ -9886,7 +10062,7 @@ export declare const ApplicationsApiFactory: (configuration?: Configuration, bas
9886
10062
  */
9887
10063
  createAppWebhookForApp(appUuid: string, subscribeWebhookDTO: SubscribeWebhookDTO, options?: RawAxiosRequestConfig): AxiosPromise<CreateResponse>;
9888
10064
  /**
9889
- * 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.
10065
+ * 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.
9890
10066
  * @summary Create a private app
9891
10067
  * @param {CreatePrivateAppRequest} createPrivateAppRequest
9892
10068
  * @param {*} [options] Override http request option.
@@ -10170,7 +10346,7 @@ export declare class ApplicationsApi extends BaseAPI {
10170
10346
  */
10171
10347
  createAppWebhookForApp(appUuid: string, subscribeWebhookDTO: SubscribeWebhookDTO, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<CreateResponse, any, {}>>;
10172
10348
  /**
10173
- * 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.
10349
+ * 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.
10174
10350
  * @summary Create a private app
10175
10351
  * @param {CreatePrivateAppRequest} createPrivateAppRequest
10176
10352
  * @param {*} [options] Override http request option.
package/dist/esm/api.js CHANGED
@@ -1881,7 +1881,7 @@ export const ApplicationsApiAxiosParamCreator = function (configuration) {
1881
1881
  };
1882
1882
  }),
1883
1883
  /**
1884
- * 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.
1884
+ * 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.
1885
1885
  * @summary Create a private app
1886
1886
  * @param {CreatePrivateAppRequest} createPrivateAppRequest
1887
1887
  * @param {*} [options] Override http request option.
@@ -2995,7 +2995,7 @@ export const ApplicationsApiFp = function (configuration) {
2995
2995
  });
2996
2996
  },
2997
2997
  /**
2998
- * 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.
2998
+ * 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.
2999
2999
  * @summary Create a private app
3000
3000
  * @param {CreatePrivateAppRequest} createPrivateAppRequest
3001
3001
  * @param {*} [options] Override http request option.
@@ -3516,7 +3516,7 @@ export const ApplicationsApiFactory = function (configuration, basePath, axios)
3516
3516
  return localVarFp.createAppWebhookForApp(appUuid, subscribeWebhookDTO, options).then((request) => request(axios, basePath));
3517
3517
  },
3518
3518
  /**
3519
- * 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.
3519
+ * 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.
3520
3520
  * @summary Create a private app
3521
3521
  * @param {CreatePrivateAppRequest} createPrivateAppRequest
3522
3522
  * @param {*} [options] Override http request option.
@@ -3855,7 +3855,7 @@ export class ApplicationsApi extends BaseAPI {
3855
3855
  return ApplicationsApiFp(this.configuration).createAppWebhookForApp(appUuid, subscribeWebhookDTO, options).then((request) => request(this.axios, this.basePath));
3856
3856
  }
3857
3857
  /**
3858
- * 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.
3858
+ * 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.
3859
3859
  * @summary Create a private app
3860
3860
  * @param {CreatePrivateAppRequest} createPrivateAppRequest
3861
3861
  * @param {*} [options] Override http request option.
@@ -99,7 +99,7 @@ const { status, data } = await apiInstance.createAppWebhookForApp(
99
99
  # **createPrivateApp**
100
100
  > CreateResponse createPrivateApp(createPrivateAppRequest)
101
101
 
102
- 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.
102
+ 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.
103
103
 
104
104
  ### Example
105
105
 
@@ -16,6 +16,7 @@ Name | Type | Description | Notes
16
16
  **deletedAt** | **number** | Unix timestamp when the entity was deleted (null if not deleted) | [optional] [default to undefined]
17
17
  **deletedBy** | [**ModelRecord**](ModelRecord.md) | Identifier of the user who deleted the entity | [optional] [default to undefined]
18
18
  **index** | **number** | Index number for ordering entities | [optional] [default to undefined]
19
+ **subdomain** | **string** | The company\&#39;s canonical subdomain, independent of website settings. | [optional] [readonly] [default to undefined]
19
20
  **details** | [**CompanyDetailsDTO**](CompanyDetailsDTO.md) | The details of the company. | [optional] [default to undefined]
20
21
  **digitalIdentity** | [**DigitalIdentityDTO**](DigitalIdentityDTO.md) | The digital identity of the company. | [optional] [default to undefined]
21
22
  **websiteSettings** | [**WebsiteSettingsDTO**](WebsiteSettingsDTO.md) | The website settings of the company. | [optional] [default to undefined]
@@ -41,6 +42,7 @@ const instance: CompanyDTO = {
41
42
  deletedAt,
42
43
  deletedBy,
43
44
  index,
45
+ subdomain,
44
46
  details,
45
47
  digitalIdentity,
46
48
  websiteSettings,
@@ -1,17 +1,60 @@
1
1
  # CreatePrivateAppRequest
2
2
 
3
- Private app creation request with label and optional description
3
+ Private app creator manifest; label is required and internal name is optional
4
4
 
5
5
  ## Properties
6
6
 
7
7
  Name | Type | Description | Notes
8
8
  ------------ | ------------- | ------------- | -------------
9
- **label** | **string** | The display label for the private app. | [default to undefined]
10
- **description** | **string** | Optional description text for the app. | [optional] [default to undefined]
11
- **authMethod** | **string** | Authentication method (API_KEY default, OAUTH2 for OAuth 2.0) | [optional] [default to undefined]
12
- **oauthRedirectUris** | **Array&lt;string&gt;** | Registered OAuth redirect URIs (required when authMethod is OAUTH2) | [optional] [default to undefined]
13
- **platformVersion** | **number** | Ignored; new private apps are always platform version 2 (async container runtime). | [optional] [default to undefined]
14
- **runtime** | **string** | Serverless runtime for the app: nodejs22 or python312. Defaults to nodejs22. | [optional] [default to undefined]
9
+ **uuid** | **string** | Unique identifier for the entity | [default to undefined]
10
+ **name** | **string** | The name of the entity | [default to undefined]
11
+ **label** | **string** | Display label for the entity, can be different from name | [default to undefined]
12
+ **createdAt** | **number** | Unix timestamp when the entity was created | [optional] [default to undefined]
13
+ **createdBy** | [**ModelRecord**](ModelRecord.md) | Identifier of the user who created the entity | [optional] [default to undefined]
14
+ **updatedAt** | **number** | Unix timestamp when the entity was last updated | [optional] [default to undefined]
15
+ **updatedBy** | [**ModelRecord**](ModelRecord.md) | Identifier of the user who last updated the entity | [optional] [default to undefined]
16
+ **deletedAt** | **number** | Unix timestamp when the entity was deleted (null if not deleted) | [optional] [default to undefined]
17
+ **deletedBy** | [**ModelRecord**](ModelRecord.md) | Identifier of the user who deleted the entity | [optional] [default to undefined]
18
+ **index** | **number** | Index number for ordering entities | [optional] [default to undefined]
19
+ **privateApp** | **boolean** | Indicates whether this app is private (only available to the creator\&#39;s company) | [optional] [default to undefined]
20
+ **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]
21
+ **details** | [**AppDetailsDTO**](AppDetailsDTO.md) | Additional details and specifications about the application | [optional] [default to undefined]
22
+ **appBars** | [**Array&lt;AppBarDTO&gt;**](AppBarDTO.md) | App bars (location-specific configuration and actions) | [optional] [default to undefined]
23
+ **serverlessFunctions** | [**Array&lt;ServerlessFunctionDTO&gt;**](ServerlessFunctionDTO.md) | Serverless functions owned by this app | [optional] [default to undefined]
24
+ **installWebhook** | [**SubscribeWebhookDTO**](SubscribeWebhookDTO.md) | Webhook triggered when the app is installed | [optional] [default to undefined]
25
+ **uninstallWebhook** | [**SubscribeWebhookDTO**](SubscribeWebhookDTO.md) | Webhook triggered when the app is uninstalled | [optional] [default to undefined]
26
+ **rotateWebhook** | [**SubscribeWebhookDTO**](SubscribeWebhookDTO.md) | Webhook triggered when the app installation token is rotated | [optional] [default to undefined]
27
+ **updateWebhook** | [**SubscribeWebhookDTO**](SubscribeWebhookDTO.md) | Webhook triggered when an already installed app is saved again | [optional] [default to undefined]
28
+ **settingsSchema** | [**Array&lt;AppSettingFieldSchema&gt;**](AppSettingFieldSchema.md) | JSON array of AppSettingFieldSchema (app-level setting field definitions) | [optional] [default to undefined]
29
+ **settingsSections** | [**Array&lt;AppSettingsSection&gt;**](AppSettingsSection.md) | Optional UI grouping of settingsSchema fields into installer cards | [optional] [default to undefined]
30
+ **externalOAuthProviders** | [**Array&lt;AppExternalOAuthProviderSummaryDTO&gt;**](AppExternalOAuthProviderSummaryDTO.md) | External OAuth providers installers can Connect (name/logo only; no secrets) | [optional] [default to undefined]
31
+ **webhookRateLimitPerMinute** | **number** | Webhook rate limit per minute | [optional] [default to undefined]
32
+ **jobRateLimitPerMinute** | **number** | App job enqueue rate limit per minute per installation | [optional] [default to undefined]
33
+ **appPublish** | [**AppPublishDTO**](AppPublishDTO.md) | Publish and review state for the app in the marketplace (creator view) | [optional] [default to undefined]
34
+ **hasApp** | [**HasAppDTO**](HasAppDTO.md) | Installation link (company–app) with token, scopes, and per-installation settingsValues; present when includeSettings is true | [optional] [default to undefined]
35
+ **image** | **string** | URL to the application\&#39;s image or icon (derived from details.image) | [optional] [default to undefined]
36
+ **url** | **string** | URL where the application can be accessed (derived from details.url) | [optional] [default to undefined]
37
+ **category** | **string** | Category the application belongs to (derived from details.category) | [optional] [default to undefined]
38
+ **installed** | **boolean** | Whether the app is installed for the current company | [optional] [default to undefined]
39
+ **requiredScopes** | **Array&lt;string&gt;** | Required scopes requested by the app (macro patterns or concrete scope strings). | [optional] [default to undefined]
40
+ **resolvedRequiredScopes** | **Array&lt;string&gt;** | Resolved concrete required scopes derived from requiredScopes and dynamic availableScopes. | [optional] [default to undefined]
41
+ **authMethod** | **string** | App credentials: NONE for platform-managed installation tokens, API_KEY (legacy default), or OAUTH2 | [optional] [default to undefined]
42
+ **oauthClientId** | **string** | OAuth 2.0 client identifier (OAuth apps only) | [optional] [default to undefined]
43
+ **oauthClientSecret** | **string** | OAuth 2.0 client secret; only returned once on create or secret rotation | [optional] [default to undefined]
44
+ **oauthClientSecretConfigured** | **boolean** | Whether an OAuth client secret is stored for this app (plain value is not re-readable) | [optional] [default to undefined]
45
+ **oauthRedirectUris** | **Array&lt;string&gt;** | Registered OAuth redirect URIs (OAuth apps only) | [optional] [default to undefined]
46
+ **oauthAuthorizeUrl** | **string** | OAuth authorization endpoint URL | [optional] [default to undefined]
47
+ **oauthTokenUrl** | **string** | OAuth token endpoint URL | [optional] [default to undefined]
48
+ **installUrl** | **string** | External URL where end users install this app (e.g. ChatGPT connector page) | [optional] [default to undefined]
49
+ **brandmark** | **string** | Square brandmark URL used in compact app surfaces | [optional] [default to undefined]
50
+ **description** | **string** | Internal app description used in Caraer admin views | [optional] [default to undefined]
51
+ **platformVersion** | **number** | App platform version: 1 &#x3D; legacy per-function Cloud Functions; 2 &#x3D; one container per app | [optional] [default to undefined]
52
+ **runtime** | **string** | Serverless runtime for platform V2 apps (nodejs22 or python312) | [optional] [default to undefined]
53
+ **runtimeBaseUrl** | **string** | Base HTTPS URL of the V2 app container runtime | [optional] [default to undefined]
54
+ **runtimeRevision** | **string** | Last deployed runtime revision id | [optional] [default to undefined]
55
+ **runtimeStatus** | **string** | V2 runtime status: PENDING, PROVISIONING, READY, FAILED | [optional] [default to undefined]
56
+ **runtimeError** | **string** | Last V2 runtime error message when FAILED | [optional] [default to undefined]
57
+ **runtimeGeneration** | **number** | Monotonic generation for async runtime jobs | [optional] [default to undefined]
15
58
 
16
59
  ## Example
17
60
 
@@ -19,12 +62,55 @@ Name | Type | Description | Notes
19
62
  import { CreatePrivateAppRequest } from '@caraer/client';
20
63
 
21
64
  const instance: CreatePrivateAppRequest = {
65
+ uuid,
66
+ name,
22
67
  label,
23
- description,
68
+ createdAt,
69
+ createdBy,
70
+ updatedAt,
71
+ updatedBy,
72
+ deletedAt,
73
+ deletedBy,
74
+ index,
75
+ privateApp,
76
+ hideApiKeyField,
77
+ details,
78
+ appBars,
79
+ serverlessFunctions,
80
+ installWebhook,
81
+ uninstallWebhook,
82
+ rotateWebhook,
83
+ updateWebhook,
84
+ settingsSchema,
85
+ settingsSections,
86
+ externalOAuthProviders,
87
+ webhookRateLimitPerMinute,
88
+ jobRateLimitPerMinute,
89
+ appPublish,
90
+ hasApp,
91
+ image,
92
+ url,
93
+ category,
94
+ installed,
95
+ requiredScopes,
96
+ resolvedRequiredScopes,
24
97
  authMethod,
98
+ oauthClientId,
99
+ oauthClientSecret,
100
+ oauthClientSecretConfigured,
25
101
  oauthRedirectUris,
102
+ oauthAuthorizeUrl,
103
+ oauthTokenUrl,
104
+ installUrl,
105
+ brandmark,
106
+ description,
26
107
  platformVersion,
27
108
  runtime,
109
+ runtimeBaseUrl,
110
+ runtimeRevision,
111
+ runtimeStatus,
112
+ runtimeError,
113
+ runtimeGeneration,
28
114
  };
29
115
  ```
30
116
 
@@ -6,8 +6,8 @@
6
6
  Name | Type | Description | Notes
7
7
  ------------ | ------------- | ------------- | -------------
8
8
  **yproperty** | **string** | | [optional] [default to undefined]
9
- **ymetric** | **string** | | [optional] [default to undefined]
10
9
  **xproperty** | **string** | | [optional] [default to undefined]
10
+ **ymetric** | **string** | | [optional] [default to undefined]
11
11
  **title** | **string** | | [optional] [default to undefined]
12
12
  **chartType** | **string** | | [optional] [default to undefined]
13
13
  **xProperty** | **string** | | [optional] [default to undefined]
@@ -21,8 +21,8 @@ import { ExistingWidgetSummary } from '@caraer/client';
21
21
 
22
22
  const instance: ExistingWidgetSummary = {
23
23
  yproperty,
24
- ymetric,
25
24
  xproperty,
25
+ ymetric,
26
26
  title,
27
27
  chartType,
28
28
  xProperty,
@@ -14,8 +14,8 @@ Name | Type | Description | Notes
14
14
  **hidden** | **boolean** | | [optional] [default to undefined]
15
15
  **disabled** | **boolean** | | [optional] [default to undefined]
16
16
  **_options** | [**Array&lt;SettingOption&gt;**](SettingOption.md) | | [optional] [default to undefined]
17
- **defaultValue** | **any** | | [optional] [default to undefined]
18
17
  **value** | **any** | | [optional] [default to undefined]
18
+ **defaultValue** | **any** | | [optional] [default to undefined]
19
19
 
20
20
  ## Example
21
21
 
@@ -32,8 +32,8 @@ const instance: SettingField = {
32
32
  hidden,
33
33
  disabled,
34
34
  _options,
35
- defaultValue,
36
35
  value,
36
+ defaultValue,
37
37
  };
38
38
  ```
39
39
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@caraer/client",
3
- "version": "2.0.574",
3
+ "version": "2.0.576",
4
4
  "description": "Generated TypeScript client for the Caraer API",
5
5
  "author": "OpenAPI-Generator Contributors",
6
6
  "repository": {