@epilot/sdk 2.15.4 → 2.15.6

package/dist/{customer-portal-runtime-SOZ4QOVZ.cjs → customer-portal-runtime-7WW3YRWJ.cjs}

@@ -1,5 +1,5 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkIZ52TBS7cjs = require('./chunk-IZ52TBS7.cjs');
+var _chunkLKV3RKOPcjs = require('./chunk-LKV3RKOP.cjs');
 require('./chunk-NJK5F5TF.cjs');
-exports. default = _chunkIZ52TBS7cjs.require_customer_portal_runtime.call(void 0, );
+exports. default = _chunkLKV3RKOPcjs.require_customer_portal_runtime.call(void 0, );

package/dist/{customer-portal-runtime-QM3MLBPV.js → customer-portal-runtime-FZQLCEJQ.js}

@@ -1,5 +1,5 @@
 import {
   require_customer_portal_runtime
-} from "./chunk-L4XLUNUO.js";
+} from "./chunk-EPDH37RS.js";
 import "./chunk-YPSWSI3M.js";
 export default require_customer_portal_runtime();

package/dist/{customer-portal.d-DsB3qJro.d.cts → customer-portal.d-JVkJjm_e.d.cts}

@@ -3618,7 +3618,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;
@@ -7204,6 +7204,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
          */
@@ -7273,6 +7287,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
          */
@@ -7497,7 +7627,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;
@@ -11565,6 +11695,51 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
+    namespace GetEntityPortalWorkflows {
+        namespace Parameters {
+            /**
+             * ID of the entity
+             * example:
+             * abc123
+             */
+            export type Id = string;
+            /**
+             * Schema slug of the entity
+             * example:
+             * opportunity
+             */
+            export type Slug = string;
+        }
+        export interface PathParameters {
+            slug: /**
+             * Schema slug of the entity
+             * example:
+             * opportunity
+             */
+            Parameters.Slug;
+            id: /**
+             * ID of the entity
+             * example:
+             * abc123
+             */
+            Parameters.Id;
+        }
+        namespace Responses {
+            export interface $200 {
+                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.PortalWorkflow[];
+            }
+            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 GetEntityWorkflows {
         namespace Parameters {
             /**
@@ -15594,8 +15769,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;
@@ -17308,6 +17483,26 @@ interface OperationMethods {
     data?: any,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetEntityWorkflows.Responses.$200>
+  /**
+   * getEntityPortalWorkflows - Get linearized workflows for an entity
+   * 
+   * 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>
   /**
    * uploadMeterReadingPhoto - Upload Meter Reading Photo
    * 
@@ -19210,6 +19405,28 @@ interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GetEntityWorkflows.Responses.$200>
   }
+  ['/v2/portal/entity/{slug}/{id}/workflows/linearized']: {
+    /**
+     * getEntityPortalWorkflows - Get linearized workflows for an entity
+     * 
+     * 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/metering/reading/photo']: {
     /**
      * uploadMeterReadingPhoto - Upload Meter Reading Photo
@@ -19893,9 +20110,12 @@ type PortalConfig = Components.Schemas.PortalConfig;
 type PortalConfigV3 = Components.Schemas.PortalConfigV3;
 type PortalDataExportColumn = Components.Schemas.PortalDataExportColumn;
 type PortalId = Components.Schemas.PortalId;
+type PortalTaskConfig = Components.Schemas.PortalTaskConfig;
 type PortalUser = Components.Schemas.PortalUser;
 type PortalUserRegistrationStatus = Components.Schemas.PortalUserRegistrationStatus;
 type PortalWidget = Components.Schemas.PortalWidget;
+type PortalWorkflow = Components.Schemas.PortalWorkflow;
+type PortalWorkflowTask = Components.Schemas.PortalWorkflowTask;
 type Product = Components.Schemas.Product;
 type ProductRecommendationsWidget = Components.Schemas.ProductRecommendationsWidget;
 type ProviderConfig = Components.Schemas.ProviderConfig;
@@ -19946,4 +20166,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 PortalUser as b0, type PortalUserRegistrationStatus as b1, type PortalWidget as b2, type Product as b3, type ProductRecommendationsWidget as b4, type ProviderConfig as b5, type ProviderDisplayName as b6, type ProviderPublicConfig as b7, type ProviderSlug as b8, type PublicAppDetails as b9, type TariffType as bA, type TeaserWidget as bB, type TriggerPortalFlow as bC, type UpdateOnlyPortalConfigAttributes as bD, type UpsertPortalConfig as bE, type UpsertPortalConfigV3 as bF, UpsertPortalWidget as bG, type UserRequest as bH, type VisualizationDataRange as bI, type VisualizationMetadata as bJ, type VisualizationTypeOption as bK, type WidgetAction as bL, type WidgetBase as bM, type WorfklowIdentifier as bN, type WorkflowExecution as bO, type WorkflowStep as bP, type PublicChangeEmailDetails as ba, type PublicChangePasswordDetails as bb, type PublicContractIdentificationDetails as bc, type PublicDataRetrievalHookDetails as bd, type PublicDeleteAccountDetails as be, type PublicExtensionCapabilities as bf, type PublicExtensionDetails as bg, type PublicMeterReadingPlausibilityCheckDetails as bh, type PublicSelfManagementExplanation as bi, type ReadBy as bj, type ReadingStatus as bk, type Reason as bl, type RegistrationIdentifier as bm, type ReimbursementEvent as bn, type Rule as bo, type SAMLProviderConfig as bp, type SSOCallbackRequest as bq, type SSOCallbackResponse as br, type SSOLoginToken as bs, SaveEntityFile as bt, type SavePortalFile as bu, type Schema as bv, type SearchIncludes as bw, type SecureProxyConfig as bx, type Source as by, type SwappableConfig 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 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 };

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

@@ -3618,7 +3618,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;
@@ -7204,6 +7204,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
          */
@@ -7273,6 +7287,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
          */
@@ -7497,7 +7627,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;
@@ -11565,6 +11695,51 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
+    namespace GetEntityPortalWorkflows {
+        namespace Parameters {
+            /**
+             * ID of the entity
+             * example:
+             * abc123
+             */
+            export type Id = string;
+            /**
+             * Schema slug of the entity
+             * example:
+             * opportunity
+             */
+            export type Slug = string;
+        }
+        export interface PathParameters {
+            slug: /**
+             * Schema slug of the entity
+             * example:
+             * opportunity
+             */
+            Parameters.Slug;
+            id: /**
+             * ID of the entity
+             * example:
+             * abc123
+             */
+            Parameters.Id;
+        }
+        namespace Responses {
+            export interface $200 {
+                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.PortalWorkflow[];
+            }
+            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 GetEntityWorkflows {
         namespace Parameters {
             /**
@@ -15594,8 +15769,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;
@@ -17308,6 +17483,26 @@ interface OperationMethods {
     data?: any,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetEntityWorkflows.Responses.$200>
+  /**
+   * getEntityPortalWorkflows - Get linearized workflows for an entity
+   * 
+   * 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>
   /**
    * uploadMeterReadingPhoto - Upload Meter Reading Photo
    * 
@@ -19210,6 +19405,28 @@ interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GetEntityWorkflows.Responses.$200>
   }
+  ['/v2/portal/entity/{slug}/{id}/workflows/linearized']: {
+    /**
+     * getEntityPortalWorkflows - Get linearized workflows for an entity
+     * 
+     * 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/metering/reading/photo']: {
     /**
      * uploadMeterReadingPhoto - Upload Meter Reading Photo
@@ -19893,9 +20110,12 @@ type PortalConfig = Components.Schemas.PortalConfig;
 type PortalConfigV3 = Components.Schemas.PortalConfigV3;
 type PortalDataExportColumn = Components.Schemas.PortalDataExportColumn;
 type PortalId = Components.Schemas.PortalId;
+type PortalTaskConfig = Components.Schemas.PortalTaskConfig;
 type PortalUser = Components.Schemas.PortalUser;
 type PortalUserRegistrationStatus = Components.Schemas.PortalUserRegistrationStatus;
 type PortalWidget = Components.Schemas.PortalWidget;
+type PortalWorkflow = Components.Schemas.PortalWorkflow;
+type PortalWorkflowTask = Components.Schemas.PortalWorkflowTask;
 type Product = Components.Schemas.Product;
 type ProductRecommendationsWidget = Components.Schemas.ProductRecommendationsWidget;
 type ProviderConfig = Components.Schemas.ProviderConfig;
@@ -19946,4 +20166,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 PortalUser as b0, type PortalUserRegistrationStatus as b1, type PortalWidget as b2, type Product as b3, type ProductRecommendationsWidget as b4, type ProviderConfig as b5, type ProviderDisplayName as b6, type ProviderPublicConfig as b7, type ProviderSlug as b8, type PublicAppDetails as b9, type TariffType as bA, type TeaserWidget as bB, type TriggerPortalFlow as bC, type UpdateOnlyPortalConfigAttributes as bD, type UpsertPortalConfig as bE, type UpsertPortalConfigV3 as bF, UpsertPortalWidget as bG, type UserRequest as bH, type VisualizationDataRange as bI, type VisualizationMetadata as bJ, type VisualizationTypeOption as bK, type WidgetAction as bL, type WidgetBase as bM, type WorfklowIdentifier as bN, type WorkflowExecution as bO, type WorkflowStep as bP, type PublicChangeEmailDetails as ba, type PublicChangePasswordDetails as bb, type PublicContractIdentificationDetails as bc, type PublicDataRetrievalHookDetails as bd, type PublicDeleteAccountDetails as be, type PublicExtensionCapabilities as bf, type PublicExtensionDetails as bg, type PublicMeterReadingPlausibilityCheckDetails as bh, type PublicSelfManagementExplanation as bi, type ReadBy as bj, type ReadingStatus as bk, type Reason as bl, type RegistrationIdentifier as bm, type ReimbursementEvent as bn, type Rule as bo, type SAMLProviderConfig as bp, type SSOCallbackRequest as bq, type SSOCallbackResponse as br, type SSOLoginToken as bs, SaveEntityFile as bt, type SavePortalFile as bu, type Schema as bv, type SearchIncludes as bw, type SecureProxyConfig as bx, type Source as by, type SwappableConfig 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 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 };