@epilot/customer-portal-client 0.48.0 → 0.49.0

package/dist/openapi.d.ts

@@ -1067,35 +1067,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
              */
@@ -1335,6 +1307,13 @@ declare namespace Components {
              * ]
              */
             contract_identifiers?: ContractIdentifier[];
+            /**
+             * What the built-in self-assignment (without a contractIdentification hook) assigns once the `contract_identifiers` match a Contract:
+             *   - `contracts`: the user's Contact is added as a customer of the Contract.
+             *   - `customer_to_portal_user`: the Contract's customers (Contacts and Accounts) are added to the Portal User's `represents`. The Portal User sees all their data, including Contracts, transitively. Mirrors the `contact_to_portal_user` assignment mode of the contractIdentification hook.
+             *
+             */
+            self_assignment_mode?: "contracts" | "customer_to_portal_user";
             /**
              * Configuration for contract selector in the portal
              */
@@ -1635,35 +1614,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
              */
@@ -1903,6 +1854,13 @@ declare namespace Components {
              * ]
              */
             contract_identifiers?: ContractIdentifier[];
+            /**
+             * What the built-in self-assignment (without a contractIdentification hook) assigns once the `contract_identifiers` match a Contract:
+             *   - `contracts`: the user's Contact is added as a customer of the Contract.
+             *   - `customer_to_portal_user`: the Contract's customers (Contacts and Accounts) are added to the Portal User's `represents`. The Portal User sees all their data, including Contracts, transitively. Mirrors the `contact_to_portal_user` assignment mode of the contractIdentification hook.
+             *
+             */
+            self_assignment_mode?: "contracts" | "customer_to_portal_user";
             /**
              * Configuration for contract selector in the portal
              */
@@ -2333,6 +2291,15 @@ declare namespace Components {
              * []
              */
             allowed_operations?: string[];
+            /**
+             * Whether the identified contact already has a portal user on this portal, so the caller
+             * can skip offering account creation. Present only on a match; omitted when it could not
+             * be determined.
+             *
+             * example:
+             * false
+             */
+            has_portal_user?: boolean;
             /**
              * Present only when no token was issued. NOT_FOUND means the given identifiers did not
              * match any contact (definitive - the client should not retry). TIMEOUT means the contact
@@ -5256,7 +5223,7 @@ declare namespace Components {
              */
             scanned: number;
             usages: {
-                kind: "portal-config" | "portal-block" | "portal-widget";
+                kind: "portal-config" | "portal-block";
                 resource: {
                     type: "portal";
                     id: string;
@@ -5291,6 +5258,32 @@ declare namespace Components {
              * https://example.com
              */
             redirect_to?: string;
+            /**
+             * Portal name, served as the document title before the app boots
+             * example:
+             * Kundenportal
+             */
+            title?: string;
+            /**
+             * Whether the served document should carry a `noindex, nofollow` robots meta tag
+             */
+            prevent_indexing?: boolean;
+            /**
+             * Organization of the portal, used to preload its design from the served document
+             * example:
+             * 123
+             */
+            organization_id?: string;
+            /**
+             * Design of the portal, used to preload it from the served document
+             */
+            design_id?: string;
+            /**
+             * The portal design as returned by design-builder parse (theme=NEW), for the served document; absent when the design could not be read
+             */
+            design?: {
+                [name: string]: any;
+            } | null;
         }
         /**
          * The meter entity
@@ -6525,35 +6518,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
              */
@@ -6793,6 +6758,13 @@ declare namespace Components {
              * ]
              */
             contract_identifiers?: ContractIdentifier[];
+            /**
+             * What the built-in self-assignment (without a contractIdentification hook) assigns once the `contract_identifiers` match a Contract:
+             *   - `contracts`: the user's Contact is added as a customer of the Contract.
+             *   - `customer_to_portal_user`: the Contract's customers (Contacts and Accounts) are added to the Portal User's `represents`. The Portal User sees all their data, including Contracts, transitively. Mirrors the `contact_to_portal_user` assignment mode of the contractIdentification hook.
+             *
+             */
+            self_assignment_mode?: "contracts" | "customer_to_portal_user";
             /**
              * Configuration for contract selector in the portal
              */
@@ -7062,6 +7034,123 @@ 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 */;
+            /**
+             * The logo to show for the portal in lists: the `logoImage` of the first page
+             * that sets one. Absent when no page carries a logo; fall back to the design.
+             *
+             */
+            logo_image?: {
+                /**
+                 * Logo for the light theme
+                 * example:
+                 * https://epilot-bucket.s3.eu-central-1.amazonaws.com/12344/logo.png
+                 */
+                url?: string;
+                /**
+                 * Logo for the dark theme
+                 */
+                dark_url?: string;
+            };
+            /**
+             * 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
@@ -7186,35 +7275,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
              */
@@ -7454,6 +7515,13 @@ declare namespace Components {
              * ]
              */
             contract_identifiers?: ContractIdentifier[];
+            /**
+             * What the built-in self-assignment (without a contractIdentification hook) assigns once the `contract_identifiers` match a Contract:
+             *   - `contracts`: the user's Contact is added as a customer of the Contract.
+             *   - `customer_to_portal_user`: the Contract's customers (Contacts and Accounts) are added to the Portal User's `represents`. The Portal User sees all their data, including Contracts, transitively. Mirrors the `contact_to_portal_user` assignment mode of the contractIdentification hook.
+             *
+             */
+            self_assignment_mode?: "contracts" | "customer_to_portal_user";
             /**
              * Configuration for contract selector in the portal
              */
@@ -7781,6 +7849,47 @@ declare namespace Components {
              */
             installer?: string;
         }
+        /**
+         * Feature settings for the portal
+         */
+        export interface PortalFeatureSettings {
+            /**
+             * Retired, not read. A portal shows a start page by having a `dashboard` page.
+             */
+            start_page?: boolean;
+            /**
+             * Retired, not read. Billing follows the organization's `commodity_billing` setting.
+             */
+            billing?: boolean;
+            /**
+             * Retired, not read. Billing pages and blocks follow the organization's `commodity_billing` setting.
+             */
+            commodity_billing?: boolean;
+            /**
+             * Retired, not read.
+             */
+            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;
+            /**
+             * Enable the portal copilot chat for this portal
+             */
+            portal_copilot?: boolean;
+            /**
+             * ID of the Agent Builder portal agent this portal's copilot chat runs, set by Agent Builder. When unset, or when the agent no longer exists in the portal's organization, the chat runs the default portal copilot.
+             */
+            portal_copilot_agent_id?: string;
+        }
         /**
          * ID of the portal
          * example:
@@ -7868,13 +7977,18 @@ declare namespace Components {
              */
             created_by?: string;
             /**
-             * Set at publish time only, and only when the publish request carried one. A revision can have been published and still have no name; `published_at` is the signal that a revision was live at some point, not this field.
+             * Set at publish time when the publish request carries one, or by renaming the revision with `updatePortalRevision`. A revision can have been published and still have no name; `published_at` is the signal that a revision was live at some point, not this field.
              *
              * example:
              * FAQ page launch
              */
             name?: string;
             description?: string;
+            source?: /**
+             * Where a revision came from, when it was not saved in the builder. Not part of the portal config. The builder renders it in the viewer's language for an unnamed revision.
+             *
+             */
+            RevisionSource;
             page_count: number;
             /**
              * The last time this revision was published. NOT the same question as `is_published`: a revision that was live yesterday still carries a `published_at`.
@@ -7943,13 +8057,18 @@ declare namespace Components {
              */
             created_by?: string;
             /**
-             * Set at publish time only, and only when the publish request carried one. A revision can have been published and still have no name; `published_at` is the signal that a revision was live at some point, not this field.
+             * Set at publish time when the publish request carries one, or by renaming the revision with `updatePortalRevision`. A revision can have been published and still have no name; `published_at` is the signal that a revision was live at some point, not this field.
              *
              * example:
              * FAQ page launch
              */
             name?: string;
             description?: string;
+            source?: /**
+             * Where a revision came from, when it was not saved in the builder. Not part of the portal config. The builder renders it in the viewer's language for an unnamed revision.
+             *
+             */
+            RevisionSource;
             page_count: number;
             /**
              * The last time this revision was published. NOT the same question as `is_published`: a revision that was live yesterday still carries a `published_at`.
@@ -8131,35 +8250,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
              */
@@ -8399,6 +8490,13 @@ declare namespace Components {
              * ]
              */
             contract_identifiers?: ContractIdentifier[];
+            /**
+             * What the built-in self-assignment (without a contractIdentification hook) assigns once the `contract_identifiers` match a Contract:
+             *   - `contracts`: the user's Contact is added as a customer of the Contract.
+             *   - `customer_to_portal_user`: the Contract's customers (Contacts and Accounts) are added to the Portal User's `represents`. The Portal User sees all their data, including Contracts, transitively. Mirrors the `contact_to_portal_user` assignment mode of the contractIdentification hook.
+             *
+             */
+            self_assignment_mode?: "contracts" | "customer_to_portal_user";
             /**
              * Configuration for contract selector in the portal
              */
@@ -8611,6 +8709,11 @@ declare namespace Components {
                 [name: string]: Block;
             };
             based_on_revision_id?: string;
+            revision_source?: /**
+             * Where a revision came from, when it was not saved in the builder. Not part of the portal config. The builder renders it in the viewer's language for an unnamed revision.
+             *
+             */
+            RevisionSource;
             pages: /**
              * A page inside a revision snapshot. `additionalProperties` is true on purpose — a page carries fields this schema does not name and they must survive into the snapshot and back onto the live page when it is published.
              *
@@ -8629,13 +8732,18 @@ declare namespace Components {
              */
             created_by?: string;
             /**
-             * Set at publish time only, and only when the publish request carried one. A revision can have been published and still have no name; `published_at` is the signal that a revision was live at some point, not this field.
+             * Set at publish time when the publish request carries one, or by renaming the revision with `updatePortalRevision`. A revision can have been published and still have no name; `published_at` is the signal that a revision was live at some point, not this field.
              *
              * example:
              * FAQ page launch
              */
             name?: string;
             description?: string;
+            source?: /**
+             * Where a revision came from, when it was not saved in the builder. Not part of the portal config. The builder renders it in the viewer's language for an unnamed revision.
+             *
+             */
+            RevisionSource;
             page_count: number;
             /**
              * The last time this revision was published. NOT the same question as `is_published`: a revision that was live yesterday still carries a `published_at`.
@@ -8852,6 +8960,28 @@ declare namespace Components {
             _schema: "portal_user";
         }
         export type PortalUserRegistrationStatus = "Registration Pending" | "Confirmation Email Sent" | "Registered" | "Email Update In Progress";
+        /**
+         * A portal whose design_id is the design asked about.
+         */
+        export interface PortalUsingDesign {
+            portal_id: /**
+             * ID of the portal
+             * example:
+             * 453ad7bf-86d5-46c8-8252-bcc868df5e3c
+             */
+            PortalId;
+            /**
+             * example:
+             * Kundenportal
+             */
+            name?: string;
+            origin?: /* Origin of the portal */ Origin;
+            /**
+             * example:
+             * 9ba94f20-b872-11ed-b30a-b3e3bf2dc8ab
+             */
+            design_id?: string;
+        }
         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
@@ -9822,6 +9952,14 @@ declare namespace Components {
                 [name: string]: any;
             };
         }
+        /**
+         * Where a revision came from, when it was not saved in the builder. Not part of the portal config. The builder renders it in the viewer's language for an unnamed revision.
+         *
+         */
+        export interface RevisionSource {
+            type: "blueprint_sync";
+            blueprint_title?: string;
+        }
         export interface Rule {
             entity?: string | null;
             attribute?: string | null;
@@ -10060,10 +10198,52 @@ declare namespace Components {
              */
             status: string;
         }
+        export interface SwapPortalReferenceGroup {
+            /**
+             * Items whose references now point at the target portal.
+             */
+            updated: SwapPortalReferenceItem[];
+            /**
+             * Items that reference the source portal but could not be updated.
+             */
+            failed: SwapPortalReferenceItem[];
+            /**
+             * Set when the items could not be listed, so none of them were checked.
+             */
+            list_error?: string;
+        }
+        export interface SwapPortalReferenceItem {
+            /**
+             * Journey id or automation flow id.
+             */
+            id: string;
+            name?: string;
+            /**
+             * Where the reference sat in the item.
+             * example:
+             * [
+             *   "steps[0].uischema.elements[2].options.portalId"
+             * ]
+             */
+            paths?: string[];
+            /**
+             * Why the update failed. Only set on failed items.
+             */
+            error?: string;
+        }
+        /**
+         * Outcome of the `portal_references` swap option. Only present when that option was requested. The swap itself has already succeeded when this is returned, so failures here do not undo it.
+         */
+        export interface SwapPortalReferencesResult {
+            journeys: SwapPortalReferenceGroup;
+            automation_flows: SwapPortalReferenceGroup;
+        }
         /**
          * 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.
+         * - `email_templates`: swap the email templates of the two portals.
+         * - `portal_references`: after the swap, re-point configuration in other services from the source portal to the target portal: the portal on journey login (AuthControl) blocks and in file upload portal access, and the portal of automation flow portal triggers. One-directional: references to the target portal are left unchanged, because the target keeps its domain and users. System flows are not changed. Uses the caller's permissions; the outcome is returned in `portal_references`.
          */
-        export type SwappableConfig = "email_templates";
+        export type SwappableConfig = "email_templates" | "portal_references";
         export type TariffType = "ht" | "nt";
         export interface TeaserWidget {
             id: string;
@@ -10204,6 +10384,15 @@ declare namespace Components {
              */
             ProviderConfig[];
         }
+        export interface UpdatePortalRevisionRequest {
+            /**
+             * New label for the revision. Trimmed by the server; an empty name after trimming removes the revision's name.
+             *
+             * example:
+             * FAQ page launch
+             */
+            name: string;
+        }
         export interface UpsertPortalConfig {
             /**
              * Journey actions allowed on an entity by a portal user
@@ -10342,35 +10531,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
              */
@@ -10610,6 +10771,13 @@ declare namespace Components {
              * ]
              */
             contract_identifiers?: ContractIdentifier[];
+            /**
+             * What the built-in self-assignment (without a contractIdentification hook) assigns once the `contract_identifiers` match a Contract:
+             *   - `contracts`: the user's Contact is added as a customer of the Contract.
+             *   - `customer_to_portal_user`: the Contract's customers (Contacts and Accounts) are added to the Portal User's `represents`. The Portal User sees all their data, including Contracts, transitively. Mirrors the `contact_to_portal_user` assignment mode of the contractIdentification hook.
+             *
+             */
+            self_assignment_mode?: "contracts" | "customer_to_portal_user";
             /**
              * Configuration for contract selector in the portal
              */
@@ -10971,35 +11139,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
              */
@@ -11239,6 +11379,13 @@ declare namespace Components {
              * ]
              */
             contract_identifiers?: ContractIdentifier[];
+            /**
+             * What the built-in self-assignment (without a contractIdentification hook) assigns once the `contract_identifiers` match a Contract:
+             *   - `contracts`: the user's Contact is added as a customer of the Contract.
+             *   - `customer_to_portal_user`: the Contract's customers (Contacts and Accounts) are added to the Portal User's `represents`. The Portal User sees all their data, including Contracts, transitively. Mirrors the `contact_to_portal_user` assignment mode of the contractIdentification hook.
+             *
+             */
+            self_assignment_mode?: "contracts" | "customer_to_portal_user";
             /**
              * Configuration for contract selector in the portal
              */
@@ -11920,6 +12067,48 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
+    namespace CompleteTemporaryPassword {
+        export interface RequestBody {
+            /**
+             * Organization ID
+             * example:
+             * 123
+             */
+            org_id: string;
+            /**
+             * ID of the portal the user belongs to
+             * example:
+             * 7hj28akg-97fb-4f5c-b2a1-3e4fbc1d8c7a
+             */
+            portal_id: string;
+            /**
+             * Email address of the portal user
+             * example:
+             * user@example.com
+             */
+            email: string;
+            /**
+             * Temporary password from the email
+             */
+            temporary_password: string;
+            /**
+             * New password, must match the portal's password policy
+             */
+            new_password: string;
+        }
+        namespace Responses {
+            export interface $200 {
+                /**
+                 * example:
+                 * Password set successfully.
+                 */
+                message?: string;
+            }
+            export type $400 = Components.Responses.InvalidRequest;
+            export type $429 = Components.Responses.TooManyRequests;
+            export type $500 = Components.Responses.InternalServerError;
+        }
+    }
     namespace ConfigureDistribution {
         namespace Parameters {
             export type Origin = /* Origin of the portal */ Components.Schemas.Origin;
@@ -15013,35 +15202,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
                  */
@@ -15281,6 +15442,13 @@ declare namespace Paths {
                  * ]
                  */
                 contract_identifiers?: Components.Schemas.ContractIdentifier[];
+                /**
+                 * What the built-in self-assignment (without a contractIdentification hook) assigns once the `contract_identifiers` match a Contract:
+                 *   - `contracts`: the user's Contact is added as a customer of the Contract.
+                 *   - `customer_to_portal_user`: the Contract's customers (Contacts and Accounts) are added to the Portal User's `represents`. The Portal User sees all their data, including Contracts, transitively. Mirrors the `contact_to_portal_user` assignment mode of the contractIdentification hook.
+                 *
+                 */
+                self_assignment_mode?: "contracts" | "customer_to_portal_user";
                 /**
                  * Configuration for contract selector in the portal
                  */
@@ -15672,35 +15840,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
                  */
@@ -15940,6 +16080,13 @@ declare namespace Paths {
                  * ]
                  */
                 contract_identifiers?: Components.Schemas.ContractIdentifier[];
+                /**
+                 * What the built-in self-assignment (without a contractIdentification hook) assigns once the `contract_identifiers` match a Contract:
+                 *   - `contracts`: the user's Contact is added as a customer of the Contract.
+                 *   - `customer_to_portal_user`: the Contract's customers (Contacts and Accounts) are added to the Portal User's `represents`. The Portal User sees all their data, including Contracts, transitively. Mirrors the `contact_to_portal_user` assignment mode of the contractIdentification hook.
+                 *
+                 */
+                self_assignment_mode?: "contracts" | "customer_to_portal_user";
                 /**
                  * Configuration for contract selector in the portal
                  */
@@ -16885,35 +17032,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
                  */
@@ -17153,6 +17272,13 @@ declare namespace Paths {
                  * ]
                  */
                 contract_identifiers?: Components.Schemas.ContractIdentifier[];
+                /**
+                 * What the built-in self-assignment (without a contractIdentification hook) assigns once the `contract_identifiers` match a Contract:
+                 *   - `contracts`: the user's Contact is added as a customer of the Contract.
+                 *   - `customer_to_portal_user`: the Contract's customers (Contacts and Accounts) are added to the Portal User's `represents`. The Portal User sees all their data, including Contracts, transitively. Mirrors the `contact_to_portal_user` assignment mode of the contractIdentification hook.
+                 *
+                 */
+                self_assignment_mode?: "contracts" | "customer_to_portal_user";
                 /**
                  * Configuration for contract selector in the portal
                  */
@@ -18269,6 +18395,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;
@@ -19152,9 +19295,18 @@ declare namespace Paths {
              */
             Components.Schemas.PortalId;
             /**
-             * 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.
+             * 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. With `mode` the listed items are included in the draft revisions.
+             */
+            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.
+             * - `email_templates`: swap the email templates of the two portals.
+             * - `portal_references`: after the swap, re-point configuration in other services from the source portal to the target portal: the portal on journey login (AuthControl) blocks and in file upload portal access, and the portal of automation flow portal triggers. One-directional: references to the target portal are left unchanged, because the target keeps its domain and users. System flows are not changed. Uses the caller's permissions; the outcome is returned in `portal_references`.
+             */
+            Components.Schemas.SwappableConfig[];
+            /**
+             * Requires portal versioning (flag on, V3 target portal), otherwise 400. `copy` saves an unpublished revision on the target holding the source's setup; neither portal changes live and the source is untouched. Omit for the original live swap. Cannot be combined with the `portal_references` item, which only applies to a live swap.
              */
-            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[];
+            mode?: "copy";
         }
         namespace Responses {
             export interface $200 {
@@ -19163,6 +19315,19 @@ declare namespace Paths {
                  * Domain and users swapped successfully.
                  */
                 message?: string;
+                portal_references?: /* Outcome of the `portal_references` swap option. Only present when that option was requested. The swap itself has already succeeded when this is returned, so failures here do not undo it. */ Components.Schemas.SwapPortalReferencesResult;
+                /**
+                 * Only with `mode`. The draft revision created on the target.
+                 */
+                revisions?: {
+                    portal_id?: /**
+                     * ID of the portal
+                     * example:
+                     * 453ad7bf-86d5-46c8-8252-bcc868df5e3c
+                     */
+                    Components.Schemas.PortalId;
+                    revision_id?: string;
+                }[];
             }
             export type $400 = Components.Responses.InvalidRequest;
             export type $401 = Components.Responses.Unauthorized;
@@ -19465,6 +19630,41 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
+    namespace UpdatePortalRevision {
+        namespace Parameters {
+            /**
+             * example:
+             * 5da0a718-c822-403d-9f5d-20d4584e0528
+             */
+            export type PortalId = string; // uuid
+            /**
+             * example:
+             * 2026-08-25T14:03:11.482Z-a7f3c1d9
+             */
+            export type RevisionId = string;
+        }
+        export interface PathParameters {
+            portal_id: /**
+             * example:
+             * 5da0a718-c822-403d-9f5d-20d4584e0528
+             */
+            Parameters.PortalId /* uuid */;
+            revision_id: /**
+             * example:
+             * 2026-08-25T14:03:11.482Z-a7f3c1d9
+             */
+            Parameters.RevisionId;
+        }
+        export type RequestBody = Components.Schemas.UpdatePortalRevisionRequest;
+        namespace Responses {
+            export type $200 = Components.Schemas.PortalRevisionSummary;
+            export type $400 = Components.Responses.InvalidRequest;
+            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 UpdatePortalUser {
         export type RequestBody = Components.Schemas.Entity;
         namespace Responses {
@@ -21585,6 +21785,16 @@ export interface OperationMethods {
     data?: any,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetUserEntryPoint.Responses.$200>
+  /**
+   * completeTemporaryPassword - completeTemporaryPassword
+   * 
+   * Replaces a portal user's temporary password with the password they chose.
+   */
+  'completeTemporaryPassword'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: Paths.CompleteTemporaryPassword.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.CompleteTemporaryPassword.Responses.$200>
   /**
    * updateCampaignPortalBlockStatus - updateCampaignPortalBlockStatus
    * 
@@ -21751,6 +21961,19 @@ export interface OperationMethods {
     data?: any,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetPortalRevision.Responses.$200>
+  /**
+   * updatePortalRevision - updatePortalRevision
+   * 
+   * Renames a revision without publishing it. Any revision can be renamed, published or not. Only the revision's `name` changes: its content, `published_at`, `published_by` and which revision is live stay as they are.
+   * 
+   * The server trims `name`. An empty name after trimming removes the revision's name, and clients fall back to a label derived from `published_at` / `created_at`. A later publish without a `name` keeps the renamed name.
+   * 
+   */
+  'updatePortalRevision'(
+    parameters?: Parameters<Paths.UpdatePortalRevision.PathParameters> | null,
+    data?: Paths.UpdatePortalRevision.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.UpdatePortalRevision.Responses.$200>
   /**
    * publishPortalRevision - publishPortalRevision
    * 
@@ -21778,10 +22001,26 @@ export 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
    * 
-   * Swaps the portal configuration of two portals.
+   * Swaps the portal configuration of two portals. Without `mode` both portals exchange pages and experience config live, as before. With `mode: copy` (portal versioning only) nothing live changes: the source's setup is saved as an unpublished revision on the target to review and publish. Domain and access/security settings never move.
    */
   'swapPortalConfig'(
     parameters?: Parameters<UnknownParamsObject> | null,
@@ -23746,6 +23985,18 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GetUserEntryPoint.Responses.$200>
   }
+  ['/v3/portal/public/user/temporary-password/complete']: {
+    /**
+     * completeTemporaryPassword - completeTemporaryPassword
+     * 
+     * Replaces a portal user's temporary password with the password they chose.
+     */
+    'post'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: Paths.CompleteTemporaryPassword.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.CompleteTemporaryPassword.Responses.$200>
+  }
   ['/v2/portal/campaign/{campaign_id}/entity:status']: {
     /**
      * updateCampaignPortalBlockStatus - updateCampaignPortalBlockStatus
@@ -23935,6 +24186,19 @@ export interface PathsDictionary {
       data?: any,
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GetPortalRevision.Responses.$200>
+    /**
+     * updatePortalRevision - updatePortalRevision
+     * 
+     * Renames a revision without publishing it. Any revision can be renamed, published or not. Only the revision's `name` changes: its content, `published_at`, `published_by` and which revision is live stay as they are.
+     * 
+     * The server trims `name`. An empty name after trimming removes the revision's name, and clients fall back to a label derived from `published_at` / `created_at`. A later publish without a `name` keeps the renamed name.
+     * 
+     */
+    'patch'(
+      parameters?: Parameters<Paths.UpdatePortalRevision.PathParameters> | null,
+      data?: Paths.UpdatePortalRevision.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.UpdatePortalRevision.Responses.$200>
   }
   ['/v3/portal/config/{portal_id}/publish']: {
     /**
@@ -23967,11 +24231,29 @@ export 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
      * 
-     * Swaps the portal configuration of two portals.
+     * Swaps the portal configuration of two portals. Without `mode` both portals exchange pages and experience config live, as before. With `mode: copy` (portal versioning only) nothing live changes: the source's setup is saved as an unpublished revision on the target to review and publish. Domain and access/security settings never move.
      */
     'post'(
       parameters?: Parameters<UnknownParamsObject> | null,
@@ -24240,9 +24522,11 @@ export type Page = Components.Schemas.Page;
 export type PageRequest = Components.Schemas.PageRequest;
 export type PaymentWidget = Components.Schemas.PaymentWidget;
 export type PortalConfig = Components.Schemas.PortalConfig;
+export type PortalConfigSummaryV3 = Components.Schemas.PortalConfigSummaryV3;
 export type PortalConfigV3 = Components.Schemas.PortalConfigV3;
 export type PortalDataExportColumn = Components.Schemas.PortalDataExportColumn;
 export type PortalDescriptionOverrides = Components.Schemas.PortalDescriptionOverrides;
+export type PortalFeatureSettings = Components.Schemas.PortalFeatureSettings;
 export type PortalId = Components.Schemas.PortalId;
 export type PortalNameOverrides = Components.Schemas.PortalNameOverrides;
 export type PortalNotification = Components.Schemas.PortalNotification;
@@ -24257,6 +24541,7 @@ export type PortalSurfaceEntityAccess = Components.Schemas.PortalSurfaceEntityAc
 export type PortalTaskConfig = Components.Schemas.PortalTaskConfig;
 export type PortalUser = Components.Schemas.PortalUser;
 export type PortalUserRegistrationStatus = Components.Schemas.PortalUserRegistrationStatus;
+export type PortalUsingDesign = Components.Schemas.PortalUsingDesign;
 export type PortalWidget = Components.Schemas.PortalWidget;
 export type PortalWorkflow = Components.Schemas.PortalWorkflow;
 export type PortalWorkflowStage = Components.Schemas.PortalWorkflowStage;
@@ -24288,6 +24573,7 @@ export type RegistrationIdentifier = Components.Schemas.RegistrationIdentifier;
 export type ReimbursementEvent = Components.Schemas.ReimbursementEvent;
 export type RevisionPage = Components.Schemas.RevisionPage;
 export type RevisionPageRequest = Components.Schemas.RevisionPageRequest;
+export type RevisionSource = Components.Schemas.RevisionSource;
 export type Rule = Components.Schemas.Rule;
 export type SAMLProviderConfig = Components.Schemas.SAMLProviderConfig;
 export type SSOCallbackRequest = Components.Schemas.SSOCallbackRequest;
@@ -24302,12 +24588,16 @@ export type Source = Components.Schemas.Source;
 export type SupportReportType = Components.Schemas.SupportReportType;
 export type SupportRequestAttachment = Components.Schemas.SupportRequestAttachment;
 export type SupportRequestResult = Components.Schemas.SupportRequestResult;
+export type SwapPortalReferenceGroup = Components.Schemas.SwapPortalReferenceGroup;
+export type SwapPortalReferenceItem = Components.Schemas.SwapPortalReferenceItem;
+export type SwapPortalReferencesResult = Components.Schemas.SwapPortalReferencesResult;
 export type SwappableConfig = Components.Schemas.SwappableConfig;
 export type TariffType = Components.Schemas.TariffType;
 export type TeaserWidget = Components.Schemas.TeaserWidget;
 export type TemplatesRef = Components.Schemas.TemplatesRef;
 export type TriggerPortalFlow = Components.Schemas.TriggerPortalFlow;
 export type UpdateOnlyPortalConfigAttributes = Components.Schemas.UpdateOnlyPortalConfigAttributes;
+export type UpdatePortalRevisionRequest = Components.Schemas.UpdatePortalRevisionRequest;
 export type UpsertPortalConfig = Components.Schemas.UpsertPortalConfig;
 export type UpsertPortalConfigV3 = Components.Schemas.UpsertPortalConfigV3;
 export type UpsertPortalWidget = Components.Schemas.UpsertPortalWidget;