@epilot/customer-portal-client 0.39.15 → 0.40.1

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;
@@ -1453,6 +1459,10 @@ declare namespace Components {
             global_blocks?: {
                 [name: string]: Block;
             };
+            /**
+             * Configures which 360 events generate an in-app notification for the portal user. Each enabled trigger renders the referenced notification template and creates a notification addressed to the portal user. Admin/builder-only — never exposed via the public portal config.
+             */
+            notification_triggers?: NotificationTriggerConfig[];
         }
         export interface CommonConfigAttributesV3 {
             /**
@@ -2947,6 +2957,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 +3325,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 +3651,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 +4746,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
@@ -5014,7 +5058,7 @@ declare namespace Components {
             /**
              * If the value is not provided, the system will be set with the time the request is processed.
              * example:
-             * 2022-10-10
+             * 2022-10-10T00:00:00.000Z
              */
             timestamp?: string;
             /**
@@ -5291,6 +5335,26 @@ declare namespace Components {
              */
             client_secret?: string;
         }
+        export interface NotificationTriggerConfig {
+            /**
+             * The 360 event that fires this notification trigger.
+             */
+            trigger_type: "entity_created" | "entity_assigned" | "workflow_step_overdue";
+            /**
+             * For `entity_created` / `entity_assigned` triggers, the entity schema slug (e.g. `opportunity`, `order`) whose creation or assignment fires this trigger. Ignored for other trigger types.
+             * example:
+             * opportunity
+             */
+            entity_schema?: string;
+            /**
+             * Whether this trigger is active.
+             */
+            enabled?: boolean;
+            /**
+             * Entity id of the notification_template to render for this trigger.
+             */
+            template_id?: string; // uuid
+        }
         /**
          * OIDC provider configuration. Values are resolved at SSO invocation time
          * (login / callback), so the fields below may reference org env vars via
@@ -5677,6 +5741,44 @@ declare namespace Components {
              */
             minNativeVersion?: string;
         }
+        export interface OutstandingTask {
+            /**
+             * ID of the entity the task belongs to
+             */
+            entity_id: string;
+            /**
+             * Schema slug of the entity (opportunity, order or contract)
+             */
+            entity_schema: string;
+            /**
+             * Title (_title) of the entity
+             */
+            entity_title: string;
+            /**
+             * Workflow execution id
+             */
+            workflow_id: string;
+            /**
+             * Workflow execution / template name
+             */
+            workflow_name: string;
+            /**
+             * Task (step) id within the workflow execution
+             */
+            step_id: string;
+            /**
+             * Task (step) name
+             */
+            step_name: string;
+            /**
+             * Journey id the customer needs to fill out
+             */
+            journey_id: string;
+            /**
+             * Whether submitting the journey from the portal should auto-complete the task. When false, an internal user completes it.
+             */
+            complete_task_automatically?: boolean;
+        }
         export interface Page {
             [name: string]: any;
             /**
@@ -6487,6 +6589,10 @@ declare namespace Components {
             global_blocks?: {
                 [name: string]: Block;
             };
+            /**
+             * Configures which 360 events generate an in-app notification for the portal user. Each enabled trigger renders the referenced notification template and creates a notification addressed to the portal user. Admin/builder-only — never exposed via the public portal config.
+             */
+            notification_triggers?: NotificationTriggerConfig[];
             /**
              * ID of the organization
              * example:
@@ -6581,9 +6687,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 +7314,71 @@ declare namespace Components {
          * 453ad7bf-86d5-46c8-8252-bcc868df5e3c
          */
         export type PortalId = string;
+        /**
+         * A 360 notification addressed to a portal user.
+         */
+        export interface PortalNotification {
+            /**
+             * Stable string identifier of the notification (the numeric notification id as a string).
+             * example:
+             * 1234567890
+             */
+            id: string;
+            /**
+             * Numeric id of the notification, used to mark it as read.
+             * example:
+             * 1234567890
+             */
+            notification_id?: number;
+            /**
+             * Type of notification.
+             * example:
+             * workflow_step_overdue
+             */
+            type?: string;
+            /**
+             * Localized, already-rendered notification title.
+             */
+            title?: {
+                en?: string;
+                de?: string;
+            };
+            /**
+             * Localized, already-rendered notification message.
+             */
+            message?: {
+                en?: string;
+                de?: string;
+            };
+            /**
+             * When the notification was created.
+             */
+            created_at?: string; // date-time
+            /**
+             * Whether the notification has been read by the user.
+             * example:
+             * false
+             */
+            read: boolean;
+            /**
+             * Optional URL the notification points to.
+             */
+            redirect_url?: 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 +7448,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 +7788,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 +8259,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 +8360,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 +8429,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?: /**
@@ -8676,6 +8969,10 @@ declare namespace Components {
             global_blocks?: {
                 [name: string]: Block;
             };
+            /**
+             * Configures which 360 events generate an in-app notification for the portal user. Each enabled trigger renders the referenced notification template and creates a notification addressed to the portal user. Admin/builder-only — never exposed via the public portal config.
+             */
+            notification_triggers?: NotificationTriggerConfig[];
         }
         export interface UpsertPortalConfigV3 {
             /**
@@ -8724,9 +9021,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 +11866,7 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
-    namespace GetEntityWorkflows {
+    namespace GetEntityPortalWorkflows {
         namespace Parameters {
             /**
              * ID of the entity
@@ -11579,7 +11877,7 @@ declare namespace Paths {
             /**
              * Schema slug of the entity
              * example:
-             * contact
+             * opportunity
              */
             export type Slug = string;
         }
@@ -11587,7 +11885,7 @@ declare namespace Paths {
             slug: /**
              * Schema slug of the entity
              * example:
-             * contact
+             * opportunity
              */
             Parameters.Slug;
             id: /**
@@ -11599,55 +11897,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[];
+                Components.Schemas.PortalWorkflow[];
             }
             export type $401 = Components.Responses.Unauthorized;
             export type $403 = Components.Responses.Forbidden;
@@ -11655,53 +11911,755 @@ declare namespace Paths {
             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
+    namespace GetEntityPortalWorkflowsBatch {
+        export interface RequestBody {
+            entities: [
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                },
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?,
+                {
+                    /**
+                     * ID of the entity
+                     */
+                    id: string;
+                    /**
+                     * Schema slug of the entity
+                     * example:
+                     * order
+                     */
+                    slug: string;
+                }?
+            ];
+        }
+        namespace Responses {
+            export interface $200 {
+                results?: /* Linearized portal workflows of a single entity */ Components.Schemas.EntityPortalWorkflows[];
+            }
+            export type $400 = Components.Responses.InvalidRequest;
+            export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
+            export type $500 = Components.Responses.InternalServerError;
+        }
+    }
+    namespace GetEntityWorkflows {
+        namespace Parameters {
+            /**
+             * 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 = /**
@@ -11744,6 +12702,26 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
+    namespace GetFilePreview {
+        namespace Parameters {
+            export type Id = /**
+             * Entity ID
+             * example:
+             * 5da0a718-c822-403d-9f5d-20d4584e0528
+             */
+            Components.Schemas.EntityId /* uuid */;
+        }
+        export interface PathParameters {
+            id: Parameters.Id;
+        }
+        namespace Responses {
+            export type $200 = Components.Schemas.FilePreviewResult;
+            export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
+            export type $404 = Components.Responses.NotFound;
+            export type $500 = Components.Responses.InternalServerError;
+        }
+    }
     namespace GetFilesCountByEntity {
         namespace Responses {
             export type $200 = Components.Schemas.EntityFileCount[];
@@ -12518,6 +13496,10 @@ declare namespace Paths {
                 global_blocks?: {
                     [name: string]: Components.Schemas.Block;
                 };
+                /**
+                 * Configures which 360 events generate an in-app notification for the portal user. Each enabled trigger renders the referenced notification template and creates a notification addressed to the portal user. Admin/builder-only — never exposed via the public portal config.
+                 */
+                notification_triggers?: Components.Schemas.NotificationTriggerConfig[];
                 /**
                  * ID of the organization
                  * example:
@@ -13136,6 +14118,10 @@ declare namespace Paths {
                 global_blocks?: {
                     [name: string]: Components.Schemas.Block;
                 };
+                /**
+                 * Configures which 360 events generate an in-app notification for the portal user. Each enabled trigger renders the referenced notification template and creates a notification addressed to the portal user. Admin/builder-only — never exposed via the public portal config.
+                 */
+                notification_triggers?: Components.Schemas.NotificationTriggerConfig[];
                 /**
                  * ID of the organization
                  * example:
@@ -13254,6 +14240,21 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
+    namespace GetOutstandingTasks {
+        namespace Responses {
+            export interface $200 {
+                tasks: Components.Schemas.OutstandingTask[];
+                /**
+                 * example:
+                 * 0
+                 */
+                total: number;
+            }
+            export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
+            export type $500 = Components.Responses.InternalServerError;
+        }
+    }
     namespace GetPortalConfig {
         namespace Parameters {
             export type Origin = /* Origin of the portal */ Components.Schemas.Origin;
@@ -13346,6 +14347,20 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
+    namespace GetPortalNotificationsUnreadCount {
+        namespace Responses {
+            export interface $200 {
+                /**
+                 * example:
+                 * 3
+                 */
+                count?: number;
+            }
+            export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
+            export type $500 = Components.Responses.InternalServerError;
+        }
+    }
     namespace GetPortalPage {
         namespace Responses {
             export type $200 = Components.Schemas.Page;
@@ -14498,6 +15513,32 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
+    namespace ListPortalNotifications {
+        namespace Parameters {
+            export type Cursor = string;
+            export type Limit = number;
+        }
+        export interface QueryParameters {
+            cursor?: Parameters.Cursor;
+            limit?: Parameters.Limit;
+        }
+        namespace Responses {
+            export interface $200 {
+                /**
+                 * Base64 encoded cursor to fetch the next page. Absent when there are no more results.
+                 */
+                cursor?: string;
+                /**
+                 * Total number of unread notifications for the user.
+                 */
+                total_unread?: number;
+                results?: /* A 360 notification addressed to a portal user. */ Components.Schemas.PortalNotification[];
+            }
+            export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
+            export type $500 = Components.Responses.InternalServerError;
+        }
+    }
     namespace LoginToPortalAsUser {
         export interface RequestBody {
             /**
@@ -14525,6 +15566,31 @@ declare namespace Paths {
             }
         }
     }
+    namespace MarkAllPortalNotificationsRead {
+        namespace Responses {
+            export interface $204 {
+            }
+            export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
+            export type $500 = Components.Responses.InternalServerError;
+        }
+    }
+    namespace MarkPortalNotificationRead {
+        namespace Parameters {
+            export type Id = number;
+        }
+        export interface PathParameters {
+            id: Parameters.Id;
+        }
+        namespace Responses {
+            export interface $204 {
+            }
+            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 MigrateEmailTemplateReferences {
         export interface RequestBody {
             /**
@@ -14831,6 +15897,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 +16334,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 +16667,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;
@@ -16107,7 +17177,6 @@ declare namespace Paths {
     }
 }
 
-
 export interface OperationMethods {
   /**
    * upsertPortal - upsertPortal
@@ -16259,7 +17328,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 +17338,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 +17349,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 +17360,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 +17370,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 +18206,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 +18227,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 +18381,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 +18391,55 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetEntityWorkflows.Responses.$200>
   /**
-   * uploadMeterReadingPhoto - Upload Meter Reading Photo
+   * getOutstandingTasks - Get outstanding workflow tasks for the portal user
+   * 
+   * Returns all outstanding workflow journey tasks for the authenticated portal user, across their opportunity, order and contract entities. Each task is an active workflow step that exposes a journey the customer still needs to fill out.
+   */
+  'getOutstandingTasks'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetOutstandingTasks.Responses.$200>
+  /**
+   * 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 +18449,7 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.UploadMeterReadingPhoto.Responses.$200>
   /**
-   * createMeterReading - Create Meter Reading
+   * createMeterReading - createMeterReading
    * 
    * Inserts a new meter reading.
    */
@@ -17332,7 +18459,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 +18472,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 +18719,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.
    */
@@ -17599,6 +18728,46 @@ export interface OperationMethods {
     data?: Paths.UpdateCampaignPortalBlockStatus.RequestBody,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.UpdateCampaignPortalBlockStatus.Responses.$200>
+  /**
+   * listPortalNotifications - listPortalNotifications
+   * 
+   * Lists the 360 notifications addressed to the authenticated portal user, newest first. The organization and the portal user are derived from the authenticated session, so a user can only ever read their own notifications.
+   */
+  'listPortalNotifications'(
+    parameters?: Parameters<Paths.ListPortalNotifications.QueryParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.ListPortalNotifications.Responses.$200>
+  /**
+   * getPortalNotificationsUnreadCount - getPortalNotificationsUnreadCount
+   * 
+   * Returns the number of unread notifications for the authenticated portal user.
+   */
+  'getPortalNotificationsUnreadCount'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetPortalNotificationsUnreadCount.Responses.$200>
+  /**
+   * markAllPortalNotificationsRead - markAllPortalNotificationsRead
+   * 
+   * Marks all notifications of the authenticated portal user as read.
+   */
+  'markAllPortalNotificationsRead'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.MarkAllPortalNotificationsRead.Responses.$204>
+  /**
+   * markPortalNotificationRead - markPortalNotificationRead
+   * 
+   * Marks a single notification of the authenticated portal user as read.
+   */
+  'markPortalNotificationRead'(
+    parameters?: Parameters<Paths.MarkPortalNotificationRead.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.MarkPortalNotificationRead.Responses.$204>
   /**
    * updateNotificationsStatus - updateNotificationsStatus
    * 
@@ -17984,7 +19153,7 @@ export interface PathsDictionary {
   }
   ['/v2/portal/consumption']: {
     /**
-     * getConsumption - Get Consumption
+     * getConsumption - getConsumption
      * 
      * Get energy consumption data between a given time period.
      */
@@ -17996,7 +19165,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 +19178,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 +19191,7 @@ export interface PathsDictionary {
   }
   ['/v2/portal/costs']: {
     /**
-     * getCosts - Get Costs
+     * getCosts - getCosts
      * 
      * Get energy cost data between a given time period.
      */
@@ -18034,7 +19203,7 @@ export interface PathsDictionary {
   }
   ['/v2/portal/prices']: {
     /**
-     * getPrices - Get Prices
+     * getPrices - getPrices
      * 
      * Get energy prices data between a given time period.
      */
@@ -19007,6 +20176,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 +20202,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 +20384,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 +20394,63 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GetEntityWorkflows.Responses.$200>
   }
+  ['/v2/portal/engagement/tasks']: {
+    /**
+     * getOutstandingTasks - Get outstanding workflow tasks for the portal user
+     * 
+     * Returns all outstanding workflow journey tasks for the authenticated portal user, across their opportunity, order and contract entities. Each task is an active workflow step that exposes a journey the customer still needs to fill out.
+     */
+    'get'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetOutstandingTasks.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 +20462,7 @@ export interface PathsDictionary {
   }
   ['/v2/portal/metering/reading']: {
     /**
-     * createMeterReading - Create Meter Reading
+     * createMeterReading - createMeterReading
      * 
      * Inserts a new meter reading.
      */
@@ -19239,7 +20474,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 +20489,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 +20766,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.
      */
@@ -19539,6 +20776,54 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.UpdateCampaignPortalBlockStatus.Responses.$200>
   }
+  ['/v2/portal/notifications']: {
+    /**
+     * listPortalNotifications - listPortalNotifications
+     * 
+     * Lists the 360 notifications addressed to the authenticated portal user, newest first. The organization and the portal user are derived from the authenticated session, so a user can only ever read their own notifications.
+     */
+    'get'(
+      parameters?: Parameters<Paths.ListPortalNotifications.QueryParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.ListPortalNotifications.Responses.$200>
+  }
+  ['/v2/portal/notifications/unread-count']: {
+    /**
+     * getPortalNotificationsUnreadCount - getPortalNotificationsUnreadCount
+     * 
+     * Returns the number of unread notifications for the authenticated portal user.
+     */
+    'get'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetPortalNotificationsUnreadCount.Responses.$200>
+  }
+  ['/v2/portal/notifications/read-all']: {
+    /**
+     * markAllPortalNotificationsRead - markAllPortalNotificationsRead
+     * 
+     * Marks all notifications of the authenticated portal user as read.
+     */
+    'put'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.MarkAllPortalNotificationsRead.Responses.$204>
+  }
+  ['/v2/portal/notifications/{id}/read']: {
+    /**
+     * markPortalNotificationRead - markPortalNotificationRead
+     * 
+     * Marks a single notification of the authenticated portal user as read.
+     */
+    'put'(
+      parameters?: Parameters<Paths.MarkPortalNotificationRead.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.MarkPortalNotificationRead.Responses.$204>
+  }
   ['/v2/portal/notifications/entity:status']: {
     /**
      * updateNotificationsStatus - updateNotificationsStatus
@@ -19782,7 +21067,6 @@ export interface PathsDictionary {
 
 export type Client = OpenAPIClient<OperationMethods, PathsDictionary>
 
-
 export type AcceptanceDecision = Components.Schemas.AcceptanceDecision;
 export type AccountExistsRequest = Components.Schemas.AccountExistsRequest;
 export type ActionLabel = Components.Schemas.ActionLabel;
@@ -19833,6 +21117,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 +21150,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;
@@ -19882,6 +21168,7 @@ export type MobileConfig = Components.Schemas.MobileConfig;
 export type MobileConfigUpdate = Components.Schemas.MobileConfigUpdate;
 export type MobileOtaConfig = Components.Schemas.MobileOtaConfig;
 export type MoblieOIDCConfig = Components.Schemas.MoblieOIDCConfig;
+export type NotificationTriggerConfig = Components.Schemas.NotificationTriggerConfig;
 export type OIDCProviderConfig = Components.Schemas.OIDCProviderConfig;
 export type OIDCProviderMetadata = Components.Schemas.OIDCProviderMetadata;
 export type Opportunity = Components.Schemas.Opportunity;
@@ -19889,6 +21176,7 @@ export type Order = Components.Schemas.Order;
 export type OrganizationSettings = Components.Schemas.OrganizationSettings;
 export type Origin = Components.Schemas.Origin;
 export type OtaPortal = Components.Schemas.OtaPortal;
+export type OutstandingTask = Components.Schemas.OutstandingTask;
 export type Page = Components.Schemas.Page;
 export type PageRequest = Components.Schemas.PageRequest;
 export type PaymentWidget = Components.Schemas.PaymentWidget;
@@ -19896,9 +21184,13 @@ 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 PortalNotification = Components.Schemas.PortalNotification;
+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;