@epilot/sdk 2.18.21 → 2.18.23

package/dist/{customer-portal.d-JVkJjm_e.d.ts → customer-portal.d-Ce8-UnSY.d.ts}

@@ -10,6 +10,9 @@ declare namespace Components {
              * Error message
              */
             message?: string;
+            /**
+             * Machine-readable cause, when the API can name one. `PORTAL_USER_PENDING_ACTIVATION` means the portal user is authenticated but not mapped to a contact yet, so re-authenticating will not help.
+             */
             reason: "invalid_token";
         }
         export type Conflict = Schemas.ErrorResp;
@@ -28,6 +31,9 @@ declare namespace Components {
         export type InternalServerError = Schemas.ErrorResp;
         export type InvalidRequest = Schemas.ErrorResp;
         export type InvalidRequestCreateMeterReading = {
+            /**
+             * Machine-readable cause, when the API can name one. `PORTAL_USER_PENDING_ACTIVATION` means the portal user is authenticated but not mapped to a contact yet, so re-authenticating will not help.
+             */
             reason?: "plausibility_check_failed" | "contract_period" | "no_counter" | "no_direction" | "timestamp_future" | "less_than_previous" | "greater_than_subsequent" | "meter_decommissioned" | "plausibility_check_failed";
             upper_limit: number;
             lower_limit: number;
@@ -2944,6 +2950,22 @@ declare namespace Components {
              */
             auto_create_cognito_user?: boolean;
         }
+        /**
+         * Linearized portal workflows of a single entity
+         */
+        export interface EntityPortalWorkflows {
+            entity_id: string;
+            /**
+             * Empty when the entity has no portal-relevant workflow
+             */
+            portal_workflows: /**
+             * A portal-facing projection of a workflow execution (V1 or V2), with the execution
+             * graph already linearized by the Workflows API into a flat, ordered list of
+             * portal-visible tasks.
+             *
+             */
+            PortalWorkflow[];
+        }
         /**
          * Response for entity get request
          */
@@ -3296,6 +3318,10 @@ declare namespace Components {
              * Error message
              */
             message?: string;
+            /**
+             * Machine-readable cause, when the API can name one. `PORTAL_USER_PENDING_ACTIVATION` means the portal user is authenticated but not mapped to a contact yet, so re-authenticating will not help.
+             */
+            reason?: string;
         }
         /**
          * example:
@@ -4713,6 +4739,20 @@ declare namespace Components {
              */
             is_new?: boolean;
         }
+        export interface FilePreviewResult {
+            /**
+             * What kind of preview (if any) is available. "pdf" covers both native PDFs and Office documents that were converted to PDF server-side. "unsupported" means no preview is available and the caller should fall back to download.
+             */
+            kind: "pdf" | "image" | "unsupported";
+            /**
+             * A Content-Disposition: inline URL to render in a preview viewer. Present only when kind is "pdf" or "image". Short-lived — do not cache across dialog opens.
+             */
+            url?: string; // uri
+            /**
+             * Optional download URL for the file, returned for any kind — including "unsupported" — whenever the file entity exposes one. It is only a Content-Disposition: attachment URL for files with access_control "private", where it is a short-lived signed URL; for any other access level it is the file entity's plain public/CDN object URL, which carries no attachment disposition and may render inline in the browser. Absent when the file entity exposes no usable URL, so clients must handle it being missing.
+             */
+            download_url?: string; // uri
+        }
         export interface Grant {
             /**
              * Action for granting permission
@@ -6578,9 +6618,10 @@ declare namespace Components {
              * providers not in the list are deleted. Omit the field to leave SSO
              * configuration unchanged; send an empty array to remove all providers.
              *
-             * Each provider is persisted verbatim — `oidc_config.client_secret` is stored
-             * as sent. Customers are encouraged to reference an org env secret via
-             * `{{ env.VAR }}` rather than embed raw values.
+             * Secrets: a provider sent without `oidc_config.client_secret` keeps the
+             * stored secret for the same slug; an explicit empty string clears it.
+             * `getPortalConfigV3` returns providers with raw secrets redacted;
+             * `{{ env.VAR }}` references pass through.
              *
              */
             identity_providers?: ProviderPublicConfig[];
@@ -8098,7 +8139,10 @@ declare namespace Components {
             use_case_slug: string;
         }
         export type Source = "ECP" | "ERP" | "360" | "journey-submission";
-        export type SwappableConfig = "all" | "domain" | "users" | "email_templates";
+        /**
+         * Optional configuration item that a portal swap can additionally include. The swap always transfers the pages and the functional experience config that keep the portal working. These items are opt-in on top of that and are OFF by default. Domain and access/security settings (domain, cognito_details, auth_settings) can never be swapped and are therefore not part of this enum.
+         */
+        export type SwappableConfig = "email_templates";
         export type TariffType = "ht" | "nt";
         export interface TeaserWidget {
             id: string;
@@ -8196,9 +8240,10 @@ declare namespace Components {
              * providers not in the list are deleted. Omit the field to leave SSO
              * configuration unchanged; send an empty array to remove all providers.
              *
-             * Each provider is persisted verbatim — `oidc_config.client_secret` is stored
-             * as sent. Customers are encouraged to reference an org env secret via
-             * `{{ env.VAR }}` rather than embed raw values.
+             * Secrets: a provider sent without `oidc_config.client_secret` keeps the
+             * stored secret for the same slug; an explicit empty string clears it.
+             * `getPortalConfigV3` returns providers with raw secrets redacted;
+             * `{{ env.VAR }}` references pass through.
              *
              */
             identity_providers?: /**
@@ -8264,9 +8309,10 @@ declare namespace Components {
              * providers not in the list are deleted. Omit the field to leave SSO
              * configuration unchanged; send an empty array to remove all providers.
              *
-             * Each provider is persisted verbatim — `oidc_config.client_secret` is stored
-             * as sent. Customers are encouraged to reference an org env secret via
-             * `{{ env.VAR }}` rather than embed raw values.
+             * Secrets: a provider sent without `oidc_config.client_secret` keeps the
+             * stored secret for the same slug; an explicit empty string clears it.
+             * `getPortalConfigV3` returns providers with raw secrets redacted;
+             * `{{ env.VAR }}` references pass through.
              *
              */
             identity_providers?: /**
@@ -8851,9 +8897,10 @@ declare namespace Components {
              * providers not in the list are deleted. Omit the field to leave SSO
              * configuration unchanged; send an empty array to remove all providers.
              *
-             * Each provider is persisted verbatim — `oidc_config.client_secret` is stored
-             * as sent. Customers are encouraged to reference an org env secret via
-             * `{{ env.VAR }}` rather than embed raw values.
+             * Secrets: a provider sent without `oidc_config.client_secret` keeps the
+             * stored secret for the same slug; an explicit empty string clears it.
+             * `getPortalConfigV3` returns providers with raw secrets redacted;
+             * `{{ env.VAR }}` references pass through.
              *
              */
             identity_providers?: /**
@@ -11740,6 +11787,621 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
+    namespace GetEntityPortalWorkflowsBatch {
+        export interface RequestBody {
+            entities: [
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                },
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?
+            ];
+        }
+        namespace Responses {
+            export interface $200 {
+                results?: /* Linearized portal workflows of a single entity */ Components.Schemas.EntityPortalWorkflows[];
+            }
+            export type $400 = Components.Responses.InvalidRequest;
+            export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
+            export type $500 = Components.Responses.InternalServerError;
+        }
+    }
     namespace GetEntityWorkflows {
         namespace Parameters {
             /**
@@ -11916,6 +12578,26 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
+    namespace GetFilePreview {
+        namespace Parameters {
+            export type Id = /**
+             * Entity ID
+             * example:
+             * 5da0a718-c822-403d-9f5d-20d4584e0528
+             */
+            Components.Schemas.EntityId /* uuid */;
+        }
+        export interface PathParameters {
+            id: Parameters.Id;
+        }
+        namespace Responses {
+            export type $200 = Components.Schemas.FilePreviewResult;
+            export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
+            export type $404 = Components.Responses.NotFound;
+            export type $500 = Components.Responses.InternalServerError;
+        }
+    }
     namespace GetFilesCountByEntity {
         namespace Responses {
             export type $200 = Components.Schemas.EntityFileCount[];
@@ -15003,6 +15685,10 @@ declare namespace Paths {
                      * The email address registered in the journey's Login & Registration block
                      */
                     journey_registration_email?: string;
+                    /**
+                     * The portal selected on the journey's Login & Registration block, used to target the registration link to that portal
+                     */
+                    journey_registration_portal_id?: string;
                 };
             };
         }
@@ -15436,9 +16122,9 @@ declare namespace Paths {
              */
             Components.Schemas.PortalId;
             /**
-             * Items to swap
+             * Optional, opt-in configuration items to additionally swap on top of the always-swapped pages and functional config. Defaults to an empty list (nothing extra swapped). Domain and access/security settings can never be swapped.
              */
-            items_to_swap?: Components.Schemas.SwappableConfig[];
+            items_to_swap?: /* Optional configuration item that a portal swap can additionally include. The swap always transfers the pages and the functional experience config that keep the portal working. These items are opt-in on top of that and are OFF by default. Domain and access/security settings (domain, cognito_details, auth_settings) can never be swapped and are therefore not part of this enum. */ Components.Schemas.SwappableConfig[];
         }
         namespace Responses {
             export interface $200 {
@@ -16431,7 +17117,7 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetPublicPortalExtensionDetailsV3.Responses.$200>
   /**
-   * getConsumption - Get Consumption
+   * getConsumption - getConsumption
    * 
    * Get energy consumption data between a given time period.
    */
@@ -16441,7 +17127,7 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetConsumption.Responses.$200>
   /**
-   * prepareVisualizationExport - Prepare Visualization Export
+   * prepareVisualizationExport - prepareVisualizationExport
    * 
    * Asks an installed App to prepare a downloadable export of a visualization (consumption chart, dynamic tariff chart, etc.). The export is produced by the third-party App via a configured portal extension hook of type `dataExport` — this endpoint does not generate the file itself, it forwards the request to the configured hook and returns the descriptor the App provides (typically a `download_url`).
    * 
@@ -16452,7 +17138,7 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.PrepareVisualizationExport.Responses.$200>
   /**
-   * getVisualizationMetadata - Get Visualization Metadata
+   * getVisualizationMetadata - getVisualizationMetadata
    * 
    * Returns runtime metadata describing how a visualization (consumption / price / cost chart) should be rendered for a given portal context (meter, contract, etc). Resolves the extension's `visualizationMetadata` hook implicitly from `app_id` + `extensionId` and invokes it. Supplies the response as a structured payload that the portal uses to configure type/aggregation options, supported intervals, and the available data range.
    * 
@@ -16463,7 +17149,7 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetVisualizationMetadata.Responses.$200>
   /**
-   * getCosts - Get Costs
+   * getCosts - getCosts
    * 
    * Get energy cost data between a given time period.
    */
@@ -16473,7 +17159,7 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetCosts.Responses.$200>
   /**
-   * getPrices - Get Prices
+   * getPrices - getPrices
    * 
    * Get energy prices data between a given time period.
    */
@@ -17309,6 +17995,16 @@ interface OperationMethods {
     data?: any,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetFileById.Responses.$200>
+  /**
+   * getFilePreview - getFilePreview
+   * 
+   * resolves an in-portal preview for a file. Returns a Content-Disposition: inline URL for directly-previewable files (PDF, common image formats), or a document-api PDF conversion result for the Office formats it currently supports (docx/xls/xlsx/xlsm) -- NOT doc/csv/pptx, which document-api's conversion does not cover today. Returns { kind: "unsupported" } (no url) for anything else, so the caller can fall back to the existing download flow. An optional `download_url` is returned for all kinds — including "unsupported" — whenever the file entity exposes one, so the client can render a real anchor for its Download action; it is only a Content-Disposition: attachment URL for private files, and for other access levels it is the plain object URL, which may render inline. The previewability decision is made server-side from the file's own filename/mime_type — never trust a client-supplied kind for anything security-sensitive.
+   */
+  'getFilePreview'(
+    parameters?: Parameters<Paths.GetFilePreview.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetFilePreview.Responses.$200>
   /**
    * trackFileDownloaded - trackFileDownloaded
    * 
@@ -17320,7 +18016,7 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.TrackFileDownloaded.Responses.$200>
   /**
-   * getFilesCountByEntity - getFileCountByEntity
+   * getFilesCountByEntity - getFilesCountByEntity
    * 
    * Fetch file counts for all ECP user related entities
    */
@@ -17474,7 +18170,7 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.UpdateWorkflowStepAsDone.Responses.$200>
   /**
-   * getEntityWorkflows - Get workflows for an entity
+   * getEntityWorkflows - getEntityWorkflows
    * 
    * Get all workflows associated with an entity (requires access to the entity)
    */
@@ -17484,7 +18180,7 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetEntityWorkflows.Responses.$200>
   /**
-   * getEntityPortalWorkflows - Get linearized workflows for an entity
+   * getEntityPortalWorkflows - getEntityPortalWorkflows
    * 
    * Get all portal-relevant workflows associated with an entity (requires access to the entity),
    * linearized by the Workflows API into a flat, ordered list of portal-visible tasks.
@@ -17504,7 +18200,25 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetEntityPortalWorkflows.Responses.$200>
   /**
-   * uploadMeterReadingPhoto - Upload Meter Reading Photo
+   * getEntityPortalWorkflowsBatch - getEntityPortalWorkflowsBatch
+   * 
+   * Batch variant of `getEntityPortalWorkflows`: returns portal-relevant workflows for
+   * up to 50 entities — schemas may differ — in a single call, each already linearized
+   * by the Workflows API into a flat, ordered list of portal-visible tasks.
+   * 
+   * Intended for portal list views (e.g. an entity list where every card shows its
+   * workflow progress). Entities the portal user cannot access are omitted from the
+   * response; an entry with an empty task list means the entity has no portal-relevant
+   * workflow.
+   * 
+   */
+  'getEntityPortalWorkflowsBatch'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: Paths.GetEntityPortalWorkflowsBatch.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetEntityPortalWorkflowsBatch.Responses.$200>
+  /**
+   * uploadMeterReadingPhoto - uploadMeterReadingPhoto
    * 
    * Uploads a Meter Reading photo and - if enabled - gives back data extracted from the photo.
    */
@@ -17514,7 +18228,7 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.UploadMeterReadingPhoto.Responses.$200>
   /**
-   * createMeterReading - Create Meter Reading
+   * createMeterReading - createMeterReading
    * 
    * Inserts a new meter reading.
    */
@@ -17524,7 +18238,9 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.CreateMeterReading.Responses.$200>
   /**
-   * getAllowedMeterReadingRange - Get allowed reading range for all counters of a meter from the configured
+   * getAllowedMeterReadingRange - getAllowedMeterReadingRange
+   * 
+   * Get allowed reading range for all counters of a meter from the configured
    * third-party plausibility check hook using 'range' mode. This endpoint requires
    * a plausibility check hook to be configured for the portal.
    * 
@@ -17535,7 +18251,7 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetAllowedMeterReadingRange.Responses.$200>
   /**
-   * getMeterReadings - Get meter readings with optional template resolution
+   * getMeterReadings - getMeterReadings
    * 
    * Fetches meter readings for a counter and optionally resolves Handlebars
    * template strings against each reading object using @epilot/variables.
@@ -17782,7 +18498,7 @@ interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetUserEntryPoint.Responses.$200>
   /**
-   * updateCampaignPortalBlockStatus - Update Campaign Portal Block Status
+   * updateCampaignPortalBlockStatus - updateCampaignPortalBlockStatus
    * 
    * Updates the status of a campaign portal block for multiple recipients.
    */
@@ -18176,7 +18892,7 @@ interface PathsDictionary {
   }
   ['/v2/portal/consumption']: {
     /**
-     * getConsumption - Get Consumption
+     * getConsumption - getConsumption
      * 
      * Get energy consumption data between a given time period.
      */
@@ -18188,7 +18904,7 @@ interface PathsDictionary {
   }
   ['/v2/portal/visualization:export']: {
     /**
-     * prepareVisualizationExport - Prepare Visualization Export
+     * prepareVisualizationExport - prepareVisualizationExport
      * 
      * Asks an installed App to prepare a downloadable export of a visualization (consumption chart, dynamic tariff chart, etc.). The export is produced by the third-party App via a configured portal extension hook of type `dataExport` — this endpoint does not generate the file itself, it forwards the request to the configured hook and returns the descriptor the App provides (typically a `download_url`).
      * 
@@ -18201,7 +18917,7 @@ interface PathsDictionary {
   }
   ['/v2/portal/visualization/metadata']: {
     /**
-     * getVisualizationMetadata - Get Visualization Metadata
+     * getVisualizationMetadata - getVisualizationMetadata
      * 
      * Returns runtime metadata describing how a visualization (consumption / price / cost chart) should be rendered for a given portal context (meter, contract, etc). Resolves the extension's `visualizationMetadata` hook implicitly from `app_id` + `extensionId` and invokes it. Supplies the response as a structured payload that the portal uses to configure type/aggregation options, supported intervals, and the available data range.
      * 
@@ -18214,7 +18930,7 @@ interface PathsDictionary {
   }
   ['/v2/portal/costs']: {
     /**
-     * getCosts - Get Costs
+     * getCosts - getCosts
      * 
      * Get energy cost data between a given time period.
      */
@@ -18226,7 +18942,7 @@ interface PathsDictionary {
   }
   ['/v2/portal/prices']: {
     /**
-     * getPrices - Get Prices
+     * getPrices - getPrices
      * 
      * Get energy prices data between a given time period.
      */
@@ -19199,6 +19915,18 @@ interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GetFileById.Responses.$200>
   }
+  ['/v2/portal/user/file/{id}/preview']: {
+    /**
+     * getFilePreview - getFilePreview
+     * 
+     * resolves an in-portal preview for a file. Returns a Content-Disposition: inline URL for directly-previewable files (PDF, common image formats), or a document-api PDF conversion result for the Office formats it currently supports (docx/xls/xlsx/xlsm) -- NOT doc/csv/pptx, which document-api's conversion does not cover today. Returns { kind: "unsupported" } (no url) for anything else, so the caller can fall back to the existing download flow. An optional `download_url` is returned for all kinds — including "unsupported" — whenever the file entity exposes one, so the client can render a real anchor for its Download action; it is only a Content-Disposition: attachment URL for private files, and for other access levels it is the plain object URL, which may render inline. The previewability decision is made server-side from the file's own filename/mime_type — never trust a client-supplied kind for anything security-sensitive.
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetFilePreview.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetFilePreview.Responses.$200>
+  }
   ['/v2/portal/user/file/{id}/downloaded']: {
     /**
      * trackFileDownloaded - trackFileDownloaded
@@ -19213,7 +19941,7 @@ interface PathsDictionary {
   }
   ['/v2/portal/user/files/count-by-entity']: {
     /**
-     * getFilesCountByEntity - getFileCountByEntity
+     * getFilesCountByEntity - getFilesCountByEntity
      * 
      * Fetch file counts for all ECP user related entities
      */
@@ -19395,7 +20123,7 @@ interface PathsDictionary {
   }
   ['/v2/portal/entity/{slug}/{id}/workflows']: {
     /**
-     * getEntityWorkflows - Get workflows for an entity
+     * getEntityWorkflows - getEntityWorkflows
      * 
      * Get all workflows associated with an entity (requires access to the entity)
      */
@@ -19407,7 +20135,7 @@ interface PathsDictionary {
   }
   ['/v2/portal/entity/{slug}/{id}/workflows/linearized']: {
     /**
-     * getEntityPortalWorkflows - Get linearized workflows for an entity
+     * getEntityPortalWorkflows - getEntityPortalWorkflows
      * 
      * Get all portal-relevant workflows associated with an entity (requires access to the entity),
      * linearized by the Workflows API into a flat, ordered list of portal-visible tasks.
@@ -19427,9 +20155,29 @@ interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GetEntityPortalWorkflows.Responses.$200>
   }
+  ['/v2/portal/entities/workflows/linearized/batch']: {
+    /**
+     * getEntityPortalWorkflowsBatch - getEntityPortalWorkflowsBatch
+     * 
+     * Batch variant of `getEntityPortalWorkflows`: returns portal-relevant workflows for
+     * up to 50 entities — schemas may differ — in a single call, each already linearized
+     * by the Workflows API into a flat, ordered list of portal-visible tasks.
+     * 
+     * Intended for portal list views (e.g. an entity list where every card shows its
+     * workflow progress). Entities the portal user cannot access are omitted from the
+     * response; an entry with an empty task list means the entity has no portal-relevant
+     * workflow.
+     * 
+     */
+    'post'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: Paths.GetEntityPortalWorkflowsBatch.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetEntityPortalWorkflowsBatch.Responses.$200>
+  }
   ['/v2/portal/metering/reading/photo']: {
     /**
-     * uploadMeterReadingPhoto - Upload Meter Reading Photo
+     * uploadMeterReadingPhoto - uploadMeterReadingPhoto
      * 
      * Uploads a Meter Reading photo and - if enabled - gives back data extracted from the photo.
      */
@@ -19441,7 +20189,7 @@ interface PathsDictionary {
   }
   ['/v2/portal/metering/reading']: {
     /**
-     * createMeterReading - Create Meter Reading
+     * createMeterReading - createMeterReading
      * 
      * Inserts a new meter reading.
      */
@@ -19453,7 +20201,9 @@ interface PathsDictionary {
   }
   ['/v2/portal/metering/reading/allowed-range/{meter_id}']: {
     /**
-     * getAllowedMeterReadingRange - Get allowed reading range for all counters of a meter from the configured
+     * getAllowedMeterReadingRange - getAllowedMeterReadingRange
+     * 
+     * Get allowed reading range for all counters of a meter from the configured
      * third-party plausibility check hook using 'range' mode. This endpoint requires
      * a plausibility check hook to be configured for the portal.
      * 
@@ -19466,7 +20216,7 @@ interface PathsDictionary {
   }
   ['/v2/portal/metering/readings']: {
     /**
-     * getMeterReadings - Get meter readings with optional template resolution
+     * getMeterReadings - getMeterReadings
      * 
      * Fetches meter readings for a counter and optionally resolves Handlebars
      * template strings against each reading object using @epilot/variables.
@@ -19743,7 +20493,7 @@ interface PathsDictionary {
   }
   ['/v2/portal/campaign/{campaign_id}/entity:status']: {
     /**
-     * updateCampaignPortalBlockStatus - Update Campaign Portal Block Status
+     * updateCampaignPortalBlockStatus - updateCampaignPortalBlockStatus
      * 
      * Updates the status of a campaign portal block for multiple recipients.
      */
@@ -20047,6 +20797,7 @@ type EntityGetParams = Components.Schemas.EntityGetParams;
 type EntityId = Components.Schemas.EntityId;
 type EntityItem = Components.Schemas.EntityItem;
 type EntityMatchingConfig = Components.Schemas.EntityMatchingConfig;
+type EntityPortalWorkflows = Components.Schemas.EntityPortalWorkflows;
 type EntityResponse = Components.Schemas.EntityResponse;
 type EntityResponseGroupedWithHits = Components.Schemas.EntityResponseGroupedWithHits;
 type EntityResponseWithHits = Components.Schemas.EntityResponseWithHits;
@@ -20079,6 +20830,7 @@ type ExtraSchemaAttributes = Components.Schemas.ExtraSchemaAttributes;
 type FailedRuleErrorResp = Components.Schemas.FailedRuleErrorResp;
 type File = Components.Schemas.File;
 type FileItem = Components.Schemas.FileItem;
+type FilePreviewResult = Components.Schemas.FilePreviewResult;
 type Grant = Components.Schemas.Grant;
 type IdentifierAttribute = Components.Schemas.IdentifierAttribute;
 type InstallmentEvent = Components.Schemas.InstallmentEvent;
@@ -20166,4 +20918,4 @@ type WorfklowIdentifier = Components.Schemas.WorfklowIdentifier;
 type WorkflowExecution = Components.Schemas.WorkflowExecution;
 type WorkflowStep = Components.Schemas.WorkflowStep;
 
-export { type EntityItem as $, type AcceptanceDecision as A, type Balance as B, type Client as C, type CommonConfigAttributesV3 as D, type Contact as E, type ContactCountRequest as F, type ContactExistsRequest as G, type ContentWidget as H, type ContextEntities as I, type ContextEntity as J, type Contract as K, type ContractIdentifier as L, type CreateUserRequest as M, type Currency as N, type OperationMethods as O, Paths as P, type DataRetrievalItem as Q, DeleteEntityFile as R, type Direction as S, type DocumentWidget as T, type DomainSettings as U, type EmailTemplates as V, type Entity as W, type EntityEditRule as X, type EntityFileCount as Y, type EntityGetParams as Z, type EntityId as _, Components as a, type PortalId as a$, type EntityMatchingConfig as a0, type EntityResponse as a1, type EntityResponseGroupedWithHits as a2, type EntityResponseWithHits as a3, type EntitySearchParams as a4, type EntitySlug as a5, type EntitySlugConfig as a6, type EntityTemplates as a7, type EntityWidget as a8, type ErrorResp as a9, type JourneyActions as aA, type JuiceSettings as aB, type Meter as aC, type MeterChartWidget as aD, type MeterReading as aE, type MeterReadingPhoto as aF, type MeterReadingPhotoData as aG, type MeterReadingWidget as aH, type MobileBranding as aI, type MobileBuildStatus as aJ, type MobileConfig as aK, type MobileConfigUpdate as aL, type MobileOtaConfig as aM, type MoblieOIDCConfig as aN, type OIDCProviderConfig as aO, type OIDCProviderMetadata as aP, type Opportunity as aQ, type Order as aR, type OrganizationSettings as aS, type Origin as aT, type OtaPortal as aU, type Page as aV, type PageRequest as aW, type PaymentWidget as aX, type PortalConfig as aY, type PortalConfigV3 as aZ, type PortalDataExportColumn as a_, type Exists as aa, type Extension as ab, type ExtensionAuthBlock as ac, type ExtensionConfig as ad, type ExtensionHook as ae, type ExtensionHookChangeEmail as af, type ExtensionHookChangePassword as ag, type ExtensionHookConsumptionDataRetrieval as ah, type ExtensionHookContractIdentification as ai, type ExtensionHookCostDataRetrieval as aj, type ExtensionHookDataExport as ak, type ExtensionHookDeleteAccount as al, type ExtensionHookMeterReadingPlausibilityCheck as am, type ExtensionHookPriceDataRetrieval as an, type ExtensionHookRegistrationIdentifiersCheck as ao, type ExtensionHookSelection as ap, type ExtensionHookVisualizationMetadata as aq, type ExtensionSeamlessLink as ar, type ExternalLink as as, type ExtraSchemaAttributes as at, type FailedRuleErrorResp as au, type File as av, type FileItem as aw, type Grant as ax, type IdentifierAttribute as ay, type InstallmentEvent as az, type PathsDictionary as b, type PortalTaskConfig as b0, type PortalUser as b1, type PortalUserRegistrationStatus as b2, type PortalWidget as b3, type PortalWorkflow as b4, type PortalWorkflowTask as b5, type Product as b6, type ProductRecommendationsWidget as b7, type ProviderConfig as b8, type ProviderDisplayName as b9, type SecureProxyConfig as bA, type Source as bB, type SwappableConfig as bC, type TariffType as bD, type TeaserWidget as bE, type TriggerPortalFlow as bF, type UpdateOnlyPortalConfigAttributes as bG, type UpsertPortalConfig as bH, type UpsertPortalConfigV3 as bI, UpsertPortalWidget as bJ, type UserRequest as bK, type VisualizationDataRange as bL, type VisualizationMetadata as bM, type VisualizationTypeOption as bN, type WidgetAction as bO, type WidgetBase as bP, type WorfklowIdentifier as bQ, type WorkflowExecution as bR, type WorkflowStep as bS, type ProviderPublicConfig as ba, type ProviderSlug as bb, type PublicAppDetails as bc, type PublicChangeEmailDetails as bd, type PublicChangePasswordDetails as be, type PublicContractIdentificationDetails as bf, type PublicDataRetrievalHookDetails as bg, type PublicDeleteAccountDetails as bh, type PublicExtensionCapabilities as bi, type PublicExtensionDetails as bj, type PublicMeterReadingPlausibilityCheckDetails as bk, type PublicSelfManagementExplanation as bl, type ReadBy as bm, type ReadingStatus as bn, type Reason as bo, type RegistrationIdentifier as bp, type ReimbursementEvent as bq, type Rule as br, type SAMLProviderConfig as bs, type SSOCallbackRequest as bt, type SSOCallbackResponse as bu, type SSOLoginToken as bv, SaveEntityFile as bw, type SavePortalFile as bx, type Schema as by, type SearchIncludes as bz, type AccountExistsRequest as c, type ActionLabel as d, type ActionWidget as e, type Activity as f, type ActivityCallerContext as g, type ActivityId as h, type ActivityItem as i, type AdditionalContactAttribute as j, type AdminUser as k, type AllowedFileExtensions as l, type AttributeMappingConfig as m, type AuthConfig as n, type BaseBillingEvent as o, type BaseEntity as p, type BillingAccount as q, type BillingEvent as r, type Block as s, type BlockId as t, type BlockProps as u, type BlockRequest as v, type BlockType as w, type BusinessPartnerItem as x, type CampaignWidget as y, type CommonConfigAttributes as z };
+export { type EntityItem as $, type AcceptanceDecision as A, type Balance as B, type Client as C, type CommonConfigAttributesV3 as D, type Contact as E, type ContactCountRequest as F, type ContactExistsRequest as G, type ContentWidget as H, type ContextEntities as I, type ContextEntity as J, type Contract as K, type ContractIdentifier as L, type CreateUserRequest as M, type Currency as N, type OperationMethods as O, Paths as P, type DataRetrievalItem as Q, DeleteEntityFile as R, type Direction as S, type DocumentWidget as T, type DomainSettings as U, type EmailTemplates as V, type Entity as W, type EntityEditRule as X, type EntityFileCount as Y, type EntityGetParams as Z, type EntityId as _, Components as a, type PortalConfigV3 as a$, type EntityMatchingConfig as a0, type EntityPortalWorkflows as a1, type EntityResponse as a2, type EntityResponseGroupedWithHits as a3, type EntityResponseWithHits as a4, type EntitySearchParams as a5, type EntitySlug as a6, type EntitySlugConfig as a7, type EntityTemplates as a8, type EntityWidget as a9, type IdentifierAttribute as aA, type InstallmentEvent as aB, type JourneyActions as aC, type JuiceSettings as aD, type Meter as aE, type MeterChartWidget as aF, type MeterReading as aG, type MeterReadingPhoto as aH, type MeterReadingPhotoData as aI, type MeterReadingWidget as aJ, type MobileBranding as aK, type MobileBuildStatus as aL, type MobileConfig as aM, type MobileConfigUpdate as aN, type MobileOtaConfig as aO, type MoblieOIDCConfig as aP, type OIDCProviderConfig as aQ, type OIDCProviderMetadata as aR, type Opportunity as aS, type Order as aT, type OrganizationSettings as aU, type Origin as aV, type OtaPortal as aW, type Page as aX, type PageRequest as aY, type PaymentWidget as aZ, type PortalConfig as a_, type ErrorResp as aa, type Exists as ab, type Extension as ac, type ExtensionAuthBlock as ad, type ExtensionConfig as ae, type ExtensionHook as af, type ExtensionHookChangeEmail as ag, type ExtensionHookChangePassword as ah, type ExtensionHookConsumptionDataRetrieval as ai, type ExtensionHookContractIdentification as aj, type ExtensionHookCostDataRetrieval as ak, type ExtensionHookDataExport as al, type ExtensionHookDeleteAccount as am, type ExtensionHookMeterReadingPlausibilityCheck as an, type ExtensionHookPriceDataRetrieval as ao, type ExtensionHookRegistrationIdentifiersCheck as ap, type ExtensionHookSelection as aq, type ExtensionHookVisualizationMetadata as ar, type ExtensionSeamlessLink as as, type ExternalLink as at, type ExtraSchemaAttributes as au, type FailedRuleErrorResp as av, type File as aw, type FileItem as ax, type FilePreviewResult as ay, type Grant as az, type PathsDictionary as b, type PortalDataExportColumn as b0, type PortalId as b1, type PortalTaskConfig as b2, type PortalUser as b3, type PortalUserRegistrationStatus as b4, type PortalWidget as b5, type PortalWorkflow as b6, type PortalWorkflowTask as b7, type Product as b8, type ProductRecommendationsWidget as b9, type Schema as bA, type SearchIncludes as bB, type SecureProxyConfig as bC, type Source as bD, type SwappableConfig as bE, type TariffType as bF, type TeaserWidget as bG, type TriggerPortalFlow as bH, type UpdateOnlyPortalConfigAttributes as bI, type UpsertPortalConfig as bJ, type UpsertPortalConfigV3 as bK, UpsertPortalWidget as bL, type UserRequest as bM, type VisualizationDataRange as bN, type VisualizationMetadata as bO, type VisualizationTypeOption as bP, type WidgetAction as bQ, type WidgetBase as bR, type WorfklowIdentifier as bS, type WorkflowExecution as bT, type WorkflowStep as bU, type ProviderConfig as ba, type ProviderDisplayName as bb, type ProviderPublicConfig as bc, type ProviderSlug as bd, type PublicAppDetails as be, type PublicChangeEmailDetails as bf, type PublicChangePasswordDetails as bg, type PublicContractIdentificationDetails as bh, type PublicDataRetrievalHookDetails as bi, type PublicDeleteAccountDetails as bj, type PublicExtensionCapabilities as bk, type PublicExtensionDetails as bl, type PublicMeterReadingPlausibilityCheckDetails as bm, type PublicSelfManagementExplanation as bn, type ReadBy as bo, type ReadingStatus as bp, type Reason as bq, type RegistrationIdentifier as br, type ReimbursementEvent as bs, type Rule as bt, type SAMLProviderConfig as bu, type SSOCallbackRequest as bv, type SSOCallbackResponse as bw, type SSOLoginToken as bx, SaveEntityFile as by, type SavePortalFile as bz, type AccountExistsRequest as c, type ActionLabel as d, type ActionWidget as e, type Activity as f, type ActivityCallerContext as g, type ActivityId as h, type ActivityItem as i, type AdditionalContactAttribute as j, type AdminUser as k, type AllowedFileExtensions as l, type AttributeMappingConfig as m, type AuthConfig as n, type BaseBillingEvent as o, type BaseEntity as p, type BillingAccount as q, type BillingEvent as r, type Block as s, type BlockId as t, type BlockProps as u, type BlockRequest as v, type BlockType as w, type BusinessPartnerItem as x, type CampaignWidget as y, type CommonConfigAttributes as z };