Field

  • actionId
    Type: integer

    The action to fire after the button click.

  • aiCreativity
    Type: string enum

    Controls the expressiveness of the language in the content. Only works if type=ai

    values
    • high
    • medium
    • low
  • aiFormatting
    Type: string enum

    Refers to the structural and visual organization of the content. Only works if type=ai

    values
    • text
    • formatted_text
    • bullets
    • numbered_list
  • aiLength
    Type: string enum

    Specifies the desired extent of the content. Only works if type=ai

    values
    • auto
    • word_or_two
    • sentence
    • few_sentences
    • paragraph
    • three_paragraphs
  • aiPrompt
    Type: string

    The Prompt field is a text parameter used to define the specific input for generating responses or actions in OpenAI's models. Only works if type=ai

  • aiType
    Type: string enum

    Specifies whether the AI field should be controlled automatically or manually.

    values
    • auto
    • manual
  • aiVoiceTone
    Type: string enum

    Determines the style and attitude of AI response. Only works if type=ai

    values
    • auto
    • professional
    • casual
    • straightforward
    • confident
    • friendly
    • humorous
    • inspirational
  • className
    Type: string

    Name of CSS class.

  • created
    Type: string Format: date-time
    read-only

    Creation timestamp

  • createdUserId
    Type: integer
    read-only

    ID of user who created this record

  • currencyId
    Type: integer

    ID of the currency used for the money input type.

  • description
    Type: string

    Description of input

  • fieldGroups
    Type: array integer[]

    IDs of the FieldGroup's this field belongs to, controlling where it is rendered.

  • id
    Type: integer
    read-only

    Unique identifier - primary key

  • inputCalculation
    Type: string

    Formula used to compute the field value. The value is evaluated at read time and is not stored; the resulting FieldValue is read-only. Syntax: reference other fields of the same record with FIELD("Field Name"), where the argument is the field's name (customFieldInputName) for custom fields, or the property name of a core column (e.g. FIELD("id"), FIELD("created")). String literals are written in double quotes ("text"), numbers as plain literals (42, 3.14), booleans as true/false. Operators: arithmetic + - * / % ^, comparison == != > < >= <=, logical && || !, parentheses for grouping. Functions are called as name(arg1, arg2, ...) and their names are case-insensitive. Available functions — arithmetic: sum, subtract, multiply, divide, mod, power, sqrt, abs, round, roundUp, roundDown, ceil, floor, average, max, min, count, countAll; logic: if, switch, and, or, not, xor, equals, greaterThan, lessThan, isEmpty, isNotEmpty, isError; text: concat, length, lower, upper, trim, contains, startsWith, endsWith, replace, substring, left, right, split, indexOf, regexMatch, regexExtract, regexReplace, format; date: now, today, dateAdd, dateSubtract, dateDiff, formatDate, year, month, day, weekday, isAfter, isBefore, workdays; array: arrayJoin, arrayUnique, arrayLength; conversion: toNumber, toString, toBoolean, toDate; record: field, recordId, createdAt, updatedAt, createdByUserId, createdByUserName. Example: if(FIELD("Deal Value") > 1000, concat("VIP: ", FIELD("Company")), "Standard"). Use POST /validate-calculation-function to check a formula before saving. Only works if type=calculation

  • inputOptions
    Type: array object[] · FieldOption[]

    In case of select or multiselect, set of options

    • color
      Type: string

      Accent color for this option displayed in the UI, in 6-digit HEX format (e.g. '#FF5733').

    • created
      Type: string Format: date-time
      read-only

      Creation timestamp

    • createdUserId
      Type: integer
      read-only

      ID of user who created this record

    • customFieldInputId
      Type: integer

      ID of parent field

    • id
      Type: integer
      read-only

      Unique identifier - primary key

    • label
      Type: string

      Label of this option

    • value
      Type: string

      Internal stored value for this option; use this value (not the label) when setting a field value of type select or multiselect.

  • inputType
    Type: string enum

    Type of input

    values
    • related_entity
    • related_entities
    • related_value
    • image
    • money
  • isLabel
    Type: string

    If true input is used as a label

  • name
    Type: string

    Name of the Input.

  • order=0
    Type: integer

    Display order of this field within its field group; lower values appear first.

  • percentUpTo100
    Type: boolean

    If true percent can be only 0 to 100.

  • property
    Type: string

    It is used for the field type related_value. It describes which entity property should be load.

  • provider
    Type: string enum

    AI provider used to generate the field value. Only works if type=ai

    values
    • platform
    • websearch
    • custom
  • providerId
    Type: integer

    ID of the provider configuration; used when provider=custom. Only works if type=ai

  • relatedCustomModuleId
    Type: integer

    ID of the custom module a related_entity/related_entities field links to. When null, the field's module column identifies the linked module.

  • relatedEntityCfId
    Type: string

    This is the link for the field type related_value, linking to a related_entity field. The related_value field uses this link to load a module and entity ID.

  • relatedEntityProperty
    Type: string

    Name of the related entity's property to load, used when the source is an entity property rather than a custom field.

  • relatedValueCounterpart
    Type: boolean

    This is an option for the field type related_entity that enables rendering the counterpart in the entity this field links to.

  • remotes
    Type: array object[] · Remote id[]

    IDs of remote integrations linked to this field.

    • id
      Type: string
      required

      Remote ID

    • application
      Type: string

      Remote Application

    • delete
      Type: boolean

      Delete Remote ID

  • required
    Type: boolean

    Whether filling out this field is required when submitting the form (true = required, false = optional).

  • rollupAggregation
    Type: string enum

    Aggregation function applied to the target field values of the linked records; the rollup's return type is derived from this aggregation and the target field's data type. Required for the rollup to compute. Only works if type=rollup

    values
    • showOriginal
    • showUnique
    • countAll
    • countValues
    • countUniqueValues
  • rollupRelationInputId
    Type: integer

    ID of the relation field the rollup follows to reach the linked records; must be a field of inputType related_entity or related_entities. Required for the rollup to compute. Only works if type=rollup

  • rollupTargetInputId
    Type: integer

    ID of the custom field on the linked records whose values get aggregated; must not be a rollup or calculation field. Required for the rollup to compute. Only works if type=rollup

  • spaces
    Type: array integer[]

    IDs of spaces this field's related_entity/related_value lookup is restricted to; empty means no restriction.

  • tooltip
    Type: string

    Content of tooltip.

  • translatable
    Type: boolean

    Is field translatable

  • visible
    Type: boolean

    Whether the field is visible (true = visible, false = hidden).