@automate.ax/integration-contracts 0.146.0 → 0.147.0

package/src/tally/openapi-types.generated.ts

@@ -0,0 +1,2858 @@
+/* eslint-disable */
+/* oxlint-disable -- Generated from Tally's externally versioned OpenAPI document. */
+/**
+ * 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
+}