FieldGroup

  • autoAttach
    Type: boolean

    When true, this field group is automatically attached to new records in the target module.

  • boostId
    Type: string
    read-only

    Boost space internal record identification

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

    Creation timestamp

  • derivedFrom
    Type: integer

    ID of group from which this group has been derived - only for protected field groups

  • entities
    Type: array object[] · FieldGroup entity[]

    Entity attachment records describing which records and positions this field group is rendered in.

    • fieldGroupPositionId
      Type: integer
      required

      Positional slot ID that determines where the group appears within the entity layout.

    • module
      Type: string
      required

      Module name identifying the type of entity this field group is attached to (e.g. 'contact', 'custom-module-item').

    • entityId
      Type: integer

      Related entity id

    • position
      Type: string

      Field group position in this entity. Common values: tab, form, form-top, top-todolist, case-top, case-bottom, contract-top, contract-bottom; a value outside these falls back to the module default position (e.g. 'bottom', or 'tab' for stock items). Not an enum — any string may be returned.

    • spaceId
      Type: integer

      ID of the space this field group attachment is scoped to.

  • id
    Type: integer
    read-only

    Unique identifier - primary key

  • inputs
    Type: array object[] · Field[]

    Ordered list of fields belonging to this field group.

    • 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

    • 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.

    • 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).

  • inputSize
    Type: string

    Default layout width applied to each field inside this group (e.g. 'full', 'half').

  • module
    Type: string

    Module name this field group belongs to (e.g. 'contact', 'deal').

  • name
    Type: string

    Name of the Field Group.

  • protected
    Type: boolean

    Marks field group as system default - non-changeable

  • size
    Type: string

    Layout width of the field group in the UI (e.g. 'full', 'half').

  • static
    Type: string

    Static HTML/text content rendered inside the group; used for informational or decorative groups with no input fields.

  • systemName
    Type: string

    Group system name - if set (non-changeable) - only for protected field groups

  • table
    Type: string

    Specific table within the module this field group targets; used when a module has multiple tables.

  • weight
    Type: integer

    Ordering index controlling the display sequence of field groups; lower values appear first.