@fusebase/fusebase-gate-sdk 2.5.1-sdk.3 → 2.6.1

package/dist/types/portals/portals.d.ts

@@ -54,6 +54,48 @@ export interface CreatePortalFolderRequestContract {
     name: string;
     /** Optional icon key for the folder (default: "folder"). */
     icon?: string;
+    /**
+     * Menu bar to place the folder in: "sidebar" (default), "top" (topbar), or
+     * "footer".
+     */
+    positionType?: PortalContentPositionType;
+}
+export interface CreatePortalLinkRequestContract {
+    /**
+     * Display name of the link menu item.
+     * @maxLength 100
+     */
+    name: string;
+    /** Absolute http(s) URL the link opens (e.g. "https://example.com/contact"). */
+    url: string;
+    /**
+     * Menu bar to place the link in: "sidebar" (default), "top" (topbar), or
+     * "footer". Use "top" for a topbar nav (e.g. Chat / Case Studies / Contact).
+     * Ignored when `parentId` is set (the link inherits the parent's bar).
+     */
+    positionType?: PortalContentPositionType;
+    /** Optional icon key for the link (default: "custom_link"). */
+    icon?: string;
+    /** Whether the link opens in a new tab (default: true). */
+    openInNewTab?: boolean;
+    /**
+     * Optional id of an existing folder menu item to nest the link under.
+     * When omitted the link is added at the root of its menu bar.
+     */
+    parentId?: string;
+}
+export interface CreatePortalLinkResponseContract {
+    /** Id of the created link menu item. */
+    menuItemId: string;
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence numbers assigned to the staged change events (addMenuItem). */
+    seqs: number[];
+    /**
+     * Always true: the link is staged in the portal's customizer draft, not yet
+     * live. The portal owner reviews and publishes it from the customizer.
+     */
+    staged: boolean;
 }
 export interface CreatePortalFolderResponseContract {
     /** Id of the created folder (the portalSection menu item). */
@@ -96,6 +138,11 @@ export interface CreatePortalPageRequestContract {
      * created at the portal root.
      */
     parentId?: string;
+    /**
+     * Menu bar to place the page in: "sidebar" (default), "top" (topbar), or
+     * "footer". Ignored when `parentId` is set (the page inherits the parent's bar).
+     */
+    positionType?: PortalContentPositionType;
 }
 export interface CreatePortalPageResponseContract {
     /** Id of the created sidebar menu item. */
@@ -114,6 +161,94 @@ export interface CreatePortalPageResponseContract {
      */
     staged: boolean;
 }
+export interface AddPortalFilesDashboardMenuItemRequestContract {
+    /**
+     * Visible name of the navigation item, also used as the dashboard block title
+     * when the dashboard page is created. Plain text. Default: `Files`.
+     * @minLength 1
+     * @maxLength 100
+     */
+    title?: string;
+    /** Which bar the root item goes to. Default: `sidebar`. */
+    positionType?: PortalContentPositionType;
+}
+export interface AddPortalFilesDashboardMenuItemResponseContract {
+    /** Id of the created navigation item. */
+    menuItemId: string;
+    /** Id of the system Files dashboard page (fixed path `/files-dashboard`). */
+    pageId: string;
+    /** Id of the dashboard block. Absent when the page already existed. */
+    blockId?: string;
+    /** Portal route the item points at: always `/files-dashboard`. */
+    url: string;
+    /** True when this call also created the dashboard page and its block. */
+    pageCreated: boolean;
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence numbers of the staged events. */
+    seqs: number[];
+    /** Always true: the change is staged in the draft, not live. */
+    staged: boolean;
+}
+export interface AddPortalChatsDashboardMenuItemRequestContract {
+    /**
+     * Visible name of the Chat dashboard navigation item. Plain text.
+     * Default: `Chat Dashboard`.
+     * @minLength 1
+     * @maxLength 100
+     */
+    title?: string;
+    /**
+     * Menu bar to place the dashboard's root item in: "sidebar" (default),
+     * "top" (topbar), or "footer".
+     */
+    positionType?: PortalContentPositionType;
+}
+export interface AddPortalChatsDashboardMenuItemResponseContract {
+    /** Id of the created root menu item. */
+    menuItemId: string;
+    /** Id of the portal's system Chat dashboard page the item points at. */
+    pageId: string;
+    /** URL path of the dashboard — always `/chats-dashboard`. */
+    url: string;
+    /** Menu bar the root item was placed in. */
+    positionType: PortalContentPositionType;
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence number of the staged addMenuItem event. */
+    seqs: number[];
+    /** Always true: the item is staged in the draft, not live. */
+    staged: boolean;
+}
+export interface AddPortalTasksDashboardMenuItemRequestContract {
+    /**
+     * Visible name of the navigation item, also used as the dashboard block title
+     * when the dashboard page is created. Plain text. Default: `Task Dashboard`.
+     * @minLength 1
+     * @maxLength 100
+     */
+    title?: string;
+    /** Which bar the root item goes to. Default: `sidebar`. */
+    positionType?: PortalContentPositionType;
+}
+export interface AddPortalTasksDashboardMenuItemResponseContract {
+    /** Id of the created navigation item. */
+    menuItemId: string;
+    /** Id of the system Tasks dashboard page (fixed path `/tasks-dashboard`). */
+    pageId: string;
+    /** Id of the dashboard block. Absent when the page already existed. */
+    blockId?: string;
+    /** Portal route the item points at: always `/tasks-dashboard`. */
+    url: string;
+    /** True when this call also created the dashboard page and its block. */
+    pageCreated: boolean;
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence numbers of the staged events. */
+    seqs: number[];
+    /** Always true: the change is staged in the draft, not live. */
+    staged: boolean;
+}
 export interface CreatePortalPageWithNoteRequestContract {
     /**
      * Title for the new page (also used as the backing Fusebase note title).
@@ -131,6 +266,11 @@ export interface CreatePortalPageWithNoteRequestContract {
     content?: string;
     /** Content format used with `content`. Defaults to `text`. */
     format?: WorkspaceNoteContentFormatContract;
+    /**
+     * Menu bar to place the page in: "sidebar" (default), "top" (topbar), or
+     * "footer". Ignored when `parentId` is set (the page inherits the parent's bar).
+     */
+    positionType?: PortalContentPositionType;
 }
 export interface CreatePortalPageWithNoteResponseContract {
     /** Global id of the created Fusebase note backing the page. */
@@ -151,6 +291,59 @@ export interface CreatePortalPageWithNoteResponseContract {
      */
     staged: boolean;
 }
+export interface AddPortalInternalSpacePageRequestContract {
+    /**
+     * Global id of the existing Internal Space page (Fusebase note) to add.
+     * Exactly one of `noteId` or `noteUrl` is required.
+     */
+    noteId?: string;
+    /**
+     * Internal Space page URL as copied from the browser, e.g.
+     * `https://acme.nimbusweb.me/space/<workspaceId>/page/<noteId>`. Exactly one
+     * of `noteId` or `noteUrl` is required.
+     */
+    noteUrl?: string;
+    /**
+     * Title for the portal page and its menu item. Defaults to the note's own
+     * title. The content block's own header always shows the note's title —
+     * publishing backfills it from the note's share.
+     * @maxLength 100
+     */
+    title?: string;
+    /**
+     * Optional id of an existing menu item (e.g. a folder) to nest the page under
+     * in the sidebar. When omitted the page is created at the portal root.
+     */
+    parentId?: string;
+    /** Optional icon key for the menu item (default: "page"). */
+    icon?: string;
+    /**
+     * Menu bar to place the page in: "sidebar" (default), "top" (topbar), or
+     * "footer". Ignored when `parentId` is set (the page inherits the parent's bar).
+     */
+    positionType?: PortalContentPositionType;
+}
+export interface AddPortalInternalSpacePageResponseContract {
+    /** Global id of the Internal Space note the page renders. */
+    noteId: string;
+    /** Id of the created note menu item (the sidebar entry). */
+    menuItemId: string;
+    /** Id of the created portal page node. */
+    pageId: string;
+    /** Id of the created content block. */
+    blockId: string;
+    /** URL path assigned to the page (e.g. "/onboarding"). */
+    url: string;
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence numbers assigned to the staged change events (addPage, addMenuItem, addBlock). */
+    seqs: number[];
+    /**
+     * Always true: the page is staged in the portal's customizer draft, not yet
+     * live. The portal owner reviews and publishes it from the customizer.
+     */
+    staged: boolean;
+}
 export interface AddPortalNoteBlockRequestContract {
     /** Id of the existing portal page node to add the note block to. */
     pageId: string;
@@ -339,6 +532,22 @@ export type PortalDatabaseBlockAppearanceContract = {
     /** Default: true. */
     showTitle?: boolean;
 };
+/**
+ * Same Appearance section, with `background` optional. getPortalBlock reports no
+ * background for a block that keeps a portal theme role (the Customizer's own
+ * outcome right after picking "Custom"), so re-sending what it reported must be
+ * accepted and must keep the stored background.
+ */
+export type PortalDatabaseBlockAppearancePatchContract = {
+    backdrop: "none" | "blank";
+} | {
+    backdrop: "custom";
+    background?: PortalBackgroundContract;
+    /** Default: `m`. */
+    padding?: "none" | "s" | "m" | "l";
+    /** Default: true. */
+    showTitle?: boolean;
+};
 /** Customizer Layout section of the Task list block. */
 export interface PortalTaskListBlockLayoutContract {
     /** Customizer Width. Default: 6. */
@@ -426,6 +635,22 @@ export type PortalFlexibleTextAppearanceContract = {
     /** Default: false. */
     showTitle?: boolean;
 };
+/**
+ * Appearance as `getPortalBlock` reports it and the update operations accept
+ * it. `background` is absent when the block keeps the portal theme's surface
+ * colour — what the Customizer stores after picking "Custom" without a colour —
+ * and sending it back without one keeps whatever background the block has.
+ */
+export type PortalFlexibleTextAppearancePatchContract = {
+    backdrop: "none" | "blank";
+} | {
+    backdrop: "custom";
+    background?: PortalTextBackgroundContract;
+    /** Default: `s`. */
+    padding?: "none" | "s" | "m" | "l";
+    /** Default: false. */
+    showTitle?: boolean;
+};
 /** Customizer Layout section shared by the three Text & Media operations. */
 export interface PortalTextAndMediaLayoutContract {
     /** Customizer Width. Default: 6. */
@@ -471,6 +696,21 @@ export interface AddPortalImageBlockRequestContract {
     /** Default: width 6 columns and automatic height. */
     layout?: PortalTextAndMediaLayoutContract;
 }
+/**
+ * Partial update of a Heading or Simple text block. Every field is optional and
+ * an omitted one keeps its current value; at least one must be sent.
+ * `content` is a field-level patch — `appearance` is not, and must be a
+ * complete variant when sent.
+ */
+export interface UpdatePortalTextBlockRequestContract {
+    content?: PortalTextContentContract;
+    appearance?: PortalFlexibleTextAppearancePatchContract;
+    layout?: PortalTextAndMediaLayoutContract;
+}
+/** The Image block's picture is the Customizer's built-in one, so only Layout is editable. */
+export interface UpdatePortalImageBlockRequestContract {
+    layout?: PortalTextAndMediaLayoutContract;
+}
 export interface PortalTextAndMediaBlockResponseContract {
     /** Id of the created block. */
     blockId: string;
@@ -521,6 +761,21 @@ export type PortalCardAppearanceContract = {
     /** Default: false. */
     showTitle?: boolean;
 };
+/**
+ * Same Appearance section, with `background` optional. getPortalBlock reports no
+ * background for a Card that keeps a portal theme role, so re-sending what it
+ * reported must be accepted and must keep the stored background.
+ */
+export type PortalCardAppearancePatchContract = {
+    backdrop: "none" | "blank";
+} | {
+    backdrop: "custom";
+    background?: PortalCardBackgroundContract;
+    /** Default: `s`. */
+    padding?: "none" | "s" | "m" | "l";
+    /** Default: false. */
+    showTitle?: boolean;
+};
 /** Customizer Layout section of a Card. */
 export interface PortalCardLayoutContract {
     /** Customizer Width. Default: 3. */
@@ -693,6 +948,15 @@ export interface PortalCarouselContentContract {
      */
     items?: PortalCarouselItemContract[];
 }
+/** Carousel content accepted by update: items is always the full desired list. */
+export interface PortalCarouselUpdateContentContract {
+    /**
+     * Full desired slide list in visual order.
+     * @minItems 1
+     * @maxItems 6
+     */
+    items: PortalCarouselItemContract[];
+}
 export interface AddPortalCarouselBlockRequestContract {
     content?: PortalCarouselContentContract;
     /** Default: width 6 columns and automatic height. */
@@ -724,6 +988,17 @@ export type PortalCountdownAppearanceContract = {
     /** Default: true. */
     showTitle?: boolean;
 };
+/** Countdown Appearance accepted by update; a stored portal-theme background may be omitted. */
+export type PortalCountdownAppearancePatchContract = {
+    backdrop: "none" | "blank";
+} | {
+    backdrop: "custom";
+    background?: PortalCardBackgroundContract;
+    /** Default: `s`. */
+    padding?: "none" | "s" | "m" | "l";
+    /** Default: true. */
+    showTitle?: boolean;
+};
 /** Customizer Layout section of a Countdown. */
 export interface PortalCountdownLayoutContract {
     /** Customizer Width. Default: 6. */
@@ -746,6 +1021,15 @@ export interface PortalCountdownContentContract {
      */
     targetAt?: string;
 }
+/** Countdown content accepted by update; the target is required when content is sent. */
+export interface PortalCountdownUpdateContentContract {
+    /**
+     * Absolute RFC 3339 date-time with `Z` or an explicit UTC offset.
+     * It must not be in the past or more than 99 days from the update.
+     * @format date-time
+     */
+    targetAt: string;
+}
 export interface AddPortalCountdownBlockRequestContract {
     /**
      * Block title shown above the countdown. Plain text; only `{{ClientName}}`
@@ -772,6 +1056,196 @@ export interface AddPortalCountdownBlockResponseContract {
     /** Always true: the block is staged in the customizer draft, not yet live. */
     staged: boolean;
 }
+export interface PortalBpmnDiagramContentContract {
+    /**
+     * Height in pixels of the BPMN canvas INSIDE the block — the Customizer's
+     * "Diagram height" field. This is not the block's Layout height.
+     * Default: 500.
+     * @minimum 150
+     * @maximum 5000
+     */
+    diagramHeight?: number;
+}
+/** BPMN content accepted by update; the canvas height is required when content is sent. */
+export interface PortalBpmnDiagramUpdateContentContract {
+    /**
+     * BPMN canvas height inside the block, separate from layout.height.
+     * @minimum 150
+     * @maximum 5000
+     */
+    diagramHeight: number;
+}
+/**
+ * Customizer Appearance section of a BPMN Diagram. Omitting `appearance` keeps
+ * the factory `blank` wrapper with the block title shown.
+ */
+export type PortalBpmnDiagramAppearanceContract = {
+    backdrop: "none" | "blank";
+} | {
+    backdrop: "custom";
+    background: PortalCardBackgroundContract;
+    /** Default: `s`. */
+    padding?: "none" | "s" | "m" | "l";
+    /** Default: true. */
+    showTitle?: boolean;
+};
+/** BPMN Appearance accepted by update; a stored portal-theme background may be omitted. */
+export type PortalBpmnDiagramAppearancePatchContract = {
+    backdrop: "none" | "blank";
+} | {
+    backdrop: "custom";
+    background?: PortalCardBackgroundContract;
+    /** Default: `s`. */
+    padding?: "none" | "s" | "m" | "l";
+    /** Default: true. */
+    showTitle?: boolean;
+};
+/** Customizer Layout section of a BPMN Diagram. */
+export interface PortalBpmnDiagramLayoutContract {
+    /** Customizer Width. Default: 6. */
+    colspan?: 2 | 3 | 4 | 5 | 6;
+    /**
+     * Customizer Height: null = Auto; a manual value is at least 50px. Default: null.
+     * @minimum 50
+     */
+    height?: number | null;
+}
+export interface AddPortalBpmnDiagramBlockRequestContract {
+    /**
+     * Block title shown above the diagram. Plain text; only `{{ClientName}}` and
+     * `{{ClientLastName}}` are variables. Default: `BPMN Diagram`.
+     * @minLength 1
+     * @maxLength 100
+     */
+    title?: string;
+    content?: PortalBpmnDiagramContentContract;
+    /** Omitted keeps the canonical blank backdrop with the title shown. */
+    appearance?: PortalBpmnDiagramAppearanceContract;
+    /** Default: width 6 columns and automatic height. */
+    layout?: PortalBpmnDiagramLayoutContract;
+}
+export interface AddPortalBpmnDiagramBlockResponseContract {
+    /** Id of the created block. */
+    blockId: string;
+    /** Id of the page the block was added to. */
+    pageId: string;
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence numbers assigned to the staged change events (addBlock). */
+    seqs: number[];
+    /** Always true: the block is staged in the customizer draft, not yet live. */
+    staged: boolean;
+}
+/**
+ * Customizer Appearance section of a Dynamic Table. Omitting `appearance` keeps
+ * the factory `blank` wrapper with the block title shown.
+ */
+export type PortalDynamicTableAppearanceContract = {
+    backdrop: "none" | "blank";
+} | {
+    backdrop: "custom";
+    background: PortalCardBackgroundContract;
+    /** Default: `s`. */
+    padding?: "none" | "s" | "m" | "l";
+    /** Default: true. */
+    showTitle?: boolean;
+};
+/** Dynamic Table Appearance accepted by update; a stored theme background may be omitted. */
+export type PortalDynamicTableAppearancePatchContract = {
+    backdrop: "none" | "blank";
+} | {
+    backdrop: "custom";
+    background?: PortalCardBackgroundContract;
+    /** Default: `s`. */
+    padding?: "none" | "s" | "m" | "l";
+    /** Default: true. */
+    showTitle?: boolean;
+};
+/** Customizer Layout section of a Dynamic Table. */
+export interface PortalDynamicTableLayoutContract {
+    /** Customizer Width. Default: 6. */
+    colspan?: 2 | 3 | 4 | 5 | 6;
+    /**
+     * Customizer Height: null = Auto; a manual value is at least 50px. Default: null.
+     * @minimum 50
+     */
+    height?: number | null;
+}
+export interface AddPortalDynamicTableBlockRequestContract {
+    /**
+     * Block title shown above the table. Plain text; only `{{ClientName}}` and
+     * `{{ClientLastName}}` are variables. Default: `Dynamic Table`.
+     * @minLength 1
+     * @maxLength 100
+     */
+    title?: string;
+    /** Omitted keeps the canonical blank backdrop with the title shown. */
+    appearance?: PortalDynamicTableAppearanceContract;
+    /** Default: width 6 columns and automatic height. */
+    layout?: PortalDynamicTableLayoutContract;
+}
+export interface AddPortalDynamicTableBlockResponseContract {
+    /** Id of the created block. */
+    blockId: string;
+    /** Id of the page the block was added to. */
+    pageId: string;
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence numbers assigned to the staged change events (addBlock). */
+    seqs: number[];
+    /** Always true: the block is staged in the customizer draft, not yet live. */
+    staged: boolean;
+    /**
+     * Always false: the block is the unconfigured shell the Customizer creates
+     * before a Data source is picked. The OAuth connection, provider source and
+     * table fields are still chosen in Portal Customizer.
+     */
+    configured: boolean;
+}
+/**
+ * Data scope of a Recent files block: the whole portal, or exactly one of its
+ * pages. `pageId` belongs to `portalPage` only.
+ */
+export type PortalRecentFilesSourceContract = {
+    type: "entirePortal";
+} | {
+    type: "portalPage";
+    pageId: string;
+};
+/** Customizer Layout section of a Recent files block. */
+export interface PortalRecentFilesLayoutContract {
+    /** Customizer Width. Default: 3. */
+    colspan?: 3 | 4 | 5 | 6;
+    /**
+     * Customizer Height: null = Auto; a manual value is at least 50px. Default: null.
+     * @minimum 50
+     */
+    height?: number | null;
+}
+export interface AddPortalRecentFilesBlockRequestContract {
+    /**
+     * Block title shown above the file list. Plain text. Default: `Recent files`.
+     * @minLength 1
+     * @maxLength 100
+     */
+    title?: string;
+    /** Default: the entire portal. */
+    source?: PortalRecentFilesSourceContract;
+    /** Default: width 3 columns and automatic height. */
+    layout?: PortalRecentFilesLayoutContract;
+}
+export interface AddPortalRecentFilesBlockResponseContract {
+    /** Id of the created block. */
+    blockId: string;
+    /** Id of the page the block was added to. */
+    pageId: string;
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence numbers assigned to the staged change events (addBlock). */
+    seqs: number[];
+    /** Always true: the block is staged in the customizer draft, not yet live. */
+    staged: boolean;
+}
 /** One block a Linked block may point at. */
 export interface PortalLinkableBlockContract {
     /** Exact id to send as `source.blockId`. Never invent one. */
@@ -788,6 +1262,407 @@ export interface PortalLinkableBlockContract {
      */
     draftOnly: boolean;
 }
+/** One block of a portal page, as returned by listPortalPageBlocks. */
+export interface PortalPageBlockContract {
+    /** Exact block id. Pass this to a move, delete or update operation. */
+    blockId: string;
+    /** Canonical portal block type (e.g. `flexible`). */
+    type: string;
+    /** Flexible template behind the block (e.g. `info-card`); null for other types. */
+    templateType: string | null;
+    /** Block title as shown in the customizer. */
+    title: string;
+    /**
+     * Typed updatePortal*Block operation that edits this block, or null when its
+     * kind has no typed update operation yet.
+     */
+    editOperation: string | null;
+    /**
+     * Page area holding the block (e.g. `page_header`, `page_body`). A move anchor
+     * must be in the same area.
+     */
+    place: string;
+    /** The block exists only in this portal's customizer draft. */
+    draftOnly: boolean;
+}
+export interface ListPortalPageBlocksResponseContract {
+    /** Every block of the page in display order: page area first, then position. */
+    blocks: PortalPageBlockContract[];
+}
+/**
+ * A block's public settings, discriminated by `kind`. One member per block
+ * family, added as that family's typed update operation lands.
+ */
+export interface PortalNoteBlockSettingsContract {
+    kind: "note";
+    /** Fusebase note behind the block. Identity — it cannot be changed. */
+    noteId: string;
+    /** Workspace holding the note. Identity — it cannot be changed. */
+    workspaceId: string;
+}
+/**
+ * Current Text & Media settings. `content` is what a partial content patch is
+ * merged over, and `appearance` is the complete variant to re-send when only
+ * one of its fields should change.
+ */
+export interface PortalTextBlockSettingsContract {
+    kind: "heading" | "text";
+    content: PortalTextContentContract;
+    appearance: PortalFlexibleTextAppearancePatchContract;
+}
+/** The Image block has no settings of its own — only the shared `layout`. */
+export interface PortalImageBlockSettingsContract {
+    kind: "image";
+}
+/**
+ * Current Embed settings. The source is `embedType` plus exactly one of `url`
+ * (named variants) or `content` (`custom`), which is the complete variant to
+ * re-send when changing it.
+ */
+export interface PortalEmbedBlockSettingsContract {
+    kind: "embed";
+    /** Customizer Embed variant. A legacy block may report `unknown`, which no update accepts. */
+    embedType: string;
+    /** The embedded URL, exactly as stored. Absent for `custom`. */
+    url?: string;
+    /** The caller's own embed code. Absent for named variants. */
+    content?: string;
+    /** Whether the "open in new tab" link is shown on the block. */
+    showEmbedLink: boolean;
+}
+/**
+ * Current Database settings. `databaseId` is absent on purpose: the Customizer
+ * never stores it — it only proves at pick time that the dashboard belongs to
+ * that database — so a `target` change takes its ids from
+ * listPortalDatabaseBlockSources, not from this read.
+ */
+export interface PortalDatabaseBlockSettingsContract {
+    kind: "database";
+    /** Dashboard (Customizer label: Table) the block renders. */
+    dashboardId: string;
+    /** View of that dashboard. */
+    viewId: string;
+    /** Rows shown per page. */
+    itemsPerPage: number;
+    /** The complete variant to re-send when only one of its fields should change. */
+    appearance: PortalDatabaseBlockAppearancePatchContract;
+}
+/**
+ * Current Card settings. Every member is shaped so the read can be sent straight
+ * back to updatePortalCardBlock: a hidden item reports only `visible: false`, and
+ * `appearance` is absent for the Card's own `bare` wrapper, which no `backdrop`
+ * value can ask for.
+ */
+export interface PortalCardBlockSettingsContract {
+    kind: "card";
+    /** Absent for a legacy template view outside the four supported ones. */
+    view?: PortalCardViewContract;
+    content: {
+        image: {
+            visible: boolean;
+        };
+        heading: PortalCardHeadingContract;
+        description: PortalCardDescriptionContract;
+        button: PortalCardButtonContract;
+        /**
+         * `null` is a Card with no link at all. Absent means the stored link is one
+         * the contract cannot express, so re-sending it would change the block.
+         */
+        destination?: PortalCardDestinationContract | null;
+    };
+    /** The complete variant to re-send when only one of its fields should change. */
+    appearance?: PortalCardAppearancePatchContract;
+}
+/** Current Carousel settings, shaped for a full-list update round trip. */
+export interface PortalCarouselBlockSettingsContract {
+    kind: "carousel";
+    content: PortalCarouselUpdateContentContract;
+}
+/** Current Countdown settings, with the internal epoch exposed as RFC 3339. */
+export interface PortalCountdownBlockSettingsContract {
+    kind: "countdown";
+    content: PortalCountdownUpdateContentContract;
+    /** Absent only for a legacy wrapper the public Appearance contract cannot express. */
+    appearance?: PortalCountdownAppearancePatchContract;
+}
+/** Current BPMN Diagram settings; BPMN XML and process data remain internal. */
+export interface PortalBpmnDiagramBlockSettingsContract {
+    kind: "bpmnDiagram";
+    content: PortalBpmnDiagramUpdateContentContract;
+    /** Absent only for a legacy wrapper the public Appearance contract cannot express. */
+    appearance?: PortalBpmnDiagramAppearancePatchContract;
+}
+/** Current Dynamic Table settings; provider, OAuth, source, columns and rows stay internal. */
+export interface PortalDynamicTableBlockSettingsContract {
+    kind: "dynamicTable";
+    /** Absent only for a legacy wrapper the public Appearance contract cannot express. */
+    appearance?: PortalDynamicTableAppearancePatchContract;
+}
+/** Current Recent files source; sort, limit and raw query data stay internal. */
+export interface PortalRecentFilesBlockSettingsContract {
+    kind: "recentFiles";
+    source: PortalRecentFilesSourceContract;
+}
+/** Current exact source of a Linked block. */
+export interface PortalLinkedBlockSettingsContract {
+    kind: "linked";
+    source: PortalLinkedBlockSourceContract;
+}
+export interface PortalFormBlockSettingsContract {
+    kind: "form";
+    content: PortalFormUpdateContentContract;
+    appearance?: PortalFormAppearancePatchContract;
+}
+export interface PortalCardGroupBlockSettingsContract {
+    kind: "cardGroup";
+    content: PortalCardGroupUpdateContentContract;
+    appearance?: PortalCardGroupAppearancePatchContract;
+}
+export interface PortalInfoBlockSettingsContract {
+    kind: "info";
+    image: PortalInfoImageContract;
+    destination: PortalInfoDestinationContract;
+    openInNewTab: boolean;
+}
+export interface PortalCustomWidgetBlockSettingsContract {
+    kind: "customWidget";
+    content: PortalCustomWidgetContentContract;
+    appearance?: PortalCustomWidgetAppearancePatchContract;
+}
+export interface PortalHtmlCssBlockSettingsContract {
+    kind: "htmlCss";
+    content: PortalHtmlCssBlockContentContract;
+}
+export interface PortalTimelineBlockSettingsContract {
+    kind: "timeline";
+    view: PortalTimelineViewContract;
+    content: PortalTimelineContentContract;
+    appearance?: PortalTimelineAppearancePatchContract;
+}
+export interface PortalFileUploaderBlockSettingsContract {
+    kind: "fileUploader";
+    description: string;
+    showAuthor: boolean;
+    showUploadDate: boolean;
+}
+export interface PortalChatBlockSettingsContract {
+    kind: "chat";
+    target: PortalChatBlockTarget;
+    /** Present only for channel targets. */
+    membersOnly?: boolean;
+}
+export interface PortalAppBlockSettingsContract {
+    kind: "app";
+    productId: string;
+    appId: string;
+    productType: "private" | "managed";
+    productOrgId: string;
+}
+export interface PortalAiAgentBlockSettingsContract {
+    kind: "aiAgent";
+    agentId: string;
+}
+/** Current code returned for an existing HTML/CSS block; all fields are explicit. */
+export interface PortalHtmlCssBlockContentContract {
+    html: string;
+    style: string;
+    script: string;
+}
+/** A block's public settings, discriminated by `kind`. */
+export type PortalBlockSettingsContract = PortalNoteBlockSettingsContract | PortalTextBlockSettingsContract | PortalImageBlockSettingsContract | PortalEmbedBlockSettingsContract | PortalDatabaseBlockSettingsContract | PortalCardBlockSettingsContract | PortalCarouselBlockSettingsContract | PortalCountdownBlockSettingsContract | PortalBpmnDiagramBlockSettingsContract | PortalDynamicTableBlockSettingsContract | PortalRecentFilesBlockSettingsContract | PortalLinkedBlockSettingsContract | PortalFormBlockSettingsContract | PortalCardGroupBlockSettingsContract | PortalInfoBlockSettingsContract | PortalCustomWidgetBlockSettingsContract | PortalHtmlCssBlockSettingsContract | PortalTimelineBlockSettingsContract | PortalFileUploaderBlockSettingsContract | PortalChatBlockSettingsContract | PortalAppBlockSettingsContract | PortalAiAgentBlockSettingsContract;
+/** Presentation of a block on its page. */
+export interface PortalBlockLayoutContract {
+    /** Block width in page columns. */
+    colspan: number;
+    /** Block height in page rows. */
+    rowspan: number;
+    /** Fixed pixel height, or null for the automatic height. */
+    height: number | null;
+}
+/** One block's semantic kind and current public settings, as returned by getPortalBlock. */
+export interface GetPortalBlockResponseContract {
+    /** Exact block id. */
+    blockId: string;
+    /**
+     * Semantic kind of the block (e.g. `note`, `card`, `form`) — the vocabulary
+     * the typed update operations use. Null for a block the block API does not
+     * model, such as a portal's system content block.
+     */
+    kind: string | null;
+    /** Canonical portal block type (e.g. `flexible`). */
+    type: string;
+    /** Flexible template behind the block (e.g. `info-card`); null for other types. */
+    templateType: string | null;
+    /** Block title as shown in the customizer. */
+    title: string;
+    /** Page area holding the block (e.g. `page_header`, `page_body`). */
+    place: string;
+    /** The block exists only in this portal's customizer draft. */
+    draftOnly: boolean;
+    /**
+     * Typed updatePortal*Block operation that edits this block, or null when its
+     * kind has no typed update operation yet.
+     */
+    editOperation: string | null;
+    layout: PortalBlockLayoutContract;
+    /**
+     * Editable settings specific to the block's kind, or null when its kind has
+     * no typed update operation yet.
+     */
+    settings: PortalBlockSettingsContract | null;
+}
+/** Layout fields a note-backed block accepts. Omitted fields keep their current value. */
+export interface UpdatePortalNoteBlockLayoutContract {
+    /** Block width in page columns: 3, 4, 5 or 6. */
+    colspan?: number;
+    /** Fixed pixel height (at least 50), or null for the automatic height. */
+    height?: number | null;
+}
+/**
+ * Partial update of a note-backed block. Every field is optional and an omitted
+ * one keeps its current value; at least one must be sent.
+ */
+export interface UpdatePortalNoteBlockRequestContract {
+    /** New block title as shown on the page. */
+    title?: string;
+    layout?: UpdatePortalNoteBlockLayoutContract;
+}
+/**
+ * Partial update of an Embed block. Every field is optional and an omitted one
+ * keeps its current value; at least one must be sent.
+ *
+ * `title`, `showEmbedLink` and the layout are field-level patches. The source is
+ * NOT: `embedType` with exactly one of `url` or `content` is a complete variant,
+ * so changing the type requires sending the matching source in the same request.
+ */
+export interface UpdatePortalEmbedBlockRequestContract {
+    /** New block title as shown on the page. */
+    title?: string;
+    /** Customizer Embed variant. `unknown` is not accepted. */
+    embedType?: PortalEmbedType;
+    /** For named variants, forbidden for `custom`: the URL to embed. */
+    url?: string;
+    /** For `custom`, forbidden for named variants: the embed code/URL. */
+    content?: string;
+    /** Whether to show the "open in new tab" link on the block. */
+    showEmbedLink?: boolean;
+    /** Block width in grid columns. */
+    colspan?: 2 | 3 | 4 | 5 | 6;
+    /** Block height in grid rows. */
+    rowspan?: 1 | 2 | 3 | 4;
+    /** Fixed pixel height, or null for the automatic height. */
+    height?: number | null;
+}
+/**
+ * Partial update of a Database block. Every field is optional and an omitted one
+ * keeps its current value; at least one must be sent.
+ *
+ * `title`, `itemsPerPage` and the layout are field-level patches. `target` and
+ * `appearance` are NOT: each is a complete variant when sent.
+ */
+export interface UpdatePortalDatabaseBlockRequestContract {
+    /** Exact ids from listPortalDatabaseBlockSources; names and aliases are rejected. */
+    target?: PortalDatabaseBlockTargetContract;
+    /** New block title as shown on the page. */
+    title?: string;
+    /** Rows shown per page. */
+    itemsPerPage?: 10 | 20 | 50 | 100 | 200 | 500;
+    /** Visual wrapper of the portal block. */
+    appearance?: PortalDatabaseBlockAppearancePatchContract;
+    /** Grid placement. */
+    layout?: PortalDatabaseBlockLayoutContract;
+}
+/**
+ * Partial update of a Card block. Every field is optional and an omitted one
+ * keeps its current value; at least one must be sent.
+ *
+ * `content` patches item by item, but each ITEM is a complete variant: a heading
+ * sent with only `size` keeps its stored text, bold and alignment, while a
+ * heading sent as `{ visible: false }` may carry nothing else. `appearance` is a
+ * complete variant too.
+ */
+export interface UpdatePortalCardBlockRequestContract {
+    /** Card Type. Changing it repaints the text colours, as the Customizer does. */
+    view?: PortalCardViewContract;
+    content?: PortalCardContentContract;
+    /** Visual wrapper of the portal block. */
+    appearance?: PortalCardAppearancePatchContract;
+    /** Grid placement. */
+    layout?: PortalCardLayoutContract;
+}
+/**
+ * Partial update of a Carousel block. `content.items`, when sent, is the full
+ * desired list; layout fields remain field-level patches.
+ */
+export interface UpdatePortalCarouselBlockRequestContract {
+    content?: PortalCarouselUpdateContentContract;
+    layout?: PortalCarouselLayoutContract;
+}
+/** Partial update of a Countdown block; omitted fields keep their current value. */
+export interface UpdatePortalCountdownBlockRequestContract {
+    /** Plain text; only `{{ClientName}}` and `{{ClientLastName}}` are variables. */
+    title?: string;
+    content?: PortalCountdownUpdateContentContract;
+    /** Complete Appearance variant when sent. */
+    appearance?: PortalCountdownAppearancePatchContract;
+    layout?: PortalCountdownLayoutContract;
+}
+/** Partial update of a BPMN Diagram block; BPMN XML and process data are not accepted. */
+export interface UpdatePortalBpmnDiagramBlockRequestContract {
+    /** Plain text; only `{{ClientName}}` and `{{ClientLastName}}` are variables. */
+    title?: string;
+    content?: PortalBpmnDiagramUpdateContentContract;
+    /** Complete Appearance variant when sent. */
+    appearance?: PortalBpmnDiagramAppearancePatchContract;
+    /** Outer block layout; layout.height is separate from content.diagramHeight. */
+    layout?: PortalBpmnDiagramLayoutContract;
+}
+/** Partial update of a Dynamic Table shell; provider and table data are not accepted. */
+export interface UpdatePortalDynamicTableBlockRequestContract {
+    /** Plain text; only `{{ClientName}}` and `{{ClientLastName}}` are variables. */
+    title?: string;
+    /** Complete Appearance variant when sent. */
+    appearance?: PortalDynamicTableAppearancePatchContract;
+    layout?: PortalDynamicTableLayoutContract;
+}
+/** Partial update of a Recent files block; file query policy is not accepted. */
+export interface UpdatePortalRecentFilesBlockRequestContract {
+    /** Plain text block title. */
+    title?: string;
+    /** Entire portal, or one exact page in the same portal. */
+    source?: PortalRecentFilesSourceContract;
+    layout?: PortalRecentFilesLayoutContract;
+}
+/** Changes the exact source of a Linked block; presentation is mirrored. */
+export interface UpdatePortalLinkedBlockRequestContract {
+    source: PortalLinkedBlockSourceContract;
+}
+/**
+ * Where the block must end up on its page. Exactly one of these keys is sent.
+ * A raw index is deliberately not accepted — it means something else as soon as
+ * another block is added or moved.
+ */
+export interface MovePortalBlockRequestContract {
+    /** `first` or `last` on the page. Mutually exclusive with the anchors. */
+    position?: "first" | "last";
+    /** Move the block immediately before this same-page anchor block. */
+    beforeBlockId?: string;
+    /** Move the block immediately after this same-page anchor block. */
+    afterBlockId?: string;
+}
+/** Result shared by every staged portal block change. */
+export interface StagedPortalBlockResponseContract {
+    /** Id of the affected block. */
+    blockId: string;
+    /** Id of the page holding the block. */
+    pageId: string;
+    /** Customizer draft branch the change was staged in. */
+    branchId: string;
+    /** Draft sequence numbers of the staged events. */
+    seqs: number[];
+    /** Always true: the change is staged in the draft and not published. */
+    staged: true;
+}
 export interface ListPortalLinkableBlocksResponseContract {
     /** Blocks of the page in display order; Linked blocks are excluded. */
     blocks: PortalLinkableBlockContract[];
@@ -830,6 +1705,14 @@ export type PortalFormAppearanceContract = {
     /** Default: true. */
     showTitle?: boolean;
 };
+export type PortalFormAppearancePatchContract = {
+    backdrop: "none" | "blank";
+} | {
+    backdrop: "custom";
+    background?: PortalCardBackgroundContract;
+    padding?: "none" | "s" | "m" | "l";
+    showTitle?: boolean;
+};
 /** Customizer Layout section of a Form. */
 export interface PortalFormLayoutContract {
     /** Customizer Width. Default: 6. */
@@ -925,6 +1808,29 @@ export interface PortalFormBlockContentContract {
     description?: PortalFormDescriptionContract;
     form?: PortalFormContentBrickContract;
 }
+export interface PortalFormUpdateFieldContract extends PortalFormFieldContract {
+    /** Preserve this exact id for an existing field; omit only for a new field. */
+    fieldId?: string;
+}
+export type PortalFormUpdateContentBrickContract = {
+    visible: false;
+} | {
+    visible?: true;
+    /** Full desired field list in visual order. */
+    fields?: PortalFormUpdateFieldContract[];
+    submit?: PortalFormSubmitContract;
+    reusable?: boolean;
+};
+export interface PortalFormUpdateContentContract {
+    description?: PortalFormDescriptionContract;
+    form?: PortalFormUpdateContentBrickContract;
+}
+export interface UpdatePortalFormBlockRequestContract {
+    title?: string;
+    content?: PortalFormUpdateContentContract;
+    appearance?: PortalFormAppearancePatchContract;
+    layout?: PortalFormLayoutContract;
+}
 export interface AddPortalFormBlockRequestContract {
     /**
      * Block title shown above the form. Plain text; only `{{ClientName}}` and
@@ -995,6 +1901,26 @@ export type PortalCardGroupAppearanceContract = {
     /** Default: true. */
     showTitle?: boolean;
 };
+/** Update/read variant: a stored custom wrapper may still use the portal theme background. */
+export type PortalCardGroupAppearancePatchContract = {
+    backdrop: "none" | "blank";
+} | {
+    backdrop: "custom";
+    background?: PortalCardBackgroundContract;
+    padding?: "none" | "s" | "m" | "l";
+    showTitle?: boolean;
+};
+export interface PortalCardGroupUpdateContentContract {
+    description?: PortalCardDescriptionContract;
+    /** Full desired card list in visual order. */
+    items?: PortalCardGroupItemContract[];
+}
+export interface UpdatePortalCardGroupBlockRequestContract {
+    title?: string;
+    content?: PortalCardGroupUpdateContentContract;
+    appearance?: PortalCardGroupAppearancePatchContract;
+    layout?: PortalCardGroupLayoutContract;
+}
 export interface AddPortalCardGroupBlockRequestContract {
     /**
      * Wrapper title, shown above the cards. Default: "Card group".
@@ -1109,6 +2035,16 @@ export interface AddPortalInfoBlockRequestContract {
     /** Default: width 1 column, one row and automatic height. */
     layout?: PortalInfoLayoutContract;
 }
+export interface UpdatePortalInfoBlockRequestContract {
+    /** New tile text. Omitted preserves the current title. */
+    title?: string;
+    /** Complete semantic image variant. */
+    image?: PortalInfoImageContract;
+    /** Complete semantic destination variant. */
+    destination?: PortalInfoDestinationContract;
+    openInNewTab?: boolean;
+    layout?: PortalInfoLayoutContract;
+}
 export interface AddPortalInfoBlockResponseContract {
     /** Id of the created block. */
     blockId: string;
@@ -1246,6 +2182,21 @@ export type PortalCustomWidgetAppearanceContract = {
     /** Default: true. */
     showTitle?: boolean;
 };
+/** Update/read variant for a stored custom wrapper still using the portal theme background. */
+export type PortalCustomWidgetAppearancePatchContract = {
+    backdrop: "none" | "blank";
+} | {
+    backdrop: "custom";
+    background?: PortalCardBackgroundContract;
+    padding?: "none" | "s" | "m" | "l";
+    showTitle?: boolean;
+};
+export interface UpdatePortalCustomWidgetBlockRequestContract {
+    title?: string;
+    content?: PortalCustomWidgetContentContract;
+    appearance?: PortalCustomWidgetAppearancePatchContract;
+    layout?: PortalCustomWidgetLayoutContract;
+}
 /** Customizer Layout section of a Custom widget. */
 export interface PortalCustomWidgetLayoutContract {
     /** Customizer Width. Default: 2. */
@@ -1317,6 +2268,13 @@ export interface PortalHtmlCssLayoutContract {
      */
     height?: number | null;
 }
+export interface UpdatePortalHtmlCssBlockRequestContract {
+    /** Existing block title; omitted means unchanged. */
+    title?: string;
+    /** Partial code patch; omitted fields remain unchanged and an empty string clears one. */
+    content?: PortalHtmlCssContentContract;
+    layout?: PortalHtmlCssLayoutContract;
+}
 export interface AddPortalHtmlCssBlockRequestContract {
     /**
      * Block title. The block's wrapper hides it BY DEFAULT, so it normally only
@@ -1438,6 +2396,15 @@ export type PortalTimelineAppearanceContract = {
     /** Default: true. */
     showTitle?: boolean;
 };
+/** Update/read variant for a custom wrapper still using the portal theme background. */
+export type PortalTimelineAppearancePatchContract = {
+    backdrop: "none" | "blank";
+} | {
+    backdrop: "custom";
+    background?: PortalCardBackgroundContract;
+    padding?: "none" | "s" | "m" | "l";
+    showTitle?: boolean;
+};
 /** Customizer Layout section of a Timeline. */
 export interface PortalTimelineLayoutContract {
     /** Customizer Width. Default: 6. */
@@ -1448,6 +2415,13 @@ export interface PortalTimelineLayoutContract {
      */
     height?: number | null;
 }
+export interface UpdatePortalTimelineBlockRequestContract {
+    view?: PortalTimelineViewContract;
+    title?: string;
+    content?: PortalTimelineContentContract;
+    appearance?: PortalTimelineAppearancePatchContract;
+    layout?: PortalTimelineLayoutContract;
+}
 export interface AddPortalTimelineBlockRequestContract {
     /** Timeline view. Default: `horizontal`. */
     view?: PortalTimelineViewContract;
@@ -1486,6 +2460,14 @@ export interface PortalFileUploaderLayoutContract {
      */
     height?: number | null;
 }
+export interface UpdatePortalFileUploaderBlockRequestContract {
+    title?: string;
+    /** @maxLength 50 */
+    description?: string;
+    showAuthor?: boolean;
+    showUploadDate?: boolean;
+    layout?: PortalFileUploaderLayoutContract;
+}
 export interface AddPortalFileUploaderBlockRequestContract {
     /**
      * Block title rendered above the file list. Plain text — the screen has no
@@ -1601,6 +2583,26 @@ export interface AddPortalChatBlockRequestContract {
     /** Fixed pixel height, or null to auto-size. Default: null. */
     height?: number | null;
 }
+/** Partial Chat widget update; omitted fields retain their stored values. */
+export interface UpdatePortalChatBlockRequestContract {
+    /**
+     * Non-empty title, up to 200 characters.
+     * @minLength 1
+     * @maxLength 200
+     */
+    title?: string;
+    /** Complete channel or DM target using an exact discovery id. */
+    target?: PortalChatBlockTarget;
+    /** Channel-only; private channels require true. */
+    membersOnly?: boolean;
+    colspan?: 3 | 4 | 5 | 6;
+    rowspan?: 1 | 2 | 3 | 4;
+    /**
+     * Fixed positive pixel height, or null for automatic height.
+     * @minimum 1
+     */
+    height?: number | null;
+}
 export interface AddPortalChatBlockResponseContract {
     /** Id of the created chat block. */
     blockId: string;
@@ -1651,54 +2653,6 @@ export interface ListPortalChatUsersResponseContract {
     /** Opaque cursor for the next page; absent when there are no more results. */
     nextCursor?: string;
 }
-/**
- * Block types the portal-service draft reducer (`blockFromDto`) understands.
- * Any other value is rejected with 400 (the reducer throws on unknown types,
- * which would otherwise fail the whole draft at publish time).
- */
-export type PortalBlockType = "note" | "content" | "docs" | "help" | "request" | "meetings" | "links" | "files-dashboard" | "tasks-dashboard" | "chats-dashboard" | "files-recent" | "flexible";
-export interface AddPortalBlockRequestContract {
-    /** Id of the existing portal page node to add the block to. */
-    pageId: string;
-    /** Block type to stage (see the op description for per-type fields). */
-    type: PortalBlockType;
-    /** Optional block title (defaults to the page's current title). */
-    title?: string;
-    /** Required for `note`/`content` blocks: the Fusebase note to embed. */
-    noteId?: string;
-    /** Required for `flexible` blocks: the flexible template, e.g. `{type:"text"}`. */
-    template?: {
-        type: string;
-        view?: string;
-    };
-    /** Optional bricks for `flexible` blocks. */
-    bricks?: unknown[];
-    /**
-     * Optional type-specific fields for the staged block, e.g. flat strings
-     * `image`/`link` for docs/help/request/meetings/links,
-     * `sourcePortalId`/`sourcePageId`/`sourceBlockId` for projection.
-     * Also overrides scaffold defaults (colspan,
-     * rowspan, …) when provided. Every field is validated against the block's
-     * real customizer shape — an unknown field or a wrong-typed value (e.g. an
-     * object where a flat string is expected) is rejected with 400.
-     */
-    properties?: Record<string, unknown>;
-}
-export interface AddPortalBlockResponseContract {
-    /** Id of the created block. */
-    blockId: string;
-    /** Id of the page the block was added to. */
-    pageId: string;
-    /** Draft branch the change was staged on. */
-    branchId: string;
-    /** Sequence numbers assigned to the staged change events (addBlock). */
-    seqs: number[];
-    /**
-     * Always true: the block is staged in the portal's customizer draft, not yet
-     * live. The portal owner reviews and publishes it from the customizer.
-     */
-    staged: boolean;
-}
 export interface AddPortalAppPageRequestContract {
     /**
      * Global id of the published Fusebase product that owns the app (the product
@@ -1731,6 +2685,11 @@ export interface AddPortalAppPageRequestContract {
     parentId?: string;
     /** Optional icon key for the menu item (default: "note"). */
     icon?: string;
+    /**
+     * Menu bar to place the page in: "sidebar" (default), "top" (topbar), or
+     * "footer". Ignored when `parentId` is set (the page inherits the parent's bar).
+     */
+    positionType?: PortalContentPositionType;
 }
 export interface AddPortalAppPageResponseContract {
     /** Id of the created portal page node hosting the app embed. */
@@ -1777,6 +2736,19 @@ export interface AddPortalAppBlockRequestContract {
     /** Title for the block (default: "App"; managed: "Managed Products"). */
     title?: string;
 }
+/** Partial App block update; any binding change sends all four identity fields. */
+export interface UpdatePortalAppBlockRequestContract {
+    productId?: string;
+    appId?: string;
+    productType?: "private" | "managed";
+    productOrgId?: string;
+    /**
+     * New block title.
+     * @minLength 1
+     * @maxLength 200
+     */
+    title?: string;
+}
 export interface AddPortalAppBlockResponseContract {
     /** Id of the created flexible block carrying the app-feature embed. */
     blockId: string;
@@ -1825,6 +2797,86 @@ export interface UpdatePortalCustomCodeResponseContract {
      */
     staged: boolean;
 }
+export interface UpdatePortalHomepageRequestContract {
+    /**
+     * Title of the homepage. Renames the portal's Home menu item, and with it the
+     * linked homepage itself — the same field as the customizer's Homepage Title.
+     */
+    title?: string;
+    /** Show the sidebar on pages other than the homepage (`theme.sidebar.show`). */
+    showSidebarOnOtherPages?: boolean;
+    /** Show the sidebar on the homepage (`theme.sidebar.homePage`). */
+    showSidebarOnHomePage?: boolean;
+    /**
+     * Start the sidebar expanded rather than collapsed
+     * (`theme.sidebar.minimized`; the renderer uses `collapsed = !minimized`).
+     */
+    expandSidebarByDefault?: boolean;
+}
+export interface UpdatePortalHomepageResponseContract {
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /**
+     * Sequence numbers assigned to the staged change events — one per affected
+     * area (homepage title, sidebar theme), staged together. At most two.
+     */
+    seqs: number[];
+    /**
+     * Always true: the change is staged in the portal's customizer draft, not yet
+     * live. The portal owner reviews and publishes it from the customizer.
+     */
+    staged: boolean;
+}
+export interface UpdatePortalItemRequestContract {
+    /** New display name (rename). Also renames the backing page, if any. */
+    name?: string;
+    /** New icon key. */
+    icon?: string;
+    /** Show (true) or hide (false) the item in navigation. */
+    visible?: boolean;
+    /**
+     * New 0-based position among its siblings (reorders the bar). Use this to fix
+     * the newest-first root ordering.
+     *
+     * @minimum 0
+     */
+    index?: number;
+    /**
+     * Move the item to a different navigation bar. A nested item moves to the root
+     * of that bar unless parentId names a folder there. When parentId is also given
+     * it must match the destination parent's bar.
+     */
+    positionType?: PortalContentPositionType;
+    /**
+     * Move the item under a different parent folder ("" = root). The item, and a
+     * folder's whole subtree, follows the new parent's bar. The parent must be
+     * able to hold children (a folder, note, section, process or page) — a link,
+     * dashboard, tag list or the home item is rejected.
+     */
+    parentId?: string;
+}
+export interface UpdatePortalItemResponseContract {
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence numbers assigned to the staged change events. */
+    seqs: number[];
+    /**
+     * Always true: the change is staged in the portal's customizer draft, not yet
+     * live. The portal owner reviews and publishes it from the customizer.
+     */
+    staged: boolean;
+}
+export interface DeletePortalItemResponseContract {
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence number assigned to the staged change event. */
+    seq: number;
+    /**
+     * Always true: the deletion is staged in the portal's customizer draft, not yet
+     * live. The portal owner reviews and publishes it from the customizer.
+     */
+    staged: boolean;
+}
 export interface DuplicatePortalItemRequestContract {
     /**
      * Id of the menu item to duplicate (a folder, note page, portal page, or link),
@@ -1866,6 +2918,44 @@ export interface PortalDetailContract {
     cnameType?: string;
     cnameValue?: string;
     cnameStatus?: string;
+    /**
+     * Published branding, the read analogue of updatePortalStyle. Omitted when
+     * portal-service does not return theme settings for the portal.
+     */
+    style?: PortalStyleContract;
+}
+/** Published branding of a portal, as stored in its theme. */
+export interface PortalStyleContract {
+    /** Color theme key. Absent when the portal never had one set explicitly. */
+    theme?: PortalThemeKey;
+    /** Logo image URL, as rendered in the portal header. */
+    logoUrl?: string;
+    /** Favicon image URL, used as the portal's browser tab icon. */
+    faviconUrl?: string;
+}
+export interface UpdatePortalStyleRequestContract {
+    /** Color theme to apply, the same picker the customizer's Theme screen shows. */
+    theme?: PortalThemeKey;
+    /** Logo image, shown in the portal header. */
+    logo?: PortalStyleImageContract;
+    /** Favicon image, used as the portal's browser tab icon. */
+    favicon?: PortalStyleImageContract;
+}
+/** An image for portal branding, referenced by its uploaded stored file. */
+export interface PortalStyleImageContract {
+    /** `storedFileUUID` of an already uploaded image file. */
+    storedFileUUID: string;
+}
+export interface UpdatePortalStyleResponseContract {
+    /** Draft branch the change was staged on. */
+    branchId: string;
+    /** Sequence number assigned to the staged change event. */
+    seq: number;
+    /**
+     * Always true: the change is staged in the portal's customizer draft, not yet
+     * live. The portal owner reviews and publishes it from the customizer.
+     */
+    staged: boolean;
 }
 export interface InviteToPortalRequestContract {
     email: string;
@@ -1979,6 +3069,12 @@ export interface PortalContentItemContract {
     type: PortalMenuItemType;
     name: string;
     slug: string;
+    /**
+     * Full path of the item inside the portal (e.g. "/docs/start"). Pass this
+     * verbatim to updatePortalContentPermissions; never rebuild a nested path
+     * from `slug`. Absent for menu items that have no path of their own.
+     */
+    path?: string;
     positionType: PortalContentPositionType;
     index: number;
     visible: boolean;
@@ -1990,6 +3086,63 @@ export interface PortalContentItemContract {
 export interface ListPortalContentResponseContract {
     items: PortalContentItemContract[];
 }
+/**
+ * "replace" leaves access to exactly the supplied emails; "add" keeps everyone
+ * who already has access and appends them.
+ */
+export type PortalContentPermissionsMode = "replace" | "add";
+export interface UpdatePortalContentPermissionsRequestContract {
+    /**
+     * Exact full path of the published page or folder inside the portal, e.g.
+     * "/inspiration-page" or "/docs/start". Take it from
+     * listPortalContent items[].path; do not rebuild it from `slug`.
+     */
+    path: string;
+    /**
+     * Emails to grant access to: between 1 and 50. Compared case-insensitively;
+     * duplicates are ignored. The count is enforced by the service — the schema
+     * generator drops `@minItems` / `@maxItems`, so declaring them here would read
+     * as shipped and be inert.
+     */
+    emails: string[];
+    /** How the supplied emails combine with the current access list. */
+    mode: PortalContentPermissionsMode;
+}
+export interface PortalContentPermissionsContract {
+    allowAll: boolean;
+    rejectAll: boolean;
+    allowUserIds: number[];
+    rejectUserIds: number[];
+}
+export interface PortalContentPermissionsUserContract {
+    /** Normalized (trimmed, lowercased) email. */
+    email: string;
+    userId: number;
+    /** True when this call created the portal membership for that email. */
+    invited: boolean;
+    /** Only for a freshly created invitation. */
+    magicLink?: string;
+}
+export interface UpdatePortalContentPermissionsResponseContract {
+    /** The published page or folder the path resolved to. */
+    item: {
+        id: string;
+        type: PortalMenuItemType;
+        name: string;
+        path: string;
+    };
+    mode: PortalContentPermissionsMode;
+    /** Access list stored on the item after the change. */
+    permissions: PortalContentPermissionsContract;
+    users: PortalContentPermissionsUserContract[];
+    /** The item plus every descendant the cascade updated. */
+    affectedItemIds: string[];
+    /**
+     * Always true: the change is live immediately. Do NOT call publishPortalDraft
+     * after this operation.
+     */
+    published: boolean;
+}
 export interface PortalAiAgentContract {
     /** Agent global id — pass verbatim to addPortalAiAgentBlock as agentId. */
     id: string;
@@ -2020,6 +3173,10 @@ export interface AddPortalAiAgentBlockRequestContract {
     /** Exact agent id from listPortalAiAgents. Never invent one. */
     agentId: string;
 }
+export interface UpdatePortalAiAgentBlockRequestContract {
+    /** Exact id returned by listPortalAiAgents. @minLength 1 */
+    agentId: string;
+}
 export interface AddPortalAiAgentBlockResponseContract {
     /** Id of the created AI Agent block. */
     blockId: string;
@@ -2046,6 +3203,11 @@ export declare const PortalDatabaseBlockAppearanceContract: {
     readonly Blank: "blank";
     readonly Custom: "custom";
 };
+export declare const PortalDatabaseBlockAppearancePatchContract: {
+    readonly None: "none";
+    readonly Blank: "blank";
+    readonly Custom: "custom";
+};
 export declare const PortalTextBackgroundContract: {
     readonly Color: "color";
 };
@@ -2054,6 +3216,11 @@ export declare const PortalFlexibleTextAppearanceContract: {
     readonly Blank: "blank";
     readonly Custom: "custom";
 };
+export declare const PortalFlexibleTextAppearancePatchContract: {
+    readonly None: "none";
+    readonly Blank: "blank";
+    readonly Custom: "custom";
+};
 export declare const PortalCardBackgroundContract: {
     readonly Color: "color";
 };
@@ -2068,6 +3235,11 @@ export declare const PortalCardAppearanceContract: {
     readonly Blank: "blank";
     readonly Custom: "custom";
 };
+export declare const PortalCardAppearancePatchContract: {
+    readonly None: "none";
+    readonly Blank: "blank";
+    readonly Custom: "custom";
+};
 export declare const PortalCardDestinationContract: {
     readonly Portalpage: "portalPage";
 };
@@ -2076,11 +3248,45 @@ export declare const PortalCountdownAppearanceContract: {
     readonly Blank: "blank";
     readonly Custom: "custom";
 };
+export declare const PortalCountdownAppearancePatchContract: {
+    readonly None: "none";
+    readonly Blank: "blank";
+    readonly Custom: "custom";
+};
+export declare const PortalBpmnDiagramAppearanceContract: {
+    readonly None: "none";
+    readonly Blank: "blank";
+    readonly Custom: "custom";
+};
+export declare const PortalBpmnDiagramAppearancePatchContract: {
+    readonly None: "none";
+    readonly Blank: "blank";
+    readonly Custom: "custom";
+};
+export declare const PortalDynamicTableAppearanceContract: {
+    readonly None: "none";
+    readonly Blank: "blank";
+    readonly Custom: "custom";
+};
+export declare const PortalDynamicTableAppearancePatchContract: {
+    readonly None: "none";
+    readonly Blank: "blank";
+    readonly Custom: "custom";
+};
+export declare const PortalRecentFilesSourceContract: {
+    readonly Entireportal: "entirePortal";
+    readonly Portalpage: "portalPage";
+};
 export declare const PortalFormAppearanceContract: {
     readonly None: "none";
     readonly Blank: "blank";
     readonly Custom: "custom";
 };
+export declare const PortalFormAppearancePatchContract: {
+    readonly None: "none";
+    readonly Blank: "blank";
+    readonly Custom: "custom";
+};
 export declare const PortalFormFieldTypeContract: {
     readonly Text: "text";
     readonly Textarea: "textarea";
@@ -2107,6 +3313,11 @@ export declare const PortalCardGroupAppearanceContract: {
     readonly Blank: "blank";
     readonly Custom: "custom";
 };
+export declare const PortalCardGroupAppearancePatchContract: {
+    readonly None: "none";
+    readonly Blank: "blank";
+    readonly Custom: "custom";
+};
 export declare const PortalInfoImageContract: {
     readonly Emoji: "emoji";
 };
@@ -2124,6 +3335,11 @@ export declare const PortalCustomWidgetAppearanceContract: {
     readonly Blank: "blank";
     readonly Custom: "custom";
 };
+export declare const PortalCustomWidgetAppearancePatchContract: {
+    readonly None: "none";
+    readonly Blank: "blank";
+    readonly Custom: "custom";
+};
 export declare const PortalTimelineViewContract: {
     readonly Horizontal: "horizontal";
     readonly Vertical: "vertical";
@@ -2133,3 +3349,8 @@ export declare const PortalTimelineAppearanceContract: {
     readonly Blank: "blank";
     readonly Custom: "custom";
 };
+export declare const PortalTimelineAppearancePatchContract: {
+    readonly None: "none";
+    readonly Blank: "blank";
+    readonly Custom: "custom";
+};