@automate.ax/integration-contracts 0.146.0 → 0.147.0

package/dist/tally/openapi-types.generated.d.ts

@@ -0,0 +1,2567 @@
+/**
+ * Generated from https://developers.tally.so/api-reference/openapi.json. Source
+ * SHA-256: 28b98ea5fb21692746d85f8bb8110c74d3826c6e15d33dd0ccf1aa0e92f1db7b.
+ */
+export interface components {
+    schemas: {
+        /**
+         * Deleting a form is done through DELETE /forms/{formId}, which moves it to
+         * the trash so it can be restored.
+         *
+         * @enum {string}
+         */
+        FormStatus: "BLANK" | "DRAFT" | "PUBLISHED";
+        /**
+         * Format: uuid
+         *
+         * Unique identifier for this block.
+         */
+        BlockUuid: string;
+        /**
+         * Format: uuid
+         *
+         * Groups related blocks together. For standalone blocks, use the block's
+         * own uuid. For child blocks (e.g., dropdown options, multiple choice
+         * options), use the parent block's uuid so all children share the same
+         * groupUuid.
+         */
+        GroupUuid: string;
+        /**
+         * When true, hides the field from respondents. Hidden fields don't appear
+         * on the form but can be shown via conditional logic.
+         */
+        IsHidden: boolean;
+        /**
+         * When true, collapses the question group in the form builder UI, hiding
+         * child blocks while showing a count indicator. Only applies to Title and
+         * Label blocks.
+         */
+        IsFolded: boolean;
+        /**
+         * When true, the field must be filled out before the form can be submitted.
+         * Respondents will see a required indicator.
+         */
+        IsRequired: boolean;
+        /**
+         * When true, the field is pre-populated with the value from defaultAnswer
+         * when the form loads.
+         */
+        HasDefaultAnswer: boolean;
+        /**
+         * Set to true to enable minCharacters validation. When true, minCharacters
+         * must be provided.
+         */
+        HasMinCharacters: boolean;
+        /**
+         * The minimum number of characters allowed. Required when hasMinCharacters
+         * is true.
+         */
+        MinCharacters: number;
+        /**
+         * Set to true to enable maxCharacters validation. When true, maxCharacters
+         * must be provided.
+         */
+        HasMaxCharacters: boolean;
+        /**
+         * The maximum number of characters allowed. Required when hasMaxCharacters
+         * is true.
+         */
+        MaxCharacters: number;
+        /**
+         * Set to true to enable minChoices validation. When true, minChoices must
+         * be provided.
+         */
+        HasMinChoices: boolean;
+        /**
+         * Minimum number of selections required. Required when hasMinChoices is
+         * true.
+         */
+        MinChoices: number;
+        /**
+         * Set to true to enable maxChoices validation. When true, maxChoices must
+         * be provided.
+         */
+        HasMaxChoices: boolean;
+        /**
+         * Maximum number of selections allowed. Required when hasMaxChoices is
+         * true.
+         */
+        MaxChoices: number;
+        /** Position of this option within the group (0-indexed). */
+        OptionIndex: number;
+        /** True if this is the first option in the group. */
+        IsFirstOption: boolean;
+        /** True if this is the last option in the group. */
+        IsLastOption: boolean;
+        /**
+         * Allow selecting multiple options. Only needs to be set on the first
+         * option in the group.
+         */
+        AllowMultiple: boolean;
+        /**
+         * Enable color-coded options display. Only needs to be set on the first
+         * option in the group.
+         */
+        ColorCodeOptions: boolean;
+        /**
+         * Color name for this option when colorCodeOptions is enabled.
+         *
+         * @enum {string}
+         */
+        OptionColor: "red" | "orange" | "yellow" | "green" | "blue" | "purple" | "pink" | "gray";
+        /**
+         * The default value for this field. Can be either a raw string value or a
+         * Field reference to dynamically populate from another field's answer.
+         */
+        DefaultAnswerString: components["schemas"]["Field"] | string;
+        /**
+         * The default value for this field. Can be either a raw number value or a
+         * Field reference to dynamically populate from another field's answer.
+         */
+        DefaultAnswerNumber: components["schemas"]["Field"] | number;
+        /** Customizes the button text for form navigation. */
+        Button: {
+            /** The text displayed on the button (e.g., "Start", "Next", "Submit"). */
+            label?: string;
+        };
+        /**
+         * Optional identifier for this block. Can be used to reference the block in
+         * integrations or conditional logic.
+         */
+        Name: string;
+        /**
+         * Rich text content. Supports basic formatting: bold, italic, underline,
+         * links, and mentions.
+         */
+        Html: string;
+        /** Rich text value represented as HTML with optional field mentions. */
+        RichText: {
+            html: components["schemas"]["Html"];
+            mentions?: components["schemas"]["Mention"][];
+        } | null;
+        /**
+         * The name of the content provider. Auto-detected from the URL via oEmbed
+         * protocol or pattern matching. Common values include: YouTube, Loom,
+         * Twitch, Twitter, Canva, Google Maps, Imgur, JSFiddle, GitHub Gist, Video,
+         * Audio, Image, PDF. May also be any other oEmbed-supported provider.
+         */
+        EmbedProvider: string;
+        /**
+         * Format: uri
+         *
+         * The URL of the content to embed. Supports video platforms (YouTube, Loom,
+         * Twitch, etc.) and audio platforms. The URL is used to auto-detect the
+         * provider and fetch embed data via oEmbed.
+         */
+        EmbedUrl: string;
+        FormSettings: {
+            language?: string | null;
+            /** @default false */
+            isClosed: boolean;
+            closeMessageTitle?: string | null;
+            closeMessageDescription?: string | null;
+            closeTimezone?: string | null;
+            closeDate?: string | null;
+            closeTime?: string | null;
+            /** Format: int64 */
+            submissionsLimit?: number | null;
+            uniqueSubmissionKey?: components["schemas"]["RichText"];
+            redirectOnCompletion?: components["schemas"]["RichText"];
+            /** @default false */
+            hasSelfEmailNotifications: boolean;
+            selfEmailTo?: components["schemas"]["RichText"];
+            selfEmailReplyTo?: components["schemas"]["RichText"];
+            selfEmailSubject?: components["schemas"]["RichText"];
+            selfEmailFromName?: components["schemas"]["RichText"];
+            selfEmailBody?: components["schemas"]["RichText"];
+            /** @default false */
+            hasRespondentEmailNotifications: boolean;
+            respondentEmailTo?: components["schemas"]["RichText"];
+            respondentEmailReplyTo?: components["schemas"]["RichText"];
+            respondentEmailSubject?: components["schemas"]["RichText"];
+            respondentEmailFromName?: components["schemas"]["RichText"];
+            respondentEmailBody?: components["schemas"]["RichText"];
+            /** @default false */
+            hasProgressBar: boolean;
+            /** @default false */
+            hasPartialSubmissions: boolean;
+            /** @default false */
+            pageAutoJump: boolean;
+            /** @default true */
+            saveForLater: boolean;
+            styles?: string | null;
+            password?: string | null;
+            /** Format: int64 */
+            submissionsDataRetentionDuration?: number | null;
+            submissionsDataRetentionUnit?: string | null;
+        };
+        Form: {
+            id: string;
+            name: string;
+            workspaceId: string;
+            status: components["schemas"]["FormStatus"];
+            numberOfSubmissions: number;
+            isClosed: boolean;
+            payments?: {
+                amount?: number;
+                currency?: string;
+            }[];
+            /** Format: date-time */
+            createdAt: string;
+            /** Format: date-time */
+            updatedAt: string;
+        };
+        Block: components["schemas"]["FormTitleBlock"] | components["schemas"]["TitleBlock"] | components["schemas"]["TextBlock"] | components["schemas"]["LabelBlock"] | components["schemas"]["Heading1Block"] | components["schemas"]["Heading2Block"] | components["schemas"]["Heading3Block"] | components["schemas"]["ImageBlock"] | components["schemas"]["EmbedBlock"] | components["schemas"]["EmbedVideoBlock"] | components["schemas"]["EmbedAudioBlock"] | components["schemas"]["DividerBlock"] | components["schemas"]["PageBreakBlock"] | components["schemas"]["InputTextBlock"] | components["schemas"]["TextareaBlock"] | components["schemas"]["InputNumberBlock"] | components["schemas"]["InputEmailBlock"] | components["schemas"]["InputLinkBlock"] | components["schemas"]["InputPhoneNumberBlock"] | components["schemas"]["InputDateBlock"] | components["schemas"]["InputTimeBlock"] | components["schemas"]["MultipleChoiceOptionBlock"] | components["schemas"]["CheckboxBlock"] | components["schemas"]["DropdownOptionBlock"] | components["schemas"]["RankingOptionBlock"] | components["schemas"]["MultiSelectOptionBlock"] | components["schemas"]["LinearScaleBlock"] | components["schemas"]["RatingBlock"] | components["schemas"]["MatrixBlock"] | components["schemas"]["MatrixRowBlock"] | components["schemas"]["MatrixColumnBlock"] | components["schemas"]["FileUploadBlock"] | components["schemas"]["SignatureBlock"] | components["schemas"]["PaymentBlock"] | components["schemas"]["HiddenFieldsBlock"] | components["schemas"]["ConditionalLogicBlock"] | components["schemas"]["CalculatedFieldsBlock"] | components["schemas"]["CaptchaBlock"] | components["schemas"]["RespondentCountryBlock"];
+        CalculatedField: {
+            /** Format: uuid */
+            uuid: string;
+            /**
+             * Name your calculated field to easily retrieve it in calculations later
+             * on.
+             */
+            name?: components["schemas"]["Name"];
+            type?: components["schemas"]["CalculatedFieldType"];
+            /**
+             * An initial value as a starting point of your calculation. This can be
+             * zero (for numbers) or left blank (for text).
+             */
+            value?: string | number;
+        };
+        HiddenField: {
+            /** Format: uuid */
+            uuid: string;
+            name?: components["schemas"]["Name"];
+        };
+        /** @enum {string} */
+        EventType: "FORM_RESPONSE";
+        User: {
+            id?: string;
+            firstName?: string;
+            lastName?: string;
+            fullName?: string;
+            email?: string;
+            /** Format: uri */
+            avatarUrl?: string | null;
+            organizationId?: string;
+            isDeleted?: boolean;
+            hasTwoFactorEnabled?: boolean;
+            /** Format: date-time */
+            createdAt?: string;
+            /** Format: date-time */
+            updatedAt?: string;
+            /** @enum {string} */
+            subscriptionPlan?: "FREE" | "PRO" | "BUSINESS";
+        };
+        Folder: {
+            id: string;
+            name: string;
+            workspaceId: string;
+            parentId: string | null;
+            createdByUserId: string;
+            /** Format: date-time */
+            createdAt: string;
+            /** Format: date-time */
+            updatedAt: string;
+        };
+        Workspace: {
+            id: string;
+            name: string;
+            index: number;
+            members?: components["schemas"]["User"][];
+            invites?: {
+                id?: string;
+                email?: string;
+                workspaceIds?: string[];
+            }[];
+            folders?: components["schemas"]["Folder"][];
+            createdByUserId: string;
+            /** Format: date-time */
+            createdAt: string;
+            /** Format: date-time */
+            updatedAt: string;
+        };
+        Invite: {
+            id: string;
+            /** Format: email */
+            email: string;
+            /** Format: date-time */
+            createdAt: string;
+            /** Format: date-time */
+            updatedAt: string;
+        };
+        QuestionField: {
+            /** Format: uuid */
+            uuid?: string;
+            type?: components["schemas"]["BlockType"];
+            /** Format: uuid */
+            blockGroupUuid?: string;
+            title?: string;
+        };
+        Question: {
+            id?: string;
+            type?: components["schemas"]["BlockType"];
+            title?: string;
+            isTitleModifiedByUser?: boolean;
+            formId?: string;
+            isDeleted?: boolean;
+            numberOfResponses?: number;
+            /** Format: date-time */
+            createdAt?: string;
+            /** Format: date-time */
+            updatedAt?: string;
+            fields?: components["schemas"]["QuestionField"][];
+        };
+        /**
+         * A reference to a form field, used to dynamically access another field's
+         * value (e.g., for default answers or mentions).
+         */
+        Field: {
+            /**
+             * Unique identifier of the referenced field. A UUID for regular fields,
+             * or a UtilityUuid value when type is UTILITY.
+             */
+            uuid: string | components["schemas"]["UtilityUuid"];
+            /** The category of field being referenced. */
+            type: components["schemas"]["FieldType"];
+            /** The block type of the referenced field. */
+            questionType: components["schemas"]["FieldQuestionType"];
+            /**
+             * Identifier of the block group containing the referenced field. A UUID
+             * for regular fields, or a UtilityUuid value when type is UTILITY.
+             */
+            blockGroupUuid: string | components["schemas"]["UtilityUuid"];
+            /** Display title of the referenced field. */
+            title: string;
+            /** For calculated fields, specifies whether the result is NUMBER or TEXT. */
+            calculatedFieldType?: components["schemas"]["CalculatedFieldType"];
+            /**
+             * Additional configuration for utility fields. Only present when type is
+             * UTILITY.
+             */
+            payload?: Record<string, never>;
+        };
+        /**
+         * The category of a field reference.
+         *
+         * @enum {string}
+         */
+        FieldType: "INPUT_FIELD" | "CALCULATED_FIELD" | "HIDDEN_FIELD" | "UTILITY" | "PLACEHOLDER" | "METADATA";
+        /**
+         * Identifier used as uuid and blockGroupUuid for utility field references.
+         *
+         * @enum {string}
+         */
+        UtilityUuid: "utility::today()";
+        /**
+         * Block types that produce answer values and can be referenced as field
+         * sources.
+         *
+         * @enum {string}
+         */
+        FieldQuestionType: "INPUT_TEXT" | "INPUT_NUMBER" | "INPUT_EMAIL" | "INPUT_LINK" | "INPUT_PHONE_NUMBER" | "INPUT_DATE" | "INPUT_TIME" | "TEXTAREA" | "RATING" | "LINEAR_SCALE" | "CHECKBOX" | "MULTIPLE_CHOICE_OPTION" | "DROPDOWN_OPTION" | "RANKING_OPTION" | "MULTI_SELECT_OPTION" | "HIDDEN_FIELDS" | "CALCULATED_FIELDS";
+        /**
+         * Choose whether the value will be text or a numeric value (number).
+         *
+         * @enum {string}
+         */
+        CalculatedFieldType: "NUMBER" | "TEXT";
+        /**
+         * A dynamic placeholder that references another field's value. Used to
+         * personalize form content (e.g., "Hello @name").
+         */
+        Mention: {
+            /**
+             * Format: uuid
+             *
+             * Unique identifier for this mention.
+             */
+            uuid: string;
+            /**
+             * The field being referenced. Its value replaces the mention placeholder
+             * at runtime.
+             */
+            field: components["schemas"]["Field"];
+            /** Fallback value displayed when the referenced field has no data. */
+            defaultValue?: unknown;
+        };
+        /** @enum {string} */
+        BlockType: "FORM_TITLE" | "TEXT" | "LABEL" | "TITLE" | "HEADING_1" | "HEADING_2" | "HEADING_3" | "DIVIDER" | "PAGE_BREAK" | "IMAGE" | "EMBED" | "EMBED_VIDEO" | "EMBED_AUDIO" | "QUESTION" | "MATRIX" | "INPUT_TEXT" | "INPUT_NUMBER" | "INPUT_EMAIL" | "INPUT_LINK" | "INPUT_PHONE_NUMBER" | "INPUT_DATE" | "INPUT_TIME" | "TEXTAREA" | "FILE_UPLOAD" | "LINEAR_SCALE" | "RATING" | "HIDDEN_FIELDS" | "MULTIPLE_CHOICE_OPTION" | "CHECKBOX" | "DROPDOWN_OPTION" | "RANKING_OPTION" | "MULTI_SELECT_OPTION" | "PAYMENT" | "SIGNATURE" | "MATRIX_ROW" | "MATRIX_COLUMN" | "CONDITIONAL_LOGIC" | "CALCULATED_FIELDS" | "CAPTCHA" | "RESPONDENT_COUNTRY";
+        /**
+         * Days or date ranges to disable in the date picker.
+         *
+         * @enum {string}
+         */
+        DisableDays: "IN_THE_PAST" | "IN_THE_FUTURE" | "MONDAYS" | "TUESDAYS" | "WEDNESDAYS" | "THURSDAYS" | "FRIDAYS" | "SATURDAYS" | "SUNDAYS";
+        /**
+         * The literal character used as decimal separator.
+         *
+         * @enum {string}
+         */
+        DecimalSeparator: "." | ",";
+        /**
+         * The literal character used as thousands separator. An empty string means
+         * no separator.
+         *
+         * @enum {string}
+         */
+        ThousandsSeparator: "" | "." | "," | " ";
+        /** @enum {string} */
+        NumberFormat: "NUMBER" | "PERCENT" | "US_DOLLAR" | "EURO" | "POUND" | "CUSTOM";
+        /** @enum {string} */
+        Currency: "AED" | "AUD" | "BGN" | "BRL" | "CAD" | "CHF" | "CNY" | "CZK" | "DKK" | "EUR" | "GBP" | "HKD" | "HRK" | "HUF" | "IDR" | "ILS" | "INR" | "ISK" | "JPY" | "KRW" | "MAD" | "MXN" | "MYR" | "NOK" | "NZD" | "PHP" | "PLN" | "RON" | "RSD" | "RUB" | "SAR" | "SEK" | "SGD" | "THB" | "TRY" | "TWD" | "UAH" | "USD" | "VND" | "ZAR";
+        /**
+         * Allowed file types for upload. Keys are MIME type categories, values are
+         * arrays of file extensions or ['*'] for all types in that category.
+         *
+         * @example
+         *   { "image/*": [".png", ".jpg", ".gif"], "application/*": [".pdf"] }
+         */
+        AllowedFiles: {
+            /** Image file extensions or ['*'] for all image types. */
+            "image/*"?: ("*" | ".jpg" | ".jpeg" | ".png" | ".gif" | ".svg" | ".heic" | ".webp" | ".bmp" | ".psd")[];
+            /** Video file extensions or ['*'] for all video types. */
+            "video/*"?: ("*" | ".mp4" | ".mov" | ".webm")[];
+            /** Audio file extensions or ['*'] for all audio types. */
+            "audio/*"?: ("*" | ".mp3" | ".wav" | ".m4a")[];
+            /** Text file extensions or ['*'] for all text types. */
+            "text/*"?: ("*" | ".txt" | ".csv" | ".html" | ".xml")[];
+            /**
+             * Application/document file extensions or ['*'] for all application
+             * types.
+             */
+            "application/*"?: ("*" | ".pdf" | ".doc" | ".docx" | ".xls" | ".xlsx" | ".ppt" | ".pptx" | ".zip" | ".rar" | ".json" | ".gzip" | ".odt")[];
+        };
+        SingleConditional: {
+            /** Format: uuid */
+            uuid: string;
+            /** @enum {string} */
+            type: "SINGLE";
+            /** Single condition comparing one field to a value. */
+            payload: {
+                field: components["schemas"]["Field"];
+                /**
+                 * Comparison operator for the condition.
+                 *
+                 * @enum {string}
+                 */
+                comparison: "IS" | "IS_NOT" | "IS_ANY_OF" | "IS_NOT_ANY_OF" | "IS_EVERY_OF" | "CONTAINS" | "DOES_NOT_CONTAIN" | "STARTS_WITH" | "DOES_NOT_START_WITH" | "ENDS_WITH" | "DOES_NOT_END_WITH" | "IS_EMPTY" | "IS_NOT_EMPTY" | "EQUAL" | "NOT_EQUAL" | "GREATER_THAN" | "LESS_THAN" | "GREATER_OR_EQUAL_THAN" | "LESS_OR_EQUAL_THAN" | "IS_BEFORE" | "IS_AFTER";
+                /** Comparison value or field reference. Nullable for empty checks. */
+                value: (string | number | string[] | components["schemas"]["Field"]) | null;
+            };
+        };
+        GroupConditional: {
+            /** Format: uuid */
+            uuid: string;
+            /** @enum {string} */
+            type: "GROUP";
+            /** Group of conditions combined with AND/OR. */
+            payload: {
+                /**
+                 * How to combine child conditions (AND/OR).
+                 *
+                 * @enum {string}
+                 */
+                logicalOperator: "AND" | "OR";
+                /** Child conditions in this group. */
+                conditionals: components["schemas"]["Conditional"][];
+            };
+        };
+        /** Union of single and group conditionals. */
+        Conditional: components["schemas"]["SingleConditional"] | components["schemas"]["GroupConditional"];
+        /** Conditional action wrapper. */
+        ConditionalAction: {
+            /** Format: uuid */
+            uuid: string;
+            /**
+             * Action type; determines which payload fields are relevant.
+             *
+             * @enum {string}
+             */
+            type: "JUMP_TO_PAGE" | "CALCULATE" | "REQUIRE_ANSWER" | "SHOW_BLOCKS" | "HIDE_BLOCKS" | "HIDE_BUTTON_TO_DISABLE_COMPLETION";
+            /** Action details executed when conditions match. */
+            payload?: {
+                /** Target page number or page UUID to jump to. */
+                jumpToPage?: string | number;
+                /** Block UUIDs to show when condition matches. */
+                showBlocks?: string[];
+                /** Block UUIDs to hide when condition matches. */
+                hideBlocks?: string[];
+                /**
+                 * Format: uuid
+                 *
+                 * Block UUID to mark as required when condition matches.
+                 */
+                requireAnswer?: string;
+                /** Calculation to apply when condition matches. */
+                calculate?: {
+                    field: components["schemas"]["Field"];
+                    /**
+                     * Math or assignment operator.
+                     *
+                     * @enum {string}
+                     */
+                    operator: "ADDITION" | "SUBTRACTION" | "MULTIPLICATION" | "DIVISION" | "ASSIGNMENT";
+                    /** Value or field reference used in the calculation. */
+                    value: string | number | string[] | components["schemas"]["Field"];
+                };
+            };
+        };
+        BlockPayload: components["schemas"]["FormTitlePayload"] | components["schemas"]["TextPayload"] | components["schemas"]["LabelPayload"] | components["schemas"]["TitlePayload"] | components["schemas"]["Heading1Payload"] | components["schemas"]["Heading2Payload"] | components["schemas"]["Heading3Payload"] | components["schemas"]["DividerPayload"] | components["schemas"]["PageBreakPayload"] | components["schemas"]["ImagePayload"] | components["schemas"]["EmbedPayload"] | components["schemas"]["EmbedVideoPayload"] | components["schemas"]["EmbedAudioPayload"] | components["schemas"]["MatrixPayload"] | components["schemas"]["InputTextPayload"] | components["schemas"]["InputNumberPayload"] | components["schemas"]["InputEmailPayload"] | components["schemas"]["InputLinkPayload"] | components["schemas"]["InputPhoneNumberPayload"] | components["schemas"]["InputDatePayload"] | components["schemas"]["InputTimePayload"] | components["schemas"]["TextareaPayload"] | components["schemas"]["FileUploadPayload"] | components["schemas"]["LinearScalePayload"] | components["schemas"]["RatingPayload"] | components["schemas"]["HiddenFieldsPayload"] | components["schemas"]["MultipleChoiceOptionPayload"] | components["schemas"]["CheckboxPayload"] | components["schemas"]["DropdownOptionPayload"] | components["schemas"]["RankingOptionPayload"] | components["schemas"]["MultiSelectOptionPayload"] | components["schemas"]["PaymentPayload"] | components["schemas"]["SignaturePayload"] | components["schemas"]["MatrixRowPayload"] | components["schemas"]["MatrixColumnPayload"] | components["schemas"]["ConditionalLogicPayload"] | components["schemas"]["CalculatedFieldsPayload"] | components["schemas"]["CaptchaPayload"] | components["schemas"]["RespondentCountryPayload"];
+        /**
+         * FormTitlePayload
+         *
+         * Payload for FORM_TITLE block type. Used for the main form title with
+         * optional logo and cover image.
+         */
+        FormTitlePayload: {
+            html?: components["schemas"]["Html"];
+            /** Plain-text form title. Used as the form name when provided. */
+            title?: string | null;
+            /**
+             * Format: uri
+             *
+             * URL of the logo image displayed as form branding. Recommended size:
+             * 200x200 pixels. Rendered as a circular image.
+             */
+            logo?: string;
+            /**
+             * Format: uri
+             *
+             * URL of a full-width cover image displayed at the top of the form.
+             * Recommended minimum width: 1500 pixels.
+             */
+            cover?: string;
+            coverSettings?: {
+                /**
+                 * Vertical position of the cover image as a percentage. Controls the
+                 * CSS object-position property. 0 shows the top edge, 50 centers the
+                 * image, and 100 shows the bottom edge.
+                 *
+                 * @default 50
+                 */
+                objectPositionYPercent: number;
+            };
+            mentions?: components["schemas"]["Mention"][];
+            button?: components["schemas"]["Button"];
+        };
+        /**
+         * TextPayload
+         *
+         * Payload for TEXT block type. Used for text content blocks.
+         */
+        TextPayload: {
+            html?: components["schemas"]["Html"];
+            isHidden?: components["schemas"]["IsHidden"];
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+        };
+        /**
+         * LabelPayload
+         *
+         * Payload for LABEL block type. Used for label elements.
+         */
+        LabelPayload: {
+            html?: components["schemas"]["Html"];
+            isHidden?: components["schemas"]["IsHidden"];
+            isFolded?: components["schemas"]["IsFolded"];
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+        };
+        /**
+         * TitlePayload
+         *
+         * Payload for TITLE block type. Used for title elements.
+         */
+        TitlePayload: {
+            html?: components["schemas"]["Html"];
+            isHidden?: components["schemas"]["IsHidden"];
+            isFolded?: components["schemas"]["IsFolded"];
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+        };
+        /**
+         * Heading1Payload
+         *
+         * Payload for HEADING_1 block type. Used for H1 headings.
+         */
+        Heading1Payload: {
+            html?: components["schemas"]["Html"];
+            isHidden?: components["schemas"]["IsHidden"];
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+        };
+        /**
+         * Heading2Payload
+         *
+         * Payload for HEADING_2 block type. Used for H2 headings.
+         */
+        Heading2Payload: {
+            html?: components["schemas"]["Html"];
+            isHidden?: components["schemas"]["IsHidden"];
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+        };
+        /**
+         * Heading3Payload
+         *
+         * Payload for HEADING_3 block type. Used for H3 headings.
+         */
+        Heading3Payload: {
+            html?: components["schemas"]["Html"];
+            isHidden?: components["schemas"]["IsHidden"];
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+        };
+        /**
+         * DividerPayload
+         *
+         * Payload for DIVIDER block type. Used for visual separators.
+         */
+        DividerPayload: {
+            isHidden?: components["schemas"]["IsHidden"];
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+        };
+        /**
+         * PageBreakPayload
+         *
+         * Payload for PAGE_BREAK block type. Used for multi-page form navigation.
+         */
+        PageBreakPayload: {
+            /**
+             * Sequential position of this page break within the form, starting from
+             * 0.
+             */
+            index?: number;
+            /** When true, indicates this is the first page break in the form. */
+            isFirst?: boolean;
+            /** When true, indicates this is the last page break in the form. */
+            isLast?: boolean;
+            name?: components["schemas"]["Name"];
+            /**
+             * When true, indicates this page break represents a custom thank-you page
+             * shown after form submission.
+             */
+            isThankYouPage?: boolean;
+            /** When true, indicates this page is collapsed in the form builder. */
+            isFolded?: boolean;
+            /** When true, this page qualifies as the thank-you page target. */
+            isQualifiedForThankYouPage?: boolean;
+            /**
+             * Customizes the button text for form navigation. When provided, label is
+             * required.
+             */
+            button?: {
+                /** The text displayed on the button (e.g., "Start", "Next", "Submit"). */
+                label: string;
+            };
+        };
+        /**
+         * ImagePayload
+         *
+         * Payload for IMAGE block type. Used for displaying images.
+         */
+        ImagePayload: {
+            images?: {
+                /** The filename of the image. */
+                name: string;
+                /** Format: uri */
+                url: string;
+            }[];
+            /**
+             * Set to true to enable caption; caption must be present if hasCaption is
+             * true.
+             */
+            hasCaption?: boolean;
+            /** The caption text to display below the image. */
+            caption?: string;
+            /** Set to true to enable link; link must be present if hasLink is true. */
+            hasLink?: boolean;
+            /**
+             * Format: uri
+             *
+             * The URL to link to when the image is clicked.
+             */
+            link?: string;
+            /**
+             * Set to true to enable alt text; altText must be present if hasAltText
+             * is true.
+             */
+            hasAltText?: boolean;
+            /** The alternative text for the image. */
+            altText?: string;
+            isHidden?: components["schemas"]["IsHidden"];
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+        };
+        /**
+         * EmbedPayload
+         *
+         * Payload for EMBED block type. Used for embedding external content.
+         */
+        EmbedPayload: {
+            isHidden?: components["schemas"]["IsHidden"];
+            /** @enum {string} */
+            type: "rich" | "video" | "photo" | "link" | "pdf" | "gist" | "image/*" | "video/*" | "audio/*";
+            provider: components["schemas"]["EmbedProvider"];
+            title: string;
+            /** Format: uri */
+            inputUrl: string;
+            display: {
+                /** Format: uri */
+                url?: string;
+            };
+            width?: string | number;
+            height?: string | number;
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+        };
+        /**
+         * EmbedVideoPayload
+         *
+         * Payload for EMBED_VIDEO block type. Used for embedding video content.
+         */
+        EmbedVideoPayload: {
+            isHidden?: components["schemas"]["IsHidden"];
+            /** @enum {string} */
+            type: "video" | "video/*";
+            provider: components["schemas"]["EmbedProvider"];
+            title: string;
+            inputUrl: components["schemas"]["EmbedUrl"];
+            display: {
+                /** Format: uri */
+                url?: string;
+            };
+            width?: string | number;
+            height?: string | number;
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+        };
+        /**
+         * EmbedAudioPayload
+         *
+         * Payload for EMBED_AUDIO block type. Used for embedding audio content.
+         */
+        EmbedAudioPayload: {
+            isHidden?: components["schemas"]["IsHidden"];
+            /** @enum {string} */
+            type: "audio/*" | "rich";
+            provider: components["schemas"]["EmbedProvider"];
+            title: string;
+            inputUrl: components["schemas"]["EmbedUrl"];
+            display: {
+                /** Format: uri */
+                url?: string;
+            };
+            width?: string | number;
+            height?: string | number;
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+        };
+        /**
+         * MatrixPayload
+         *
+         * Payload for MATRIX block type. Used for matrix/grid questions.
+         */
+        MatrixPayload: {
+            isRequired?: components["schemas"]["IsRequired"];
+            isHidden?: components["schemas"]["IsHidden"];
+            hasDefaultAnswer?: components["schemas"]["HasDefaultAnswer"];
+            defaultAnswer?: components["schemas"]["DefaultAnswerString"];
+            name?: components["schemas"]["Name"];
+        };
+        /**
+         * InputTextPayload
+         *
+         * Payload for INPUT_TEXT block type. Used for short text input fields.
+         */
+        InputTextPayload: {
+            isHidden?: components["schemas"]["IsHidden"];
+            isRequired?: components["schemas"]["IsRequired"];
+            hasDefaultAnswer?: components["schemas"]["HasDefaultAnswer"];
+            defaultAnswer?: components["schemas"]["DefaultAnswerString"];
+            placeholder?: string;
+            hasMinCharacters?: components["schemas"]["HasMinCharacters"];
+            minCharacters?: components["schemas"]["MinCharacters"];
+            hasMaxCharacters?: components["schemas"]["HasMaxCharacters"];
+            maxCharacters?: components["schemas"]["MaxCharacters"];
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+            name?: components["schemas"]["Name"];
+        };
+        /**
+         * InputNumberPayload
+         *
+         * Payload for INPUT_NUMBER block type. Used for numeric input fields.
+         */
+        InputNumberPayload: {
+            isHidden?: components["schemas"]["IsHidden"];
+            isRequired?: components["schemas"]["IsRequired"];
+            hasDefaultAnswer?: components["schemas"]["HasDefaultAnswer"];
+            defaultAnswer?: components["schemas"]["DefaultAnswerNumber"];
+            placeholder?: string;
+            /**
+             * Set to true to enable minNumber; minNumber must be present if
+             * hasMinNumber is true.
+             */
+            hasMinNumber?: boolean;
+            /** The minimum allowed value (required if hasMinNumber is true). */
+            minNumber?: number;
+            /**
+             * Set to true to enable maxNumber; maxNumber must be present if
+             * hasMaxNumber is true.
+             */
+            hasMaxNumber?: boolean;
+            /** The maximum allowed value (required if hasMaxNumber is true). */
+            maxNumber?: number;
+            decimalSeparator?: components["schemas"]["DecimalSeparator"];
+            thousandsSeparator?: components["schemas"]["ThousandsSeparator"];
+            format?: components["schemas"]["NumberFormat"];
+            /**
+             * Custom prefix to display before the number (e.g., currency symbol).
+             * Used with NumberFormat.Custom.
+             */
+            prefix?: string;
+            /**
+             * Custom suffix to display after the number (e.g., unit). Used with
+             * NumberFormat.Custom.
+             */
+            suffix?: string;
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+            name?: components["schemas"]["Name"];
+        };
+        /**
+         * InputEmailPayload
+         *
+         * Payload for INPUT_EMAIL block type. Used for email input fields.
+         */
+        InputEmailPayload: {
+            isHidden?: components["schemas"]["IsHidden"];
+            isRequired?: components["schemas"]["IsRequired"];
+            hasDefaultAnswer?: components["schemas"]["HasDefaultAnswer"];
+            defaultAnswer?: components["schemas"]["DefaultAnswerString"];
+            /**
+             * When true, respondents must verify their email address before
+             * submitting.
+             */
+            requireVerification?: boolean;
+            placeholder?: string;
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+            name?: components["schemas"]["Name"];
+        };
+        /**
+         * InputLinkPayload
+         *
+         * Payload for INPUT_LINK block type. Used for URL input fields.
+         */
+        InputLinkPayload: {
+            isHidden?: components["schemas"]["IsHidden"];
+            isRequired?: components["schemas"]["IsRequired"];
+            hasDefaultAnswer?: components["schemas"]["HasDefaultAnswer"];
+            defaultAnswer?: components["schemas"]["DefaultAnswerString"];
+            placeholder?: string;
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+            name?: components["schemas"]["Name"];
+        };
+        /**
+         * InputPhoneNumberPayload
+         *
+         * Payload for INPUT_PHONE_NUMBER block type. Used for phone number input
+         * fields.
+         */
+        InputPhoneNumberPayload: {
+            isHidden?: components["schemas"]["IsHidden"];
+            isRequired?: components["schemas"]["IsRequired"];
+            hasDefaultAnswer?: components["schemas"]["HasDefaultAnswer"];
+            defaultAnswer?: components["schemas"]["DefaultAnswerString"];
+            placeholder?: string;
+            /**
+             * When true, allows international phone numbers from any country. When
+             * false, restricts input to the default country.
+             */
+            internationalFormat?: boolean;
+            /**
+             * ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'DE') that sets the
+             * default country for the phone number input.
+             */
+            defaultCountryCode?: string;
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+            name?: components["schemas"]["Name"];
+        };
+        /**
+         * InputDatePayload
+         *
+         * Payload for INPUT_DATE block type. Used for date picker fields.
+         */
+        InputDatePayload: {
+            isHidden?: components["schemas"]["IsHidden"];
+            isRequired?: components["schemas"]["IsRequired"];
+            hasDefaultAnswer?: components["schemas"]["HasDefaultAnswer"];
+            defaultAnswer?: components["schemas"]["DefaultAnswerString"];
+            placeholder?: string;
+            /** Array of days or date ranges to disable in the date picker. */
+            disableDays?: components["schemas"]["DisableDays"][];
+            /**
+             * Display format for the date.
+             *
+             * @enum {string}
+             */
+            format?: "MM/dd/yyyy" | "dd/MM/yyyy" | "yyyy/MM/dd" | "dd.MM.yyyy" | "yyyy-MM-dd";
+            /**
+             * Format: date
+             *
+             * Disable dates before this date.
+             */
+            beforeDate?: string;
+            /**
+             * Format: date
+             *
+             * Disable dates after this date.
+             */
+            afterDate?: string;
+            /** Restrict selectable dates to a specific range. */
+            dateRange?: {
+                /**
+                 * Format: date
+                 *
+                 * Start date of the allowed range.
+                 */
+                from?: string;
+                /**
+                 * Format: date
+                 *
+                 * End date of the allowed range.
+                 */
+                to?: string;
+            };
+            /** Array of specific dates to disable. */
+            specificDates?: string[];
+            /**
+             * Day the week starts on in the calendar view. 0=Sunday, 1=Monday,
+             * 2=Tuesday, 3=Wednesday, 4=Thursday, 5=Friday, 6=Saturday.
+             *
+             * @enum {string}
+             */
+            startWeekOn?: "0" | "1" | "2" | "3" | "4" | "5" | "6";
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+            name?: components["schemas"]["Name"];
+        };
+        /**
+         * InputTimePayload
+         *
+         * Payload for INPUT_TIME block type. Used for time picker fields.
+         */
+        InputTimePayload: {
+            isHidden?: components["schemas"]["IsHidden"];
+            isRequired?: components["schemas"]["IsRequired"];
+            hasDefaultAnswer?: components["schemas"]["HasDefaultAnswer"];
+            defaultAnswer?: components["schemas"]["DefaultAnswerString"];
+            placeholder?: string;
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+            name?: components["schemas"]["Name"];
+        };
+        /**
+         * TextareaPayload
+         *
+         * Payload for TEXTAREA block type. Used for long text input fields.
+         */
+        TextareaPayload: {
+            isHidden?: components["schemas"]["IsHidden"];
+            isRequired?: components["schemas"]["IsRequired"];
+            hasDefaultAnswer?: components["schemas"]["HasDefaultAnswer"];
+            defaultAnswer?: components["schemas"]["DefaultAnswerString"];
+            placeholder?: string;
+            hasMinCharacters?: components["schemas"]["HasMinCharacters"];
+            minCharacters?: components["schemas"]["MinCharacters"];
+            hasMaxCharacters?: components["schemas"]["HasMaxCharacters"];
+            maxCharacters?: components["schemas"]["MaxCharacters"];
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+            name?: components["schemas"]["Name"];
+        };
+        /**
+         * FileUploadPayload
+         *
+         * Payload for FILE_UPLOAD block type. Used for file upload fields.
+         */
+        FileUploadPayload: {
+            isHidden?: components["schemas"]["IsHidden"];
+            isRequired?: components["schemas"]["IsRequired"];
+            /** When true, allows uploading multiple files. */
+            hasMultipleFiles?: boolean;
+            /**
+             * Set to true to enable minFiles validation. When true, minFiles must be
+             * provided.
+             */
+            hasMinFiles?: boolean;
+            /** Minimum number of files required. Required when hasMinFiles is true. */
+            minFiles?: number;
+            /**
+             * Set to true to enable maxFiles validation. When true, maxFiles must be
+             * provided.
+             */
+            hasMaxFiles?: boolean;
+            /** Maximum number of files allowed. Required when hasMaxFiles is true. */
+            maxFiles?: number;
+            /**
+             * Set to true to enable maxFileSize validation. When true, maxFileSize
+             * and maxFileSizeUnit must be provided.
+             */
+            hasMaxFileSize?: boolean;
+            /** Maximum file size. Required when hasMaxFileSize is true. */
+            maxFileSize?: number;
+            /**
+             * Unit for maxFileSize. Required when hasMaxFileSize is true.
+             *
+             * @enum {string}
+             */
+            maxFileSizeUnit?: "KB" | "MB" | "GB";
+            allowedFiles?: components["schemas"]["AllowedFiles"];
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+            name?: components["schemas"]["Name"];
+        };
+        /**
+         * LinearScalePayload
+         *
+         * Payload for LINEAR_SCALE block type. Used for scale/slider questions.
+         */
+        LinearScalePayload: {
+            isHidden?: components["schemas"]["IsHidden"];
+            isRequired?: components["schemas"]["IsRequired"];
+            hasDefaultAnswer?: components["schemas"]["HasDefaultAnswer"];
+            /** Default selected value. Must be within the start-end range. */
+            defaultAnswer?: number;
+            /** Starting value of the scale (0-100). Defaults to 0. */
+            start?: number;
+            /** Ending value of the scale (0-100). Must be >= start. Defaults to 10. */
+            end?: number;
+            /** Step increment between scale values. Must be >= 1. Defaults to 1. */
+            step?: number;
+            /** When true, leftLabel must be provided. */
+            hasLeftLabel?: boolean;
+            /**
+             * Label displayed at the start of the scale. Required when hasLeftLabel
+             * is true.
+             */
+            leftLabel?: string;
+            /** When true, centerLabel must be provided. */
+            hasCenterLabel?: boolean;
+            /**
+             * Label displayed at the center of the scale. Required when
+             * hasCenterLabel is true.
+             */
+            centerLabel?: string;
+            /** When true, rightLabel must be provided. */
+            hasRightLabel?: boolean;
+            /**
+             * Label displayed at the end of the scale. Required when hasRightLabel is
+             * true.
+             */
+            rightLabel?: string;
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+            name?: components["schemas"]["Name"];
+        };
+        /**
+         * RatingPayload
+         *
+         * Payload for RATING block type. Used for star rating questions.
+         */
+        RatingPayload: {
+            isHidden?: components["schemas"]["IsHidden"];
+            isRequired?: components["schemas"]["IsRequired"];
+            hasDefaultAnswer?: components["schemas"]["HasDefaultAnswer"];
+            defaultAnswer?: components["schemas"]["DefaultAnswerNumber"];
+            /** Number of stars for the rating scale (1-10). Defaults to 5. */
+            stars?: number;
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+            name?: components["schemas"]["Name"];
+        };
+        /**
+         * HiddenFieldsPayload
+         *
+         * Payload for HIDDEN_FIELDS block type. Used for hidden form fields.
+         */
+        HiddenFieldsPayload: {
+            /**
+             * Array of hidden fields. Each hidden field captures a value from URL
+             * query parameters matching the field name.
+             */
+            hiddenFields: components["schemas"]["HiddenField"][];
+        };
+        /**
+         * MultipleChoiceOptionPayload
+         *
+         * Payload for MULTIPLE_CHOICE_OPTION block type. Used for single-select
+         * radio questions.
+         */
+        MultipleChoiceOptionPayload: {
+            isHidden?: components["schemas"]["IsHidden"];
+            isRequired?: components["schemas"]["IsRequired"];
+            hasDefaultAnswer?: components["schemas"]["HasDefaultAnswer"];
+            defaultAnswer?: components["schemas"]["DefaultAnswerString"];
+            index: components["schemas"]["OptionIndex"];
+            isFirst: components["schemas"]["IsFirstOption"];
+            isLast: components["schemas"]["IsLastOption"];
+            allowMultiple?: components["schemas"]["AllowMultiple"];
+            hasMinChoices?: components["schemas"]["HasMinChoices"];
+            minChoices?: components["schemas"]["MinChoices"];
+            hasMaxChoices?: components["schemas"]["HasMaxChoices"];
+            maxChoices?: components["schemas"]["MaxChoices"];
+            colorCodeOptions?: components["schemas"]["ColorCodeOptions"];
+            color?: components["schemas"]["OptionColor"];
+            /**
+             * Enable option badges (numbers or letters). Only needs to be set on the
+             * first option in the group.
+             */
+            hasBadge?: boolean;
+            /**
+             * Badge display type. Only needs to be set on the first option in the
+             * group.
+             *
+             * @enum {string}
+             */
+            badgeType?: "OFF" | "NUMBERS" | "LETTERS";
+            /** True if the question group has an 'Other' option enabled. */
+            hasOtherOption?: boolean;
+            /** True if this specific option is the 'Other' free-text field. */
+            isOtherOption?: boolean;
+            /**
+             * Randomize option order. Only needs to be set on the first option in the
+             * group.
+             */
+            randomize?: boolean;
+            /**
+             * Array of option UUIDs that should stay in their original position when
+             * randomize is enabled. Only needs to be set on the first option in the
+             * group.
+             */
+            lockInPlace?: string[];
+            /** URL of an image to display alongside the option. */
+            image?: string;
+            name?: components["schemas"]["Name"];
+            /** The display text of the option. */
+            text?: string;
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+        };
+        /**
+         * CheckboxPayload
+         *
+         * Payload for CHECKBOX block type. Used for individual checkbox options
+         * within a checkbox group.
+         */
+        CheckboxPayload: {
+            isHidden?: components["schemas"]["IsHidden"];
+            isRequired?: components["schemas"]["IsRequired"];
+            hasDefaultAnswer?: components["schemas"]["HasDefaultAnswer"];
+            defaultAnswer?: components["schemas"]["DefaultAnswerString"];
+            index: components["schemas"]["OptionIndex"];
+            isFirst: components["schemas"]["IsFirstOption"];
+            isLast: components["schemas"]["IsLastOption"];
+            /**
+             * Format: uri
+             *
+             * URL of an image displayed alongside this checkbox option.
+             */
+            image?: string;
+            hasMinChoices?: components["schemas"]["HasMinChoices"];
+            minChoices?: components["schemas"]["MinChoices"];
+            hasMaxChoices?: components["schemas"]["HasMaxChoices"];
+            maxChoices?: components["schemas"]["MaxChoices"];
+            /** True if the question group has an 'Other' option enabled. */
+            hasOtherOption?: boolean;
+            /** True if this specific option is the 'Other' free-text field. */
+            isOtherOption?: boolean;
+            /**
+             * Randomize option order. Only needs to be set on the first option in the
+             * group.
+             */
+            randomize?: boolean;
+            /**
+             * Array of option UUIDs that stay in their original position when
+             * randomize is enabled.
+             */
+            lockInPlace?: string[];
+            name?: components["schemas"]["Name"];
+            /** The display text of the checkbox option. */
+            text?: string;
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+        };
+        /**
+         * DropdownOptionPayload
+         *
+         * Payload for DROPDOWN_OPTION block type. Used for dropdown select
+         * questions.
+         */
+        DropdownOptionPayload: {
+            isHidden?: components["schemas"]["IsHidden"];
+            isRequired?: components["schemas"]["IsRequired"];
+            hasDefaultAnswer?: components["schemas"]["HasDefaultAnswer"];
+            defaultAnswer?: components["schemas"]["DefaultAnswerString"];
+            placeholder?: string;
+            index: components["schemas"]["OptionIndex"];
+            isFirst: components["schemas"]["IsFirstOption"];
+            isLast: components["schemas"]["IsLastOption"];
+            allowMultiple?: components["schemas"]["AllowMultiple"];
+            hasMinChoices?: components["schemas"]["HasMinChoices"];
+            minChoices?: components["schemas"]["MinChoices"];
+            hasMaxChoices?: components["schemas"]["HasMaxChoices"];
+            maxChoices?: components["schemas"]["MaxChoices"];
+            /** True if the question group has an 'Other' option enabled. */
+            hasOtherOption?: boolean;
+            /** True if this specific option is the 'Other' free-text field. */
+            isOtherOption?: boolean;
+            /**
+             * Randomize option order. Only needs to be set on the first option in the
+             * group.
+             */
+            randomize?: boolean;
+            /**
+             * Array of option UUIDs that should stay in their original position when
+             * randomize is enabled. Only needs to be set on the first option in the
+             * group.
+             */
+            lockInPlace?: string[];
+            name?: components["schemas"]["Name"];
+            /** The display text of the dropdown option. */
+            text?: string;
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+        };
+        /**
+         * RankingOptionPayload
+         *
+         * Payload for RANKING_OPTION block type. Used for ranking/ordering
+         * questions.
+         */
+        RankingOptionPayload: {
+            isHidden?: components["schemas"]["IsHidden"];
+            isRequired?: components["schemas"]["IsRequired"];
+            hasDefaultAnswer?: components["schemas"]["HasDefaultAnswer"];
+            defaultAnswer?: components["schemas"]["DefaultAnswerString"];
+            index: components["schemas"]["OptionIndex"];
+            isFirst: components["schemas"]["IsFirstOption"];
+            isLast: components["schemas"]["IsLastOption"];
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+            name?: components["schemas"]["Name"];
+            html?: components["schemas"]["Html"];
+            /** The text of the ranking option. */
+            text?: string;
+            /** The image of the ranking option. */
+            image?: string;
+            /**
+             * Whether to randomize the ranking options. Only needs to be set on the
+             * first option in the group.
+             */
+            randomize?: boolean;
+            /**
+             * Array of option UUIDs that should stay in their original position when
+             * randomize is enabled. Only needs to be set on the first option in the
+             * group.
+             */
+            lockInPlace?: string[];
+        };
+        /**
+         * MultiSelectOptionPayload
+         *
+         * Payload for MULTI_SELECT_OPTION block type. Used for multi-select
+         * checkbox questions.
+         */
+        MultiSelectOptionPayload: {
+            isHidden?: components["schemas"]["IsHidden"];
+            isRequired?: components["schemas"]["IsRequired"];
+            hasDefaultAnswer?: components["schemas"]["HasDefaultAnswer"];
+            defaultAnswer?: components["schemas"]["DefaultAnswerString"];
+            index: components["schemas"]["OptionIndex"];
+            isFirst: components["schemas"]["IsFirstOption"];
+            isLast: components["schemas"]["IsLastOption"];
+            color?: components["schemas"]["OptionColor"];
+            /** True if the question group has an 'Other' option enabled. */
+            hasOtherOption?: boolean;
+            /** True if this specific option is the 'Other' free-text field. */
+            isOtherOption?: boolean;
+            /**
+             * Randomize option order. Only needs to be set on the first option in the
+             * group.
+             */
+            randomize?: boolean;
+            /**
+             * Array of option UUIDs that should stay in their original position when
+             * randomize is enabled. Only needs to be set on the first option in the
+             * group.
+             */
+            lockInPlace?: string[];
+            hasMinChoices?: components["schemas"]["HasMinChoices"];
+            minChoices?: components["schemas"]["MinChoices"];
+            hasMaxChoices?: components["schemas"]["HasMaxChoices"];
+            maxChoices?: components["schemas"]["MaxChoices"];
+            /** Display text for this option. */
+            text?: string;
+            /** Placeholder text for the 'Other' option input field. */
+            placeholder?: string;
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+            name?: components["schemas"]["Name"];
+        };
+        /**
+         * PaymentPayload
+         *
+         * Payload for PAYMENT block type. Used for payment collection.
+         */
+        PaymentPayload: {
+            isHidden?: components["schemas"]["IsHidden"];
+            isRequired?: components["schemas"]["IsRequired"];
+            /**
+             * Payment amount. Can be a fixed number or a Field reference for dynamic
+             * pricing based on another form field's value.
+             */
+            amount?: number | components["schemas"]["Field"];
+            currency: components["schemas"]["Currency"];
+            /**
+             * True once the payment block is connected to a payment provider (e.g.,
+             * Stripe).
+             */
+            isConfigured: boolean;
+            /** Format: uuid */
+            stateUuid?: string;
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+            name?: components["schemas"]["Name"];
+        };
+        /**
+         * SignaturePayload
+         *
+         * Payload for SIGNATURE block type. Used for signature collection.
+         */
+        SignaturePayload: {
+            isHidden?: components["schemas"]["IsHidden"];
+            isRequired?: components["schemas"]["IsRequired"];
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+            name?: components["schemas"]["Name"];
+            /** Custom label text displayed below the signature pad. */
+            label?: string;
+        };
+        /**
+         * MatrixRowPayload
+         *
+         * Payload for MATRIX_ROW block type. Used for matrix question rows.
+         */
+        MatrixRowPayload: {
+            isHidden?: components["schemas"]["IsHidden"];
+            isRequired?: components["schemas"]["IsRequired"];
+            index: components["schemas"]["OptionIndex"];
+            isFirst: components["schemas"]["IsFirstOption"];
+            isLast: components["schemas"]["IsLastOption"];
+            /** True if respondents can select multiple columns per row. */
+            allowMultiple?: boolean;
+            /** True if the matrix rows are shown in random order. */
+            randomizeRows?: boolean;
+            name?: components["schemas"]["Name"];
+            html?: components["schemas"]["Html"];
+            /** Display text for this matrix row. */
+            text?: string;
+        };
+        /**
+         * MatrixColumnPayload
+         *
+         * Payload for MATRIX_COLUMN block type. Used for matrix question columns.
+         */
+        MatrixColumnPayload: {
+            isHidden?: components["schemas"]["IsHidden"];
+            isRequired?: components["schemas"]["IsRequired"];
+            index: components["schemas"]["OptionIndex"];
+            isFirst: components["schemas"]["IsFirstOption"];
+            isLast: components["schemas"]["IsLastOption"];
+            /** True if respondents can select multiple columns per row. */
+            allowMultiple?: boolean;
+            /** True if the matrix rows are shown in random order. */
+            randomizeRows?: boolean;
+            name?: components["schemas"]["Name"];
+            html?: components["schemas"]["Html"];
+            /** Display text for this matrix column. */
+            text?: string;
+        };
+        /**
+         * ConditionalLogicPayload
+         *
+         * Payload for CONDITIONAL_LOGIC block type. Used for form logic and
+         * branching.
+         */
+        ConditionalLogicPayload: {
+            /** Conditions that must be satisfied before actions run. */
+            conditionals: components["schemas"]["Conditional"][];
+            /** Actions executed when conditions are satisfied. */
+            actions: components["schemas"]["ConditionalAction"][];
+            /**
+             * How to combine top-level conditions (AND/OR).
+             *
+             * @enum {string}
+             */
+            logicalOperator: "AND" | "OR";
+            /**
+             * Format: uuid
+             *
+             * UUID of the logic block being updated; null when creating.
+             */
+            updateUuid?: string | null;
+        };
+        /**
+         * CalculatedFieldsPayload
+         *
+         * Payload for CALCULATED_FIELDS block type. Used for computed/calculated
+         * values.
+         */
+        CalculatedFieldsPayload: {
+            calculatedFields: components["schemas"]["CalculatedField"][];
+        };
+        /**
+         * CaptchaPayload
+         *
+         * Payload for CAPTCHA block type. Used for bot protection.
+         */
+        CaptchaPayload: {
+            columnListUuid?: components["schemas"]["ColumnListUuid"];
+            columnUuid?: components["schemas"]["ColumnUuid"];
+            columnRatio?: components["schemas"]["ColumnRatio"];
+        };
+        /**
+         * RespondentCountryPayload
+         *
+         * Payload for RESPONDENT_COUNTRY block type. Used for capturing respondent
+         * location.
+         */
+        RespondentCountryPayload: Record<string, never>;
+        /**
+         * The width percentage of a column within a column layout row. Valid values
+         * range from 10 to 90, where the sum of all column ratios in a row should
+         * equal 100.
+         */
+        ColumnRatio: number;
+        /**
+         * Format: uuid
+         *
+         * Groups blocks into a column layout row. Blocks sharing the same
+         * columnListUuid are displayed side-by-side.
+         */
+        ColumnListUuid: string;
+        /**
+         * Format: uuid
+         *
+         * Identifies which column within a row this block belongs to. Blocks with
+         * the same columnUuid stack vertically within that column.
+         */
+        ColumnUuid: string;
+        /**
+         * FormTitleBlock
+         *
+         * A block with type FORM_TITLE. Used for the main form title with optional
+         * logo and cover image.
+         */
+        FormTitleBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "FORM_TITLE";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "FORM_TITLE" | "TEXT";
+            payload: components["schemas"]["FormTitlePayload"];
+        };
+        /**
+         * TitleBlock
+         *
+         * A block with type TITLE. Used for section titles within the form.
+         */
+        TitleBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "TITLE";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "TITLE" | "QUESTION";
+            payload: components["schemas"]["TitlePayload"];
+        };
+        /**
+         * TextBlock
+         *
+         * A block with type TEXT. Used for rich text content within the form.
+         */
+        TextBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "TEXT";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "TEXT" | "PAGE_BREAK" | "DIVIDER";
+            payload: components["schemas"]["TextPayload"];
+        };
+        /**
+         * LabelBlock
+         *
+         * A block with type LABEL. Used for form field labels.
+         */
+        LabelBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "LABEL";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "LABEL";
+            payload: components["schemas"]["LabelPayload"];
+        };
+        /**
+         * Heading1Block
+         *
+         * A block with type HEADING_1. Used for large headings.
+         */
+        Heading1Block: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "HEADING_1";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "HEADING_1";
+            payload: components["schemas"]["Heading1Payload"];
+        };
+        /**
+         * Heading2Block
+         *
+         * A block with type HEADING_2. Used for medium headings.
+         */
+        Heading2Block: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "HEADING_2";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "HEADING_2";
+            payload: components["schemas"]["Heading2Payload"];
+        };
+        /**
+         * Heading3Block
+         *
+         * A block with type HEADING_3. Used for small headings.
+         */
+        Heading3Block: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "HEADING_3";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "HEADING_3";
+            payload: components["schemas"]["Heading3Payload"];
+        };
+        /**
+         * ImageBlock
+         *
+         * A block with type IMAGE. Used for displaying images in the form.
+         */
+        ImageBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "IMAGE";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "IMAGE";
+            payload: components["schemas"]["ImagePayload"];
+        };
+        /**
+         * EmbedBlock
+         *
+         * A block with type EMBED. Used for embedding external content.
+         */
+        EmbedBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "EMBED";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "EMBED";
+            payload: components["schemas"]["EmbedPayload"];
+        };
+        /**
+         * EmbedVideoBlock
+         *
+         * A block with type EMBED_VIDEO. Used for embedding video content.
+         */
+        EmbedVideoBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "EMBED_VIDEO";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "EMBED_VIDEO";
+            payload: components["schemas"]["EmbedVideoPayload"];
+        };
+        /**
+         * EmbedAudioBlock
+         *
+         * A block with type EMBED_AUDIO. Used for embedding audio content.
+         */
+        EmbedAudioBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "EMBED_AUDIO";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "EMBED_AUDIO";
+            payload: components["schemas"]["EmbedAudioPayload"];
+        };
+        /**
+         * DividerBlock
+         *
+         * A block with type DIVIDER. Used for visual separation between sections.
+         */
+        DividerBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "DIVIDER";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "DIVIDER";
+            payload: components["schemas"]["DividerPayload"];
+        };
+        /**
+         * PageBreakBlock
+         *
+         * A block with type PAGE_BREAK. Used for creating multi-page forms.
+         */
+        PageBreakBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "PAGE_BREAK";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "PAGE_BREAK";
+            payload: components["schemas"]["PageBreakPayload"];
+        };
+        /**
+         * InputTextBlock
+         *
+         * A block with type INPUT_TEXT. Used for single-line text input.
+         */
+        InputTextBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "INPUT_TEXT";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "INPUT_TEXT";
+            payload: components["schemas"]["InputTextPayload"];
+        };
+        /**
+         * TextareaBlock
+         *
+         * A block with type TEXTAREA. Used for multi-line text input.
+         */
+        TextareaBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "TEXTAREA";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "TEXTAREA";
+            payload: components["schemas"]["TextareaPayload"];
+        };
+        /**
+         * InputNumberBlock
+         *
+         * A block with type INPUT_NUMBER. Used for numeric input.
+         */
+        InputNumberBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "INPUT_NUMBER";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "INPUT_NUMBER";
+            payload: components["schemas"]["InputNumberPayload"];
+        };
+        /**
+         * InputEmailBlock
+         *
+         * A block with type INPUT_EMAIL. Used for email address input.
+         */
+        InputEmailBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "INPUT_EMAIL";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "INPUT_EMAIL";
+            payload: components["schemas"]["InputEmailPayload"];
+        };
+        /**
+         * InputLinkBlock
+         *
+         * A block with type INPUT_LINK. Used for URL input.
+         */
+        InputLinkBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "INPUT_LINK";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "INPUT_LINK";
+            payload: components["schemas"]["InputLinkPayload"];
+        };
+        /**
+         * InputPhoneNumberBlock
+         *
+         * A block with type INPUT_PHONE_NUMBER. Used for phone number input.
+         */
+        InputPhoneNumberBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "INPUT_PHONE_NUMBER";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "INPUT_PHONE_NUMBER";
+            payload: components["schemas"]["InputPhoneNumberPayload"];
+        };
+        /**
+         * InputDateBlock
+         *
+         * A block with type INPUT_DATE. Used for date selection.
+         */
+        InputDateBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "INPUT_DATE";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "INPUT_DATE";
+            payload: components["schemas"]["InputDatePayload"];
+        };
+        /**
+         * InputTimeBlock
+         *
+         * A block with type INPUT_TIME. Used for time selection.
+         */
+        InputTimeBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "INPUT_TIME";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "INPUT_TIME";
+            payload: components["schemas"]["InputTimePayload"];
+        };
+        /**
+         * MultipleChoiceOptionBlock
+         *
+         * A block with type MULTIPLE_CHOICE_OPTION. Individual option within a
+         * multiple choice question.
+         */
+        MultipleChoiceOptionBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "MULTIPLE_CHOICE_OPTION";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "MULTIPLE_CHOICE";
+            payload: components["schemas"]["MultipleChoiceOptionPayload"];
+        };
+        /**
+         * CheckboxBlock
+         *
+         * A block with type CHECKBOX. Individual checkbox option within a
+         * checkboxes group.
+         */
+        CheckboxBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "CHECKBOX";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "CHECKBOXES";
+            payload: components["schemas"]["CheckboxPayload"];
+        };
+        /**
+         * DropdownOptionBlock
+         *
+         * A block with type DROPDOWN_OPTION. Individual option within a dropdown.
+         */
+        DropdownOptionBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "DROPDOWN_OPTION";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "DROPDOWN";
+            payload: components["schemas"]["DropdownOptionPayload"];
+        };
+        /**
+         * RankingOptionBlock
+         *
+         * A block with type RANKING_OPTION. Individual option within a ranking
+         * question.
+         */
+        RankingOptionBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "RANKING_OPTION";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "RANKING";
+            payload: components["schemas"]["RankingOptionPayload"];
+        };
+        /**
+         * MultiSelectOptionBlock
+         *
+         * A block with type MULTI_SELECT_OPTION. Individual option within a
+         * multi-select dropdown.
+         */
+        MultiSelectOptionBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "MULTI_SELECT_OPTION";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "MULTI_SELECT";
+            payload: components["schemas"]["MultiSelectOptionPayload"];
+        };
+        /**
+         * LinearScaleBlock
+         *
+         * A block with type LINEAR_SCALE. Used for numeric scale ratings (e.g.,
+         * 1-10).
+         */
+        LinearScaleBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "LINEAR_SCALE";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "LINEAR_SCALE";
+            payload: components["schemas"]["LinearScalePayload"];
+        };
+        /**
+         * RatingBlock
+         *
+         * A block with type RATING. Used for star/emoji ratings.
+         */
+        RatingBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "RATING";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "RATING";
+            payload: components["schemas"]["RatingPayload"];
+        };
+        /**
+         * MatrixBlock
+         *
+         * A block with type MATRIX. Container for matrix/grid questions.
+         */
+        MatrixBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "MATRIX";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "MATRIX";
+            payload: components["schemas"]["MatrixPayload"];
+        };
+        /**
+         * MatrixRowBlock
+         *
+         * A block with type MATRIX_ROW. Row within a matrix question.
+         */
+        MatrixRowBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "MATRIX_ROW";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "MATRIX";
+            payload: components["schemas"]["MatrixRowPayload"];
+        };
+        /**
+         * MatrixColumnBlock
+         *
+         * A block with type MATRIX_COLUMN. Column within a matrix question.
+         */
+        MatrixColumnBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "MATRIX_COLUMN";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "MATRIX";
+            payload: components["schemas"]["MatrixColumnPayload"];
+        };
+        /**
+         * FileUploadBlock
+         *
+         * A block with type FILE_UPLOAD. Used for file upload input.
+         */
+        FileUploadBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "FILE_UPLOAD";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "FILE_UPLOAD";
+            payload: components["schemas"]["FileUploadPayload"];
+        };
+        /**
+         * SignatureBlock
+         *
+         * A block with type SIGNATURE. Used for capturing signatures.
+         */
+        SignatureBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "SIGNATURE";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "SIGNATURE";
+            payload: components["schemas"]["SignaturePayload"];
+        };
+        /**
+         * PaymentBlock
+         *
+         * A block with type PAYMENT. Used for payment collection.
+         */
+        PaymentBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "PAYMENT";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "PAYMENT";
+            payload: components["schemas"]["PaymentPayload"];
+        };
+        /**
+         * HiddenFieldsBlock
+         *
+         * A block with type HIDDEN_FIELDS. Used for hidden form fields.
+         */
+        HiddenFieldsBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "HIDDEN_FIELDS";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "HIDDEN_FIELDS";
+            payload: components["schemas"]["HiddenFieldsPayload"];
+        };
+        /**
+         * ConditionalLogicBlock
+         *
+         * A block with type CONDITIONAL_LOGIC. Used for form branching logic.
+         */
+        ConditionalLogicBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "CONDITIONAL_LOGIC";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "CONDITIONAL_LOGIC";
+            payload: components["schemas"]["ConditionalLogicPayload"];
+        };
+        /**
+         * CalculatedFieldsBlock
+         *
+         * A block with type CALCULATED_FIELDS. Used for computed/calculated values.
+         */
+        CalculatedFieldsBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "CALCULATED_FIELDS";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "CALCULATED_FIELDS";
+            payload: components["schemas"]["CalculatedFieldsPayload"];
+        };
+        /**
+         * CaptchaBlock
+         *
+         * A block with type CAPTCHA. Used for bot protection.
+         */
+        CaptchaBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "CAPTCHA";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "CAPTCHA";
+            payload: components["schemas"]["CaptchaPayload"];
+        };
+        /**
+         * RespondentCountryBlock
+         *
+         * A block with type RESPONDENT_COUNTRY. Used for capturing respondent
+         * location.
+         */
+        RespondentCountryBlock: {
+            uuid: components["schemas"]["BlockUuid"];
+            /** @enum {string} */
+            type: "RESPONDENT_COUNTRY";
+            groupUuid: components["schemas"]["GroupUuid"];
+            /** @enum {string} */
+            groupType: "RESPONDENT_COUNTRY";
+            payload: components["schemas"]["RespondentCountryPayload"];
+        };
+        GetFormsResponse: {
+            items: components["schemas"]["Form"][];
+            /** Current page number */
+            page: number;
+            /** Number of items per page */
+            limit: number;
+            /** Total number of items */
+            total: number;
+            /** Whether there are more pages available */
+            hasMore: boolean;
+        };
+        PostFormsRequest: {
+            /**
+             * ID of the workspace to create the form in. If not provided, uses the
+             * user's default workspace
+             */
+            workspaceId?: string;
+            /** ID of the template to base the form on */
+            templateId?: string;
+            /**
+             * ID of the folder to place the form in. Must belong to the target
+             * workspace.
+             */
+            folderId?: string;
+            /** Initial status of the form */
+            status: components["schemas"]["FormStatus"];
+            blocks: components["schemas"]["Block"][];
+            settings?: components["schemas"]["FormSettings"];
+        };
+        PostFormsResponse: components["schemas"]["Form"];
+        GetFormsFormIdResponse: components["schemas"]["Form"] & {
+            settings?: components["schemas"]["FormSettings"];
+            blocks?: components["schemas"]["Block"][];
+        };
+        PatchFormsFormIdRequest: {
+            /** New name for the form */
+            name?: string;
+            /** New status for the form */
+            status?: components["schemas"]["FormStatus"];
+            /** Updated blocks for the form */
+            blocks?: components["schemas"]["Block"][];
+            /** Updated settings for the form */
+            settings?: components["schemas"]["FormSettings"];
+        };
+        PatchFormsFormIdResponse: components["schemas"]["Form"];
+        GetUsersMeResponse: {
+            subscriptionPlan?: string;
+        } & components["schemas"]["User"];
+        GetWorkspacesResponse: {
+            items: components["schemas"]["Workspace"][];
+            /** Current page number */
+            page: number;
+            /** Number of items per page */
+            limit: number;
+            /** Total number of items */
+            total: number;
+            /** Whether there are more pages available */
+            hasMore: boolean;
+        };
+        PostWorkspacesRequest: {
+            /** The name of the workspace */
+            name: string;
+        };
+        PostWorkspacesResponse: components["schemas"]["Workspace"];
+        GetWorkspacesWorkspaceIdResponse: components["schemas"]["Workspace"];
+        PatchWorkspacesWorkspaceIdRequest: {
+            /** The new name for the workspace */
+            name: string;
+        };
+        GetWorkspacesWorkspaceIdFoldersResponse: components["schemas"]["Folder"][];
+        PostWorkspacesWorkspaceIdFoldersRequest: {
+            /** The name of the folder */
+            name: string;
+            /** The ID of the parent folder to nest this folder under */
+            parentId?: string;
+        };
+        PostWorkspacesWorkspaceIdFoldersResponse: components["schemas"]["Folder"];
+        PatchWorkspacesWorkspaceIdFoldersIdRequest: {
+            /** The new name for the folder */
+            name: string;
+        };
+        GetOrganizationsOrganizationIdUsersResponse: components["schemas"]["User"][];
+        GetOrganizationsOrganizationIdInvitesResponse: {
+            id?: string;
+            organizationId?: string;
+            email?: string;
+            /** Format: date-time */
+            createdAt?: string;
+            /** Format: date-time */
+            updatedAt?: string;
+        }[];
+        PostOrganizationsOrganizationIdInvitesRequest: {
+            /** Array of workspace IDs to invite users to */
+            workspaceIds: string[];
+            /** Comma or semicolon separated list of email addresses to invite */
+            emails: string;
+        };
+        GetFormsFormIdQuestionsResponse: {
+            questions?: components["schemas"]["Question"][];
+            hasResponses?: boolean;
+        };
+        PatchFormsFormIdQuestionsQuestionIdRequest: {
+            /** The new title for the question */
+            title?: string;
+        };
+        PatchFormsFormIdQuestionsQuestionIdResponse: components["schemas"]["Question"];
+        GetFormsFormIdBlocksResponse: {
+            id?: string;
+            name?: string;
+            blocks?: components["schemas"]["Block"][];
+        };
+        PatchFormsFormIdBlocksRequest: {
+            blocks: components["schemas"]["Block"][];
+            settings?: components["schemas"]["FormSettings"] | null;
+        };
+        PatchFormsFormIdBlocksResponse: components["schemas"]["Block"];
+        GetFormsFormIdSubmissionsResponse: {
+            /** Current page number */
+            page?: number;
+            /** Number of submissions per page */
+            limit?: number;
+            /** Whether there are more pages available */
+            hasMore?: boolean;
+            totalNumberOfSubmissionsPerFilter?: {
+                /** Total number of all submissions */
+                all?: number;
+                /** Total number of completed submissions */
+                completed?: number;
+                /** Total number of partial submissions */
+                partial?: number;
+            };
+            /** List of form questions */
+            questions?: components["schemas"]["Question"][];
+            /** List of form submissions */
+            submissions?: {
+                /** Submission ID */
+                id?: string;
+                /** Form ID */
+                formId?: string;
+                /** Whether the submission is completed */
+                isCompleted?: boolean;
+                /**
+                 * Format: date-time
+                 *
+                 * When the submission was submitted
+                 */
+                submittedAt?: string;
+                /**
+                 * Format: uri
+                 *
+                 * Signed URL to view the submission in a browser. Includes an access
+                 * token, no expiry.
+                 */
+                previewUrl?: string;
+                /**
+                 * Format: uri
+                 *
+                 * Signed URL to download the submission as a PDF. Includes an access
+                 * token, no expiry.
+                 */
+                pdfUrl?: string;
+                /**
+                 * List of responses to form questions. Note: Only questions that have
+                 * been answered will appear in this array.
+                 */
+                responses?: {
+                    /** Response ID */
+                    id: string;
+                    /** Form ID */
+                    formId: string;
+                    /** Question ID */
+                    questionId: string;
+                    /** Respondent ID */
+                    respondentId: string;
+                    /** Submission ID */
+                    submissionId?: string | null;
+                    /**
+                     * Format: uuid
+                     *
+                     * Session UUID
+                     */
+                    sessionUuid: string;
+                    /**
+                     * The answer value for this question. Type varies based on question
+                     * type.
+                     */
+                    answer: (string | number | boolean | unknown[] | Record<string, never>) | null;
+                    /** Formatted answer (e.g., for number inputs with custom formatting) */
+                    formattedAnswer?: string;
+                    /**
+                     * Format: date-time
+                     *
+                     * When the response was created
+                     */
+                    createdAt: string;
+                    /**
+                     * Format: date-time
+                     *
+                     * When the response was last updated
+                     */
+                    updatedAt: string;
+                }[];
+            }[];
+        };
+        GetFormsFormIdSubmissionsSubmissionIdResponse: {
+            /** List of form questions with their fields */
+            questions?: components["schemas"]["Question"][];
+            /** The form submission with responses */
+            submission?: {
+                /** Submission ID */
+                id?: string;
+                /** Form ID */
+                formId?: string;
+                /** Whether the submission is completed */
+                isCompleted?: boolean;
+                /**
+                 * Format: date-time
+                 *
+                 * When the submission was submitted
+                 */
+                submittedAt?: string;
+                /**
+                 * Format: date-time
+                 *
+                 * When the submission was created
+                 */
+                createdAt?: string;
+                /**
+                 * Format: date-time
+                 *
+                 * When the submission was last updated
+                 */
+                updatedAt?: string;
+                /**
+                 * Format: uri
+                 *
+                 * Signed URL to view the submission in a browser. Includes an access
+                 * token, no expiry.
+                 */
+                previewUrl?: string;
+                /**
+                 * Format: uri
+                 *
+                 * Signed URL to download the submission as a PDF. Includes an access
+                 * token, no expiry.
+                 */
+                pdfUrl?: string;
+                /**
+                 * List of responses to form questions. Note: Only questions that have
+                 * been answered will appear in this array.
+                 */
+                responses?: {
+                    /** Response ID */
+                    id: string;
+                    /** Form ID */
+                    formId: string;
+                    /** Question ID */
+                    questionId: string;
+                    /** Respondent ID */
+                    respondentId: string;
+                    /** Submission ID */
+                    submissionId?: string | null;
+                    /**
+                     * Format: uuid
+                     *
+                     * Session UUID
+                     */
+                    sessionUuid: string;
+                    /**
+                     * The answer value for this question. Type varies based on question
+                     * type.
+                     */
+                    answer: (string | number | boolean | unknown[] | Record<string, never>) | null;
+                    /** Formatted answer (e.g., for number inputs with custom formatting) */
+                    formattedAnswer?: string;
+                    /**
+                     * Format: date-time
+                     *
+                     * When the response was created
+                     */
+                    createdAt: string;
+                    /**
+                     * Format: date-time
+                     *
+                     * When the response was last updated
+                     */
+                    updatedAt: string;
+                }[];
+            };
+        };
+        GetFormsFormIdAnalyticsMetricsResponse: {
+            visits?: number;
+            visitDuration?: number;
+            submissions?: number;
+            uniqueRespondents?: number;
+            totalViews?: number;
+            starts?: number;
+            completions?: number;
+            completionDuration?: number;
+            completionRate?: number;
+        };
+        GetFormsFormIdAnalyticsVisitsResponse: {
+            data?: {
+                [key: string]: {
+                    totalVisits?: number;
+                };
+            };
+            interval?: number;
+        };
+        GetFormsFormIdAnalyticsSubmissionsResponse: {
+            data?: {
+                [key: string]: {
+                    completed?: number;
+                    partial?: number;
+                };
+            };
+            interval?: number;
+        };
+        GetFormsFormIdAnalyticsDimensionsResponse: {
+            source?: {
+                [key: string]: number;
+            };
+            browser?: {
+                [key: string]: number;
+            };
+            os?: {
+                [key: string]: number;
+            };
+            device?: {
+                [key: string]: number;
+            };
+            country?: {
+                [key: string]: number;
+            };
+            city?: {
+                [key: string]: number;
+            };
+        };
+        GetFormsFormIdAnalyticsDropOffResponse: {
+            stats?: {
+                totalVisitors?: number;
+                formStarts?: number;
+                formCompletes?: number;
+                completionRate?: number;
+                completionTimeInSeconds?: number;
+                visitDurationInSeconds?: number;
+            };
+            /** Format: date-time */
+            dataAvailableSince?: string;
+            shouldShowDataCutoffNotice?: boolean;
+            data?: {
+                blockGroupUuid?: string;
+                views?: number;
+                startedViews?: number;
+                answers?: number;
+                drops?: number;
+                title?: string;
+                type?: string;
+                answerRate?: number;
+                dropRate?: number;
+                isRequired?: boolean;
+            }[];
+            hasConditionalLogic?: boolean;
+        } | null;
+        GetWebhooksResponse: {
+            /** List of webhooks */
+            webhooks?: {
+                /** Webhook ID */
+                id?: string;
+                /** Form ID the webhook is attached to */
+                formId?: string;
+                /** The webhook endpoint URL */
+                url?: string;
+                /** Secret used to sign webhook payloads */
+                signingSecret?: string | null;
+                /** Custom HTTP headers to include in webhook requests */
+                httpHeaders?: {
+                    /** Header name */
+                    name?: string;
+                    /** Header value */
+                    value?: string;
+                }[] | null;
+                /** Types of events this webhook subscribes to */
+                eventTypes?: components["schemas"]["EventType"][];
+                /** External subscriber identifier */
+                externalSubscriber?: string | null;
+                /** Whether the webhook is enabled */
+                isEnabled?: boolean;
+                /**
+                 * Format: date-time
+                 *
+                 * When the webhook was last synced
+                 */
+                lastSyncedAt?: string | null;
+                /**
+                 * Format: date-time
+                 *
+                 * When the webhook was created
+                 */
+                createdAt?: string;
+                /**
+                 * Format: date-time
+                 *
+                 * When the webhook was last updated
+                 */
+                updatedAt?: string;
+            }[];
+            /** Current page number */
+            page?: number;
+            /** Number of webhooks per page */
+            limit?: number;
+            /** Whether there are more pages available */
+            hasMore?: boolean;
+            /** Total number of webhooks */
+            totalCount?: number;
+        };
+        PostWebhooksRequest: {
+            /** The ID of the form to create the webhook for */
+            formId: string;
+            /** The URL to send webhook events to */
+            url: string;
+            /** Optional secret used to sign webhook payloads */
+            signingSecret?: string | null;
+            /** Optional custom HTTP headers to include in webhook requests */
+            httpHeaders?: {
+                /** The header name */
+                name: string;
+                /** The header value */
+                value: string;
+            }[] | null;
+            /** Types of events to receive */
+            eventTypes: components["schemas"]["EventType"][];
+            /** Optional identifier for the external subscriber */
+            externalSubscriber?: string;
+        };
+        PostWebhooksResponse: {
+            id?: string;
+            url?: string;
+            eventTypes?: components["schemas"]["EventType"][];
+            isEnabled?: boolean;
+            /** Format: date-time */
+            createdAt?: string;
+        };
+        PatchWebhooksWebhookIdRequest: {
+            /** The ID of the form the webhook is for */
+            formId: string;
+            /** The URL to send webhook events to */
+            url: string;
+            /** Optional secret used to sign webhook payloads */
+            signingSecret?: string | null;
+            /** Optional custom HTTP headers to include in webhook requests */
+            httpHeaders?: {
+                /** The header name */
+                name: string;
+                /** The header value */
+                value: string;
+            }[] | null;
+            /** Types of events to receive */
+            eventTypes: components["schemas"]["EventType"][];
+            /** Whether the webhook is enabled */
+            isEnabled: boolean;
+        };
+        GetWebhooksWebhookIdEventsResponse: {
+            /** Current page number */
+            page?: number;
+            /** Number of events per page (25) */
+            limit?: number;
+            /** Whether there are more pages available */
+            hasMore?: boolean;
+            /** Total number of webhook events */
+            totalNumberOfEvents?: number;
+            /** List of webhook events */
+            events?: {
+                /** Event ID */
+                id?: string;
+                /** Webhook ID */
+                webhookId?: string;
+                /** The URL the webhook was sent to */
+                webhookUrl?: string;
+                /**
+                 * Type of event
+                 *
+                 * @enum {string}
+                 */
+                eventType?: "FORM_RESPONSE";
+                /**
+                 * Delivery status of the webhook
+                 *
+                 * @enum {string}
+                 */
+                deliveryStatus?: "QUEUED" | "SUCCEEDED" | "FAILED" | "DROPPED";
+                /** HTTP status code returned by the webhook endpoint */
+                statusCode?: number | null;
+                /** Response body from the webhook endpoint */
+                response?: string | null;
+                /** Number of retry attempts */
+                retry?: number;
+                /** The webhook payload that was sent */
+                payload?: Record<string, never>;
+                /**
+                 * Format: date-time
+                 *
+                 * When the event was created
+                 */
+                createdAt?: string;
+                /**
+                 * Format: date-time
+                 *
+                 * When the event was last updated
+                 */
+                updatedAt?: string;
+            }[];
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}