@epilot/customer-portal-client 0.39.15 → 0.41.0

package/dist/openapi.d.ts

@@ -13,6 +13,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;
@@ -31,6 +34,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;
@@ -2947,6 +2953,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
          */
@@ -3299,6 +3321,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:
@@ -3621,7 +3647,7 @@ declare namespace Components {
              */
             change_mode?: "synchronous" | "asynchronous";
             /**
-             * Whether the portal user must confirm their current password before the change email request is handed over to the third-party system. When true, the portal collects and verifies the current password before calling the hook. Treated as true when `change_mode` is `synchronous`, since the portal re-creates the login with the confirmed password. Skipped either way for portal users whose identity is managed by an identity provider: an SSO login has no password to confirm.
+             * Whether the portal user must confirm their current password before the change email request is handed over to the third-party system. When true, the portal collects and verifies the current password before calling the hook. Skipped for portal users whose identity is managed by an identity provider: an SSO login has no password to confirm. When no password is confirmed and `change_mode` is `synchronous`, the re-created login gets a random password and the portal user signs in through their identity provider, or sets a new password via the email code flow.
              *
              */
             require_password_confirmation?: boolean;
@@ -4716,6 +4742,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
@@ -6581,9 +6621,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[];
@@ -7207,6 +7248,20 @@ declare namespace Components {
          * 453ad7bf-86d5-46c8-8252-bcc868df5e3c
          */
         export type PortalId = string;
+        /**
+         * Portal-specific (ECP / installer) display config of a workflow task
+         */
+        export interface PortalTaskConfig {
+            enabled?: boolean;
+            label?: string;
+            description?: string;
+            journey?: {
+                id?: string;
+                journeyId?: string;
+                name?: string;
+                complete_task_automatically?: boolean;
+            };
+        }
         /**
          * The portal user entity
          */
@@ -7276,6 +7331,122 @@ declare namespace Components {
         }
         export type PortalUserRegistrationStatus = "Registration Pending" | "Confirmation Email Sent" | "Registered" | "Email Update In Progress";
         export type PortalWidget = EntityWidget | ContentWidget | ActionWidget | TeaserWidget | DocumentWidget | PaymentWidget | MeterReadingWidget | MeterChartWidget | CampaignWidget | ProductRecommendationsWidget;
+        /**
+         * 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.
+         *
+         */
+        export interface PortalWorkflow {
+            /**
+             * Id of the workflow / flow execution
+             */
+            id: string;
+            /**
+             * Id of the workflow definition / flow template this execution was created from
+             */
+            definition_id?: string;
+            name: string;
+            status: "STARTED" | "DONE" | "CLOSED";
+            /**
+             * 2 = legacy V1 workflow execution (linear model), 3 = V2 flow execution (graph model)
+             */
+            version: 2 | 3;
+            /**
+             * Creation timestamp, doubles as started time
+             */
+            created_at?: string;
+            /**
+             * Last update timestamp
+             */
+            updated_at?: string;
+            /**
+             * Timestamp when the execution was completed, if it is
+             */
+            completed_at?: string;
+            due_date?: string;
+            assigned_to?: string[];
+            contexts?: {
+                entity_id?: string;
+                entity_schema?: string;
+                is_primary?: boolean;
+            }[];
+            /**
+             * True when the linearized path reached the end of the execution graph. False when an
+             * unevaluated decision task was encountered, meaning additional tasks may appear once
+             * the decision is resolved (the returned tasks are still the guaranteed active path).
+             * Always true for V1 executions.
+             *
+             */
+            is_path_complete: boolean;
+            /**
+             * Portal-visible tasks in linear (timeline) order
+             */
+            tasks: /* A single portal-visible task of a linearized workflow execution */ PortalWorkflowTask[];
+        }
+        /**
+         * A single portal-visible task of a linearized workflow execution
+         */
+        export interface PortalWorkflowTask {
+            /**
+             * Id of the underlying task (V2) or step (V1)
+             */
+            id: string;
+            /**
+             * Internal task/step name (fallback label when the portal config has none)
+             */
+            name: string;
+            /**
+             * Zero-based position of the task in the linearized timeline
+             */
+            order: number;
+            /**
+             * Normalized task status:
+             * - COMPLETED / SKIPPED: the task is done (skipped tasks count as done for progress)
+             * - IN_PROGRESS: the task has been reached and work has started
+             * - PENDING: the task has not been completed yet
+             *
+             */
+            status: "COMPLETED" | "SKIPPED" | "IN_PROGRESS" | "PENDING";
+            /**
+             * True when the task has been reached in the execution — all predecessor tasks on its
+             * path are completed/skipped — so the portal user can act on it (e.g. start its journey).
+             * Tasks that are only part of the projected future path are returned with is_active false.
+             *
+             */
+            is_active: boolean;
+            ecp?: /* Portal-specific (ECP / installer) display config of a workflow task */ PortalTaskConfig;
+            installer?: /* Portal-specific (ECP / installer) display config of a workflow task */ PortalTaskConfig;
+            /**
+             * Journey linked to the task, if any
+             */
+            journey?: {
+                id?: string;
+                journeyId?: string;
+                name?: string;
+                /**
+                 * If true, the task is auto completed when the journey is completed
+                 */
+                complete_task_automatically?: boolean;
+            };
+            assigned_to?: string[];
+            /**
+             * Id of the phase the underlying task belongs to, if any (V2 only)
+             */
+            phase_id?: string;
+            /**
+             * Name of the phase the underlying task belongs to, if any (V2 only)
+             */
+            phase_name?: string;
+            /**
+             * Timestamp when the task was completed or skipped
+             */
+            completed_at?: string;
+            /**
+             * Last update timestamp of the underlying task/step
+             */
+            updated_at?: string;
+        }
         /**
          * The product entity
          */
@@ -7500,7 +7671,7 @@ declare namespace Components {
             change_mode?: "synchronous" | "asynchronous";
             /**
              * Whether the portal user must confirm their current password before the email change is handed over to the third-party system.
-             * Also required when `change_mode` is `synchronous`, except for portal users whose identity is managed by an identity provider - an SSO login has no password to confirm.
+             * Not required for portal users whose identity is managed by an identity provider - an SSO login has no password to confirm.
              *
              */
             require_password_confirmation?: boolean;
@@ -7971,7 +8142,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;
@@ -8069,9 +8243,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?: /**
@@ -8137,9 +8312,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?: /**
@@ -8724,9 +8900,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?: /**
@@ -11568,7 +11745,7 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
-    namespace GetEntityWorkflows {
+    namespace GetEntityPortalWorkflows {
         namespace Parameters {
             /**
              * ID of the entity
@@ -11579,7 +11756,7 @@ declare namespace Paths {
             /**
              * Schema slug of the entity
              * example:
-             * contact
+             * opportunity
              */
             export type Slug = string;
         }
@@ -11587,7 +11764,7 @@ declare namespace Paths {
             slug: /**
              * Schema slug of the entity
              * example:
-             * contact
+             * opportunity
              */
             Parameters.Slug;
             id: /**
@@ -11599,144 +11776,13 @@ declare namespace Paths {
         }
         namespace Responses {
             export interface $200 {
-                workflow_executions?: /**
-                 * example:
-                 * {
-                 *   "id": "8gja72h6kas6h",
-                 *   "name": "Lead Qualification",
-                 *   "trigger": "MANUAL",
-                 *   "status": "STARTED",
-                 *   "creationTime": "2021-04-27T12:01:13.000Z",
-                 *   "lastUpdateTime": "2021-04-27T12:01:13.000Z",
-                 *   "dueDate": "2021-04-27T12:01:13.000Z",
-                 *   "assignedTo": [
-                 *     "252",
-                 *     "29052"
-                 *   ],
-                 *   "flow": [
-                 *     {
-                 *       "id": "sectionId1",
-                 *       "name": "Initial Information Gathering",
-                 *       "steps": [
-                 *         {
-                 *           "id": "sada5641f3a21",
-                 *           "name": "Call client and confirm address and product",
-                 *           "status": "ASSIGNED",
-                 *           "assignedTo": [
-                 *             "11"
-                 *           ]
-                 *         },
-                 *         {
-                 *           "id": "sada5641f3a22",
-                 *           "name": "Check product availability",
-                 *           "status": "UNASSIGNED"
-                 *         },
-                 *         {
-                 *           "id": "sada5641f3a23",
-                 *           "name": "Send email confirming contact with the client",
-                 *           "status": "SKIPPED"
-                 *         }
-                 *       ]
-                 *     },
-                 *     {
-                 *       "id": "firstLevelStepId1",
-                 *       "name": "Print and send catalog",
-                 *       "status": "SKIPPED",
-                 *       "dueDate": "2023-01-15T20:00:00"
-                 *     }
-                 *   ]
-                 * }
+                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.
+                 *
                  */
-                Components.Schemas.WorkflowExecution[];
-            }
-            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 GetExport {
-        namespace Parameters {
-            export type JobId = string;
-        }
-        export interface PathParameters {
-            jobId: Parameters.JobId;
-        }
-        namespace Responses {
-            export interface $200 {
-                jobId?: string;
-                status?: "queued" | "running" | "ready" | "failed" | "expired";
-                downloadUrl?: string;
-                error?: string;
-            }
-            export type $401 = Components.Responses.Unauthorized;
-            export interface $404 {
-            }
-            export type $500 = Components.Responses.InternalServerError;
-        }
-    }
-    namespace GetExternalLinks {
-        namespace Parameters {
-            export type ContactId = /**
-             * Entity ID
-             * example:
-             * 5da0a718-c822-403d-9f5d-20d4584e0528
-             */
-            Components.Schemas.EntityId /* uuid */;
-            export type Origin = /* Origin of the portal */ Components.Schemas.Origin;
-        }
-        export interface QueryParameters {
-            origin?: Parameters.Origin;
-            contactId?: Parameters.ContactId;
-        }
-        namespace Responses {
-            export type $200 = Components.Schemas.ExternalLink[];
-            export type $401 = Components.Responses.Unauthorized;
-            export type $403 = Components.Responses.Forbidden;
-            export type $500 = Components.Responses.InternalServerError;
-        }
-    }
-    namespace GetExternalLinksV3 {
-        namespace Parameters {
-            export type ContactId = /**
-             * Entity ID
-             * example:
-             * 5da0a718-c822-403d-9f5d-20d4584e0528
-             */
-            Components.Schemas.EntityId /* uuid */;
-            export type PortalId = /**
-             * ID of the portal
-             * example:
-             * 453ad7bf-86d5-46c8-8252-bcc868df5e3c
-             */
-            Components.Schemas.PortalId;
-        }
-        export interface QueryParameters {
-            portal_id?: Parameters.PortalId;
-            contactId?: Parameters.ContactId;
-        }
-        namespace Responses {
-            export type $200 = Components.Schemas.ExternalLink[];
-            export type $401 = Components.Responses.Unauthorized;
-            export type $403 = Components.Responses.Forbidden;
-            export type $500 = Components.Responses.InternalServerError;
-        }
-    }
-    namespace GetFileById {
-        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 interface $200 {
-                file?: /* The file entity */ Components.Schemas.FileItem;
+                Components.Schemas.PortalWorkflow[];
             }
             export type $401 = Components.Responses.Unauthorized;
             export type $403 = Components.Responses.Forbidden;
@@ -11744,34 +11790,845 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
-    namespace GetFilesCountByEntity {
-        namespace Responses {
-            export type $200 = Components.Schemas.EntityFileCount[];
-            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 GetMeterReadings {
+    namespace GetEntityPortalWorkflowsBatch {
         export interface RequestBody {
-            meter_id: string;
-            counter_id: string;
-            sort?: "asc" | "desc";
-            from?: number;
-            size?: number;
-            /**
-             * Template map (key to Handlebars template string). Each template is resolved per reading.
-             */
-            templates?: {
-                [name: string]: string;
-            };
-            /**
-             * Template map resolved against the counter entity.
-             */
-            counter_templates?: {
-                [name: string]: string;
-            };
+            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 {
+            /**
+             * ID of the entity
+             * example:
+             * abc123
+             */
+            export type Id = string;
+            /**
+             * Schema slug of the entity
+             * example:
+             * contact
+             */
+            export type Slug = string;
+        }
+        export interface PathParameters {
+            slug: /**
+             * Schema slug of the entity
+             * example:
+             * contact
+             */
+            Parameters.Slug;
+            id: /**
+             * ID of the entity
+             * example:
+             * abc123
+             */
+            Parameters.Id;
+        }
+        namespace Responses {
+            export interface $200 {
+                workflow_executions?: /**
+                 * example:
+                 * {
+                 *   "id": "8gja72h6kas6h",
+                 *   "name": "Lead Qualification",
+                 *   "trigger": "MANUAL",
+                 *   "status": "STARTED",
+                 *   "creationTime": "2021-04-27T12:01:13.000Z",
+                 *   "lastUpdateTime": "2021-04-27T12:01:13.000Z",
+                 *   "dueDate": "2021-04-27T12:01:13.000Z",
+                 *   "assignedTo": [
+                 *     "252",
+                 *     "29052"
+                 *   ],
+                 *   "flow": [
+                 *     {
+                 *       "id": "sectionId1",
+                 *       "name": "Initial Information Gathering",
+                 *       "steps": [
+                 *         {
+                 *           "id": "sada5641f3a21",
+                 *           "name": "Call client and confirm address and product",
+                 *           "status": "ASSIGNED",
+                 *           "assignedTo": [
+                 *             "11"
+                 *           ]
+                 *         },
+                 *         {
+                 *           "id": "sada5641f3a22",
+                 *           "name": "Check product availability",
+                 *           "status": "UNASSIGNED"
+                 *         },
+                 *         {
+                 *           "id": "sada5641f3a23",
+                 *           "name": "Send email confirming contact with the client",
+                 *           "status": "SKIPPED"
+                 *         }
+                 *       ]
+                 *     },
+                 *     {
+                 *       "id": "firstLevelStepId1",
+                 *       "name": "Print and send catalog",
+                 *       "status": "SKIPPED",
+                 *       "dueDate": "2023-01-15T20:00:00"
+                 *     }
+                 *   ]
+                 * }
+                 */
+                Components.Schemas.WorkflowExecution[];
+            }
+            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 GetExport {
+        namespace Parameters {
+            export type JobId = string;
+        }
+        export interface PathParameters {
+            jobId: Parameters.JobId;
+        }
+        namespace Responses {
+            export interface $200 {
+                jobId?: string;
+                status?: "queued" | "running" | "ready" | "failed" | "expired";
+                downloadUrl?: string;
+                error?: string;
+            }
+            export type $401 = Components.Responses.Unauthorized;
+            export interface $404 {
+            }
+            export type $500 = Components.Responses.InternalServerError;
+        }
+    }
+    namespace GetExternalLinks {
+        namespace Parameters {
+            export type ContactId = /**
+             * Entity ID
+             * example:
+             * 5da0a718-c822-403d-9f5d-20d4584e0528
+             */
+            Components.Schemas.EntityId /* uuid */;
+            export type Origin = /* Origin of the portal */ Components.Schemas.Origin;
+        }
+        export interface QueryParameters {
+            origin?: Parameters.Origin;
+            contactId?: Parameters.ContactId;
+        }
+        namespace Responses {
+            export type $200 = Components.Schemas.ExternalLink[];
+            export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
+            export type $500 = Components.Responses.InternalServerError;
+        }
+    }
+    namespace GetExternalLinksV3 {
+        namespace Parameters {
+            export type ContactId = /**
+             * Entity ID
+             * example:
+             * 5da0a718-c822-403d-9f5d-20d4584e0528
+             */
+            Components.Schemas.EntityId /* uuid */;
+            export type PortalId = /**
+             * ID of the portal
+             * example:
+             * 453ad7bf-86d5-46c8-8252-bcc868df5e3c
+             */
+            Components.Schemas.PortalId;
+        }
+        export interface QueryParameters {
+            portal_id?: Parameters.PortalId;
+            contactId?: Parameters.ContactId;
+        }
+        namespace Responses {
+            export type $200 = Components.Schemas.ExternalLink[];
+            export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
+            export type $500 = Components.Responses.InternalServerError;
+        }
+    }
+    namespace GetFileById {
+        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 interface $200 {
+                file?: /* The file entity */ Components.Schemas.FileItem;
+            }
+            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 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[];
+            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 GetMeterReadings {
+        export interface RequestBody {
+            meter_id: string;
+            counter_id: string;
+            sort?: "asc" | "desc";
+            from?: number;
+            size?: number;
+            /**
+             * Template map (key to Handlebars template string). Each template is resolved per reading.
+             */
+            templates?: {
+                [name: string]: string;
+            };
+            /**
+             * Template map resolved against the counter entity.
+             */
+            counter_templates?: {
+                [name: string]: string;
+            };
         }
         namespace Responses {
             export interface $200 {
@@ -14831,6 +15688,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;
                 };
             };
         }
@@ -15264,9 +16125,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 {
@@ -15597,8 +16458,8 @@ declare namespace Paths {
             email: string;
             /**
              * Password of the portal user for confirmation.
-             * Required unless a `changeEmail` portal extension hook with `require_password_confirmation` disabled is configured for the portal.
-             * Also required by a `changeEmail` hook with `change_mode` set to `synchronous`, except for portal users whose identity is managed by an identity provider - an SSO login has no password to confirm.
+             * Required unless a `changeEmail` portal extension hook with `require_password_confirmation` disabled is configured for the portal,
+             * or the portal user's identity is managed by an identity provider - an SSO login has no password to confirm.
              *
              */
             password?: string;
@@ -16259,7 +17120,7 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetPublicPortalExtensionDetailsV3.Responses.$200>
   /**
-   * getConsumption - Get Consumption
+   * getConsumption - getConsumption
    * 
    * Get energy consumption data between a given time period.
    */
@@ -16269,7 +17130,7 @@ export 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`).
    * 
@@ -16280,7 +17141,7 @@ export 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.
    * 
@@ -16291,7 +17152,7 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetVisualizationMetadata.Responses.$200>
   /**
-   * getCosts - Get Costs
+   * getCosts - getCosts
    * 
    * Get energy cost data between a given time period.
    */
@@ -16301,7 +17162,7 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetCosts.Responses.$200>
   /**
-   * getPrices - Get Prices
+   * getPrices - getPrices
    * 
    * Get energy prices data between a given time period.
    */
@@ -17137,6 +17998,16 @@ export 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
    * 
@@ -17148,7 +18019,7 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.TrackFileDownloaded.Responses.$200>
   /**
-   * getFilesCountByEntity - getFileCountByEntity
+   * getFilesCountByEntity - getFilesCountByEntity
    * 
    * Fetch file counts for all ECP user related entities
    */
@@ -17302,7 +18173,7 @@ export 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)
    */
@@ -17312,7 +18183,45 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetEntityWorkflows.Responses.$200>
   /**
-   * uploadMeterReadingPhoto - Upload Meter Reading Photo
+   * 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.
+   * 
+   * Unlike `getEntityWorkflows`, this endpoint returns a single uniform shape for both legacy
+   * (V1) workflow executions and graph-based (V2) flow executions — the execution graph is
+   * already resolved server-side (active path, task reachability, chronological ordering), so
+   * clients can render a timeline without any graph traversal logic.
+   * 
+   * Tasks carry the config of both portal audiences (`ecp` and `installer`); clients filter
+   * per their configured audience, so one response serves every block on a page.
+   * 
+   */
+  'getEntityPortalWorkflows'(
+    parameters?: Parameters<Paths.GetEntityPortalWorkflows.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetEntityPortalWorkflows.Responses.$200>
+  /**
+   * 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.
    */
@@ -17322,7 +18231,7 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.UploadMeterReadingPhoto.Responses.$200>
   /**
-   * createMeterReading - Create Meter Reading
+   * createMeterReading - createMeterReading
    * 
    * Inserts a new meter reading.
    */
@@ -17332,7 +18241,9 @@ export 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.
    * 
@@ -17343,7 +18254,7 @@ export 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.
@@ -17590,7 +18501,7 @@ export 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.
    */
@@ -17984,7 +18895,7 @@ export interface PathsDictionary {
   }
   ['/v2/portal/consumption']: {
     /**
-     * getConsumption - Get Consumption
+     * getConsumption - getConsumption
      * 
      * Get energy consumption data between a given time period.
      */
@@ -17996,7 +18907,7 @@ export 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`).
      * 
@@ -18009,7 +18920,7 @@ export 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.
      * 
@@ -18022,7 +18933,7 @@ export interface PathsDictionary {
   }
   ['/v2/portal/costs']: {
     /**
-     * getCosts - Get Costs
+     * getCosts - getCosts
      * 
      * Get energy cost data between a given time period.
      */
@@ -18034,7 +18945,7 @@ export interface PathsDictionary {
   }
   ['/v2/portal/prices']: {
     /**
-     * getPrices - Get Prices
+     * getPrices - getPrices
      * 
      * Get energy prices data between a given time period.
      */
@@ -19007,6 +19918,18 @@ export 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
@@ -19021,7 +19944,7 @@ export interface PathsDictionary {
   }
   ['/v2/portal/user/files/count-by-entity']: {
     /**
-     * getFilesCountByEntity - getFileCountByEntity
+     * getFilesCountByEntity - getFilesCountByEntity
      * 
      * Fetch file counts for all ECP user related entities
      */
@@ -19203,7 +20126,7 @@ export 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)
      */
@@ -19213,9 +20136,51 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GetEntityWorkflows.Responses.$200>
   }
+  ['/v2/portal/entity/{slug}/{id}/workflows/linearized']: {
+    /**
+     * 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.
+     * 
+     * Unlike `getEntityWorkflows`, this endpoint returns a single uniform shape for both legacy
+     * (V1) workflow executions and graph-based (V2) flow executions — the execution graph is
+     * already resolved server-side (active path, task reachability, chronological ordering), so
+     * clients can render a timeline without any graph traversal logic.
+     * 
+     * Tasks carry the config of both portal audiences (`ecp` and `installer`); clients filter
+     * per their configured audience, so one response serves every block on a page.
+     * 
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetEntityPortalWorkflows.PathParameters> | null,
+      data?: any,
+      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.
      */
@@ -19227,7 +20192,7 @@ export interface PathsDictionary {
   }
   ['/v2/portal/metering/reading']: {
     /**
-     * createMeterReading - Create Meter Reading
+     * createMeterReading - createMeterReading
      * 
      * Inserts a new meter reading.
      */
@@ -19239,7 +20204,9 @@ export 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.
      * 
@@ -19252,7 +20219,7 @@ export 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.
@@ -19529,7 +20496,7 @@ export 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.
      */
@@ -19833,6 +20800,7 @@ export type EntityGetParams = Components.Schemas.EntityGetParams;
 export type EntityId = Components.Schemas.EntityId;
 export type EntityItem = Components.Schemas.EntityItem;
 export type EntityMatchingConfig = Components.Schemas.EntityMatchingConfig;
+export type EntityPortalWorkflows = Components.Schemas.EntityPortalWorkflows;
 export type EntityResponse = Components.Schemas.EntityResponse;
 export type EntityResponseGroupedWithHits = Components.Schemas.EntityResponseGroupedWithHits;
 export type EntityResponseWithHits = Components.Schemas.EntityResponseWithHits;
@@ -19865,6 +20833,7 @@ export type ExtraSchemaAttributes = Components.Schemas.ExtraSchemaAttributes;
 export type FailedRuleErrorResp = Components.Schemas.FailedRuleErrorResp;
 export type File = Components.Schemas.File;
 export type FileItem = Components.Schemas.FileItem;
+export type FilePreviewResult = Components.Schemas.FilePreviewResult;
 export type Grant = Components.Schemas.Grant;
 export type IdentifierAttribute = Components.Schemas.IdentifierAttribute;
 export type InstallmentEvent = Components.Schemas.InstallmentEvent;
@@ -19896,9 +20865,12 @@ export type PortalConfig = Components.Schemas.PortalConfig;
 export type PortalConfigV3 = Components.Schemas.PortalConfigV3;
 export type PortalDataExportColumn = Components.Schemas.PortalDataExportColumn;
 export type PortalId = Components.Schemas.PortalId;
+export type PortalTaskConfig = Components.Schemas.PortalTaskConfig;
 export type PortalUser = Components.Schemas.PortalUser;
 export type PortalUserRegistrationStatus = Components.Schemas.PortalUserRegistrationStatus;
 export type PortalWidget = Components.Schemas.PortalWidget;
+export type PortalWorkflow = Components.Schemas.PortalWorkflow;
+export type PortalWorkflowTask = Components.Schemas.PortalWorkflowTask;
 export type Product = Components.Schemas.Product;
 export type ProductRecommendationsWidget = Components.Schemas.ProductRecommendationsWidget;
 export type ProviderConfig = Components.Schemas.ProviderConfig;