@epilot/sdk 2.4.4-alpha.0 → 2.5.0

package/dist/app.d--5n0FQQ4.d.cts

@@ -0,0 +1,3757 @@
+import { OpenAPIClient, Parameters, AxiosRequestConfig, OperationResponse, UnknownParamsObject } from 'openapi-client-axios';
+
+/* Auto-copied from app-client */
+
+
+declare namespace Components {
+    namespace RequestBodies {
+        export interface CreateBundlePresignedRequest {
+            /**
+             * Version of the app
+             */
+            version: string;
+            /**
+             * ID of the journey block component
+             */
+            component_id?: string;
+        }
+        export interface CreateConfigRequest {
+            /**
+             * Name of the app
+             */
+            name: string;
+            description: Schemas.TranslatedString;
+            category?: string;
+            /**
+             * S3 key of the logo file
+             */
+            logo_url_key?: string;
+        }
+        export interface CreateLogoPresignedRequest {
+            /**
+             * Original filename of the logo
+             * example:
+             * company-logo.png
+             */
+            filename: string;
+            /**
+             * MIME type of the logo file
+             * example:
+             * image/png
+             */
+            mime_type: "image/png" | "image/jpeg" | "image/jpg";
+        }
+        export interface CreateReviewRequest {
+            /**
+             * Email of the technical contact
+             */
+            technical_contact: string;
+            /**
+             * Email of the marketing contact
+             */
+            marketing_contact: string;
+            /**
+             * URL to a demo of the app
+             */
+            demo_url?: string;
+        }
+        export interface InstallRequest {
+            /**
+             * Version of the app to update to
+             */
+            version?: string;
+            /**
+             * Configuration values for the app components
+             */
+            option_values?: Schemas.OptionsRef[];
+            /**
+             * Manifest ID used to create/update the entity
+             */
+            _manifest?: string /* uuid */[];
+        }
+        export interface PatchConfigMetadataRequest {
+            /**
+             * Name of the app
+             */
+            name?: string;
+            description?: Schemas.TranslatedString;
+            category?: string;
+            documentation_url?: string;
+            notifications?: Schemas.NotificationConfig;
+            pricing?: Schemas.Pricing;
+            /**
+             * S3 key of the logo file
+             */
+            logo_url_key?: string;
+            /**
+             * Email address for support requests
+             */
+            support_email?: string;
+            /**
+             * Flag to indicate if the app is in dev mode. If true, the app takes the override properties of components into account.
+             */
+            dev_mode?: boolean;
+        }
+        export interface PatchVersionRequest {
+            /**
+             * ID of the manifest to use for this version
+             */
+            manifest_id?: string;
+            /**
+             * Name of the role
+             */
+            role_id?: string | null;
+            grants?: /* Required grants for the app in order to call APIs for the installing tenant */ Schemas.Grants;
+        }
+        export type UpsertComponentRequest = Schemas.BaseComponent;
+    }
+    namespace Schemas {
+        export interface Actor {
+            /**
+             * Organization ID of the actor
+             */
+            org_id?: string;
+            /**
+             * User ID of the actor
+             */
+            user_id?: string;
+            /**
+             * Type of the actor (e.g., user, system)
+             */
+            type: "user" | "system";
+        }
+        export interface AggregatedEvents {
+            type?: "aggregated";
+            groups?: {
+                /**
+                 * The grouped dimensions e.g., "source": "CUSTOM_JOURNEY_BLOCK", "event_type": "ERROR"
+                 */
+                dimensions?: {
+                    [name: string]: any;
+                };
+                metrics?: {
+                    count?: number;
+                    error_rate?: number;
+                };
+            }[];
+        }
+        export interface ApiProxyComponent {
+            component_type: "API_PROXY";
+            configuration: /* Configuration for an API proxy component */ ApiProxyConfig;
+        }
+        /**
+         * Configuration for an API proxy component
+         */
+        export interface ApiProxyConfig {
+            /**
+             * Human-friendly proxy name used in SDK calls
+             */
+            name: string; // ^[a-zA-Z0-9_-]+$
+            /**
+             * Base URL of the target API. Must be HTTPS.
+             */
+            target: string; // uri ^https://
+            /**
+             * Authentication strategy
+             */
+            auth_type: "header" | "bearer" | "oauth2" | "none";
+            /**
+             * Header name for 'header' auth type
+             */
+            auth_header?: string;
+            /**
+             * OAuth2 token endpoint URL
+             */
+            token_url?: string; // uri ^https://
+        }
+        export interface AppBridgeSurfaceConfig {
+            /**
+             * URL of the uploaded App Bridge App. This is the entrypoint for the app
+             */
+            app_url?: string;
+            /**
+             * URL of the uploaded zip file containing the app
+             */
+            zip_url?: string;
+            /**
+             * URL of the app in dev mode
+             */
+            override_url?: string;
+        }
+        export interface AppEventData {
+            /**
+             * ID of the app configuration
+             */
+            app_id: string;
+            /**
+             * Version of the app configuration
+             */
+            version: string;
+            event_id?: string;
+            component_id: string;
+            timestamp?: string;
+            correlation_id?: string;
+            event_type: "ERROR" | "WARNING" | "INFO";
+            source: /* Type of app component */ ComponentType;
+            actor: Actor;
+            /**
+             * Details about the event
+             */
+            details?: {
+                [name: string]: any;
+            };
+        }
+        export interface Audit {
+            /**
+             * Timestamp of the creation
+             */
+            created_at?: string;
+            /**
+             * User ID of the creator
+             */
+            created_by?: string;
+            /**
+             * Timestamp of the last update
+             */
+            updated_at?: string;
+            /**
+             * User ID of the last updater
+             */
+            updated_by?: string;
+        }
+        export interface Author {
+            /**
+             * Name of the author
+             */
+            name?: string;
+            /**
+             * Company of the author
+             */
+            company: string;
+            /**
+             * Email of the author
+             */
+            email?: string;
+        }
+        export type BaseComponent = {
+            /**
+             * Unique identifier for the component
+             */
+            id: string;
+            /**
+             * Name of the component
+             */
+            name?: {
+                /**
+                 * English translation
+                 */
+                en?: string | null;
+                /**
+                 * German translation
+                 */
+                de: string;
+            };
+            /**
+             * Description of the component
+             */
+            description?: {
+                /**
+                 * English translation
+                 */
+                en?: string | null;
+                /**
+                 * German translation
+                 */
+                de: string;
+            };
+            /**
+             * List of options for the app component
+             */
+            options?: /* Options for the component configuration */ Options[];
+            surfaces?: {
+                [key: string]: any;
+            };
+        } & (JourneyBlockComponent | PortalBlockComponent | PortalExtensionComponent | CustomFlowActionComponent | ErpInformToolkitComponent | CustomCapabilityComponent | ExternalProductCatalogComponent | CustomPageComponent | ApiProxyComponent);
+        export interface BaseComponentCommon {
+            /**
+             * Unique identifier for the component
+             */
+            id: string;
+            /**
+             * Name of the component
+             */
+            name?: {
+                /**
+                 * English translation
+                 */
+                en?: string | null;
+                /**
+                 * German translation
+                 */
+                de: string;
+            };
+            /**
+             * Description of the component
+             */
+            description?: {
+                /**
+                 * English translation
+                 */
+                en?: string | null;
+                /**
+                 * German translation
+                 */
+                de: string;
+            };
+            /**
+             * List of options for the app component
+             */
+            options?: /* Options for the component configuration */ Options[];
+            surfaces?: {
+                [key: string]: any;
+            };
+        }
+        export interface BaseCustomActionConfig {
+            /**
+             * Name of the custom action
+             */
+            name?: string;
+            /**
+             * Description of the custom action
+             */
+            description?: string;
+            /**
+             * Wait for callback_url to be called before completing the action
+             */
+            wait_for_callback?: boolean;
+        }
+        export interface BatchEventRequest {
+            events: [
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?,
+                AppEventData?
+            ];
+        }
+        /**
+         * How often the subscription is billed
+         */
+        export type BillingFrequency = "MONTHLY" | "QUARTERLY" | "YEARLY" | "CUSTOM";
+        /**
+         * References another journey block by its ID. The configuring user picks
+         * a block from the journey via a dropdown in the journey-builder; the
+         * chosen block's ID is stored as the arg value (a string). The bundle can
+         * then call `subscribe(blockId, cb)` / `getValue(blockId)` against that ID.
+         *
+         */
+        export interface BlockReferenceArg {
+            type?: "block_reference";
+            /**
+             * Restrict the picker to blocks of these journey block types
+             * (e.g. ["availability-check", "address"]). Omit to allow any type.
+             *
+             */
+            allowed_types?: string[];
+        }
+        export interface BlueprintRef {
+            /**
+             * ID of the blueprint
+             */
+            manifest_id?: string;
+            /**
+             * ID of the job that created the blueprint
+             */
+            job_id?: string;
+            /**
+             * S3 key of a pre-exported blueprint zip used for cross-org installs
+             */
+            source_blueprint_file?: string;
+        }
+        export interface BooleanArg {
+            type?: "boolean";
+        }
+        export interface CallerIdentity {
+            /**
+             * a human readable name of the caller (e.g. user name, token name or email address)
+             * example:
+             * manifest@epilot.cloud
+             */
+            name?: any;
+            /**
+             * epilot organization id
+             * example:
+             * 911690
+             */
+            org_id: string;
+            /**
+             * epilot user id, when called by a user
+             * example:
+             * 11001045
+             */
+            user_id?: string;
+            /**
+             * token id, when called by API token
+             * example:
+             * api_5ZugdRXasLfWBypHi93Fk
+             */
+            token_id?: string;
+        }
+        /**
+         * Type of app component
+         */
+        export type ComponentType = "CUSTOM_JOURNEY_BLOCK" | "CUSTOM_PORTAL_BLOCK" | "PORTAL_EXTENSION" | "CUSTOM_FLOW_ACTION" | "ERP_INFORM_TOOLKIT" | "CUSTOM_CAPABILITY" | "EXTERNAL_PRODUCT_CATALOG" | "CUSTOM_PAGE" | "API_PROXY";
+        /**
+         * Configuration of the published app
+         */
+        export interface Configuration {
+            app_id: string;
+            /**
+             * Name of the app
+             */
+            name: string;
+            author?: Author;
+            /**
+             * Flag to indicate if the app is in dev mode. If true, the app takes the override_url property of components into account.
+             */
+            dev_mode?: boolean;
+            /**
+             * List of available versions of the app
+             */
+            versions: string[];
+            /**
+             * List of available public versions of the app
+             */
+            public_versions?: string[];
+            /**
+             * Email address for support requests
+             */
+            support_email?: string;
+            /**
+             * Latest version of the app
+             */
+            latest_version: string;
+            /**
+             * Category of the app.
+             */
+            category?: string;
+            /**
+             * URL of the app icon.
+             */
+            icon_url?: string;
+            /**
+             * URL of the app documentation.
+             */
+            documentation_url?: string;
+            /**
+             * Markdown description of the app.
+             */
+            description: {
+                /**
+                 * English translation
+                 */
+                en?: string | null;
+                /**
+                 * German translation
+                 */
+                de: string;
+            };
+            /**
+             * Configuration for developer notifications
+             */
+            notifications?: {
+                /**
+                 * Email address to receive notifications
+                 * example:
+                 * developer@example.com
+                 */
+                email?: string; // email
+                /**
+                 * List of events to subscribe to
+                 */
+                events?: NotificationEvent[];
+            };
+            /**
+             * Organization ID of the app owner
+             */
+            owner_org_id: string;
+            /**
+             * Flag to indicate if the app is built by epilot.
+             */
+            internal?: boolean;
+            /**
+             * Pricing information for the app
+             */
+            pricing?: {
+                pricing_type?: "FREE" | "SUBSCRIPTION" | "USAGE_BASED" | "ONE_TIME" | "CUSTOM" | "UNKNOWN";
+                billing_frequency?: /* How often the subscription is billed */ BillingFrequency;
+            };
+            /**
+             * Audit information for the app
+             */
+            configuration_audit?: {
+                /**
+                 * Timestamp of the creation
+                 */
+                created_at?: string;
+                /**
+                 * User ID of the creator
+                 */
+                created_by?: string;
+                /**
+                 * Timestamp of the last update
+                 */
+                updated_at?: string;
+                /**
+                 * User ID of the last updater
+                 */
+                updated_by?: string;
+            };
+            components: BaseComponent[];
+            /**
+             * Visibility of the app version
+             */
+            visibility?: "public" | "private";
+            /**
+             * Flag to indicate if the app is public.
+             */
+            public?: boolean;
+            /**
+             * Flag to indicate if the app is pending for verification
+             */
+            pending?: boolean;
+            /**
+             * Version of the app that is installed
+             */
+            version: string;
+            /**
+             * Flag to indicate if the app is in beta.
+             */
+            is_beta?: boolean;
+            /**
+             * Timestamp when the app version is deprecated
+             */
+            deprecated_at?: string;
+            /**
+             * Changelog for the app version
+             */
+            changelog?: string;
+            /**
+             * Status of the review process
+             */
+            review_status?: "approved" | "rejected" | "pending";
+            role?: Role;
+            blueprint_ref?: BlueprintRef;
+            version_audit: {
+                /**
+                 * Timestamp of the creation
+                 */
+                created_at?: string;
+                /**
+                 * User ID of the creator
+                 */
+                created_by?: string;
+                /**
+                 * Timestamp of the last update
+                 */
+                updated_at?: string;
+                /**
+                 * User ID of the last updater
+                 */
+                updated_by?: string;
+                /**
+                 * Timestamp of the last version update
+                 */
+                versioned_at?: string;
+                /**
+                 * User ID of the user who last updated the app
+                 */
+                versioned_by?: string;
+            };
+        }
+        /**
+         * Basic metadata about your app configuration which does not get versioned
+         */
+        export interface ConfigurationMetadata {
+            app_id: string;
+            /**
+             * Name of the app
+             */
+            name: string;
+            author?: Author;
+            /**
+             * Flag to indicate if the app is in dev mode. If true, the app takes the override_url property of components into account.
+             */
+            dev_mode?: boolean;
+            /**
+             * List of available versions of the app
+             */
+            versions: string[];
+            /**
+             * List of available public versions of the app
+             */
+            public_versions?: string[];
+            /**
+             * Email address for support requests
+             */
+            support_email?: string;
+            /**
+             * Latest version of the app
+             */
+            latest_version: string;
+            /**
+             * Category of the app.
+             */
+            category?: string;
+            /**
+             * URL of the app icon.
+             */
+            icon_url?: string;
+            /**
+             * URL of the app documentation.
+             */
+            documentation_url?: string;
+            /**
+             * Markdown description of the app.
+             */
+            description: {
+                /**
+                 * English translation
+                 */
+                en?: string | null;
+                /**
+                 * German translation
+                 */
+                de: string;
+            };
+            /**
+             * Configuration for developer notifications
+             */
+            notifications?: {
+                /**
+                 * Email address to receive notifications
+                 * example:
+                 * developer@example.com
+                 */
+                email?: string; // email
+                /**
+                 * List of events to subscribe to
+                 */
+                events?: NotificationEvent[];
+            };
+            /**
+             * Organization ID of the app owner, required for private apps or sandbox accounts
+             */
+            owner_org_id: string;
+            /**
+             * Flag to indicate if the app is built by epilot.
+             */
+            internal?: boolean;
+            /**
+             * Pricing information for the app
+             */
+            pricing?: {
+                pricing_type?: "FREE" | "SUBSCRIPTION" | "USAGE_BASED" | "ONE_TIME" | "CUSTOM" | "UNKNOWN";
+                billing_frequency?: /* How often the subscription is billed */ BillingFrequency;
+            };
+            /**
+             * Audit information for the app
+             */
+            configuration_audit?: {
+                /**
+                 * Timestamp of the creation
+                 */
+                created_at?: string;
+                /**
+                 * User ID of the creator
+                 */
+                created_by?: string;
+                /**
+                 * Timestamp of the last update
+                 */
+                updated_at?: string;
+                /**
+                 * User ID of the last updater
+                 */
+                updated_by?: string;
+            };
+        }
+        /**
+         * Configuration data about your app which is versionable
+         */
+        export interface ConfigurationVersion {
+            app_id: string;
+            /**
+             * Organization ID of the app owner
+             */
+            owner_org_id: string;
+            components: BaseComponent[];
+            /**
+             * Visibility of the app version
+             */
+            visibility?: "public" | "private";
+            /**
+             * Flag to indicate if the app is public.
+             */
+            public?: boolean;
+            /**
+             * Flag to indicate if the app is pending for verification
+             */
+            pending?: boolean;
+            /**
+             * Version of the app that is installed
+             */
+            version: string;
+            /**
+             * Flag to indicate if the app is in beta.
+             */
+            is_beta?: boolean;
+            /**
+             * Timestamp when the app version is deprecated
+             */
+            deprecated_at?: string;
+            /**
+             * Changelog for the app version
+             */
+            changelog?: string;
+            /**
+             * Status of the review process
+             */
+            review_status?: "approved" | "rejected" | "pending";
+            role?: Role;
+            blueprint_ref?: BlueprintRef;
+            version_audit: {
+                /**
+                 * Timestamp of the creation
+                 */
+                created_at?: string;
+                /**
+                 * User ID of the creator
+                 */
+                created_by?: string;
+                /**
+                 * Timestamp of the last update
+                 */
+                updated_at?: string;
+                /**
+                 * User ID of the last updater
+                 */
+                updated_by?: string;
+                /**
+                 * Timestamp of the last version update
+                 */
+                versioned_at?: string;
+                /**
+                 * User ID of the user who last updated the app
+                 */
+                versioned_by?: string;
+            };
+        }
+        export interface CustomCapabilityComponent {
+            component_type: "CUSTOM_CAPABILITY";
+            configuration: {
+                /**
+                 * Define what type of capability this is
+                 */
+                type?: "tab" | "group";
+                /**
+                 * Which schemas are supported by the capability. If empty, all schemas are supported.
+                 */
+                allowed_schemas?: string[];
+            };
+            surfaces?: {
+                capability_config?: AppBridgeSurfaceConfig;
+            };
+        }
+        export interface CustomFlowActionComponent {
+            component_type: "CUSTOM_FLOW_ACTION";
+            configuration: CustomFlowConfig;
+            surfaces?: {
+                flow_action_config?: AppBridgeSurfaceConfig;
+            };
+        }
+        export type CustomFlowConfig = ExternalIntegrationCustomActionConfig | SandboxCustomActionConfig;
+        export interface CustomPageComponent {
+            component_type: "CUSTOM_PAGE";
+            configuration: CustomPageConfig;
+            surfaces?: {
+                page?: AppBridgeSurfaceConfig;
+            };
+        }
+        export interface CustomPageConfig {
+            /**
+             * URL slug for the page route. Must be unique per organization.
+             * example:
+             * zapier
+             */
+            slug: string; // ^[a-z0-9][a-z0-9-]*[a-z0-9]$
+            /**
+             * Display label in the navigation sidebar.
+             * example:
+             * Zapier
+             */
+            nav_label?: string;
+            /**
+             * Icon identifier for the navigation item.
+             * example:
+             * zap
+             */
+            nav_icon?: string;
+            /**
+             * Optional tooltip or description for the navigation item.
+             */
+            nav_description?: string;
+        }
+        export interface EnumArg {
+            type?: "enum";
+            /**
+             * If true, allows selection of multiple values
+             */
+            isMulti?: boolean;
+            /**
+             * List of options for enum type
+             */
+            options: [
+                {
+                    /**
+                     * Unique identifier for the option
+                     */
+                    id: string;
+                    /**
+                     * Display label for the option
+                     */
+                    label: {
+                        /**
+                         * English translation
+                         */
+                        en?: string | null;
+                        /**
+                         * German translation
+                         */
+                        de: string;
+                    };
+                },
+                ...{
+                    /**
+                     * Unique identifier for the option
+                     */
+                    id: string;
+                    /**
+                     * Display label for the option
+                     */
+                    label: {
+                        /**
+                         * English translation
+                         */
+                        en?: string | null;
+                        /**
+                         * German translation
+                         */
+                        de: string;
+                    };
+                }[]
+            ];
+        }
+        export interface ErpInformToolkitComponent {
+            component_type: "ERP_INFORM_TOOLKIT";
+            configuration: {
+                type: "inbound" | "outbound";
+            };
+        }
+        export interface EventsQuery {
+            /**
+             * Either use preset OR start+end
+             */
+            time_range?: {
+                /**
+                 * Start time (ISO 8601)
+                 */
+                start?: string; // date-time
+                /**
+                 * End time (ISO 8601)
+                 */
+                end?: string; // date-time
+                /**
+                 * Predefined time range (alternative to start/end)
+                 */
+                preset?: "1h" | "6h" | "24h" | "7d" | "30d";
+            };
+            filters?: {
+                /**
+                 * Filter by component types
+                 */
+                source?: /* Type of app component */ ComponentType[];
+                /**
+                 * Filter by specific component IDs
+                 */
+                component_id?: string[];
+                /**
+                 * Filter by event types
+                 */
+                event_type?: ("ERROR" | "WARNING" | "INFO")[];
+                /**
+                 * Filter by correlation ID for tracing
+                 */
+                correlation_id?: string;
+            };
+            aggregation?: {
+                /**
+                 * Group results by specified fields
+                 */
+                group_by?: ("source" | "component_id" | "event_type" | "hour" | "day")[];
+                /**
+                 * Metrics to calculate
+                 */
+                metrics?: ("count" | "error_rate" | "unique_users")[];
+            };
+            pagination?: {
+                page?: number;
+                page_size?: number;
+            };
+            sort?: {
+                field?: "timestamp" | "event_type" | "component_id";
+                order?: "asc" | "desc";
+            };
+        }
+        export interface EventsQueryResponse {
+            query?: EventsQuery;
+            results?: RawEvents | AggregatedEvents;
+            pagination?: {
+                page?: number;
+                page_size?: number;
+                total_items?: number;
+                has_next?: boolean;
+            };
+        }
+        export interface ExternalIntegrationCustomActionConfig {
+            /**
+             * Name of the custom action
+             */
+            name?: string;
+            /**
+             * Description of the custom action
+             */
+            description?: string;
+            /**
+             * Wait for callback_url to be called before completing the action
+             */
+            wait_for_callback?: boolean;
+            type: "external_integration";
+            external_integration_settings?: {
+                /**
+                 * URL to call
+                 */
+                url?: string;
+                headers?: {
+                    [name: string]: any;
+                };
+            };
+        }
+        export interface ExternalProductCatalogAuthBlock {
+            /**
+             * HTTP method to use for authentication
+             */
+            method?: string;
+            /**
+             * URL to use for authentication. Supports variable interpolation.
+             */
+            url: string;
+            /**
+             * Parameters to append to the URL. Supports variable interpolation.
+             */
+            params?: {
+                [name: string]: string;
+            };
+            /**
+             * Headers to use for authentication. Supports variable interpolation.
+             */
+            headers?: {
+                [name: string]: string;
+            };
+            /**
+             * JSON body to use for authentication. Supports variable interpolation. Content format is determined by Content-Type header.
+             */
+            body?: {
+                [name: string]: any;
+            };
+        }
+        export interface ExternalProductCatalogComponent {
+            component_type: "EXTERNAL_PRODUCT_CATALOG";
+            configuration: ExternalProductCatalogConfig;
+        }
+        export interface ExternalProductCatalogConfig {
+            hooks?: (/**
+             * Hook for getting products from an external catalog. This hook makes a call to retrieve product data from an external source. Check the docs or the response API call contract https://docs.api.epilot.io/pricing-api-external-catalog for more details.
+             *
+             */
+            ExternalProductCatalogHookProducts | /**
+             * Hook for getting product recommendations from an external catalog. This hook makes a call to retrieve product recommendations from an external source. Check the docs or the response API call contract https://docs.api.epilot.io/pricing-api-external-catalog for more details.
+             *
+             */
+            ExternalProductCatalogHookProductRecommendations)[];
+        }
+        /**
+         * Hook for getting product recommendations from an external catalog. This hook makes a call to retrieve product recommendations from an external source. Check the docs or the response API call contract https://docs.api.epilot.io/pricing-api-external-catalog for more details.
+         *
+         */
+        export interface ExternalProductCatalogHookProductRecommendations {
+            /**
+             * Identifier of the hook. Should not change between updates.
+             */
+            id: string; // ^[a-zA-Z0-9_-]+$
+            name?: TranslatedString;
+            type: "product-recommendations";
+            auth?: ExternalProductCatalogAuthBlock;
+            call: {
+                /**
+                 * HTTP method to use for the call
+                 */
+                method?: string;
+                /**
+                 * URL to call. Supports variable interpolation.
+                 */
+                url: string;
+                /**
+                 * Parameters to append to the URL. Supports variable interpolation.
+                 */
+                params?: {
+                    [name: string]: string;
+                };
+                /**
+                 * Headers to use. Supports variable interpolation.
+                 */
+                headers?: {
+                    [name: string]: string;
+                };
+                /**
+                 * JSON body to use for the call. Supports variable interpolation. If empty / not provided, the default request context will be used based on the consumer (e.g. Journey).
+                 */
+                body?: {
+                    [name: string]: any;
+                };
+            };
+        }
+        /**
+         * Hook for getting products from an external catalog. This hook makes a call to retrieve product data from an external source. Check the docs or the response API call contract https://docs.api.epilot.io/pricing-api-external-catalog for more details.
+         *
+         */
+        export interface ExternalProductCatalogHookProducts {
+            /**
+             * Identifier of the hook. Should not change between updates.
+             */
+            id: string; // ^[a-zA-Z0-9_-]+$
+            name?: TranslatedString;
+            type: "products";
+            auth?: ExternalProductCatalogAuthBlock;
+            call: {
+                /**
+                 * HTTP method to use for the call
+                 */
+                method?: string;
+                /**
+                 * URL to call. Supports variable interpolation.
+                 */
+                url: string;
+                /**
+                 * Parameters to append to the URL. Supports variable interpolation.
+                 */
+                params?: {
+                    [name: string]: string;
+                };
+                /**
+                 * Headers to use. Supports variable interpolation.
+                 */
+                headers?: {
+                    [name: string]: string;
+                };
+                /**
+                 * JSON body to use for the call. Supports variable interpolation. If empty / not provided, the default request context will be used based on the consumer (e.g. Journey).
+                 */
+                body?: {
+                    [name: string]: any;
+                };
+            };
+        }
+        /**
+         * Required grants for the app in order to call APIs for the installing tenant
+         */
+        export type Grants = {
+            /**
+             * The action the app can perform
+             */
+            action: string;
+            /**
+             * The resource the app can access
+             */
+            resource?: string;
+        }[];
+        /**
+         * Information about the installed app. Has configuration data of the installed version
+         */
+        export interface Installation {
+            /**
+             * ID of the app configuration
+             */
+            app_id: string;
+            /**
+             * Unique identifier for the organization the app is installed in
+             */
+            installer_org_id: string;
+            /**
+             * Organization ID of the app creator
+             */
+            owner_org_id?: string;
+            /**
+             * Flag to indicate if the app is enabled. Enabled is set to true when required option values are set.
+             */
+            enabled: boolean;
+            /**
+             * Name of the app
+             */
+            name: string;
+            /**
+             * Configuration values for the app components
+             */
+            option_values?: OptionsRef[];
+            /**
+             * List of component configurations for the installed version
+             */
+            components: BaseComponent[];
+            /**
+             * Version of the app that is installed
+             */
+            installed_version: string;
+            /**
+             * The name of the role the app can use to access APIs
+             */
+            role?: string;
+            blueprint_ref?: BlueprintRef;
+            /**
+             * Audit information for the app
+             */
+            installation_audit?: {
+                /**
+                 * Timestamp of the creation
+                 */
+                created_at?: string;
+                /**
+                 * User ID of the creator
+                 */
+                created_by?: string;
+                /**
+                 * Timestamp of the last update
+                 */
+                updated_at?: string;
+                /**
+                 * User ID of the last updater
+                 */
+                updated_by?: string;
+            };
+            /**
+             * Manifest ID used to create/update the entity
+             */
+            _manifest?: string /* uuid */[];
+        }
+        export interface JourneyBlockComponent {
+            component_type: "CUSTOM_JOURNEY_BLOCK";
+            configuration: JourneyBlockConfig;
+        }
+        export type JourneyBlockComponentArgs = {
+            /**
+             * Unique identifier for this component arg
+             */
+            key: string;
+            type: "text" | "boolean" | "enum" | "block_reference";
+            /**
+             * Flag to indicate if this option is required
+             */
+            required?: boolean;
+            /**
+             * Description of what this component arg does
+             */
+            description?: {
+                /**
+                 * English translation
+                 */
+                en?: string | null;
+                /**
+                 * German translation
+                 */
+                de: string;
+            };
+            /**
+             * Human-readable label for the component arg
+             */
+            label: {
+                /**
+                 * English translation
+                 */
+                en?: string | null;
+                /**
+                 * German translation
+                 */
+                de: string;
+            };
+        } & (TextArg | BooleanArg | EnumArg | /**
+         * References another journey block by its ID. The configuring user picks
+         * a block from the journey via a dropdown in the journey-builder; the
+         * chosen block's ID is stored as the arg value (a string). The bundle can
+         * then call `subscribe(blockId, cb)` / `getValue(blockId)` against that ID.
+         *
+         */
+        BlockReferenceArg);
+        export interface JourneyBlockConfig {
+            override_dev_mode?: /* Override URL when app is in dev mode */ OverrideDevMode;
+            /**
+             * URL of the web component object
+             * example:
+             * https://cdn.apps.com/123/v1.0.0/bundle.js
+             */
+            component_url: string;
+            /**
+             * Custom element tag for the component
+             */
+            component_tag: string;
+            /**
+             * Arguments to pass to the component
+             */
+            component_args?: JourneyBlockComponentArgs[];
+            /**
+             * Size of the bundle in bytes
+             */
+            component_size?: number;
+            /**
+             * Define data which is mapped to entity mapping ui blocks
+             */
+            component_mapping?: {
+                [name: string]: "string" | "boolean" | "date" | "datetime" | "link" | "number";
+            };
+        }
+        export interface NotificationConfig {
+            /**
+             * Email address to receive notifications
+             * example:
+             * developer@example.com
+             */
+            email?: string; // email
+            /**
+             * List of events to subscribe to
+             */
+            events?: NotificationEvent[];
+        }
+        export type NotificationEvent = "app.installed" | "app.uninstalled";
+        /**
+         * One declared field inside a `type: object` option. Fields are primitives — object nesting
+         * is not supported.
+         *
+         */
+        export interface ObjectField {
+            /**
+             * Unique identifier for this field within the parent object.
+             */
+            key: string;
+            /**
+             * Human-readable label for the field.
+             */
+            label?: string;
+            /**
+             * Detailed description of what this field is for.
+             */
+            description?: string;
+            /**
+             * Flag to indicate if this field must be filled.
+             */
+            required?: boolean;
+            /**
+             * Primitive type of this field.
+             */
+            type: "text" | "number" | "boolean" | "secret";
+        }
+        export interface Option {
+            /**
+             * Key matching a config_option from the component
+             */
+            key: string;
+            /**
+             * The configured value for this option. Shape depends on the matching component option's
+             * `type` and `repeatable` (see `Options.value`).
+             *
+             */
+            value: any;
+        }
+        /**
+         * Options for the component configuration
+         */
+        export interface Options {
+            /**
+             * Unique identifier for this configuration option
+             */
+            key: string;
+            /**
+             * Human-readable label for the configuration option
+             */
+            label?: string;
+            /**
+             * Flag to indicate if this option is required
+             */
+            required?: boolean;
+            /**
+             * Detailed description of what this configuration option does
+             */
+            description?: string;
+            /**
+             * When true, the configured value is an array of entries, each tagged with a stable
+             * server-assigned `id`. Combine with any `type` to express "many of this thing."
+             * Defaults to false.
+             *
+             */
+            repeatable?: boolean;
+            /**
+             * Field declarations — required when `type: object`. Each entry describes one primitive
+             * sub-field of the object value. Object types may not nest (no `type: object` inside `fields`).
+             *
+             */
+            fields?: /**
+             * One declared field inside a `type: object` option. Fields are primitives — object nesting
+             * is not supported.
+             *
+             */
+            ObjectField[];
+            /**
+             * The configured value for this option. Shape depends on `type` and `repeatable`:
+             * - primitive `type` (text/number/boolean/secret), `repeatable` false → primitive
+             * - primitive `type`, `repeatable` true → array of `{id, value}` entries
+             * - `type: object`, `repeatable` false → object with declared fields
+             * - `type: object`, `repeatable` true → array of `{id, ...declared fields}` entries
+             *
+             * `id` is server-assigned and stable across edits so consumers can reference entries
+             * by id rather than by index.
+             *
+             */
+            value?: any;
+            /**
+             * The type of this option. `object` declares a structured value whose fields are listed
+             * under `fields`. Combine with `repeatable: true` to express a list of these objects.
+             *
+             */
+            type: "text" | "number" | "boolean" | "secret" | "object";
+        }
+        export interface OptionsRef {
+            /**
+             * ID of the component these values are for
+             */
+            component_id: string;
+            options: Option[];
+        }
+        /**
+         * Override URL when app is in dev mode
+         */
+        export interface OverrideDevMode {
+            /**
+             * URL of the web component object in dev mode
+             * example:
+             * http://localhost:3000
+             */
+            override_url?: string;
+        }
+        export interface PortalBlockComponent {
+            component_type: "CUSTOM_PORTAL_BLOCK";
+            configuration: PortalBlockConfig;
+            surfaces?: {
+                portal_block?: PortalBlockSurfaceConfig;
+            };
+        }
+        export interface PortalBlockConfig {
+        }
+        export interface PortalBlockSurfaceConfig {
+            /**
+             * URL of the uploaded App Bridge App. This is the entrypoint for the app
+             */
+            app_url?: string;
+            /**
+             * URL of the uploaded zip file containing the app
+             */
+            zip_url?: string;
+            /**
+             * URL of the app in dev mode
+             */
+            override_url?: string;
+            /**
+             * Define which surfaces of the portal this block can be placed in
+             */
+            supported_surfaces?: ("main" | "footer_inline" | "footer_left_absolute" | "footer_right_absolute")[];
+        }
+        export interface PortalExtensionAuthBlock {
+            /**
+             * HTTP method to use for authentication
+             */
+            method?: string;
+            /**
+             * URL to use for authentication. Supports variable interpolation.
+             */
+            url: string;
+            /**
+             * Parameters to append to the URL. Supports variable interpolation.
+             */
+            params?: {
+                [name: string]: string;
+            };
+            /**
+             * Headers to use for authentication. Supports variable interpolation.
+             */
+            headers?: {
+                [name: string]: string;
+            };
+            /**
+             * JSON body to use for authentication. Supports variable interpolation. Content format is determined by Content-Type header.
+             */
+            body?: {
+                [name: string]: any;
+            };
+            cache?: {
+                /**
+                 * Key to use to identify the auth response. Supports interpolation.
+                 * example:
+                 * {{Options.api_key}}
+                 */
+                key: string;
+                /**
+                 * Time to live in seconds for the cache. Supports interpolation.
+                 * example:
+                 * {{AuthResponse.data.expires_in}}
+                 */
+                ttl: string;
+            };
+        }
+        export interface PortalExtensionComponent {
+            component_type: "PORTAL_EXTENSION";
+            configuration: PortalExtensionConfig;
+        }
+        export interface PortalExtensionConfig {
+            hooks?: (/**
+             * Hook that replaces the built-in registration identifiers check. This hook makes a POST call whenever a user is trying to register to find the corresponding contact. The expected response to the call is:
+             *   - 200 with contact id if exactly one contact is found
+             *   - 404 if no contact is found or more than contact is found
+             *
+             */
+            PortalExtensionHookRegistrationIdentifiersCheck | /**
+             * Hook that replaces the built-in Contract identification for self-assignment. This hook involves an HTTP request whenever a user is trying to self-assign Contract(s).
+             * The expected response http status code to the call is:
+             *   - 200 if found
+             *   - 404 if not found
+             *
+             * The following assignment modes are supported:
+             *   - `contracts`: We expect the response to contain Contract ids (customizable using `result` property).
+             *   - `contact_to_contracts`: We expect the response to contain a Contact id (customizable using `result` property) and we will assign the Contact as a Customer to the Contracts and (optionally) update the Contact attribute specified by `contact_relation_attribute` to add the matched Contact.
+             *   - `contact_to_portal_user`: We expect the response to contain a Contact id (customizable using `result` property) and we will assign the Contact to the Portal User. Portal User will be able to see all data including Contracts transitively.
+             *
+             * Defaults to `contact_to_contracts` for backwards compatibility. We recommend using `contact_to_portal_user` as it does not influence the data model of business entities.
+             *
+             */
+            PortalExtensionHookContractIdentification | /**
+             * Hook that will allow using the specified source as data for price visualizations. This hook is triggered to fetch the data. Format of the request and response has to follow the following specification: TBD. The expected response to the call is:
+             *   - 200 with the time series data
+             *
+             */
+            PortalExtensionHookPriceDataRetrieval | /**
+             * Hook that will allow using the specified source as data for consumption visualizations. This hook is triggered to fetch the data. Format of the request and response has to follow the following specification: TBD. The expected response to the call is:
+             *   - 200 with the time series data
+             *
+             */
+            PortalExtensionHookConsumptionDataRetrieval | /**
+             * Generic data export hook. When configured on blocks that support it, the portal delegates the export action (e.g. CSV/Excel/PDF download) to the configured external source instead of generating the file itself. Can be used by any block that supports export — consumption charts, dynamic tariff charts, etc. The expected response to the call is:
+             *   - 200 with a JSON body describing the exported file (download_url, optional filename, content_type, expires_at)
+             *
+             */
+            PortalExtensionHookDataExport | /**
+             * Hook that will allow using the specified source as data for consumption visualizations. This hook is triggered to fetch the data. Format of the request and response has to follow the following specification: TBD. The expected response to the call is:
+             *   - 200 with the time series data
+             *
+             */
+            PortalExtensionHookCostDataRetrieval | /**
+             * Hook that checks the plausibility of meter readings before they are saved. This hook makes a POST call whenever a user is trying to save a meter reading. The expected response to the call is:
+             *   - 200:
+             *     If meter reading is plausible, the response should contain:
+             *       - valid: true
+             *     If meter reading is not plausible, the response should contain:
+             *       - valid: false
+             *
+             */
+            PortalExtensionHookMeterReadingPlausibilityCheck | /**
+             * Hook that returns runtime metadata describing how a visualization (consumption / price / cost chart) should be rendered for a given portal context (meter, contract, etc). It is invoked by the portal before fetching data, with the same context the data hook would receive, so that the discovery shape can vary per meter/contract. The expected response to the call is:
+             *   - 200 with a JSON body of shape:
+             *     {
+             *       "type_options": [
+             *         { "id": "ht", "label": { "en": "High tariff" }, "aggregation_group": "consumption", "statistical_method": "sum", "unit": "kWh" },
+             *         ...
+             *       ],
+             *       "intervals": ["PT15M", "PT1H", "P1D", "P1M"],
+             *       "data_range": { "from": "2024-01-01T00:00:00Z", "to": "2026-05-01T00:00:00Z" }
+             *     }
+             *   Each type option carries its own `statistical_method`, which describes the method already applied to that type's data and dictates the chart shape: `sum` is rendered as a bar chart; `min`, `average`, and `max` are rendered as a line chart. A single visualization can therefore mix bar-shaped types with line-shaped types. Defaults to `sum` when omitted.
+             *   `aggregation_group` controls how types within a group are visually combined (depends on the per-type `statistical_method`):
+             *     - bar chart (`sum`): same-group types are stacked into a single bar (e.g. ht/nt summed into total consumption); different-group types render side-by-side.
+             *     - line chart (`min` / `average` / `max`): same-group types are rendered as an area chart; different-group types render as separate lines.
+             *   All fields are optional; the consumer falls back to its defaults for whatever the hook does not return.
+             * The portal looks up this hook implicitly per extension (one `visualizationMetadata` hook per extension) — there is no need for a data-retrieval hook to reference it explicitly.
+             *
+             */
+            PortalExtensionHookVisualizationMetadata)[];
+            links?: {
+                /**
+                 * Identifier of the link. Should not change between updates.
+                 */
+                id: string; // ^[a-zA-Z0-9_-]+$
+                name: TranslatedString;
+                description?: TranslatedString;
+                type: "seamless";
+                /**
+                 * Controls whether the link should be shown. Supports variable interpolation.
+                 * example:
+                 * {{Contact.customer_number | is_not_empty}}
+                 */
+                condition?: string;
+                auth?: PortalExtensionAuthBlock;
+                redirect: {
+                    /**
+                     * URL to redirect to. Supports variable interpolation.
+                     */
+                    url?: string;
+                    /**
+                     * Parameters to append to the URL. Supports variable interpolation.
+                     */
+                    params?: {
+                        [name: string]: string;
+                    };
+                };
+            }[];
+        }
+        /**
+         * Hook that will allow using the specified source as data for consumption visualizations. This hook is triggered to fetch the data. Format of the request and response has to follow the following specification: TBD. The expected response to the call is:
+         *   - 200 with the time series data
+         *
+         */
+        export interface PortalExtensionHookConsumptionDataRetrieval {
+            /**
+             * Identifier of the hook. Should not change between updates.
+             */
+            id: string; // ^[a-zA-Z0-9_-]+$
+            name?: TranslatedString;
+            type: "consumptionDataRetrieval";
+            /**
+             * Deprecated. Prefer declaring a sibling `visualizationMetadata` hook on the same extension and returning `intervals` from its response — that way the supported intervals can vary per meter/contract.
+             * Intervals supported by the API. If omitted, it is assumed that all intervals are supported.
+             *
+             */
+            intervals?: ("PT15M" | "PT1H" | "P1D" | "P1M")[];
+            auth?: PortalExtensionAuthBlock;
+            call: {
+                /**
+                 * HTTP method to use for the call
+                 */
+                method?: string;
+                /**
+                 * URL to call. Supports variable interpolation.
+                 */
+                url: string;
+                /**
+                 * Parameters to append to the URL. Supports variable interpolation.
+                 */
+                params?: {
+                    [name: string]: string;
+                };
+                /**
+                 * Headers to use. Supports variable interpolation.
+                 */
+                headers?: {
+                    [name: string]: string;
+                };
+                /**
+                 * Request body to send. Supports variable interpolation. Content format is determined by Content-Type header.
+                 */
+                body?: {
+                    [name: string]: any;
+                };
+            };
+            resolved?: {
+                /**
+                 * Optional path to the data (array) in the response. If omitted, the data is assumed to be on the top level.
+                 */
+                dataPath?: string;
+            };
+            /**
+             * Deprecated. Prefer `secure_proxy` instead.
+             * If true, requests are made from a set of static IP addresses and only allow connections to a set of allowed IP addresses. Get in touch with us to add your IP addresses.
+             *
+             */
+            use_static_ips?: boolean;
+            secure_proxy?: /* If set, requests are routed through the ERP Integration secure proxy. Mutually exclusive with use_static_ips. */ PortalExtensionSecureProxy;
+        }
+        /**
+         * Hook that replaces the built-in Contract identification for self-assignment. This hook involves an HTTP request whenever a user is trying to self-assign Contract(s).
+         * The expected response http status code to the call is:
+         *   - 200 if found
+         *   - 404 if not found
+         *
+         * The following assignment modes are supported:
+         *   - `contracts`: We expect the response to contain Contract ids (customizable using `result` property).
+         *   - `contact_to_contracts`: We expect the response to contain a Contact id (customizable using `result` property) and we will assign the Contact as a Customer to the Contracts and (optionally) update the Contact attribute specified by `contact_relation_attribute` to add the matched Contact.
+         *   - `contact_to_portal_user`: We expect the response to contain a Contact id (customizable using `result` property) and we will assign the Contact to the Portal User. Portal User will be able to see all data including Contracts transitively.
+         *
+         * Defaults to `contact_to_contracts` for backwards compatibility. We recommend using `contact_to_portal_user` as it does not influence the data model of business entities.
+         *
+         */
+        export interface PortalExtensionHookContractIdentification {
+            /**
+             * Identifier of the hook. Should not change between updates.
+             */
+            id: string; // ^[a-zA-Z0-9_-]+$
+            name?: TranslatedString;
+            type: "contractIdentification";
+            auth?: PortalExtensionAuthBlock;
+            call: {
+                /**
+                 * HTTP method to use for the call
+                 */
+                method?: string;
+                /**
+                 * URL to call. Supports variable interpolation.
+                 */
+                url: string;
+                /**
+                 * Parameters to append to the URL. Supports variable interpolation.
+                 */
+                params?: {
+                    [name: string]: string;
+                };
+                /**
+                 * Headers to use. Supports variable interpolation.
+                 */
+                headers: {
+                    [name: string]: string;
+                };
+                /**
+                 * Optional JSON body to use for the call. Defaults to object with all configured identifiers grouped by entity, e.g. `{"contract": {"contract_name": "Name"}}`. Supports variable interpolation.
+                 */
+                body?: {
+                    [key: string]: any;
+                };
+                /**
+                 * Contract or Contact ID usually retrieved from the response body, e.g. `{{CallResponse.data.contact_id}}`. If no result is passed and the request suceeds, we attempt to resolve the Contact ID automatically. Supports variable interpolation.
+                 */
+                result?: string;
+            };
+            /**
+             * Mode of contract assignment. See hook description for mode details.
+             */
+            assignment_mode?: "contracts" | "contact_to_contracts" | "contact_to_portal_user";
+            /**
+             * Name of the Contact attribute to update with the matched Contact ID when using `contact_to_contracts` mode. Must be a Contact relation attribute supporting multiple entities.
+             * example:
+             * represents_contact
+             */
+            contact_relation_attribute?: string;
+            /**
+             * Explanation of the hook.
+             */
+            explanation?: {
+                [name: string]: string;
+                /**
+                 * Explanation of the functionality shown to the end user.
+                 * example:
+                 * This process will give you access to the matching Contracts.
+                 */
+                en: string;
+            };
+            /**
+             * Deprecated. Prefer `secure_proxy` instead.
+             * If true, requests are made from a set of static IP addresses and only allow connections to a set of allowed IP addresses. Get in touch with us to add your IP addresses.
+             *
+             */
+            use_static_ips?: boolean;
+            secure_proxy?: /* If set, requests are routed through the ERP Integration secure proxy. Mutually exclusive with use_static_ips. */ PortalExtensionSecureProxy;
+        }
+        /**
+         * Hook that will allow using the specified source as data for consumption visualizations. This hook is triggered to fetch the data. Format of the request and response has to follow the following specification: TBD. The expected response to the call is:
+         *   - 200 with the time series data
+         *
+         */
+        export interface PortalExtensionHookCostDataRetrieval {
+            /**
+             * Identifier of the hook. Should not change between updates.
+             */
+            id: string; // ^[a-zA-Z0-9_-]+$
+            name?: TranslatedString;
+            type: "costDataRetrieval";
+            /**
+             * Deprecated. Prefer declaring a sibling `visualizationMetadata` hook on the same extension and returning `intervals` from its response — that way the supported intervals can vary per meter/contract.
+             * Intervals supported by the API. If omitted, it is assumed that all intervals are supported.
+             *
+             */
+            intervals?: ("PT15M" | "PT1H" | "P1D" | "P1M")[];
+            auth?: PortalExtensionAuthBlock;
+            call: {
+                /**
+                 * HTTP method to use for the call
+                 */
+                method?: string;
+                /**
+                 * URL to call. Supports variable interpolation.
+                 */
+                url: string;
+                /**
+                 * Parameters to append to the URL. Supports variable interpolation.
+                 */
+                params?: {
+                    [name: string]: string;
+                };
+                /**
+                 * Headers to use. Supports variable interpolation.
+                 */
+                headers?: {
+                    [name: string]: string;
+                };
+                /**
+                 * Request body to send. Supports variable interpolation. Content format is determined by Content-Type header.
+                 */
+                body?: {
+                    [name: string]: any;
+                };
+            };
+            resolved?: {
+                /**
+                 * Optional path to the data (array) in the response. If omitted, the data is assumed to be on the top level.
+                 */
+                dataPath?: string;
+            };
+            /**
+             * Deprecated. Prefer `secure_proxy` instead.
+             * If true, requests are made from a set of static IP addresses and only allow connections to a set of allowed IP addresses. Get in touch with us to add your IP addresses.
+             *
+             */
+            use_static_ips?: boolean;
+            secure_proxy?: /* If set, requests are routed through the ERP Integration secure proxy. Mutually exclusive with use_static_ips. */ PortalExtensionSecureProxy;
+        }
+        /**
+         * Generic data export hook. When configured on blocks that support it, the portal delegates the export action (e.g. CSV/Excel/PDF download) to the configured external source instead of generating the file itself. Can be used by any block that supports export — consumption charts, dynamic tariff charts, etc. The expected response to the call is:
+         *   - 200 with a JSON body describing the exported file (download_url, optional filename, content_type, expires_at)
+         *
+         */
+        export interface PortalExtensionHookDataExport {
+            /**
+             * Identifier of the hook. Should not change between updates.
+             */
+            id: string; // ^[a-zA-Z0-9_-]+$
+            name?: TranslatedString;
+            type: "dataExport";
+            /**
+             * Optional list of portal block types this hook supports. If omitted,
+             * the hook is usable on any export-capable block. Allowed values match
+             * the block type identifiers used by the portal builder
+             * (e.g. `consumption_visualization`, `dynamic_tariff`).
+             *
+             */
+            block_types?: string[];
+            auth?: PortalExtensionAuthBlock;
+            call: {
+                /**
+                 * HTTP method to use for the call
+                 */
+                method?: string;
+                /**
+                 * URL to call. Supports variable interpolation.
+                 */
+                url: string;
+                /**
+                 * Parameters to append to the URL. Supports variable interpolation.
+                 */
+                params?: {
+                    [name: string]: string;
+                };
+                /**
+                 * Headers to use. Supports variable interpolation.
+                 */
+                headers?: {
+                    [name: string]: string;
+                };
+                /**
+                 * Request body to send. Supports variable interpolation. Content format is determined by Content-Type header.
+                 */
+                body?: {
+                    [name: string]: any;
+                };
+            };
+            /**
+             * Deprecated. Prefer `secure_proxy` instead.
+             * If true, requests are made from a set of static IP addresses and only allow connections to a set of allowed IP addresses. Get in touch with us to add your IP addresses.
+             *
+             */
+            use_static_ips?: boolean;
+            secure_proxy?: /* If set, requests are routed through the ERP Integration secure proxy. Mutually exclusive with use_static_ips. */ PortalExtensionSecureProxy;
+        }
+        /**
+         * Hook that checks the plausibility of meter readings before they are saved. This hook makes a POST call whenever a user is trying to save a meter reading. The expected response to the call is:
+         *   - 200:
+         *     If meter reading is plausible, the response should contain:
+         *       - valid: true
+         *     If meter reading is not plausible, the response should contain:
+         *       - valid: false
+         *
+         */
+        export interface PortalExtensionHookMeterReadingPlausibilityCheck {
+            /**
+             * Identifier of the hook. Should not change between updates.
+             */
+            id: string; // ^[a-zA-Z0-9_-]+$
+            name?: TranslatedString;
+            type: "meterReadingPlausibilityCheck";
+            /**
+             * Mode for plausibility check:
+             * - "check": Validates meter reading and returns valid: boolean (used during submission)
+             * - "range": Returns min/max allowed values for each counter for validation before submission
+             *
+             */
+            plausibility_mode?: "check" | "range";
+            auth?: PortalExtensionAuthBlock;
+            call: {
+                /**
+                 * URL to call. Supports variable interpolation.
+                 */
+                url: string;
+                /**
+                 * JSON body to use for the call. Supports variable interpolation.
+                 */
+                body: {
+                    [name: string]: any;
+                };
+                /**
+                 * Headers to use. Supports variable interpolation.
+                 */
+                headers: {
+                    [name: string]: string;
+                };
+            };
+            /**
+             * Response to the call
+             */
+            resolved: {
+                /**
+                 * Optional path to an array in the response. If specified and the path points to an array,
+                 * the hook will map over each item using 'Item' variable for interpolation.
+                 * Relevant only if plausibility_mode is "range".
+                 *
+                 * example:
+                 * data.results
+                 */
+                dataPath?: string;
+                /**
+                 * Counter identifier(s) used to match against the meter's counters.
+                 * Can be a string (counter ID) or an object with counter properties.
+                 * The backend resolves this to meter_counter_id in the final response.
+                 * Relevant only if plausibility_mode is "range".
+                 *
+                 * example:
+                 * {
+                 *   "obis_code": "{{Item.obis}}"
+                 * }
+                 */
+                counter_identifiers?: {
+                    [name: string]: string;
+                };
+                /**
+                 * Indicate whether the meter reading is plausible. Relevant only if plausibility_mode is "check".
+                 * example:
+                 * {{CallResponse.data.valid}}
+                 */
+                valid?: string;
+                /**
+                 * Upper allowed limit of the meter reading
+                 * example:
+                 * {{CallResponse.data.upper_limit}}
+                 */
+                upper_limit?: string;
+                /**
+                 * Lower allowed limit of the meter reading
+                 * example:
+                 * {{CallResponse.data.lower_limit}}
+                 */
+                lower_limit?: string;
+            };
+            /**
+             * Deprecated. Prefer `secure_proxy` instead.
+             * If true, requests are made from a set of static IP addresses and only allow connections to a set of allowed IP addresses. Get in touch with us to add your IP addresses.
+             *
+             */
+            use_static_ips?: boolean;
+            secure_proxy?: /* If set, requests are routed through the ERP Integration secure proxy. Mutually exclusive with use_static_ips. */ PortalExtensionSecureProxy;
+        }
+        /**
+         * Hook that will allow using the specified source as data for price visualizations. This hook is triggered to fetch the data. Format of the request and response has to follow the following specification: TBD. The expected response to the call is:
+         *   - 200 with the time series data
+         *
+         */
+        export interface PortalExtensionHookPriceDataRetrieval {
+            /**
+             * Identifier of the hook. Should not change between updates.
+             */
+            id: string; // ^[a-zA-Z0-9_-]+$
+            name?: TranslatedString;
+            type: "priceDataRetrieval";
+            /**
+             * Deprecated. Prefer declaring a sibling `visualizationMetadata` hook on the same extension and returning `intervals` from its response — that way the supported intervals can vary per meter/contract.
+             * Intervals supported by the API. If omitted, it is assumed that all intervals are supported.
+             *
+             */
+            intervals?: ("PT15M" | "PT1H" | "P1D" | "P1M")[];
+            auth?: PortalExtensionAuthBlock;
+            call: {
+                /**
+                 * HTTP method to use for the call
+                 */
+                method?: string;
+                /**
+                 * URL to call. Supports variable interpolation.
+                 */
+                url: string;
+                /**
+                 * Parameters to append to the URL. Supports variable interpolation.
+                 */
+                params?: {
+                    [name: string]: string;
+                };
+                /**
+                 * Headers to use. Supports variable interpolation.
+                 */
+                headers?: {
+                    [name: string]: string;
+                };
+                /**
+                 * Request body to send. Supports variable interpolation. Content format is determined by Content-Type header.
+                 */
+                body?: {
+                    [name: string]: any;
+                };
+            };
+            resolved?: {
+                /**
+                 * Optional path to the data (array) in the response. If omitted, the data is assumed to be on the top level.
+                 */
+                dataPath?: string;
+            };
+            /**
+             * Deprecated. Prefer `secure_proxy` instead.
+             * If true, requests are made from a set of static IP addresses and only allow connections to a set of allowed IP addresses. Get in touch with us to add your IP addresses.
+             *
+             */
+            use_static_ips?: boolean;
+            secure_proxy?: /* If set, requests are routed through the ERP Integration secure proxy. Mutually exclusive with use_static_ips. */ PortalExtensionSecureProxy;
+        }
+        /**
+         * Hook that replaces the built-in registration identifiers check. This hook makes a POST call whenever a user is trying to register to find the corresponding contact. The expected response to the call is:
+         *   - 200 with contact id if exactly one contact is found
+         *   - 404 if no contact is found or more than contact is found
+         *
+         */
+        export interface PortalExtensionHookRegistrationIdentifiersCheck {
+            /**
+             * Identifier of the hook. Should not change between updates.
+             */
+            id: string; // ^[a-zA-Z0-9_-]+$
+            name?: TranslatedString;
+            type: "registrationIdentifiersCheck";
+            auth?: PortalExtensionAuthBlock;
+            call: {
+                /**
+                 * HTTP method to use for the call
+                 */
+                method?: string;
+                /**
+                 * URL to call. Supports variable interpolation.
+                 */
+                url: string;
+                /**
+                 * Parameters to append to the URL. Supports variable interpolation.
+                 */
+                params?: {
+                    [name: string]: string;
+                };
+                /**
+                 * Headers to use. Supports variable interpolation.
+                 */
+                headers: {
+                    [name: string]: string;
+                };
+                /**
+                 * Optional JSON body to use for the call. Defaults to object with all configured identifiers grouped by entity, e.g. `{"contract": {"contract_name": "Name"}}`. Supports variable interpolation.
+                 */
+                body?: {
+                    [key: string]: any;
+                };
+                /**
+                 * Contact ID usually retrieved from the response body, e.g. `{{CallResponse.data.contact_id}}`. If no result is passed and the request suceeds, we attempt to resolve the Contact ID automatically. Supports variable interpolation.
+                 */
+                result: string;
+            };
+            /**
+             * Deprecated. Prefer `secure_proxy` instead.
+             * If true, requests are made from a set of static IP addresses and only allow connections to a set of allowed IP addresses. Get in touch with us to add your IP addresses.
+             *
+             */
+            use_static_ips?: boolean;
+            secure_proxy?: /* If set, requests are routed through the ERP Integration secure proxy. Mutually exclusive with use_static_ips. */ PortalExtensionSecureProxy;
+        }
+        /**
+         * Hook that returns runtime metadata describing how a visualization (consumption / price / cost chart) should be rendered for a given portal context (meter, contract, etc). It is invoked by the portal before fetching data, with the same context the data hook would receive, so that the discovery shape can vary per meter/contract. The expected response to the call is:
+         *   - 200 with a JSON body of shape:
+         *     {
+         *       "type_options": [
+         *         { "id": "ht", "label": { "en": "High tariff" }, "aggregation_group": "consumption", "statistical_method": "sum", "unit": "kWh" },
+         *         ...
+         *       ],
+         *       "intervals": ["PT15M", "PT1H", "P1D", "P1M"],
+         *       "data_range": { "from": "2024-01-01T00:00:00Z", "to": "2026-05-01T00:00:00Z" }
+         *     }
+         *   Each type option carries its own `statistical_method`, which describes the method already applied to that type's data and dictates the chart shape: `sum` is rendered as a bar chart; `min`, `average`, and `max` are rendered as a line chart. A single visualization can therefore mix bar-shaped types with line-shaped types. Defaults to `sum` when omitted.
+         *   `aggregation_group` controls how types within a group are visually combined (depends on the per-type `statistical_method`):
+         *     - bar chart (`sum`): same-group types are stacked into a single bar (e.g. ht/nt summed into total consumption); different-group types render side-by-side.
+         *     - line chart (`min` / `average` / `max`): same-group types are rendered as an area chart; different-group types render as separate lines.
+         *   All fields are optional; the consumer falls back to its defaults for whatever the hook does not return.
+         * The portal looks up this hook implicitly per extension (one `visualizationMetadata` hook per extension) — there is no need for a data-retrieval hook to reference it explicitly.
+         *
+         */
+        export interface PortalExtensionHookVisualizationMetadata {
+            /**
+             * Identifier of the hook. Should not change between updates.
+             */
+            id: string; // ^[a-zA-Z0-9_-]+$
+            name?: TranslatedString;
+            type: "visualizationMetadata";
+            auth?: PortalExtensionAuthBlock;
+            call: {
+                /**
+                 * HTTP method to use for the call
+                 */
+                method?: string;
+                /**
+                 * URL to call. Supports variable interpolation.
+                 */
+                url: string;
+                /**
+                 * Parameters to append to the URL. Supports variable interpolation.
+                 */
+                params?: {
+                    [name: string]: string;
+                };
+                /**
+                 * Headers to use. Supports variable interpolation.
+                 */
+                headers?: {
+                    [name: string]: string;
+                };
+                /**
+                 * Request body to send. Supports variable interpolation. Content format is determined by Content-Type header.
+                 */
+                body?: {
+                    [name: string]: any;
+                };
+            };
+            resolved?: {
+                /**
+                 * Optional path to the metadata object in the response. If omitted, the metadata is assumed to be on the top level.
+                 */
+                dataPath?: string;
+            };
+            /**
+             * Deprecated. Prefer `secure_proxy` instead.
+             * If true, requests are made from a set of static IP addresses and only allow connections to a set of allowed IP addresses. Get in touch with us to add your IP addresses.
+             *
+             */
+            use_static_ips?: boolean;
+            secure_proxy?: /* If set, requests are routed through the ERP Integration secure proxy. Mutually exclusive with use_static_ips. */ PortalExtensionSecureProxy;
+        }
+        export interface PortalExtensionSeamlessLink {
+            /**
+             * Identifier of the link. Should not change between updates.
+             */
+            id: string; // ^[a-zA-Z0-9_-]+$
+            name: TranslatedString;
+            description?: TranslatedString;
+            type: "seamless";
+            /**
+             * Controls whether the link should be shown. Supports variable interpolation.
+             * example:
+             * {{Contact.customer_number | is_not_empty}}
+             */
+            condition?: string;
+            auth?: PortalExtensionAuthBlock;
+            redirect: {
+                /**
+                 * URL to redirect to. Supports variable interpolation.
+                 */
+                url?: string;
+                /**
+                 * Parameters to append to the URL. Supports variable interpolation.
+                 */
+                params?: {
+                    [name: string]: string;
+                };
+            };
+        }
+        /**
+         * If set, requests are routed through the ERP Integration secure proxy. Mutually exclusive with use_static_ips.
+         */
+        export interface PortalExtensionSecureProxy {
+            /**
+             * Integration ID that owns the secure_proxy use case.
+             */
+            integration_id: string; // uuid
+            /**
+             * Use case slug for the secure proxy use case.
+             */
+            use_case_slug: string;
+        }
+        export interface Pricing {
+            pricing_type?: "FREE" | "SUBSCRIPTION" | "USAGE_BASED" | "ONE_TIME" | "CUSTOM" | "UNKNOWN";
+            billing_frequency?: /* How often the subscription is billed */ BillingFrequency;
+        }
+        /**
+         * Public configuration of the published app
+         */
+        export interface PublicConfiguration {
+            /**
+             * ID of the app configuration
+             */
+            app_id: string;
+            /**
+             * Email address for support requests
+             */
+            support_email?: string;
+            /**
+             * Organization ID of the app owner
+             */
+            owner_org_id: string;
+            /**
+             * Name of the app
+             */
+            name: string;
+            author?: Author;
+            /**
+             * Flag to indicate if the app is in dev mode.
+             */
+            dev_mode?: boolean;
+            /**
+             * Category of the app.
+             */
+            category?: string;
+            /**
+             * URL of the app icon.
+             */
+            icon_url?: string;
+            /**
+             * URL of the app documentation.
+             */
+            documentation_url?: string;
+            /**
+             * Markdown description of the app.
+             */
+            description?: {
+                /**
+                 * English translation
+                 */
+                en?: string | null;
+                /**
+                 * German translation
+                 */
+                de: string;
+            };
+            /**
+             * Pricing information for the app
+             */
+            pricing?: {
+                pricing_type?: "FREE" | "SUBSCRIPTION" | "USAGE_BASED" | "ONE_TIME" | "CUSTOM" | "UNKNOWN";
+                billing_frequency?: /* How often the subscription is billed */ BillingFrequency;
+            };
+            components: BaseComponent[];
+            /**
+             * Flag to indicate if the app is in beta.
+             */
+            is_beta?: boolean;
+            /**
+             * Timestamp when the app version is deprecated
+             */
+            deprecated_at?: string;
+            /**
+             * Version of the app that is installed
+             */
+            version: string;
+            role?: Role;
+            blueprint_ref?: BlueprintRef;
+            /**
+             * Latest version of the app
+             */
+            latest_version?: string;
+            /**
+             * Flag to indicate if the app is public.
+             */
+            public?: boolean;
+            /**
+             * List of available versions of the app
+             */
+            versions?: /* Configuration data about your app which is versionable */ ConfigurationVersion[];
+        }
+        export interface RawEvents {
+            type?: "raw";
+            events?: AppEventData[];
+        }
+        export interface Review {
+            /**
+             * Version of the app that is under review
+             */
+            version?: string;
+            /**
+             * Status of the review
+             */
+            review_status?: "approved" | "rejected" | "pending";
+            /**
+             * Timestamp of the review
+             */
+            requested_at?: string;
+            /**
+             * User ID of the reviewer
+             */
+            requested_by?: string;
+            /**
+             * Email of the technical contact
+             */
+            technical_contact?: string;
+            /**
+             * Email of the marketing contact
+             */
+            marketing_contact?: string;
+            /**
+             * URL of the demo
+             */
+            demo_url?: string;
+        }
+        export interface Role {
+            /**
+             * Name of the role
+             */
+            id?: string;
+            grants?: /* Required grants for the app in order to call APIs for the installing tenant */ Grants;
+        }
+        export interface S3Reference {
+            /**
+             * The name of the S3 bucket where the JSON file for import is stored.
+             * example:
+             * my-bucket
+             */
+            bucket: string;
+            /**
+             * The key or path to the JSON file within the S3 bucket.
+             * example:
+             * manifest.json
+             */
+            key: string;
+        }
+        export interface SandboxCustomActionConfig {
+            /**
+             * Name of the custom action
+             */
+            name?: string;
+            /**
+             * Description of the custom action
+             */
+            description?: string;
+            /**
+             * Wait for callback_url to be called before completing the action
+             */
+            wait_for_callback?: boolean;
+            type: "sandbox";
+            sandbox_settings?: {
+                /**
+                 * JavaScript code to execute for the sandbox action. Maximum size: 300KB (hard limit). Code is stored as raw JavaScript and will be syntax-validated on save. Security restrictions: eval() and Function() constructor are not allowed.
+                 *
+                 */
+                code?: string;
+            };
+        }
+        export interface TextArg {
+            type?: "text";
+        }
+        export interface TranslatedString {
+            /**
+             * English translation
+             */
+            en?: string | null;
+            /**
+             * German translation
+             */
+            de: string;
+        }
+    }
+}
+declare namespace Paths {
+    namespace CloneVersion {
+        namespace Parameters {
+            export type AppId = string;
+            export type SourceVersion = string;
+            export type TargetVersion = string;
+        }
+        export interface PathParameters {
+            appId: Parameters.AppId;
+            sourceVersion: Parameters.SourceVersion;
+            targetVersion: Parameters.TargetVersion;
+        }
+        namespace Responses {
+            export interface $201 {
+                app_id?: string;
+                version?: string;
+                status?: "pending" | "published";
+            }
+            export interface $400 {
+            }
+            export interface $404 {
+            }
+        }
+    }
+    namespace CreateBundleUploadUrl {
+        namespace Parameters {
+            export type AppId = string;
+        }
+        export interface PathParameters {
+            appId: Parameters.AppId;
+        }
+        export type RequestBody = Components.RequestBodies.CreateBundlePresignedRequest;
+        namespace Responses {
+            export interface $200 {
+                /**
+                 * ID of the journye block component
+                 */
+                component_id?: string;
+                /**
+                 * URL of the web component object
+                 */
+                component_url?: string;
+                /**
+                 * Presigned S3 URL for uploading the bundle
+                 */
+                upload_url: string;
+                s3ref?: Components.Schemas.S3Reference;
+                /**
+                 * Timestamp when the upload URL expires
+                 */
+                expires_at?: string; // date-time
+            }
+            export interface $404 {
+            }
+        }
+    }
+    namespace CreateComponent {
+        namespace Parameters {
+            export type AppId = string;
+            export type Version = string;
+        }
+        export interface PathParameters {
+            appId: Parameters.AppId;
+            version: Parameters.Version;
+        }
+        export type RequestBody = Components.RequestBodies.UpsertComponentRequest;
+        namespace Responses {
+            export interface $200 {
+                component?: Components.Schemas.BaseComponent;
+            }
+            export interface $400 {
+            }
+            export interface $404 {
+            }
+        }
+    }
+    namespace CreateConfiguration {
+        export type RequestBody = Components.RequestBodies.CreateConfigRequest;
+        namespace Responses {
+            export interface $201 {
+                app_id: string;
+            }
+        }
+    }
+    namespace CreateLogoUploadUrl {
+        export type RequestBody = Components.RequestBodies.CreateLogoPresignedRequest;
+        namespace Responses {
+            export interface $200 {
+                /**
+                 * Presigned S3 URL for uploading the logo
+                 */
+                upload_url: string;
+                s3ref?: Components.Schemas.S3Reference;
+                /**
+                 * Timestamp when the upload URL expires
+                 */
+                expires_at?: string; // date-time
+            }
+            export interface $404 {
+            }
+        }
+    }
+    namespace CreateReview {
+        namespace Parameters {
+            export type AppId = string;
+            export type Version = string;
+        }
+        export interface PathParameters {
+            appId: Parameters.AppId;
+            version: Parameters.Version;
+        }
+        export type RequestBody = Components.RequestBodies.CreateReviewRequest;
+        namespace Responses {
+            export interface $200 {
+                review?: Components.Schemas.Review;
+            }
+            export interface $400 {
+            }
+            export interface $404 {
+            }
+        }
+    }
+    namespace CreateZipUploadUrl {
+        namespace Parameters {
+            export type AppId = string;
+        }
+        export interface PathParameters {
+            appId: Parameters.AppId;
+        }
+        export interface RequestBody {
+            /**
+             * Version of the app configuration
+             * example:
+             * 1.0.0
+             */
+            version?: string;
+            /**
+             * ID of the journey block component
+             */
+            component_id?: string;
+            /**
+             * example:
+             * dist.zip
+             */
+            filename?: string;
+        }
+        namespace Responses {
+            export interface $200 {
+                /**
+                 * ID of the journye block component
+                 */
+                component_id?: string;
+                /**
+                 * Presigned S3 URL for uploading the bundle
+                 */
+                upload_url: string;
+                /**
+                 * Public CDN URL for the unpacked artifacts
+                 */
+                artifact_url: string;
+                s3ref?: Components.Schemas.S3Reference;
+                /**
+                 * Timestamp when the upload URL expires
+                 */
+                expires_at?: string; // date-time
+            }
+            export interface $404 {
+            }
+        }
+    }
+    namespace DeleteComponent {
+        namespace Parameters {
+            export type AppId = string;
+            export type ComponentId = string;
+            export type Version = string;
+        }
+        export interface PathParameters {
+            appId: Parameters.AppId;
+            version: Parameters.Version;
+            componentId: Parameters.ComponentId;
+        }
+        namespace Responses {
+            export interface $204 {
+            }
+            export interface $404 {
+            }
+        }
+    }
+    namespace DeleteConfiguration {
+        namespace Responses {
+            export interface $204 {
+            }
+            export interface $404 {
+            }
+        }
+    }
+    namespace DeleteLogo {
+        namespace Responses {
+            export interface $204 {
+            }
+            export interface $404 {
+            }
+        }
+    }
+    namespace DeleteVersion {
+        namespace Parameters {
+            export type AppId = string;
+            export type Version = string;
+        }
+        export interface PathParameters {
+            appId: Parameters.AppId;
+            version: Parameters.Version;
+        }
+        namespace Responses {
+            export interface $204 {
+            }
+            export interface $400 {
+            }
+            export interface $404 {
+            }
+            export interface $409 {
+            }
+        }
+    }
+    namespace GetConfiguration {
+        namespace Parameters {
+            export type Version = string;
+        }
+        export interface QueryParameters {
+            version?: Parameters.Version;
+        }
+        namespace Responses {
+            export type $200 = /* Configuration of the published app */ Components.Schemas.Configuration;
+            export interface $404 {
+            }
+        }
+    }
+    namespace GetInstallation {
+        namespace Parameters {
+            export type AppId = string;
+        }
+        export interface PathParameters {
+            appId: Parameters.AppId;
+        }
+        namespace Responses {
+            export type $200 = /* Information about the installed app. Has configuration data of the installed version */ Components.Schemas.Installation;
+            export interface $404 {
+            }
+        }
+    }
+    namespace GetPublicConfiguration {
+        namespace Parameters {
+            export type Version = string;
+        }
+        export interface QueryParameters {
+            version?: Parameters.Version;
+        }
+        namespace Responses {
+            export type $200 = /* Public configuration of the published app */ Components.Schemas.PublicConfiguration;
+            export interface $404 {
+            }
+        }
+    }
+    namespace GetPublicFacingComponent {
+        namespace Responses {
+            export interface $200 {
+                component?: Components.Schemas.BaseComponent;
+            }
+            export interface $404 {
+            }
+        }
+    }
+    namespace GetReview {
+        namespace Parameters {
+            export type AppId = string;
+            export type Version = string;
+        }
+        export interface PathParameters {
+            appId: Parameters.AppId;
+            version: Parameters.Version;
+        }
+        namespace Responses {
+            export interface $200 {
+                review?: Components.Schemas.Review;
+            }
+            export interface $404 {
+            }
+        }
+    }
+    namespace GetVersion {
+        namespace Parameters {
+            export type AppId = string;
+            export type Version = string;
+        }
+        export interface PathParameters {
+            appId: Parameters.AppId;
+            version: Parameters.Version;
+        }
+        namespace Responses {
+            export type $200 = /* Configuration of the published app */ Components.Schemas.Configuration;
+            export interface $404 {
+            }
+        }
+    }
+    namespace IngestEvent {
+        export type RequestBody = Components.Schemas.AppEventData | Components.Schemas.BatchEventRequest;
+        namespace Responses {
+            export interface $202 {
+            }
+            export interface $400 {
+            }
+        }
+    }
+    namespace Install {
+        namespace Parameters {
+            export type AppId = string;
+        }
+        export interface PathParameters {
+            appId: Parameters.AppId;
+        }
+        export type RequestBody = Components.RequestBodies.InstallRequest;
+        namespace Responses {
+            export type $201 = /* Information about the installed app. Has configuration data of the installed version */ Components.Schemas.Installation;
+            export interface $404 {
+            }
+        }
+    }
+    namespace ListConfigurations {
+        namespace Parameters {
+            export type Page = number;
+            export type PageSize = number;
+        }
+        export interface QueryParameters {
+            page?: Parameters.Page;
+            pageSize?: Parameters.PageSize;
+        }
+        namespace Responses {
+            export interface $200 {
+                configurations?: /* Basic metadata about your app configuration which does not get versioned */ Components.Schemas.ConfigurationMetadata[];
+                pagination?: {
+                    total?: number;
+                    page?: number;
+                    pageSize?: number;
+                };
+            }
+        }
+    }
+    namespace ListInstallations {
+        namespace Parameters {
+            export type ComponentType = /* Type of app component */ Components.Schemas.ComponentType;
+            export type Enabled = boolean;
+            export type Page = number;
+            export type PageSize = number;
+        }
+        export interface QueryParameters {
+            componentType?: Parameters.ComponentType;
+            enabled?: Parameters.Enabled;
+            page?: Parameters.Page;
+            pageSize?: Parameters.PageSize;
+        }
+        namespace Responses {
+            export interface $200 {
+                apps?: /* Information about the installed app. Has configuration data of the installed version */ Components.Schemas.Installation[];
+                pagination?: {
+                    total?: number;
+                    page?: number;
+                    pageSize?: number;
+                };
+            }
+        }
+    }
+    namespace ListPublicConfigurations {
+        namespace Parameters {
+            export type Page = number;
+            export type PageSize = number;
+        }
+        export interface QueryParameters {
+            page?: Parameters.Page;
+            pageSize?: Parameters.PageSize;
+        }
+        namespace Responses {
+            export interface $200 {
+                configurations?: /* Basic metadata about your app configuration which does not get versioned */ Components.Schemas.ConfigurationMetadata[];
+                pagination?: {
+                    total?: number;
+                    page?: number;
+                    pageSize?: number;
+                };
+            }
+        }
+    }
+    namespace ListVersions {
+        namespace Parameters {
+            export type AppId = string;
+            export type Page = number;
+            export type PageSize = number;
+        }
+        export interface PathParameters {
+            appId: Parameters.AppId;
+        }
+        export interface QueryParameters {
+            page?: Parameters.Page;
+            pageSize?: Parameters.PageSize;
+        }
+        namespace Responses {
+            export interface $200 {
+                versions?: /* Configuration data about your app which is versionable */ Components.Schemas.ConfigurationVersion[];
+                pagination?: {
+                    total?: number;
+                    page?: number;
+                    pageSize?: number;
+                };
+            }
+            export interface $400 {
+            }
+        }
+    }
+    namespace PatchComponent {
+        namespace Parameters {
+            export type AppId = string;
+            export type ComponentId = string;
+            export type Version = string;
+        }
+        export interface PathParameters {
+            appId: Parameters.AppId;
+            version: Parameters.Version;
+            componentId: Parameters.ComponentId;
+        }
+        export type RequestBody = Components.RequestBodies.UpsertComponentRequest;
+        namespace Responses {
+            export interface $204 {
+            }
+            export interface $400 {
+            }
+            export interface $404 {
+            }
+        }
+    }
+    namespace PatchInstallation {
+        namespace Parameters {
+            export type AppId = string;
+        }
+        export interface PathParameters {
+            appId: Parameters.AppId;
+        }
+        export type RequestBody = Components.RequestBodies.InstallRequest;
+        namespace Responses {
+            export interface $204 {
+            }
+            export interface $404 {
+            }
+        }
+    }
+    namespace PatchMetadata {
+        export type RequestBody = Components.RequestBodies.PatchConfigMetadataRequest;
+        namespace Responses {
+            export interface $204 {
+            }
+            export interface $404 {
+            }
+        }
+    }
+    namespace PatchVersion {
+        namespace Parameters {
+            export type AppId = string;
+            export type Version = string;
+        }
+        export interface PathParameters {
+            appId: Parameters.AppId;
+            version: Parameters.Version;
+        }
+        export type RequestBody = Components.RequestBodies.PatchVersionRequest;
+        namespace Responses {
+            export interface $204 {
+            }
+            export interface $400 {
+            }
+            export interface $404 {
+            }
+        }
+    }
+    namespace PromoteVersion {
+        namespace Parameters {
+            export type AppId = string;
+            export type Version = string;
+        }
+        export interface PathParameters {
+            appId: Parameters.AppId;
+            version: Parameters.Version;
+        }
+        namespace Responses {
+            export type $200 = /* Information about the installed app. Has configuration data of the installed version */ Components.Schemas.Installation;
+            export interface $400 {
+            }
+            export interface $404 {
+            }
+        }
+    }
+    namespace PublicProxyGet {
+        namespace Responses {
+            export interface $200 {
+            }
+            export interface $403 {
+            }
+            export interface $404 {
+            }
+            export interface $502 {
+            }
+        }
+    }
+    namespace PublicProxyPost {
+        export interface RequestBody {
+        }
+        namespace Responses {
+            export interface $200 {
+            }
+            export interface $403 {
+            }
+            export interface $404 {
+            }
+            export interface $502 {
+            }
+        }
+    }
+    namespace QueryEvents {
+        namespace Parameters {
+            export type AppId = string;
+        }
+        export interface PathParameters {
+            appId: Parameters.AppId;
+        }
+        export type RequestBody = Components.Schemas.EventsQuery;
+        namespace Responses {
+            export type $200 = Components.Schemas.EventsQueryResponse;
+            export interface $400 {
+            }
+            export interface $404 {
+            }
+        }
+    }
+    namespace Uninstall {
+        namespace Parameters {
+            export type AppId = string;
+        }
+        export interface PathParameters {
+            appId: Parameters.AppId;
+        }
+        namespace Responses {
+            export interface $204 {
+            }
+            export interface $404 {
+            }
+        }
+    }
+    namespace V1AppConfigurations$AppId {
+        namespace Parameters {
+            export type AppId = string;
+        }
+        export interface PathParameters {
+            appId: Parameters.AppId;
+        }
+    }
+    namespace V1AppConfigurations$AppIdLogo {
+        namespace Parameters {
+            export type AppId = string;
+        }
+        export interface PathParameters {
+            appId: Parameters.AppId;
+        }
+    }
+    namespace V1AppConfigurationsPublic$AppId {
+        namespace Parameters {
+            export type AppId = string;
+        }
+        export interface PathParameters {
+            appId: Parameters.AppId;
+        }
+    }
+    namespace V1PublicApp$AppIdComponents$ComponentId {
+        namespace Parameters {
+            export type AppId = string;
+            export type ComponentId = string;
+        }
+        export interface PathParameters {
+            appId: Parameters.AppId;
+            componentId: Parameters.ComponentId;
+        }
+    }
+    namespace V1PublicApp$AppIdProxy$ProxyName$Path {
+        namespace Parameters {
+            export type AppId = string;
+            export type Path = string;
+            export type ProxyName = string;
+        }
+        export interface PathParameters {
+            appId: Parameters.AppId;
+            proxyName: Parameters.ProxyName;
+            path: Parameters.Path;
+        }
+    }
+}
+
+
+interface OperationMethods {
+  /**
+   * getPublicFacingComponent - getPublicFacingComponent
+   * 
+   * Retrieve public facing components for an installed app
+   */
+  'getPublicFacingComponent'(
+    parameters?: Parameters<Paths.V1PublicApp$AppIdComponents$ComponentId.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetPublicFacingComponent.Responses.$200>
+  /**
+   * listConfigurations - listConfigurations
+   * 
+   * List all app configuration metadata owned by an organization. To get full app configuration details, use the /v1/app-configurations/{appId} endpoint.
+   */
+  'listConfigurations'(
+    parameters?: Parameters<Paths.ListConfigurations.QueryParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.ListConfigurations.Responses.$200>
+  /**
+   * createConfiguration - createConfiguration
+   * 
+   * Create a new private app configuration. To make it public a verification process needs to be triggered
+   */
+  'createConfiguration'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: Paths.CreateConfiguration.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.CreateConfiguration.Responses.$201>
+  /**
+   * listPublicConfigurations - listPublicConfigurations
+   * 
+   * List all publicly available app configurations that can be installed. This endpoint returns apps that have at least one public version.
+   */
+  'listPublicConfigurations'(
+    parameters?: Parameters<Paths.ListPublicConfigurations.QueryParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.ListPublicConfigurations.Responses.$200>
+  /**
+   * getPublicConfiguration - getPublicConfiguration
+   * 
+   * Retrieve the public configuration of an app to install in your tenant
+   */
+  'getPublicConfiguration'(
+    parameters?: Parameters<Paths.GetPublicConfiguration.QueryParameters & Paths.V1AppConfigurationsPublic$AppId.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetPublicConfiguration.Responses.$200>
+  /**
+   * getConfiguration - getConfiguration
+   * 
+   * Retrieve a specific app configuration
+   */
+  'getConfiguration'(
+    parameters?: Parameters<Paths.GetConfiguration.QueryParameters & Paths.V1AppConfigurations$AppId.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetConfiguration.Responses.$200>
+  /**
+   * patchMetadata - patchMetadata
+   * 
+   * Patch non-versioned configuration metadata of a given app configuration.
+   */
+  'patchMetadata'(
+    parameters?: Parameters<Paths.V1AppConfigurations$AppId.PathParameters> | null,
+    data?: Paths.PatchMetadata.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.PatchMetadata.Responses.$204>
+  /**
+   * deleteConfiguration - Delete app configuration
+   * 
+   * Delete an app configuration and all its versions and components.
+   */
+  'deleteConfiguration'(
+    parameters?: Parameters<Paths.V1AppConfigurations$AppId.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.DeleteConfiguration.Responses.$204>
+  /**
+   * queryEvents - queryEvents
+   * 
+   * Query analytics events for a specific app with flexible filtering
+   */
+  'queryEvents'(
+    parameters?: Parameters<Paths.QueryEvents.PathParameters> | null,
+    data?: Paths.QueryEvents.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.QueryEvents.Responses.$200>
+  /**
+   * createBundleUploadUrl - createBundleUploadUrl
+   * 
+   * Generate a presigned URL for uploading app bundle to /<app-id>/bundle.js path
+   */
+  'createBundleUploadUrl'(
+    parameters?: Parameters<Paths.CreateBundleUploadUrl.PathParameters> | null,
+    data?: Paths.CreateBundleUploadUrl.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.CreateBundleUploadUrl.Responses.$200>
+  /**
+   * createZipUploadUrl - createZipUploadUrl
+   * 
+   * Generate a presigned URL to upload a zip file with artifacts that will be unpacked in a new directory under the /<app-id>/ path
+   * 
+   */
+  'createZipUploadUrl'(
+    parameters?: Parameters<Paths.CreateZipUploadUrl.PathParameters> | null,
+    data?: Paths.CreateZipUploadUrl.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.CreateZipUploadUrl.Responses.$200>
+  /**
+   * createLogoUploadUrl - createLogoUploadUrl
+   * 
+   * Generate a presigned URL for uploading app logo to /<app-id>/logo.png path
+   */
+  'createLogoUploadUrl'(
+    parameters?: Parameters<Paths.V1AppConfigurations$AppIdLogo.PathParameters> | null,
+    data?: Paths.CreateLogoUploadUrl.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.CreateLogoUploadUrl.Responses.$200>
+  /**
+   * deleteLogo - deleteLogo
+   * 
+   * Delete the app logo from /<app-id>/logo.png path
+   */
+  'deleteLogo'(
+    parameters?: Parameters<Paths.V1AppConfigurations$AppIdLogo.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.DeleteLogo.Responses.$204>
+  /**
+   * listVersions - listVersions
+   * 
+   * Retrieve a list of versions for an app configuration
+   */
+  'listVersions'(
+    parameters?: Parameters<Paths.ListVersions.QueryParameters & Paths.ListVersions.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.ListVersions.Responses.$200>
+  /**
+   * getVersion - getVersion
+   * 
+   * Retrieve a specific version of an app configuration
+   */
+  'getVersion'(
+    parameters?: Parameters<Paths.GetVersion.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetVersion.Responses.$200>
+  /**
+   * patchVersion - patchVersion
+   * 
+   * Patch an existing app version
+   */
+  'patchVersion'(
+    parameters?: Parameters<Paths.PatchVersion.PathParameters> | null,
+    data?: Paths.PatchVersion.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.PatchVersion.Responses.$204>
+  /**
+   * deleteVersion - deleteVersion
+   * 
+   * Delete a specific version of an app configuration
+   */
+  'deleteVersion'(
+    parameters?: Parameters<Paths.DeleteVersion.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.DeleteVersion.Responses.$204>
+  /**
+   * getReview - getReview
+   * 
+   * Retrieve the review status of a specific app version
+   */
+  'getReview'(
+    parameters?: Parameters<Paths.GetReview.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetReview.Responses.$200>
+  /**
+   * createReview - createReview
+   * 
+   * Submit an app version for review to make it public
+   */
+  'createReview'(
+    parameters?: Parameters<Paths.CreateReview.PathParameters> | null,
+    data?: Paths.CreateReview.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.CreateReview.Responses.$200>
+  /**
+   * createComponent - createComponent
+   * 
+   * Patch an existing app version to create/add a component
+   */
+  'createComponent'(
+    parameters?: Parameters<Paths.CreateComponent.PathParameters> | null,
+    data?: Paths.CreateComponent.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.CreateComponent.Responses.$200>
+  /**
+   * patchComponent - patchComponent
+   * 
+   * Patch an existing app version to update its components
+   */
+  'patchComponent'(
+    parameters?: Parameters<Paths.PatchComponent.PathParameters> | null,
+    data?: Paths.PatchComponent.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.PatchComponent.Responses.$204>
+  /**
+   * deleteComponent - deleteComponent
+   * 
+   * Delete a specific component from an app version
+   */
+  'deleteComponent'(
+    parameters?: Parameters<Paths.DeleteComponent.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.DeleteComponent.Responses.$204>
+  /**
+   * cloneVersion - cloneVersion
+   * 
+   * Clone an existing app version to create a new version
+   */
+  'cloneVersion'(
+    parameters?: Parameters<Paths.CloneVersion.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.CloneVersion.Responses.$201>
+  /**
+   * listInstallations - listInstallations
+   * 
+   * Retrieve a list of installed apps for the organization.
+   */
+  'listInstallations'(
+    parameters?: Parameters<Paths.ListInstallations.QueryParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.ListInstallations.Responses.$200>
+  /**
+   * getInstallation - getInstallation
+   * 
+   * Retrieve details of an installed app by its ID.
+   */
+  'getInstallation'(
+    parameters?: Parameters<Paths.GetInstallation.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetInstallation.Responses.$200>
+  /**
+   * install - install
+   * 
+   * Upsert app installation by its ID.
+   */
+  'install'(
+    parameters?: Parameters<Paths.Install.PathParameters> | null,
+    data?: Paths.Install.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.Install.Responses.$201>
+  /**
+   * patchInstallation - patchInstallation
+   * 
+   * Patch an installed app by its ID.
+   */
+  'patchInstallation'(
+    parameters?: Parameters<Paths.PatchInstallation.PathParameters> | null,
+    data?: Paths.PatchInstallation.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.PatchInstallation.Responses.$204>
+  /**
+   * uninstall - uninstall
+   * 
+   * Uninstall an app by its ID.
+   */
+  'uninstall'(
+    parameters?: Parameters<Paths.Uninstall.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.Uninstall.Responses.$204>
+  /**
+   * promoteVersion - promoteVersion
+   * 
+   * Update an installed app to a new version
+   */
+  'promoteVersion'(
+    parameters?: Parameters<Paths.PromoteVersion.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.PromoteVersion.Responses.$200>
+  /**
+   * ingestEvent - ingestEvent
+   * 
+   * Internal endpoint for services to submit app events for analytic purposes
+   */
+  'ingestEvent'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: Paths.IngestEvent.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.IngestEvent.Responses.$202>
+  /**
+   * publicProxyGet - publicProxyGet
+   * 
+   * Forward a GET request to a registered proxy target from a public-facing component (e.g. journey blocks)
+   */
+  'publicProxyGet'(
+    parameters?: Parameters<Paths.V1PublicApp$AppIdProxy$ProxyName$Path.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.PublicProxyGet.Responses.$200>
+  /**
+   * publicProxyPost - publicProxyPost
+   * 
+   * Forward a POST request to a registered proxy target from a public-facing component (e.g. journey blocks)
+   */
+  'publicProxyPost'(
+    parameters?: Parameters<Paths.V1PublicApp$AppIdProxy$ProxyName$Path.PathParameters> | null,
+    data?: Paths.PublicProxyPost.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.PublicProxyPost.Responses.$200>
+}
+
+interface PathsDictionary {
+  ['/v1/public/app/{appId}/components/{componentId}']: {
+    /**
+     * getPublicFacingComponent - getPublicFacingComponent
+     * 
+     * Retrieve public facing components for an installed app
+     */
+    'get'(
+      parameters?: Parameters<Paths.V1PublicApp$AppIdComponents$ComponentId.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetPublicFacingComponent.Responses.$200>
+  }
+  ['/v1/app-configurations']: {
+    /**
+     * listConfigurations - listConfigurations
+     * 
+     * List all app configuration metadata owned by an organization. To get full app configuration details, use the /v1/app-configurations/{appId} endpoint.
+     */
+    'get'(
+      parameters?: Parameters<Paths.ListConfigurations.QueryParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.ListConfigurations.Responses.$200>
+    /**
+     * createConfiguration - createConfiguration
+     * 
+     * Create a new private app configuration. To make it public a verification process needs to be triggered
+     */
+    'post'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: Paths.CreateConfiguration.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.CreateConfiguration.Responses.$201>
+  }
+  ['/v1/app-configurations/public']: {
+    /**
+     * listPublicConfigurations - listPublicConfigurations
+     * 
+     * List all publicly available app configurations that can be installed. This endpoint returns apps that have at least one public version.
+     */
+    'get'(
+      parameters?: Parameters<Paths.ListPublicConfigurations.QueryParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.ListPublicConfigurations.Responses.$200>
+  }
+  ['/v1/app-configurations/public/{appId}']: {
+    /**
+     * getPublicConfiguration - getPublicConfiguration
+     * 
+     * Retrieve the public configuration of an app to install in your tenant
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetPublicConfiguration.QueryParameters & Paths.V1AppConfigurationsPublic$AppId.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetPublicConfiguration.Responses.$200>
+  }
+  ['/v1/app-configurations/{appId}']: {
+    /**
+     * getConfiguration - getConfiguration
+     * 
+     * Retrieve a specific app configuration
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetConfiguration.QueryParameters & Paths.V1AppConfigurations$AppId.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetConfiguration.Responses.$200>
+    /**
+     * patchMetadata - patchMetadata
+     * 
+     * Patch non-versioned configuration metadata of a given app configuration.
+     */
+    'patch'(
+      parameters?: Parameters<Paths.V1AppConfigurations$AppId.PathParameters> | null,
+      data?: Paths.PatchMetadata.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.PatchMetadata.Responses.$204>
+    /**
+     * deleteConfiguration - Delete app configuration
+     * 
+     * Delete an app configuration and all its versions and components.
+     */
+    'delete'(
+      parameters?: Parameters<Paths.V1AppConfigurations$AppId.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.DeleteConfiguration.Responses.$204>
+  }
+  ['/v1/app-configurations/{appId}/events']: {
+    /**
+     * queryEvents - queryEvents
+     * 
+     * Query analytics events for a specific app with flexible filtering
+     */
+    'post'(
+      parameters?: Parameters<Paths.QueryEvents.PathParameters> | null,
+      data?: Paths.QueryEvents.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.QueryEvents.Responses.$200>
+  }
+  ['/v1/app-configurations/{appId}/bundle']: {
+    /**
+     * createBundleUploadUrl - createBundleUploadUrl
+     * 
+     * Generate a presigned URL for uploading app bundle to /<app-id>/bundle.js path
+     */
+    'post'(
+      parameters?: Parameters<Paths.CreateBundleUploadUrl.PathParameters> | null,
+      data?: Paths.CreateBundleUploadUrl.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.CreateBundleUploadUrl.Responses.$200>
+  }
+  ['/v1/app-configurations/{appId}/zip']: {
+    /**
+     * createZipUploadUrl - createZipUploadUrl
+     * 
+     * Generate a presigned URL to upload a zip file with artifacts that will be unpacked in a new directory under the /<app-id>/ path
+     * 
+     */
+    'post'(
+      parameters?: Parameters<Paths.CreateZipUploadUrl.PathParameters> | null,
+      data?: Paths.CreateZipUploadUrl.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.CreateZipUploadUrl.Responses.$200>
+  }
+  ['/v1/app-configurations/{appId}/logo']: {
+    /**
+     * createLogoUploadUrl - createLogoUploadUrl
+     * 
+     * Generate a presigned URL for uploading app logo to /<app-id>/logo.png path
+     */
+    'post'(
+      parameters?: Parameters<Paths.V1AppConfigurations$AppIdLogo.PathParameters> | null,
+      data?: Paths.CreateLogoUploadUrl.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.CreateLogoUploadUrl.Responses.$200>
+    /**
+     * deleteLogo - deleteLogo
+     * 
+     * Delete the app logo from /<app-id>/logo.png path
+     */
+    'delete'(
+      parameters?: Parameters<Paths.V1AppConfigurations$AppIdLogo.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.DeleteLogo.Responses.$204>
+  }
+  ['/v1/app-configurations/{appId}/versions']: {
+    /**
+     * listVersions - listVersions
+     * 
+     * Retrieve a list of versions for an app configuration
+     */
+    'get'(
+      parameters?: Parameters<Paths.ListVersions.QueryParameters & Paths.ListVersions.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.ListVersions.Responses.$200>
+  }
+  ['/v1/app-configurations/{appId}/versions/{version}']: {
+    /**
+     * getVersion - getVersion
+     * 
+     * Retrieve a specific version of an app configuration
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetVersion.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetVersion.Responses.$200>
+    /**
+     * deleteVersion - deleteVersion
+     * 
+     * Delete a specific version of an app configuration
+     */
+    'delete'(
+      parameters?: Parameters<Paths.DeleteVersion.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.DeleteVersion.Responses.$204>
+    /**
+     * patchVersion - patchVersion
+     * 
+     * Patch an existing app version
+     */
+    'patch'(
+      parameters?: Parameters<Paths.PatchVersion.PathParameters> | null,
+      data?: Paths.PatchVersion.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.PatchVersion.Responses.$204>
+  }
+  ['/v1/app-configurations/{appId}/versions/{version}/review']: {
+    /**
+     * getReview - getReview
+     * 
+     * Retrieve the review status of a specific app version
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetReview.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetReview.Responses.$200>
+    /**
+     * createReview - createReview
+     * 
+     * Submit an app version for review to make it public
+     */
+    'post'(
+      parameters?: Parameters<Paths.CreateReview.PathParameters> | null,
+      data?: Paths.CreateReview.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.CreateReview.Responses.$200>
+  }
+  ['/v1/app-configurations/{appId}/versions/{version}/components']: {
+    /**
+     * createComponent - createComponent
+     * 
+     * Patch an existing app version to create/add a component
+     */
+    'post'(
+      parameters?: Parameters<Paths.CreateComponent.PathParameters> | null,
+      data?: Paths.CreateComponent.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.CreateComponent.Responses.$200>
+  }
+  ['/v1/app-configurations/{appId}/versions/{version}/components/{componentId}']: {
+    /**
+     * patchComponent - patchComponent
+     * 
+     * Patch an existing app version to update its components
+     */
+    'patch'(
+      parameters?: Parameters<Paths.PatchComponent.PathParameters> | null,
+      data?: Paths.PatchComponent.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.PatchComponent.Responses.$204>
+    /**
+     * deleteComponent - deleteComponent
+     * 
+     * Delete a specific component from an app version
+     */
+    'delete'(
+      parameters?: Parameters<Paths.DeleteComponent.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.DeleteComponent.Responses.$204>
+  }
+  ['/v1/app-configurations/{appId}/versions/{sourceVersion}/clone-to/{targetVersion}']: {
+    /**
+     * cloneVersion - cloneVersion
+     * 
+     * Clone an existing app version to create a new version
+     */
+    'post'(
+      parameters?: Parameters<Paths.CloneVersion.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.CloneVersion.Responses.$201>
+  }
+  ['/v1/app']: {
+    /**
+     * listInstallations - listInstallations
+     * 
+     * Retrieve a list of installed apps for the organization.
+     */
+    'get'(
+      parameters?: Parameters<Paths.ListInstallations.QueryParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.ListInstallations.Responses.$200>
+  }
+  ['/v1/app/{appId}']: {
+    /**
+     * getInstallation - getInstallation
+     * 
+     * Retrieve details of an installed app by its ID.
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetInstallation.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetInstallation.Responses.$200>
+    /**
+     * install - install
+     * 
+     * Upsert app installation by its ID.
+     */
+    'post'(
+      parameters?: Parameters<Paths.Install.PathParameters> | null,
+      data?: Paths.Install.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.Install.Responses.$201>
+    /**
+     * patchInstallation - patchInstallation
+     * 
+     * Patch an installed app by its ID.
+     */
+    'patch'(
+      parameters?: Parameters<Paths.PatchInstallation.PathParameters> | null,
+      data?: Paths.PatchInstallation.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.PatchInstallation.Responses.$204>
+    /**
+     * uninstall - uninstall
+     * 
+     * Uninstall an app by its ID.
+     */
+    'delete'(
+      parameters?: Parameters<Paths.Uninstall.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.Uninstall.Responses.$204>
+  }
+  ['/v1/app/{appId}/promote-to/{version}']: {
+    /**
+     * promoteVersion - promoteVersion
+     * 
+     * Update an installed app to a new version
+     */
+    'post'(
+      parameters?: Parameters<Paths.PromoteVersion.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.PromoteVersion.Responses.$200>
+  }
+  ['/v1/app-events']: {
+    /**
+     * ingestEvent - ingestEvent
+     * 
+     * Internal endpoint for services to submit app events for analytic purposes
+     */
+    'post'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: Paths.IngestEvent.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.IngestEvent.Responses.$202>
+  }
+  ['/v1/public/app/{appId}/proxy/{proxyName}/{path}']: {
+    /**
+     * publicProxyGet - publicProxyGet
+     * 
+     * Forward a GET request to a registered proxy target from a public-facing component (e.g. journey blocks)
+     */
+    'get'(
+      parameters?: Parameters<Paths.V1PublicApp$AppIdProxy$ProxyName$Path.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.PublicProxyGet.Responses.$200>
+    /**
+     * publicProxyPost - publicProxyPost
+     * 
+     * Forward a POST request to a registered proxy target from a public-facing component (e.g. journey blocks)
+     */
+    'post'(
+      parameters?: Parameters<Paths.V1PublicApp$AppIdProxy$ProxyName$Path.PathParameters> | null,
+      data?: Paths.PublicProxyPost.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.PublicProxyPost.Responses.$200>
+  }
+}
+
+type Client = OpenAPIClient<OperationMethods, PathsDictionary>
+
+
+type Actor = Components.Schemas.Actor;
+type AggregatedEvents = Components.Schemas.AggregatedEvents;
+type ApiProxyComponent = Components.Schemas.ApiProxyComponent;
+type ApiProxyConfig = Components.Schemas.ApiProxyConfig;
+type AppBridgeSurfaceConfig = Components.Schemas.AppBridgeSurfaceConfig;
+type AppEventData = Components.Schemas.AppEventData;
+type Audit = Components.Schemas.Audit;
+type Author = Components.Schemas.Author;
+type BaseComponent = Components.Schemas.BaseComponent;
+type BaseComponentCommon = Components.Schemas.BaseComponentCommon;
+type BaseCustomActionConfig = Components.Schemas.BaseCustomActionConfig;
+type BatchEventRequest = Components.Schemas.BatchEventRequest;
+type BillingFrequency = Components.Schemas.BillingFrequency;
+type BlockReferenceArg = Components.Schemas.BlockReferenceArg;
+type BlueprintRef = Components.Schemas.BlueprintRef;
+type BooleanArg = Components.Schemas.BooleanArg;
+type CallerIdentity = Components.Schemas.CallerIdentity;
+type ComponentType = Components.Schemas.ComponentType;
+type Configuration = Components.Schemas.Configuration;
+type ConfigurationMetadata = Components.Schemas.ConfigurationMetadata;
+type ConfigurationVersion = Components.Schemas.ConfigurationVersion;
+type CustomCapabilityComponent = Components.Schemas.CustomCapabilityComponent;
+type CustomFlowActionComponent = Components.Schemas.CustomFlowActionComponent;
+type CustomFlowConfig = Components.Schemas.CustomFlowConfig;
+type CustomPageComponent = Components.Schemas.CustomPageComponent;
+type CustomPageConfig = Components.Schemas.CustomPageConfig;
+type EnumArg = Components.Schemas.EnumArg;
+type ErpInformToolkitComponent = Components.Schemas.ErpInformToolkitComponent;
+type EventsQuery = Components.Schemas.EventsQuery;
+type EventsQueryResponse = Components.Schemas.EventsQueryResponse;
+type ExternalIntegrationCustomActionConfig = Components.Schemas.ExternalIntegrationCustomActionConfig;
+type ExternalProductCatalogAuthBlock = Components.Schemas.ExternalProductCatalogAuthBlock;
+type ExternalProductCatalogComponent = Components.Schemas.ExternalProductCatalogComponent;
+type ExternalProductCatalogConfig = Components.Schemas.ExternalProductCatalogConfig;
+type ExternalProductCatalogHookProductRecommendations = Components.Schemas.ExternalProductCatalogHookProductRecommendations;
+type ExternalProductCatalogHookProducts = Components.Schemas.ExternalProductCatalogHookProducts;
+type Grants = Components.Schemas.Grants;
+type Installation = Components.Schemas.Installation;
+type JourneyBlockComponent = Components.Schemas.JourneyBlockComponent;
+type JourneyBlockComponentArgs = Components.Schemas.JourneyBlockComponentArgs;
+type JourneyBlockConfig = Components.Schemas.JourneyBlockConfig;
+type NotificationConfig = Components.Schemas.NotificationConfig;
+type NotificationEvent = Components.Schemas.NotificationEvent;
+type ObjectField = Components.Schemas.ObjectField;
+type Option = Components.Schemas.Option;
+type Options = Components.Schemas.Options;
+type OptionsRef = Components.Schemas.OptionsRef;
+type OverrideDevMode = Components.Schemas.OverrideDevMode;
+type PortalBlockComponent = Components.Schemas.PortalBlockComponent;
+type PortalBlockConfig = Components.Schemas.PortalBlockConfig;
+type PortalBlockSurfaceConfig = Components.Schemas.PortalBlockSurfaceConfig;
+type PortalExtensionAuthBlock = Components.Schemas.PortalExtensionAuthBlock;
+type PortalExtensionComponent = Components.Schemas.PortalExtensionComponent;
+type PortalExtensionConfig = Components.Schemas.PortalExtensionConfig;
+type PortalExtensionHookConsumptionDataRetrieval = Components.Schemas.PortalExtensionHookConsumptionDataRetrieval;
+type PortalExtensionHookContractIdentification = Components.Schemas.PortalExtensionHookContractIdentification;
+type PortalExtensionHookCostDataRetrieval = Components.Schemas.PortalExtensionHookCostDataRetrieval;
+type PortalExtensionHookDataExport = Components.Schemas.PortalExtensionHookDataExport;
+type PortalExtensionHookMeterReadingPlausibilityCheck = Components.Schemas.PortalExtensionHookMeterReadingPlausibilityCheck;
+type PortalExtensionHookPriceDataRetrieval = Components.Schemas.PortalExtensionHookPriceDataRetrieval;
+type PortalExtensionHookRegistrationIdentifiersCheck = Components.Schemas.PortalExtensionHookRegistrationIdentifiersCheck;
+type PortalExtensionHookVisualizationMetadata = Components.Schemas.PortalExtensionHookVisualizationMetadata;
+type PortalExtensionSeamlessLink = Components.Schemas.PortalExtensionSeamlessLink;
+type PortalExtensionSecureProxy = Components.Schemas.PortalExtensionSecureProxy;
+type Pricing = Components.Schemas.Pricing;
+type PublicConfiguration = Components.Schemas.PublicConfiguration;
+type RawEvents = Components.Schemas.RawEvents;
+type Review = Components.Schemas.Review;
+type Role = Components.Schemas.Role;
+type S3Reference = Components.Schemas.S3Reference;
+type SandboxCustomActionConfig = Components.Schemas.SandboxCustomActionConfig;
+type TextArg = Components.Schemas.TextArg;
+type TranslatedString = Components.Schemas.TranslatedString;
+
+export { type PortalBlockComponent as $, type Actor as A, type BaseComponent as B, type Client as C, type ErpInformToolkitComponent as D, type EnumArg as E, type EventsQuery as F, type EventsQueryResponse as G, type ExternalIntegrationCustomActionConfig as H, type ExternalProductCatalogAuthBlock as I, type ExternalProductCatalogComponent as J, type ExternalProductCatalogConfig as K, type ExternalProductCatalogHookProductRecommendations as L, type ExternalProductCatalogHookProducts as M, type Grants as N, type OperationMethods as O, Paths as P, type Installation as Q, type JourneyBlockComponent as R, type JourneyBlockComponentArgs as S, type JourneyBlockConfig as T, type NotificationConfig as U, type NotificationEvent as V, type ObjectField as W, type Option as X, type Options as Y, type OptionsRef as Z, type OverrideDevMode as _, Components as a, type PortalBlockConfig as a0, type PortalBlockSurfaceConfig as a1, type PortalExtensionAuthBlock as a2, type PortalExtensionComponent as a3, type PortalExtensionConfig as a4, type PortalExtensionHookConsumptionDataRetrieval as a5, type PortalExtensionHookContractIdentification as a6, type PortalExtensionHookCostDataRetrieval as a7, type PortalExtensionHookDataExport as a8, type PortalExtensionHookMeterReadingPlausibilityCheck as a9, type PortalExtensionHookPriceDataRetrieval as aa, type PortalExtensionHookRegistrationIdentifiersCheck as ab, type PortalExtensionHookVisualizationMetadata as ac, type PortalExtensionSeamlessLink as ad, type PortalExtensionSecureProxy as ae, type Pricing as af, type PublicConfiguration as ag, type RawEvents as ah, type Review as ai, type Role as aj, type S3Reference as ak, type SandboxCustomActionConfig as al, type TextArg as am, type TranslatedString as an, type PathsDictionary as b, type AggregatedEvents as c, type ApiProxyComponent as d, type ApiProxyConfig as e, type AppBridgeSurfaceConfig as f, type AppEventData as g, type Audit as h, type Author as i, type BaseComponentCommon as j, type BaseCustomActionConfig as k, type BatchEventRequest as l, type BillingFrequency as m, type BlockReferenceArg as n, type BlueprintRef as o, type BooleanArg as p, type CallerIdentity as q, type ComponentType as r, type Configuration as s, type ConfigurationMetadata as t, type ConfigurationVersion as u, type CustomCapabilityComponent as v, type CustomFlowActionComponent as w, type CustomFlowConfig as x, type CustomPageComponent as y, type CustomPageConfig as z };