@epilot/sdk 2.20.38 → 2.20.40

package/dist/{customer-portal.d-DF4g7c3i.d.ts → customer-portal.d-3yCmlzXi.d.ts}

@@ -1064,35 +1064,7 @@ declare namespace Components {
              * false
              */
             user_account_self_management?: boolean;
-            /**
-             * Feature settings for the portal
-             */
-            feature_settings?: {
-                /**
-                 * Start page feature flag
-                 */
-                start_page?: boolean;
-                /**
-                 * Billing feature flag
-                 */
-                billing?: boolean;
-                /**
-                 * Change due date feature flag
-                 */
-                change_due_date?: boolean;
-                /**
-                 * Enable or disable the new design for the portal
-                 */
-                new_design?: boolean;
-                /**
-                 * Enable the MCP (AI agent) connector channel for this portal
-                 */
-                mcp_enabled?: boolean;
-                /**
-                 * Server-managed generation used to invalidate MCP grants after the connector is disabled or re-enabled
-                 */
-                mcp_grant_version?: number;
-            };
+            feature_settings?: /* Feature settings for the portal */ PortalFeatureSettings;
             /**
              * Access token for the portal
              */
@@ -1632,35 +1604,7 @@ declare namespace Components {
              * false
              */
             user_account_self_management?: boolean;
-            /**
-             * Feature settings for the portal
-             */
-            feature_settings?: {
-                /**
-                 * Start page feature flag
-                 */
-                start_page?: boolean;
-                /**
-                 * Billing feature flag
-                 */
-                billing?: boolean;
-                /**
-                 * Change due date feature flag
-                 */
-                change_due_date?: boolean;
-                /**
-                 * Enable or disable the new design for the portal
-                 */
-                new_design?: boolean;
-                /**
-                 * Enable the MCP (AI agent) connector channel for this portal
-                 */
-                mcp_enabled?: boolean;
-                /**
-                 * Server-managed generation used to invalidate MCP grants after the connector is disabled or re-enabled
-                 */
-                mcp_grant_version?: number;
-            };
+            feature_settings?: /* Feature settings for the portal */ PortalFeatureSettings;
             /**
              * Access token for the portal
              */
@@ -2228,7 +2172,7 @@ declare namespace Components {
             trigger_identifiers_check?: boolean;
         }
         /**
-         * ContactExistsRequest plus the surface the token is requested for.
+         * ContactExistsRequest plus the surface the token is requested for. `registration_identifiers` carries the values of the surface's effective identifiers (keyed by schema, then attribute name): the surface's own `identifiers` when it configures any, otherwise the portal's `registration_identifiers`.
          *
          */
         export interface ContactIdentifyRequest {
@@ -3519,6 +3463,15 @@ declare namespace Components {
              * ]
              */
             targets?: string /* uuid */[];
+            /**
+             * The entity must match at least one of these targets. Combined with `targets` (all of which must match) using AND.
+             * example:
+             * [
+             *   "3ec28ab5-8598-41ef-9486-b57fca1d5e2a",
+             *   "5f2c1e7a-6b0d-4a8e-9c3f-1d2e3f4a5b6c"
+             * ]
+             */
+            match_any_targets?: string /* uuid */[];
             /**
              * Optional enrichment data to side-load alongside results under the `includes` response key.
              * example:
@@ -3551,6 +3504,10 @@ declare namespace Components {
              */
             EntitySlug;
             targets?: string /* uuid */[];
+            /**
+             * The entity must match at least one of these targets. Combined with `targets` (all of which must match) using AND.
+             */
+            match_any_targets?: string /* uuid */[];
             /**
              * DEPRECATED — client-supplied Handlebars templates. Use `templates_ref` instead so templates are derived server-side from admin-authored portal configuration. Ignored when `templates_ref` is present; rejected once the org has the `portals-reject-client-templates` flag enabled.
              */
@@ -5216,6 +5173,46 @@ declare namespace Components {
             slug?: string | null;
             rules?: Rule[] | null;
         }
+        export interface JourneyContextUsagesRequest {
+            /**
+             * Journey whose context parameters are being looked up
+             */
+            journey_id: string;
+            /**
+             * Context parameter names (the `paramKey` of each parameter)
+             */
+            param_keys: string[];
+            /**
+             * Accepted for a uniform adapter request shape; portals reference parameters by name only, so this is ignored.
+             */
+            param_ids?: string[];
+        }
+        export interface JourneyContextUsagesResponse {
+            /**
+             * partial when the row cap, the soft deadline or a failed portal truncated the result
+             */
+            status: "ok" | "partial";
+            /**
+             * Portals examined
+             */
+            scanned: number;
+            usages: {
+                kind: "portal-config" | "portal-block" | "portal-widget";
+                resource: {
+                    type: "portal";
+                    id: string;
+                    name?: string;
+                };
+                location: {
+                    [name: string]: any;
+                };
+                matched_as: {
+                    dialect: "name";
+                    token: string;
+                    at?: string;
+                };
+            }[];
+        }
         export interface JuiceSettings {
             /**
              * Whether the org is in dummy mode
@@ -5643,6 +5640,27 @@ declare namespace Components {
              */
             client_secret?: string;
         }
+        export interface NewDesignMigrationResult {
+            org_id?: string;
+            portal_id?: string;
+            origin?: string;
+            name?: string;
+            is_v3_item?: boolean;
+            dry_run?: boolean;
+            /**
+             * True when the migration was written (false for dry_run)
+             */
+            migrated?: boolean;
+            summary?: {
+                [name: string]: any;
+            };
+            /**
+             * Stored feature_settings and pages before the migration, for rollback
+             */
+            before?: {
+                [name: string]: any;
+            };
+        }
         export interface NotificationTriggerConfig {
             /**
              * The 360 event that fires this notification trigger.
@@ -6448,35 +6466,7 @@ declare namespace Components {
              * false
              */
             user_account_self_management?: boolean;
-            /**
-             * Feature settings for the portal
-             */
-            feature_settings?: {
-                /**
-                 * Start page feature flag
-                 */
-                start_page?: boolean;
-                /**
-                 * Billing feature flag
-                 */
-                billing?: boolean;
-                /**
-                 * Change due date feature flag
-                 */
-                change_due_date?: boolean;
-                /**
-                 * Enable or disable the new design for the portal
-                 */
-                new_design?: boolean;
-                /**
-                 * Enable the MCP (AI agent) connector channel for this portal
-                 */
-                mcp_enabled?: boolean;
-                /**
-                 * Server-managed generation used to invalidate MCP grants after the connector is disabled or re-enabled
-                 */
-                mcp_grant_version?: number;
-            };
+            feature_settings?: /* Feature settings for the portal */ PortalFeatureSettings;
             /**
              * Access token for the portal
              */
@@ -6985,6 +6975,106 @@ declare namespace Components {
             grants?: Grant[];
             identity_providers?: ProviderPublicConfig[];
         }
+        /**
+         * Lightweight view of a portal config for lists and pickers. Carries the identifying,
+         * display and registration fields only. Pages, email templates, grants, feature flags,
+         * identity providers and certificate details are left out; read them per portal with
+         * `getPortalConfigV3`.
+         *
+         */
+        export interface PortalConfigSummaryV3 {
+            portal_id?: /**
+             * ID of the portal
+             * example:
+             * 453ad7bf-86d5-46c8-8252-bcc868df5e3c
+             */
+            PortalId;
+            /**
+             * ID of the organization
+             * example:
+             * 12345
+             */
+            organization_id?: string;
+            origin?: /* Origin of the portal */ Origin;
+            /**
+             * Name of the portal
+             */
+            name?: string;
+            /**
+             * Whether the portal is enabled
+             */
+            enabled?: boolean;
+            /**
+             * Custom domain of the portal
+             */
+            domain?: string;
+            /**
+             * epilot-hosted domain of the portal
+             */
+            epilot_domain?: string;
+            is_epilot_domain?: boolean;
+            /**
+             * Status of the custom domain setup, when a custom domain is configured
+             */
+            dnsStatus?: "CONFIGURING" | "PENDING" | "SUCCEED" | "EXPIRED" | "NEW_CERT_IN_PROGRESS";
+            design_id?: /**
+             * Entity ID
+             * example:
+             * 5da0a718-c822-403d-9f5d-20d4584e0528
+             */
+            EntityId /* uuid */;
+            /**
+             * Default 360 user to notify upon an internal notification
+             */
+            default_user_to_notify?: {
+                /**
+                 * Default admin users for pending user notification to notify
+                 */
+                onPendingUser?: AdminUser[];
+            };
+            feature_settings?: /* Feature settings for the portal */ PortalFeatureSettings;
+            self_registration_setting?: "ALLOW_WITH_CONTACT_CREATION" | "ALLOW_WITHOUT_CONTACT_CREATION" | "DENY" | "ALWAYS_CREATE_CONTACT" | "DISALLOW_COMPLETELY" | "BLOCK_IF_PORTAL_USER_EXISTS";
+            self_registration_account_setting?: "ALLOW_WITH_CREATION" | "DENY" | "ALWAYS_CREATE" | "BLOCK_IF_PORTAL_USER_EXISTS" | "DISALLOW_COMPLETELY";
+            block_registration_if_portal_user_exists?: boolean;
+            /**
+             * Entity type used as the primary identifier for self-registration
+             */
+            self_registration_entity?: "contact" | "account";
+            /**
+             * Enable or disable user account self management
+             */
+            user_account_self_management?: boolean;
+            /**
+             * Identifiers to identify a contact of a portal user during the registration.
+             */
+            registration_identifiers?: ContractIdentifier[];
+            /**
+             * Surfaces this portal's data is reached from besides the portal UI itself.
+             */
+            surfaces?: /**
+             * One surface a portal's data is reached from (see `surfaces` on the portal config).
+             *
+             * A surface names how callers authenticate on it and what they may reach once they
+             * have. Data access is always a subset of the portal's own: a schema not in
+             * `allowed_portal_entities` cannot be opened up by a surface, and the portal's
+             * contact-relation rules still apply underneath the surface's own.
+             *
+             * Tokens minted for a surface (currently: contact identification tokens for
+             * `registration_identifiers` surfaces) carry the surface id. The surface's data
+             * access is resolved from the portal config on every request, not baked into the
+             * token, so tightening a surface applies to tokens already in circulation.
+             *
+             */
+            PortalSurface[];
+            is_dummy?: boolean;
+            is_v3_item?: boolean;
+            /**
+             * ID of the currently published revision, if the portal has been published
+             */
+            published_revision_id?: string;
+            _created_at?: string; // date-time
+            _updated_at?: string; // date-time
+        }
         export interface PortalConfigV3 {
             /**
              * Journey actions allowed on an entity by a portal user
@@ -7109,35 +7199,7 @@ declare namespace Components {
              * false
              */
             user_account_self_management?: boolean;
-            /**
-             * Feature settings for the portal
-             */
-            feature_settings?: {
-                /**
-                 * Start page feature flag
-                 */
-                start_page?: boolean;
-                /**
-                 * Billing feature flag
-                 */
-                billing?: boolean;
-                /**
-                 * Change due date feature flag
-                 */
-                change_due_date?: boolean;
-                /**
-                 * Enable or disable the new design for the portal
-                 */
-                new_design?: boolean;
-                /**
-                 * Enable the MCP (AI agent) connector channel for this portal
-                 */
-                mcp_enabled?: boolean;
-                /**
-                 * Server-managed generation used to invalidate MCP grants after the connector is disabled or re-enabled
-                 */
-                mcp_grant_version?: number;
-            };
+            feature_settings?: /* Feature settings for the portal */ PortalFeatureSettings;
             /**
              * Access token for the portal
              */
@@ -7686,12 +7748,77 @@ declare namespace Components {
                 };
             };
         }
+        /**
+         * Portal-facing overrides of a stage description, configured per portal
+         * audience in the Flows Hub. Served unresolved for the same reason as
+         * `PortalNameOverrides`; a block falls back to `description` when its
+         * audience's key is absent. The values are rich text, like `description`
+         * itself.
+         *
+         */
+        export interface PortalDescriptionOverrides {
+            /**
+             * Description shown in the End Customer Portal
+             */
+            ecp?: string;
+            /**
+             * Description shown in the Installer Portal
+             */
+            installer?: string;
+        }
+        /**
+         * Feature settings for the portal
+         */
+        export interface PortalFeatureSettings {
+            /**
+             * Start page feature flag
+             */
+            start_page?: boolean;
+            /**
+             * Billing feature flag
+             */
+            billing?: boolean;
+            /**
+             * Change due date feature flag
+             */
+            change_due_date?: boolean;
+            /**
+             * Enable or disable the new design for the portal
+             */
+            new_design?: boolean;
+            /**
+             * Enable the MCP (AI agent) connector channel for this portal
+             */
+            mcp_enabled?: boolean;
+            /**
+             * Server-managed generation used to invalidate MCP grants after the connector is disabled or re-enabled
+             */
+            mcp_grant_version?: number;
+        }
         /**
          * ID of the portal
          * example:
          * 453ad7bf-86d5-46c8-8252-bcc868df5e3c
          */
         export type PortalId = string;
+        /**
+         * Portal-facing overrides of a flow or stage title, configured per portal
+         * audience in the Flows Hub. Served unresolved because this endpoint asks
+         * the Workflows API for audience `all` — one cached response feeds blocks
+         * of both audiences, so each block picks its own override and falls back
+         * to `name` when the key is absent.
+         *
+         */
+        export interface PortalNameOverrides {
+            /**
+             * Title shown in the End Customer Portal
+             */
+            ecp?: string;
+            /**
+             * Title shown in the Installer Portal
+             */
+            installer?: string;
+        }
         /**
          * A 360 notification addressed to a portal user.
          */
@@ -8018,35 +8145,7 @@ declare namespace Components {
              * false
              */
             user_account_self_management?: boolean;
-            /**
-             * Feature settings for the portal
-             */
-            feature_settings?: {
-                /**
-                 * Start page feature flag
-                 */
-                start_page?: boolean;
-                /**
-                 * Billing feature flag
-                 */
-                billing?: boolean;
-                /**
-                 * Change due date feature flag
-                 */
-                change_due_date?: boolean;
-                /**
-                 * Enable or disable the new design for the portal
-                 */
-                new_design?: boolean;
-                /**
-                 * Enable the MCP (AI agent) connector channel for this portal
-                 */
-                mcp_enabled?: boolean;
-                /**
-                 * Server-managed generation used to invalidate MCP grants after the connector is disabled or re-enabled
-                 */
-                mcp_grant_version?: number;
-            };
+            feature_settings?: /* Feature settings for the portal */ PortalFeatureSettings;
             /**
              * Access token for the portal
              */
@@ -8572,10 +8671,11 @@ declare namespace Components {
              * How a caller on this surface proves who they are.
              *
              * - `login`: a logged-in portal user token (the portal's own authentication).
-             * - `registration_identifiers`: the caller supplies the portal's
-             *   `registration_identifiers` to `identifyContact` and receives a short-lived
-             *   contact identification token. Anyone who knows or guesses those values can
-             *   use this surface, so its data access should be as narrow as the use case allows.
+             * - `registration_identifiers`: the caller supplies the values of the surface's
+             *   identifiers (its own `identifiers`, or the portal's `registration_identifiers`
+             *   when it sets none) to `identifyContact` and receives a short-lived contact
+             *   identification token. Anyone who knows or guesses those values can use this
+             *   surface, so its data access should be as narrow as the use case allows.
              *
              * `anonymous` (no proof of identity at all) is planned and not accepted yet.
              *
@@ -8585,6 +8685,30 @@ declare namespace Components {
              * Lifetime of tokens minted for this surface. Only used with `registration_identifiers`.
              */
             token_ttl_seconds?: number; // int32
+            /**
+             * Identifier attributes a caller must supply on this surface to be identified. Only
+             * used with `authentication: registration_identifiers`.
+             *
+             * Omitted or empty means the surface uses the portal's `registration_identifiers`.
+             * When set, these replace the portal's `registration_identifiers` on this surface
+             * only: `identifyContact` requires a value for each of them (400 listing the missing
+             * ones otherwise), runs the contact lookup and the `registrationIdentifiersCheck`
+             * hook on them, and refuses to issue tokens (403) unless there are at least two.
+             * Entries without `name` or `schema` are ignored.
+             *
+             * example:
+             * [
+             *   {
+             *     "name": "customer_number",
+             *     "schema": "contact"
+             *   },
+             *   {
+             *     "name": "meter_number",
+             *     "schema": "meter"
+             *   }
+             * ]
+             */
+            identifiers?: RegistrationIdentifier[];
             data_access?: /* What a caller on a surface may reach. Every property is optional; omitting all of them is the portal's default scope. */ PortalSurfaceDataAccess;
         }
         /**
@@ -8639,6 +8763,10 @@ declare namespace Components {
                 id?: string;
                 journeyId?: string;
                 name?: string;
+                /**
+                 * Portal-facing label configured in the Flows Hub that replaces the portal's default "Start now" button for this journey.
+                 */
+                portal_button_label?: string;
                 complete_task_automatically?: boolean;
             };
         }
@@ -8778,6 +8906,15 @@ declare namespace Components {
              *
              */
             PortalWorkflowStage[];
+            portal_titles?: /**
+             * Portal-facing overrides of a flow or stage title, configured per portal
+             * audience in the Flows Hub. Served unresolved because this endpoint asks
+             * the Workflows API for audience `all` — one cached response feeds blocks
+             * of both audiences, so each block picks its own override and falls back
+             * to `name` when the key is absent.
+             *
+             */
+            PortalNameOverrides;
         }
         /**
          * A customer-facing stage of a flow execution, with a progress status derived
@@ -8803,15 +8940,34 @@ declare namespace Components {
              * - COMPLETED: every task of the stage is done, and the flow has moved past it
              * - IN_PROGRESS: the flow's current work is inside this stage
              * - UPCOMING: the flow has not reached this stage yet
+             * - NOT_REACHED: the flow finished (DONE or CLOSED) before reaching this stage — a run may legitimately end at any stage
              *
              */
-            status: "COMPLETED" | "IN_PROGRESS" | "UPCOMING";
+            status: "COMPLETED" | "IN_PROGRESS" | "UPCOMING" | "NOT_REACHED";
             /**
              * Latest completion timestamp among the stage's tasks; set only when the
              * stage is COMPLETED and at least one of its tasks recorded one
              *
              */
             completed_at?: string;
+            portal_names?: /**
+             * Portal-facing overrides of a flow or stage title, configured per portal
+             * audience in the Flows Hub. Served unresolved because this endpoint asks
+             * the Workflows API for audience `all` — one cached response feeds blocks
+             * of both audiences, so each block picks its own override and falls back
+             * to `name` when the key is absent.
+             *
+             */
+            PortalNameOverrides;
+            portal_descriptions?: /**
+             * Portal-facing overrides of a stage description, configured per portal
+             * audience in the Flows Hub. Served unresolved for the same reason as
+             * `PortalNameOverrides`; a block falls back to `description` when its
+             * audience's key is absent. The values are rich text, like `description`
+             * itself.
+             *
+             */
+            PortalDescriptionOverrides;
         }
         /**
          * A single portal-visible task of a linearized workflow execution
@@ -8853,6 +9009,10 @@ declare namespace Components {
                 id?: string;
                 journeyId?: string;
                 name?: string;
+                /**
+                 * Portal-facing label configured in the Flows Hub that replaces the portal's default "Start now" button for this journey. Blank or absent means the portal keeps its own translated default.
+                 */
+                portal_button_label?: string;
                 /**
                  * If true, the task is auto completed when the journey is completed
                  */
@@ -10168,35 +10328,7 @@ declare namespace Components {
              * false
              */
             user_account_self_management?: boolean;
-            /**
-             * Feature settings for the portal
-             */
-            feature_settings?: {
-                /**
-                 * Start page feature flag
-                 */
-                start_page?: boolean;
-                /**
-                 * Billing feature flag
-                 */
-                billing?: boolean;
-                /**
-                 * Change due date feature flag
-                 */
-                change_due_date?: boolean;
-                /**
-                 * Enable or disable the new design for the portal
-                 */
-                new_design?: boolean;
-                /**
-                 * Enable the MCP (AI agent) connector channel for this portal
-                 */
-                mcp_enabled?: boolean;
-                /**
-                 * Server-managed generation used to invalidate MCP grants after the connector is disabled or re-enabled
-                 */
-                mcp_grant_version?: number;
-            };
+            feature_settings?: /* Feature settings for the portal */ PortalFeatureSettings;
             /**
              * Access token for the portal
              */
@@ -10797,35 +10929,7 @@ declare namespace Components {
              * false
              */
             user_account_self_management?: boolean;
-            /**
-             * Feature settings for the portal
-             */
-            feature_settings?: {
-                /**
-                 * Start page feature flag
-                 */
-                start_page?: boolean;
-                /**
-                 * Billing feature flag
-                 */
-                billing?: boolean;
-                /**
-                 * Change due date feature flag
-                 */
-                change_due_date?: boolean;
-                /**
-                 * Enable or disable the new design for the portal
-                 */
-                new_design?: boolean;
-                /**
-                 * Enable the MCP (AI agent) connector channel for this portal
-                 */
-                mcp_enabled?: boolean;
-                /**
-                 * Server-managed generation used to invalidate MCP grants after the connector is disabled or re-enabled
-                 */
-                mcp_grant_version?: number;
-            };
+            feature_settings?: /* Feature settings for the portal */ PortalFeatureSettings;
             /**
              * Access token for the portal
              */
@@ -14839,35 +14943,7 @@ declare namespace Paths {
                  * false
                  */
                 user_account_self_management?: boolean;
-                /**
-                 * Feature settings for the portal
-                 */
-                feature_settings?: {
-                    /**
-                     * Start page feature flag
-                     */
-                    start_page?: boolean;
-                    /**
-                     * Billing feature flag
-                     */
-                    billing?: boolean;
-                    /**
-                     * Change due date feature flag
-                     */
-                    change_due_date?: boolean;
-                    /**
-                     * Enable or disable the new design for the portal
-                     */
-                    new_design?: boolean;
-                    /**
-                     * Enable the MCP (AI agent) connector channel for this portal
-                     */
-                    mcp_enabled?: boolean;
-                    /**
-                     * Server-managed generation used to invalidate MCP grants after the connector is disabled or re-enabled
-                     */
-                    mcp_grant_version?: number;
-                };
+                feature_settings?: /* Feature settings for the portal */ Components.Schemas.PortalFeatureSettings;
                 /**
                  * Access token for the portal
                  */
@@ -15498,35 +15574,7 @@ declare namespace Paths {
                  * false
                  */
                 user_account_self_management?: boolean;
-                /**
-                 * Feature settings for the portal
-                 */
-                feature_settings?: {
-                    /**
-                     * Start page feature flag
-                     */
-                    start_page?: boolean;
-                    /**
-                     * Billing feature flag
-                     */
-                    billing?: boolean;
-                    /**
-                     * Change due date feature flag
-                     */
-                    change_due_date?: boolean;
-                    /**
-                     * Enable or disable the new design for the portal
-                     */
-                    new_design?: boolean;
-                    /**
-                     * Enable the MCP (AI agent) connector channel for this portal
-                     */
-                    mcp_enabled?: boolean;
-                    /**
-                     * Server-managed generation used to invalidate MCP grants after the connector is disabled or re-enabled
-                     */
-                    mcp_grant_version?: number;
-                };
+                feature_settings?: /* Feature settings for the portal */ Components.Schemas.PortalFeatureSettings;
                 /**
                  * Access token for the portal
                  */
@@ -16711,35 +16759,7 @@ declare namespace Paths {
                  * false
                  */
                 user_account_self_management?: boolean;
-                /**
-                 * Feature settings for the portal
-                 */
-                feature_settings?: {
-                    /**
-                     * Start page feature flag
-                     */
-                    start_page?: boolean;
-                    /**
-                     * Billing feature flag
-                     */
-                    billing?: boolean;
-                    /**
-                     * Change due date feature flag
-                     */
-                    change_due_date?: boolean;
-                    /**
-                     * Enable or disable the new design for the portal
-                     */
-                    new_design?: boolean;
-                    /**
-                     * Enable the MCP (AI agent) connector channel for this portal
-                     */
-                    mcp_enabled?: boolean;
-                    /**
-                     * Server-managed generation used to invalidate MCP grants after the connector is disabled or re-enabled
-                     */
-                    mcp_grant_version?: number;
-                };
+                feature_settings?: /* Feature settings for the portal */ Components.Schemas.PortalFeatureSettings;
                 /**
                  * Access token for the portal
                  */
@@ -17971,7 +17991,7 @@ declare namespace Paths {
             domain?: Parameters.Domain;
         }
         export type RequestBody = /**
-         * ContactExistsRequest plus the surface the token is requested for.
+         * ContactExistsRequest plus the surface the token is requested for. `registration_identifiers` carries the values of the surface's effective identifiers (keyed by schema, then attribute name): the surface's own `identifiers` when it configures any, otherwise the portal's `registration_identifiers`.
          *
          */
         Components.Schemas.ContactIdentifyRequest;
@@ -18095,6 +18115,23 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
+    namespace ListPortalConfigSummaries {
+        namespace Responses {
+            export interface $200 {
+                data?: /**
+                 * Lightweight view of a portal config for lists and pickers. Carries the identifying,
+                 * display and registration fields only. Pages, email templates, grants, feature flags,
+                 * identity providers and certificate details are left out; read them per portal with
+                 * `getPortalConfigV3`.
+                 *
+                 */
+                Components.Schemas.PortalConfigSummaryV3[];
+            }
+            export type $401 = Components.Responses.Unauthorized;
+            export type $403 = Components.Responses.Forbidden;
+            export type $500 = Components.Responses.InternalServerError;
+        }
+    }
     namespace ListPortalNotifications {
         namespace Parameters {
             export type Cursor = string;
@@ -20421,15 +20458,24 @@ interface OperationMethods {
   /**
    * identifyContact - identifyContact
    * 
-   * Identify a contact by the portal's configured registration identifiers and, on a match,
-   * issue a short-lived bearer token that acts as that contact.
+   * Identify a contact by the surface's identifiers and, on a match, issue a short-lived
+   * bearer token that acts as that contact.
    * 
-   * Resolution is identical to `checkContactExistsV3`. The token does not grant a portal
+   * The identifiers checked are the surface's own `identifiers` when it configures any,
+   * otherwise the portal's `registration_identifiers`. Their values are sent in the
+   * `registration_identifiers` request property. Resolution is otherwise identical to
+   * `checkContactExistsV3`: the same lookup, `registrationIdentifiersCheck` hook and
+   * TIMEOUT semantics, run on the surface's identifiers. The token does not grant a portal
    * session; it is accepted only on the operations listed in `allowed_operations`, and
    * expires at `expires_at`. Requires `surface_id` to name a surface of the portal whose
    * `authentication` is `registration_identifiers`; returns 403 otherwise. The token is
    * confined to that surface's data access. Requests may be rate limited (429).
    * 
+   * No portal session is expected, but the caller must present a public access token
+   * (`token_type: journey` or `token_type: portal`) as the bearer, minted for the same
+   * `org_id`; the request is rejected with 401 otherwise. It binds the call to the journey
+   * or portal it comes from — the token is public, so it proves origin, not identity.
+   * 
    */
   'identifyContact'(
     parameters?: Parameters<Paths.IdentifyContact.QueryParameters> | null,
@@ -21515,7 +21561,10 @@ interface OperationMethods {
   /**
    * deletePortalConfig - deletePortalConfig
    * 
-   * Deletes a specific portal configuration by ID.
+   * Deletes a specific portal configuration by ID, together with everything the portal owns:
+   * its pages, revisions, email templates and widget configuration. The custom domain network
+   * setup is torn down asynchronously afterwards.
+   * 
    */
   'deletePortalConfig'(
     parameters?: Parameters<Paths.DeletePortalConfig.PathParameters> | null,
@@ -21592,6 +21641,22 @@ interface OperationMethods {
     data?: any,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.ListAllPortalConfigs.Responses.$200>
+  /**
+   * listPortalConfigSummaries - listPortalConfigSummaries
+   * 
+   * Lists the portals of the organization as lightweight summaries: the identifying,
+   * display and registration fields of each portal config, without pages, email
+   * templates, grants, feature flags, identity providers or certificate details.
+   * 
+   * Use it for portal overviews and pickers. Read a single portal with
+   * `getPortalConfigV3` when the full configuration is needed.
+   * 
+   */
+  'listPortalConfigSummaries'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.ListPortalConfigSummaries.Responses.$200>
   /**
    * swapPortalConfig - swapPortalConfig
    * 
@@ -22419,15 +22484,24 @@ interface PathsDictionary {
     /**
      * identifyContact - identifyContact
      * 
-     * Identify a contact by the portal's configured registration identifiers and, on a match,
-     * issue a short-lived bearer token that acts as that contact.
+     * Identify a contact by the surface's identifiers and, on a match, issue a short-lived
+     * bearer token that acts as that contact.
      * 
-     * Resolution is identical to `checkContactExistsV3`. The token does not grant a portal
+     * The identifiers checked are the surface's own `identifiers` when it configures any,
+     * otherwise the portal's `registration_identifiers`. Their values are sent in the
+     * `registration_identifiers` request property. Resolution is otherwise identical to
+     * `checkContactExistsV3`: the same lookup, `registrationIdentifiersCheck` hook and
+     * TIMEOUT semantics, run on the surface's identifiers. The token does not grant a portal
      * session; it is accepted only on the operations listed in `allowed_operations`, and
      * expires at `expires_at`. Requires `surface_id` to name a surface of the portal whose
      * `authentication` is `registration_identifiers`; returns 403 otherwise. The token is
      * confined to that surface's data access. Requests may be rate limited (429).
      * 
+     * No portal session is expected, but the caller must present a public access token
+     * (`token_type: journey` or `token_type: portal`) as the bearer, minted for the same
+     * `org_id`; the request is rejected with 401 otherwise. It binds the call to the journey
+     * or portal it comes from — the token is public, so it proves origin, not identity.
+     * 
      */
     'post'(
       parameters?: Parameters<Paths.IdentifyContact.QueryParameters> | null,
@@ -23683,7 +23757,10 @@ interface PathsDictionary {
     /**
      * deletePortalConfig - deletePortalConfig
      * 
-     * Deletes a specific portal configuration by ID.
+     * Deletes a specific portal configuration by ID, together with everything the portal owns:
+     * its pages, revisions, email templates and widget configuration. The custom domain network
+     * setup is torn down asynchronously afterwards.
+     * 
      */
     'delete'(
       parameters?: Parameters<Paths.DeletePortalConfig.PathParameters> | null,
@@ -23769,6 +23846,24 @@ interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.ListAllPortalConfigs.Responses.$200>
   }
+  ['/v3/portal/configs/summaries']: {
+    /**
+     * listPortalConfigSummaries - listPortalConfigSummaries
+     * 
+     * Lists the portals of the organization as lightweight summaries: the identifying,
+     * display and registration fields of each portal config, without pages, email
+     * templates, grants, feature flags, identity providers or certificate details.
+     * 
+     * Use it for portal overviews and pickers. Read a single portal with
+     * `getPortalConfigV3` when the full configuration is needed.
+     * 
+     */
+    'get'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.ListPortalConfigSummaries.Responses.$200>
+  }
   ['/v3/portal/config/swap']: {
     /**
      * swapPortalConfig - swapPortalConfig
@@ -24013,6 +24108,8 @@ type Grant = Components.Schemas.Grant;
 type IdentifierAttribute = Components.Schemas.IdentifierAttribute;
 type InstallmentEvent = Components.Schemas.InstallmentEvent;
 type JourneyActions = Components.Schemas.JourneyActions;
+type JourneyContextUsagesRequest = Components.Schemas.JourneyContextUsagesRequest;
+type JourneyContextUsagesResponse = Components.Schemas.JourneyContextUsagesResponse;
 type JuiceSettings = Components.Schemas.JuiceSettings;
 type Meter = Components.Schemas.Meter;
 type MeterChartWidget = Components.Schemas.MeterChartWidget;
@@ -24026,6 +24123,7 @@ type MobileConfig = Components.Schemas.MobileConfig;
 type MobileConfigUpdate = Components.Schemas.MobileConfigUpdate;
 type MobileOtaConfig = Components.Schemas.MobileOtaConfig;
 type MoblieOIDCConfig = Components.Schemas.MoblieOIDCConfig;
+type NewDesignMigrationResult = Components.Schemas.NewDesignMigrationResult;
 type NotificationTriggerConfig = Components.Schemas.NotificationTriggerConfig;
 type OIDCProviderConfig = Components.Schemas.OIDCProviderConfig;
 type OIDCProviderMetadata = Components.Schemas.OIDCProviderMetadata;
@@ -24039,9 +24137,13 @@ type Page = Components.Schemas.Page;
 type PageRequest = Components.Schemas.PageRequest;
 type PaymentWidget = Components.Schemas.PaymentWidget;
 type PortalConfig = Components.Schemas.PortalConfig;
+type PortalConfigSummaryV3 = Components.Schemas.PortalConfigSummaryV3;
 type PortalConfigV3 = Components.Schemas.PortalConfigV3;
 type PortalDataExportColumn = Components.Schemas.PortalDataExportColumn;
+type PortalDescriptionOverrides = Components.Schemas.PortalDescriptionOverrides;
+type PortalFeatureSettings = Components.Schemas.PortalFeatureSettings;
 type PortalId = Components.Schemas.PortalId;
+type PortalNameOverrides = Components.Schemas.PortalNameOverrides;
 type PortalNotification = Components.Schemas.PortalNotification;
 type PortalRevision = Components.Schemas.PortalRevision;
 type PortalRevisionCreated = Components.Schemas.PortalRevisionCreated;
@@ -24118,4 +24220,4 @@ type WorfklowIdentifier = Components.Schemas.WorfklowIdentifier;
 type WorkflowExecution = Components.Schemas.WorkflowExecution;
 type WorkflowStep = Components.Schemas.WorkflowStep;
 
-export { type EntityEditRule as $, type AcceptanceDecision as A, type Balance as B, type Client as C, type CommonConfigAttributes as D, type CommonConfigAttributesV3 as E, type Contact as F, type ContactCountRequest as G, type ContactExistsRequest as H, type ContactIdentifyRequest as I, type ContactIdentifyResponse as J, type ContentWidget as K, type ContextEntities as L, type ContextEntity as M, type Contract as N, type OperationMethods as O, Paths as P, type ContractIdentifier as Q, type CreateSupportRequest as R, type CreateUserRequest as S, type Currency as T, type DataRetrievalItem as U, DeleteEntityFile as V, type Direction as W, type DocumentWidget as X, type DomainSettings as Y, type EmailTemplates as Z, type Entity as _, Components as a, type OtaPortal as a$, type EntityFileCount as a0, type EntityGetParams as a1, type EntityId as a2, type EntityItem as a3, type EntityMatchingConfig as a4, type EntityPortalWorkflows as a5, type EntityResponse as a6, type EntityResponseGroupedWithHits as a7, type EntityResponseWithHits as a8, type EntitySearchParams as a9, type File as aA, type FileItem as aB, type FilePreviewResult as aC, type Grant as aD, type IdentifierAttribute as aE, type InstallmentEvent as aF, type JourneyActions as aG, type JuiceSettings as aH, type Meter as aI, type MeterChartWidget as aJ, type MeterReading as aK, type MeterReadingPhoto as aL, type MeterReadingPhotoData as aM, type MeterReadingWidget as aN, type MobileBranding as aO, type MobileBuildStatus as aP, type MobileConfig as aQ, type MobileConfigUpdate as aR, type MobileOtaConfig as aS, type MoblieOIDCConfig as aT, type NotificationTriggerConfig as aU, type OIDCProviderConfig as aV, type OIDCProviderMetadata as aW, type Opportunity as aX, type Order as aY, type OrganizationSettings as aZ, type Origin as a_, type EntitySlug as aa, type EntitySlugConfig as ab, type EntityTemplates as ac, type EntityWidget as ad, type ErrorResp as ae, type Exists as af, type Extension as ag, type ExtensionAuthBlock as ah, type ExtensionConfig as ai, type ExtensionHook as aj, type ExtensionHookChangeEmail as ak, type ExtensionHookChangePassword as al, type ExtensionHookConsumptionDataRetrieval as am, type ExtensionHookContractIdentification as an, type ExtensionHookCostDataRetrieval as ao, type ExtensionHookDataExport as ap, type ExtensionHookDeleteAccount as aq, type ExtensionHookMeterReadingPlausibilityCheck as ar, type ExtensionHookPriceDataRetrieval as as, type ExtensionHookRegistrationIdentifiersCheck as at, type ExtensionHookSelection as au, type ExtensionHookVisualizationMetadata as av, type ExtensionSeamlessLink as aw, type ExternalLink as ax, type ExtraSchemaAttributes as ay, type FailedRuleErrorResp as az, type PathsDictionary as b, type SupportRequestAttachment as b$, type OutstandingTask as b0, type Page as b1, type PageRequest as b2, type PaymentWidget as b3, type PortalConfig as b4, type PortalConfigV3 as b5, type PortalDataExportColumn as b6, type PortalId as b7, type PortalNotification as b8, type PortalRevision as b9, type PublicDeleteAccountDetails as bA, type PublicExtensionCapabilities as bB, type PublicExtensionDetails as bC, type PublicIdentityProvider as bD, type PublicMeterReadingPlausibilityCheckDetails as bE, type PublicSelfManagementExplanation as bF, type PublishResult as bG, type PublishRevisionRequest as bH, type ReadBy as bI, type ReadingStatus as bJ, type Reason as bK, type RegistrationIdentifier as bL, type ReimbursementEvent as bM, type RevisionPage as bN, type RevisionPageRequest as bO, type Rule as bP, type SAMLProviderConfig as bQ, type SSOCallbackRequest as bR, type SSOCallbackResponse as bS, type SSOLoginToken as bT, SaveEntityFile as bU, type SavePortalFile as bV, type Schema as bW, type SearchIncludes as bX, type SecureProxyConfig as bY, type Source as bZ, type SupportReportType as b_, type PortalRevisionCreated as ba, type PortalRevisionList as bb, type PortalRevisionRequest as bc, type PortalRevisionSummary as bd, type PortalSurface as be, type PortalSurfaceDataAccess as bf, type PortalSurfaceEntityAccess as bg, type PortalTaskConfig as bh, type PortalUser as bi, type PortalUserRegistrationStatus as bj, type PortalWidget as bk, type PortalWorkflow as bl, type PortalWorkflowStage as bm, type PortalWorkflowTask as bn, type Product as bo, type ProductRecommendationsWidget as bp, type ProviderConfig as bq, type ProviderDisplayName as br, type ProviderPublicConfig as bs, type ProviderPublicConfigV3 as bt, type ProviderSlug as bu, type PublicAppDetails as bv, type PublicChangeEmailDetails as bw, type PublicChangePasswordDetails as bx, type PublicContractIdentificationDetails as by, type PublicDataRetrievalHookDetails as bz, type AccountExistsRequest as c, type SupportRequestResult as c0, type SwappableConfig as c1, type TariffType as c2, type TeaserWidget as c3, type TemplatesRef as c4, type TriggerPortalFlow as c5, type UpdateOnlyPortalConfigAttributes as c6, type UpsertPortalConfig as c7, type UpsertPortalConfigV3 as c8, UpsertPortalWidget as c9, type UserRequest as ca, type VisualizationDataRange as cb, type VisualizationMetadata as cc, type VisualizationTypeOption as cd, type WidgetAction as ce, type WidgetBase as cf, type WorfklowIdentifier as cg, type WorkflowExecution as ch, type WorkflowStep as ci, 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 CleverPvContext as z };
+export { type EntityEditRule as $, type AcceptanceDecision as A, type Balance as B, type Client as C, type CommonConfigAttributes as D, type CommonConfigAttributesV3 as E, type Contact as F, type ContactCountRequest as G, type ContactExistsRequest as H, type ContactIdentifyRequest as I, type ContactIdentifyResponse as J, type ContentWidget as K, type ContextEntities as L, type ContextEntity as M, type Contract as N, type OperationMethods as O, Paths as P, type ContractIdentifier as Q, type CreateSupportRequest as R, type CreateUserRequest as S, type Currency as T, type DataRetrievalItem as U, DeleteEntityFile as V, type Direction as W, type DocumentWidget as X, type DomainSettings as Y, type EmailTemplates as Z, type Entity as _, Components as a, type Order as a$, type EntityFileCount as a0, type EntityGetParams as a1, type EntityId as a2, type EntityItem as a3, type EntityMatchingConfig as a4, type EntityPortalWorkflows as a5, type EntityResponse as a6, type EntityResponseGroupedWithHits as a7, type EntityResponseWithHits as a8, type EntitySearchParams as a9, type File as aA, type FileItem as aB, type FilePreviewResult as aC, type Grant as aD, type IdentifierAttribute as aE, type InstallmentEvent as aF, type JourneyActions as aG, type JourneyContextUsagesRequest as aH, type JourneyContextUsagesResponse as aI, type JuiceSettings as aJ, type Meter as aK, type MeterChartWidget as aL, type MeterReading as aM, type MeterReadingPhoto as aN, type MeterReadingPhotoData as aO, type MeterReadingWidget as aP, type MobileBranding as aQ, type MobileBuildStatus as aR, type MobileConfig as aS, type MobileConfigUpdate as aT, type MobileOtaConfig as aU, type MoblieOIDCConfig as aV, type NewDesignMigrationResult as aW, type NotificationTriggerConfig as aX, type OIDCProviderConfig as aY, type OIDCProviderMetadata as aZ, type Opportunity as a_, type EntitySlug as aa, type EntitySlugConfig as ab, type EntityTemplates as ac, type EntityWidget as ad, type ErrorResp as ae, type Exists as af, type Extension as ag, type ExtensionAuthBlock as ah, type ExtensionConfig as ai, type ExtensionHook as aj, type ExtensionHookChangeEmail as ak, type ExtensionHookChangePassword as al, type ExtensionHookConsumptionDataRetrieval as am, type ExtensionHookContractIdentification as an, type ExtensionHookCostDataRetrieval as ao, type ExtensionHookDataExport as ap, type ExtensionHookDeleteAccount as aq, type ExtensionHookMeterReadingPlausibilityCheck as ar, type ExtensionHookPriceDataRetrieval as as, type ExtensionHookRegistrationIdentifiersCheck as at, type ExtensionHookSelection as au, type ExtensionHookVisualizationMetadata as av, type ExtensionSeamlessLink as aw, type ExternalLink as ax, type ExtraSchemaAttributes as ay, type FailedRuleErrorResp as az, type PathsDictionary as b, SaveEntityFile as b$, type OrganizationSettings as b0, type Origin as b1, type OtaPortal as b2, type OutstandingTask as b3, type Page as b4, type PageRequest as b5, type PaymentWidget as b6, type PortalConfig as b7, type PortalConfigSummaryV3 as b8, type PortalConfigV3 as b9, type ProviderPublicConfigV3 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 PublicIdentityProvider as bK, type PublicMeterReadingPlausibilityCheckDetails as bL, type PublicSelfManagementExplanation as bM, type PublishResult as bN, type PublishRevisionRequest as bO, type ReadBy as bP, type ReadingStatus as bQ, type Reason as bR, type RegistrationIdentifier as bS, type ReimbursementEvent as bT, type RevisionPage as bU, type RevisionPageRequest as bV, type Rule as bW, type SAMLProviderConfig as bX, type SSOCallbackRequest as bY, type SSOCallbackResponse as bZ, type SSOLoginToken as b_, type PortalDataExportColumn as ba, type PortalDescriptionOverrides as bb, type PortalFeatureSettings as bc, type PortalId as bd, type PortalNameOverrides as be, type PortalNotification as bf, type PortalRevision as bg, type PortalRevisionCreated as bh, type PortalRevisionList as bi, type PortalRevisionRequest as bj, type PortalRevisionSummary as bk, type PortalSurface as bl, type PortalSurfaceDataAccess as bm, type PortalSurfaceEntityAccess as bn, type PortalTaskConfig as bo, type PortalUser as bp, type PortalUserRegistrationStatus as bq, type PortalWidget as br, type PortalWorkflow as bs, type PortalWorkflowStage as bt, type PortalWorkflowTask as bu, type Product as bv, type ProductRecommendationsWidget as bw, type ProviderConfig as bx, type ProviderDisplayName as by, type ProviderPublicConfig as bz, type AccountExistsRequest as c, type SavePortalFile as c0, type Schema as c1, type SearchIncludes as c2, type SecureProxyConfig as c3, type Source as c4, type SupportReportType as c5, type SupportRequestAttachment as c6, type SupportRequestResult as c7, type SwappableConfig as c8, type TariffType as c9, type TeaserWidget as ca, type TemplatesRef as cb, type TriggerPortalFlow as cc, type UpdateOnlyPortalConfigAttributes as cd, type UpsertPortalConfig as ce, type UpsertPortalConfigV3 as cf, UpsertPortalWidget as cg, type UserRequest as ch, type VisualizationDataRange as ci, type VisualizationMetadata as cj, type VisualizationTypeOption as ck, type WidgetAction as cl, type WidgetBase as cm, type WorfklowIdentifier as cn, type WorkflowExecution as co, type WorkflowStep as cp, 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 CleverPvContext as z };