> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tesouro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# UnderwritingDynamicFieldSchema

> A node in the org-applicable dynamic field catalog. A CHOICE node's children are its mutually-exclusive variants, a GROUP node's children all apply, and a SCALAR node is a leaf holding a typed value.

`OBJECT`

A node in the org-applicable dynamic field catalog. A CHOICE node's children are its mutually-exclusive variants, a GROUP node's children all apply, and a SCALAR node is a leaf holding a typed value.

## Fields

<ResponseField name="children" type="[UnderwritingDynamicFieldSchema!]!" required>
  The child nodes of this node: a GROUP's children all apply, while a CHOICE's children are its
  mutually-exclusive variants. This single recursive resolver serves every level of the catalog
  tree.
</ResponseField>

<ResponseField name="id" type="UUID!" required>
  The unique identifier of the dynamic field schema node.
</ResponseField>

<ResponseField name="parentDynamicFieldSchemaId" type="UUID">
  The id of this node's parent schema node, or null for a root node. Lets clients reconstruct the
  catalog tree from a flat list of nodes.
</ResponseField>

<ResponseField name="key" type="String!" required>
  The stable, immutable machine key for this node, e.g. "business\_id".
</ResponseField>

<ResponseField name="label" type="String!" required>
  The display label for this node.
</ResponseField>

<ResponseField name="helperText" type="String">
  Optional helper text guiding the user when filling this field.
</ResponseField>

<ResponseField name="kind" type="UnderwritingDynamicFieldKind!" required>
  The structural kind of this node, determining how its value and child nodes are interpreted.

  <Expandable title="Possible enum values">
    <ResponseField name="CHOICE" type="enum">
      A container whose child nodes are mutually exclusive; exactly one variant is selected and only that variant's children apply.
    </ResponseField>

    <ResponseField name="GROUP" type="enum">
      A container whose child nodes all apply together.
    </ResponseField>

    <ResponseField name="SCALAR" type="enum">
      A leaf node holding a single typed value as described by its data type.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="isRequired" type="Boolean!" required>
  Whether a value for this node is required.
</ResponseField>

<ResponseField name="fieldType" type="UnderwritingDynamicFieldType">
  The UI control type of a SCALAR node, determining how it is rendered and how its value is interpreted.

  <Expandable title="Possible enum values">
    <ResponseField name="CHECKBOX" type="enum">
      A boolean checkbox for true/false or yes/no values.
    </ResponseField>

    <ResponseField name="CURRENCY" type="enum">
      A field whose value is a currency.
    </ResponseField>

    <ResponseField name="DATE_PICKER" type="enum">
      A date picker control for selecting a calendar date.
    </ResponseField>

    <ResponseField name="SELECT" type="enum">
      A dropdown control allowing selection of a single value from a predefined list.
    </ResponseField>

    <ResponseField name="TEXTAREA" type="enum">
      A multi-line text area for entering longer text values.
    </ResponseField>

    <ResponseField name="TEXT_FIELD" type="enum">
      A single-line text input field.
    </ResponseField>

    <ResponseField name="TEXT_FIELD_MASKED" type="enum">
      A single-line text input field where the value is masked for sensitive data such as SSN or account numbers.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="selectFieldOptions" type="[SelectFieldOption!]!" required>
  The selectable options for a SELECT field.

  <Expandable title="child attributes">
    <ResponseField name="label" type="String!" required>
      The human-readable label displayed for this option.
    </ResponseField>

    <ResponseField name="value" type="String!" required>
      The underlying value submitted when this option is selected.
    </ResponseField>
  </Expandable>
</ResponseField>