OpenAPI SpecificationJSON
API Reference

Schema

A schema object specifies the set of datapoints that are extracted from the annotation. For more information see Schema

Schema content consists of a list of section objects. Each section represents a logical part of the document, such as amounts or vendor info. Schema allows multiple sections, and there should be at least one section in the schema.

Rossum schema supports data fields with single values (datapoint), fields with multiple values (multivalue) or tuples of fields (tuple). At the topmost level, each schema consists of sections, which may either directly contain actual data fields (datapoints) or use nested multivalues and tuples as containers for single datapoints.

The supported shapes are:

  • simple: atomic datapoints of type number, string, date or enum
  • list: simple datapoint within a multivalue
  • tabular: simple datapoint within a "multivalue tuple" (a multivalue list containing a tuple for every row)

All schema objects use discriminators based on the 'category' field for proper type identification.

This resource supports ETag HTTP header handling. Use If-None-Match for conditional retrieval and If-Match for conditional updates and deletes.

Schema

Attribute
Type
Description
id
read-only
integer

ID of the schema.

name
string

Name of the schema (not visible in UI).

url
read-only
URL

URL of the schema.

queues
read-only
list[URL]

List of queues that use schema object.

metadata
object

Client data. May be used to store e.g. external system object IDs. See Metadata for more details.

Default: {}
modified_by
read-only
URL

User that last modified the object.

modified_at
read-only
datetime

Timestamp of last modification.

content
list[object]

Schema content: list of sections.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"section"
icon
string | null

The icon that appears on the left panel in the UI for a given section (not yet supported on UI).

children
list[object]

Specifies objects grouped under a given section. It may contain multivalue or datapoint objects.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"multivalue"
min_occurrences
integer | null

Minimum number of occurrences of nested objects. If condition of min_occurrences is violated corresponding fields should be manually reviewed. Minimum required value for the field is 0. If not specified, it is set to 0 by default.

min: 0Default: 0
max_occurrences
integer | null

Maximum number of occurrences of nested objects. All additional rows above max_occurrences are removed by extraction process. Minimum required value for the field is 1. If not specified, it is set to 1000 by default.

min: 1Default: 1000
show_grid_by_default
boolean

If set to true, the magic-grid is opened instead of footer upon entering the multivalue. Default false. Applied only in UI. Useful when annotating documents for custom training.

Default: false
rir_field_names
list[string]

List of names used to initialize content from the AI engine predictions. If specified, the value of the first field from the array is used, otherwise default name line_items is used. Attribute can be set only for multivalue containing objects with category tuple.

grid
object

Multivalue grid object allows to specify a row type for each row of the grid. Configure magic-grid feature properties.

row_types
list[string]

List of allowed row type values.

Default: ["data"]
default_row_type
string

Row type to be used by default.

Default: "data"
row_types_to_extract
list[string]

Types of rows to be extracted to related table.

Default: ["data"]
children
object

Object specifying type of children. It may contain only objects with categories tuple or datapoint.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"tuple"
rir_field_names
list[string]

List of names used to initialize content from the AI engine predictions. If specified, the value of the first extracted field from the array is used, otherwise, no AI engine initialization is done for the object.

children
list[object]

Array specifying objects that belong to a given tuple. It can contain only objects with category datapoint.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"number"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"date"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"enum"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options
list[object]

Options for enum datapoint.

value
string

Value of the option.

label
string

User-friendly label for the option, shown in the UI.

type
"button"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"number"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"date"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"enum"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options
list[object]

Options for enum datapoint.

value
string

Value of the option.

label
string

User-friendly label for the option, shown in the UI.

type
"button"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"number"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"date"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"enum"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options
list[object]

Options for enum datapoint.

value
string

Value of the option.

label
string

User-friendly label for the option, shown in the UI.

type
"button"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

List schemas

Retrieve all schema objects.

GET
/api/v1/schemas
curl -X GET "https://example.rossum.app/api/v1/schemas?id=1%2C2%2C3&queue=1%2C2%2C3"
{
  "pagination": {
    "total": 1,
    "total_pages": 1,
    "next": null,
    "previous": null
  },
  "results": [
    {
      "id": 31336,
      "name": "Basic Schema",
      "url": "https://example.rossum.app/api/v1/schemas/31336",
      "queues": [
        "https://example.rossum.app/api/v1/queues/8236"
      ],
      "metadata": {
        "some_key": "some_value"
      },
      "modified_by": "https://example.rossum.app/api/v1/users/10775",
      "modified_at": "2021-04-26T10:08:03.856648Z",
      "content": [
        {
          "category": "section",
          "id": "invoice_info_section",
          "label": "Basic information",
          "icon": null,
          "children": [
            {
              "category": "datapoint",
              "id": "document_id",
              "label": "Invoice number",
              "type": "string",
              "rir_field_names": [
                "document_id"
              ],
              "constraints": {
                "required": false
              },
              "default_value": null
            },
            {
              "category": "datapoint",
              "id": "date_issue",
              "label": "Issue date",
              "type": "date",
              "format": "YYYY-MM-DD",
              "rir_field_names": [
                "date_issue"
              ],
              "constraints": {
                "required": false
              },
              "default_value": null
            },
            {
              "category": "datapoint",
              "id": "document_type",
              "label": "Document type",
              "type": "enum",
              "options": [
                {
                  "label": "Invoice Received",
                  "value": "21"
                },
                {
                  "label": "Invoice Sent",
                  "value": "22"
                },
                {
                  "label": "Receipt",
                  "value": "23"
                }
              ],
              "enum_value_type": "number",
              "default_value": "21",
              "rir_field_names": []
            }
          ]
        },
        {
          "category": "section",
          "id": "line_items_section",
          "label": "Line items",
          "icon": null,
          "children": [
            {
              "category": "multivalue",
              "id": "line_items",
              "label": "Line items",
              "min_occurrences": null,
              "max_occurrences": null,
              "rir_field_names": [
                "line_items"
              ],
              "children": {
                "category": "tuple",
                "id": "line_item",
                "label": "Line item",
                "children": [
                  {
                    "category": "datapoint",
                    "id": "item_desc",
                    "label": "Description",
                    "type": "string",
                    "rir_field_names": [
                      "table_column_description"
                    ],
                    "constraints": {
                      "required": true
                    },
                    "stretch": true
                  },
                  {
                    "category": "datapoint",
                    "id": "item_quantity",
                    "label": "Quantity",
                    "type": "number",
                    "format": "# ##0.#",
                    "rir_field_names": [
                      "table_column_quantity"
                    ],
                    "constraints": {
                      "required": false
                    },
                    "width": 15
                  },
                  {
                    "category": "datapoint",
                    "id": "item_amount_total",
                    "label": "Price w tax",
                    "type": "number",
                    "format": "# ##0.#",
                    "rir_field_names": [
                      "table_column_amount_total"
                    ],
                    "constraints": {
                      "required": false
                    },
                    "aggregations": {
                      "sum": {
                        "label": "Total"
                      }
                    }
                  }
                ]
              }
            }
          ]
        },
        {
          "category": "section",
          "id": "tax_details_section",
          "label": "Tax details",
          "icon": null,
          "children": [
            {
              "category": "multivalue",
              "id": "tax_details",
              "label": "Tax details",
              "min_occurrences": null,
              "max_occurrences": null,
              "rir_field_names": [
                "tax_details"
              ],
              "children": {
                "category": "tuple",
                "id": "tax_detail",
                "label": "Tax detail",
                "children": [
                  {
                    "category": "datapoint",
                    "id": "tax_detail_rate",
                    "label": "Tax rate",
                    "type": "number",
                    "format": "# ##0.#",
                    "rir_field_names": [
                      "tax_detail_rate"
                    ],
                    "constraints": {
                      "required": false
                    },
                    "width": 15
                  },
                  {
                    "category": "datapoint",
                    "id": "tax_detail_base",
                    "label": "Tax base",
                    "type": "number",
                    "format": "# ##0.#",
                    "rir_field_names": [
                      "tax_detail_base"
                    ],
                    "constraints": {
                      "required": false
                    }
                  },
                  {
                    "category": "datapoint",
                    "id": "tax_detail_tax",
                    "label": "Tax amount",
                    "type": "number",
                    "format": "# ##0.#",
                    "rir_field_names": [
                      "tax_detail_tax"
                    ],
                    "constraints": {
                      "required": false
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  ]
}
{
  "detail": "Bad Request.",
  "code": "bad_request"
}
{
  "detail": "Invalid token.",
  "code": "authentication_failed"
}
{
  "detail": "Access to the requested resource is forbidden.",
  "code": "access_forbidden"
}
{
  "detail": "Not found.",
  "code": "not_found"
}
{
  "detail": "Conflict.",
  "code": "conflict_status"
}
{
  "detail": "Request was rate limited.",
  "code": "rate_limited",
  "url": "https://rossum.app/api/docs/openapi/guides/overview/#rate-limiting"
}
{
  "detail": "Server error.",
  "code": "error"
}
{
  "detail": "Bad Gateway.",
  "code": "bad_gateway"
}
{
  "detail": "Service Unavailable.",
  "code": "service_unavailable"
}
{
  "detail": "Gateway timeout.",
  "code": "gateway_timeout"
}

Response

200OK

OK

Attribute
Type
Description
pagination
pagination
total
integer

Total number of items.

total_pages
integer

Total number of pages.

next
URL

URL for the next page of results.

previous
URL

URL for the previous page of results.

results
id
read-only
integer

ID of the schema.

name
string

Name of the schema (not visible in UI).

url
read-only
URL

URL of the schema.

queues
read-only
list[URL]

List of queues that use schema object.

metadata
object

Client data. May be used to store e.g. external system object IDs. See Metadata for more details.

Default: {}
modified_by
read-only
URL

User that last modified the object.

modified_at
read-only
datetime

Timestamp of last modification.

content
list[object]

Schema content: list of sections.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"section"
icon
string | null

The icon that appears on the left panel in the UI for a given section (not yet supported on UI).

children
list[object]

Specifies objects grouped under a given section. It may contain multivalue or datapoint objects.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"multivalue"
min_occurrences
integer | null

Minimum number of occurrences of nested objects. If condition of min_occurrences is violated corresponding fields should be manually reviewed. Minimum required value for the field is 0. If not specified, it is set to 0 by default.

min: 0Default: 0
max_occurrences
integer | null

Maximum number of occurrences of nested objects. All additional rows above max_occurrences are removed by extraction process. Minimum required value for the field is 1. If not specified, it is set to 1000 by default.

min: 1Default: 1000
show_grid_by_default
boolean

If set to true, the magic-grid is opened instead of footer upon entering the multivalue. Default false. Applied only in UI. Useful when annotating documents for custom training.

Default: false
rir_field_names
list[string]

List of names used to initialize content from the AI engine predictions. If specified, the value of the first field from the array is used, otherwise default name line_items is used. Attribute can be set only for multivalue containing objects with category tuple.

grid
object

Multivalue grid object allows to specify a row type for each row of the grid. Configure magic-grid feature properties.

row_types
list[string]

List of allowed row type values.

Default: ["data"]
default_row_type
string

Row type to be used by default.

Default: "data"
row_types_to_extract
list[string]

Types of rows to be extracted to related table.

Default: ["data"]
children
object

Object specifying type of children. It may contain only objects with categories tuple or datapoint.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"tuple"
rir_field_names
list[string]

List of names used to initialize content from the AI engine predictions. If specified, the value of the first extracted field from the array is used, otherwise, no AI engine initialization is done for the object.

children
list[object]

Array specifying objects that belong to a given tuple. It can contain only objects with category datapoint.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"number"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"date"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"enum"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options
list[object]

Options for enum datapoint.

value
string

Value of the option.

label
string

User-friendly label for the option, shown in the UI.

type
"button"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"number"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"date"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"enum"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options
list[object]

Options for enum datapoint.

value
string

Value of the option.

label
string

User-friendly label for the option, shown in the UI.

type
"button"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"number"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"date"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"enum"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options
list[object]

Options for enum datapoint.

value
string

Value of the option.

label
string

User-friendly label for the option, shown in the UI.

type
"button"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

400Bad Request

Invalid input data.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

401Unauthorized

The username/password is invalid or token is invalid (e.g. expired).

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

403Forbidden

Insufficient permission, missing authentication, invalid CSRF token and similar issue.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

404Not Found

The specified resource was not found.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

409Conflict

Conflict

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

429Too Many Requests

Request rate is too high, wait before sending more requests. See Rate Limiting for more details.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

url
read-only
string

Link to the rate limiting documentation

500Internal Server Error

Server failure while processing the request.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

502Bad Gateway

Invalid response from the upstream server.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

503Service Unavailable

We're temporarily offline for maintenance. Please try again later.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

504

Upstream server could not complete the request in time.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

Create schema

Create a new schema object.

POST
/api/v1/schemas
curl -X POST "https://example.rossum.app/api/v1/schemas" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": 31336,
  "name": "Basic Schema",
  "url": "https://example.rossum.app/api/v1/schemas/31336",
  "queues": [
    "https://example.rossum.app/api/v1/queues/8236"
  ],
  "metadata": {
    "some_key": "some_value"
  },
  "modified_by": "https://example.rossum.app/api/v1/users/10775",
  "modified_at": "2021-04-26T10:08:03.856648Z",
  "content": [
    {
      "category": "section",
      "id": "invoice_info_section",
      "label": "Basic information",
      "icon": null,
      "children": [
        {
          "category": "datapoint",
          "id": "document_id",
          "label": "Invoice number",
          "type": "string",
          "rir_field_names": [
            "document_id"
          ],
          "constraints": {
            "required": false
          },
          "default_value": null
        },
        {
          "category": "datapoint",
          "id": "date_issue",
          "label": "Issue date",
          "type": "date",
          "format": "YYYY-MM-DD",
          "rir_field_names": [
            "date_issue"
          ],
          "constraints": {
            "required": false
          },
          "default_value": null
        },
        {
          "category": "datapoint",
          "id": "document_type",
          "label": "Document type",
          "type": "enum",
          "options": [
            {
              "label": "Invoice Received",
              "value": "21"
            },
            {
              "label": "Invoice Sent",
              "value": "22"
            },
            {
              "label": "Receipt",
              "value": "23"
            }
          ],
          "enum_value_type": "number",
          "default_value": "21",
          "rir_field_names": []
        }
      ]
    },
    {
      "category": "section",
      "id": "line_items_section",
      "label": "Line items",
      "icon": null,
      "children": [
        {
          "category": "multivalue",
          "id": "line_items",
          "label": "Line items",
          "min_occurrences": null,
          "max_occurrences": null,
          "rir_field_names": [
            "line_items"
          ],
          "children": {
            "category": "tuple",
            "id": "line_item",
            "label": "Line item",
            "children": [
              {
                "category": "datapoint",
                "id": "item_desc",
                "label": "Description",
                "type": "string",
                "rir_field_names": [
                  "table_column_description"
                ],
                "constraints": {
                  "required": true
                },
                "stretch": true
              },
              {
                "category": "datapoint",
                "id": "item_quantity",
                "label": "Quantity",
                "type": "number",
                "format": "# ##0.#",
                "rir_field_names": [
                  "table_column_quantity"
                ],
                "constraints": {
                  "required": false
                },
                "width": 15
              },
              {
                "category": "datapoint",
                "id": "item_amount_total",
                "label": "Price w tax",
                "type": "number",
                "format": "# ##0.#",
                "rir_field_names": [
                  "table_column_amount_total"
                ],
                "constraints": {
                  "required": false
                },
                "aggregations": {
                  "sum": {
                    "label": "Total"
                  }
                }
              }
            ]
          }
        }
      ]
    },
    {
      "category": "section",
      "id": "tax_details_section",
      "label": "Tax details",
      "icon": null,
      "children": [
        {
          "category": "multivalue",
          "id": "tax_details",
          "label": "Tax details",
          "min_occurrences": null,
          "max_occurrences": null,
          "rir_field_names": [
            "tax_details"
          ],
          "children": {
            "category": "tuple",
            "id": "tax_detail",
            "label": "Tax detail",
            "children": [
              {
                "category": "datapoint",
                "id": "tax_detail_rate",
                "label": "Tax rate",
                "type": "number",
                "format": "# ##0.#",
                "rir_field_names": [
                  "tax_detail_rate"
                ],
                "constraints": {
                  "required": false
                },
                "width": 15
              },
              {
                "category": "datapoint",
                "id": "tax_detail_base",
                "label": "Tax base",
                "type": "number",
                "format": "# ##0.#",
                "rir_field_names": [
                  "tax_detail_base"
                ],
                "constraints": {
                  "required": false
                }
              },
              {
                "category": "datapoint",
                "id": "tax_detail_tax",
                "label": "Tax amount",
                "type": "number",
                "format": "# ##0.#",
                "rir_field_names": [
                  "tax_detail_tax"
                ],
                "constraints": {
                  "required": false
                }
              }
            ]
          }
        }
      ]
    }
  ]
}
{
  "detail": "Bad Request.",
  "code": "bad_request"
}
{
  "detail": "Invalid token.",
  "code": "authentication_failed"
}
{
  "detail": "Access to the requested resource is forbidden.",
  "code": "access_forbidden"
}
{
  "detail": "Not found.",
  "code": "not_found"
}
{
  "detail": "Conflict.",
  "code": "conflict_status"
}
{
  "detail": "Payload Too Large.",
  "code": "payload_too_large"
}
{
  "detail": "Request was rate limited.",
  "code": "rate_limited",
  "url": "https://rossum.app/api/docs/openapi/guides/overview/#rate-limiting"
}
{
  "detail": "Server error.",
  "code": "error"
}
{
  "detail": "Bad Gateway.",
  "code": "bad_gateway"
}
{
  "detail": "Service Unavailable.",
  "code": "service_unavailable"
}
{
  "detail": "Gateway timeout.",
  "code": "gateway_timeout"
}

Request Body

application/json

Attribute
Type
Description
name*
string

Name of the schema (not visible in UI).

metadata
object

Client data. May be used to store e.g. external system object IDs. See Metadata for more details.

Default: {}
content*
list[object]

Schema content: list of sections.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"section"
icon
string | null

The icon that appears on the left panel in the UI for a given section (not yet supported on UI).

children*
list[object]

Specifies objects grouped under a given section. It may contain multivalue or datapoint objects.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"multivalue"
min_occurrences
integer | null

Minimum number of occurrences of nested objects. If condition of min_occurrences is violated corresponding fields should be manually reviewed. Minimum required value for the field is 0. If not specified, it is set to 0 by default.

min: 0Default: 0
max_occurrences
integer | null

Maximum number of occurrences of nested objects. All additional rows above max_occurrences are removed by extraction process. Minimum required value for the field is 1. If not specified, it is set to 1000 by default.

min: 1Default: 1000
show_grid_by_default
boolean

If set to true, the magic-grid is opened instead of footer upon entering the multivalue. Default false. Applied only in UI. Useful when annotating documents for custom training.

Default: false
rir_field_names
list[string]

List of names used to initialize content from the AI engine predictions. If specified, the value of the first field from the array is used, otherwise default name line_items is used. Attribute can be set only for multivalue containing objects with category tuple.

grid
object

Multivalue grid object allows to specify a row type for each row of the grid. Configure magic-grid feature properties.

row_types*
list[string]

List of allowed row type values.

Default: ["data"]
default_row_type*
string

Row type to be used by default.

Default: "data"
row_types_to_extract*
list[string]

Types of rows to be extracted to related table.

Default: ["data"]
children*
object

Object specifying type of children. It may contain only objects with categories tuple or datapoint.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"tuple"
rir_field_names
list[string]

List of names used to initialize content from the AI engine predictions. If specified, the value of the first extracted field from the array is used, otherwise, no AI engine initialization is done for the object.

children*
list[object]

Array specifying objects that belong to a given tuple. It may contain only objects with category datapoint.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type*
"number"

Data type of the object.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category*
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type*
"date"

Data type of the object.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category*
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type*
"enum"

Data type of the object.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category*
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options*
list[object]

Options for enum datapoint.

value*
string

Value of the option.

label*
string

User-friendly label for the option, shown in the UI.

type*
"button"

Data type of the object.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category*
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type*
"number"

Data type of the object.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category*
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type*
"date"

Data type of the object.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category*
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type*
"enum"

Data type of the object.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category*
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options*
list[object]

Options for enum datapoint.

value*
string

Value of the option.

label*
string

User-friendly label for the option, shown in the UI.

type*
"button"

Data type of the object.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category*
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type*
"number"

Data type of the object.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category*
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type*
"date"

Data type of the object.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category*
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type*
"enum"

Data type of the object.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category*
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options*
list[object]

Options for enum datapoint.

value*
string

Value of the option.

label*
string

User-friendly label for the option, shown in the UI.

type*
"button"

Data type of the object.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category*
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

Response

201Created

Created

Attribute
Type
Description
id
read-only
integer

ID of the schema.

name
string

Name of the schema (not visible in UI).

url
read-only
URL

URL of the schema.

queues
read-only
list[URL]

List of queues that use schema object.

metadata
object

Client data. May be used to store e.g. external system object IDs. See Metadata for more details.

Default: {}
modified_by
read-only
URL

User that last modified the object.

modified_at
read-only
datetime

Timestamp of last modification.

content
list[object]

Schema content: list of sections.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"section"
icon
string | null

The icon that appears on the left panel in the UI for a given section (not yet supported on UI).

children
list[object]

Specifies objects grouped under a given section. It may contain multivalue or datapoint objects.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"multivalue"
min_occurrences
integer | null

Minimum number of occurrences of nested objects. If condition of min_occurrences is violated corresponding fields should be manually reviewed. Minimum required value for the field is 0. If not specified, it is set to 0 by default.

min: 0Default: 0
max_occurrences
integer | null

Maximum number of occurrences of nested objects. All additional rows above max_occurrences are removed by extraction process. Minimum required value for the field is 1. If not specified, it is set to 1000 by default.

min: 1Default: 1000
show_grid_by_default
boolean

If set to true, the magic-grid is opened instead of footer upon entering the multivalue. Default false. Applied only in UI. Useful when annotating documents for custom training.

Default: false
rir_field_names
list[string]

List of names used to initialize content from the AI engine predictions. If specified, the value of the first field from the array is used, otherwise default name line_items is used. Attribute can be set only for multivalue containing objects with category tuple.

grid
object

Multivalue grid object allows to specify a row type for each row of the grid. Configure magic-grid feature properties.

row_types
list[string]

List of allowed row type values.

Default: ["data"]
default_row_type
string

Row type to be used by default.

Default: "data"
row_types_to_extract
list[string]

Types of rows to be extracted to related table.

Default: ["data"]
children
object

Object specifying type of children. It may contain only objects with categories tuple or datapoint.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"tuple"
rir_field_names
list[string]

List of names used to initialize content from the AI engine predictions. If specified, the value of the first extracted field from the array is used, otherwise, no AI engine initialization is done for the object.

children
list[object]

Array specifying objects that belong to a given tuple. It can contain only objects with category datapoint.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"number"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"date"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"enum"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options
list[object]

Options for enum datapoint.

value
string

Value of the option.

label
string

User-friendly label for the option, shown in the UI.

type
"button"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"number"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"date"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"enum"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options
list[object]

Options for enum datapoint.

value
string

Value of the option.

label
string

User-friendly label for the option, shown in the UI.

type
"button"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"number"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"date"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"enum"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options
list[object]

Options for enum datapoint.

value
string

Value of the option.

label
string

User-friendly label for the option, shown in the UI.

type
"button"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

400Bad Request

Invalid input data.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

401Unauthorized

The username/password is invalid or token is invalid (e.g. expired).

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

403Forbidden

Insufficient permission, missing authentication, invalid CSRF token and similar issue.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

404Not Found

The specified resource was not found.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

409Conflict

Conflict

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

413

Payload too large (especially for files uploaded).

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

429Too Many Requests

Request rate is too high, wait before sending more requests. See Rate Limiting for more details.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

url
read-only
string

Link to the rate limiting documentation

500Internal Server Error

Server failure while processing the request.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

502Bad Gateway

Invalid response from the upstream server.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

503Service Unavailable

We're temporarily offline for maintenance. Please try again later.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

504

Upstream server could not complete the request in time.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

Retrieve schema

Get a schema object.

GET
/api/v1/schemas/{schemaID}
curl -X GET "https://example.rossum.app/api/v1/schemas/31336"
{
  "id": 31336,
  "name": "Basic Schema",
  "url": "https://example.rossum.app/api/v1/schemas/31336",
  "queues": [
    "https://example.rossum.app/api/v1/queues/8236"
  ],
  "metadata": {
    "some_key": "some_value"
  },
  "modified_by": "https://example.rossum.app/api/v1/users/10775",
  "modified_at": "2021-04-26T10:08:03.856648Z",
  "content": [
    {
      "category": "section",
      "id": "invoice_info_section",
      "label": "Basic information",
      "icon": null,
      "children": [
        {
          "category": "datapoint",
          "id": "document_id",
          "label": "Invoice number",
          "type": "string",
          "rir_field_names": [
            "document_id"
          ],
          "constraints": {
            "required": false
          },
          "default_value": null
        },
        {
          "category": "datapoint",
          "id": "date_issue",
          "label": "Issue date",
          "type": "date",
          "format": "YYYY-MM-DD",
          "rir_field_names": [
            "date_issue"
          ],
          "constraints": {
            "required": false
          },
          "default_value": null
        },
        {
          "category": "datapoint",
          "id": "document_type",
          "label": "Document type",
          "type": "enum",
          "options": [
            {
              "label": "Invoice Received",
              "value": "21"
            },
            {
              "label": "Invoice Sent",
              "value": "22"
            },
            {
              "label": "Receipt",
              "value": "23"
            }
          ],
          "enum_value_type": "number",
          "default_value": "21",
          "rir_field_names": []
        }
      ]
    },
    {
      "category": "section",
      "id": "line_items_section",
      "label": "Line items",
      "icon": null,
      "children": [
        {
          "category": "multivalue",
          "id": "line_items",
          "label": "Line items",
          "min_occurrences": null,
          "max_occurrences": null,
          "rir_field_names": [
            "line_items"
          ],
          "children": {
            "category": "tuple",
            "id": "line_item",
            "label": "Line item",
            "children": [
              {
                "category": "datapoint",
                "id": "item_desc",
                "label": "Description",
                "type": "string",
                "rir_field_names": [
                  "table_column_description"
                ],
                "constraints": {
                  "required": true
                },
                "stretch": true
              },
              {
                "category": "datapoint",
                "id": "item_quantity",
                "label": "Quantity",
                "type": "number",
                "format": "# ##0.#",
                "rir_field_names": [
                  "table_column_quantity"
                ],
                "constraints": {
                  "required": false
                },
                "width": 15
              },
              {
                "category": "datapoint",
                "id": "item_amount_total",
                "label": "Price w tax",
                "type": "number",
                "format": "# ##0.#",
                "rir_field_names": [
                  "table_column_amount_total"
                ],
                "constraints": {
                  "required": false
                },
                "aggregations": {
                  "sum": {
                    "label": "Total"
                  }
                }
              }
            ]
          }
        }
      ]
    },
    {
      "category": "section",
      "id": "tax_details_section",
      "label": "Tax details",
      "icon": null,
      "children": [
        {
          "category": "multivalue",
          "id": "tax_details",
          "label": "Tax details",
          "min_occurrences": null,
          "max_occurrences": null,
          "rir_field_names": [
            "tax_details"
          ],
          "children": {
            "category": "tuple",
            "id": "tax_detail",
            "label": "Tax detail",
            "children": [
              {
                "category": "datapoint",
                "id": "tax_detail_rate",
                "label": "Tax rate",
                "type": "number",
                "format": "# ##0.#",
                "rir_field_names": [
                  "tax_detail_rate"
                ],
                "constraints": {
                  "required": false
                },
                "width": 15
              },
              {
                "category": "datapoint",
                "id": "tax_detail_base",
                "label": "Tax base",
                "type": "number",
                "format": "# ##0.#",
                "rir_field_names": [
                  "tax_detail_base"
                ],
                "constraints": {
                  "required": false
                }
              },
              {
                "category": "datapoint",
                "id": "tax_detail_tax",
                "label": "Tax amount",
                "type": "number",
                "format": "# ##0.#",
                "rir_field_names": [
                  "tax_detail_tax"
                ],
                "constraints": {
                  "required": false
                }
              }
            ]
          }
        }
      ]
    }
  ]
}
{
  "detail": "Object was not modified",
  "code": "not_modified"
}
{
  "detail": "Bad Request.",
  "code": "bad_request"
}
{
  "detail": "Invalid token.",
  "code": "authentication_failed"
}
{
  "detail": "Access to the requested resource is forbidden.",
  "code": "access_forbidden"
}
{
  "detail": "Not found.",
  "code": "not_found"
}
{
  "detail": "Conflict.",
  "code": "conflict_status"
}
{
  "detail": "Request was rate limited.",
  "code": "rate_limited",
  "url": "https://rossum.app/api/docs/openapi/guides/overview/#rate-limiting"
}
{
  "detail": "Server error.",
  "code": "error"
}
{
  "detail": "Bad Gateway.",
  "code": "bad_gateway"
}
{
  "detail": "Service Unavailable.",
  "code": "service_unavailable"
}
{
  "detail": "Gateway timeout.",
  "code": "gateway_timeout"
}

Response

200OK

OK

Attribute
Type
Description
id
read-only
integer

ID of the schema.

name
string

Name of the schema (not visible in UI).

url
read-only
URL

URL of the schema.

queues
read-only
list[URL]

List of queues that use schema object.

metadata
object

Client data. May be used to store e.g. external system object IDs. See Metadata for more details.

Default: {}
modified_by
read-only
URL

User that last modified the object.

modified_at
read-only
datetime

Timestamp of last modification.

content
list[object]

Schema content: list of sections.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"section"
icon
string | null

The icon that appears on the left panel in the UI for a given section (not yet supported on UI).

children
list[object]

Specifies objects grouped under a given section. It may contain multivalue or datapoint objects.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"multivalue"
min_occurrences
integer | null

Minimum number of occurrences of nested objects. If condition of min_occurrences is violated corresponding fields should be manually reviewed. Minimum required value for the field is 0. If not specified, it is set to 0 by default.

min: 0Default: 0
max_occurrences
integer | null

Maximum number of occurrences of nested objects. All additional rows above max_occurrences are removed by extraction process. Minimum required value for the field is 1. If not specified, it is set to 1000 by default.

min: 1Default: 1000
show_grid_by_default
boolean

If set to true, the magic-grid is opened instead of footer upon entering the multivalue. Default false. Applied only in UI. Useful when annotating documents for custom training.

Default: false
rir_field_names
list[string]

List of names used to initialize content from the AI engine predictions. If specified, the value of the first field from the array is used, otherwise default name line_items is used. Attribute can be set only for multivalue containing objects with category tuple.

grid
object

Multivalue grid object allows to specify a row type for each row of the grid. Configure magic-grid feature properties.

row_types
list[string]

List of allowed row type values.

Default: ["data"]
default_row_type
string

Row type to be used by default.

Default: "data"
row_types_to_extract
list[string]

Types of rows to be extracted to related table.

Default: ["data"]
children
object

Object specifying type of children. It may contain only objects with categories tuple or datapoint.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"tuple"
rir_field_names
list[string]

List of names used to initialize content from the AI engine predictions. If specified, the value of the first extracted field from the array is used, otherwise, no AI engine initialization is done for the object.

children
list[object]

Array specifying objects that belong to a given tuple. It can contain only objects with category datapoint.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"number"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"date"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"enum"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options
list[object]

Options for enum datapoint.

value
string

Value of the option.

label
string

User-friendly label for the option, shown in the UI.

type
"button"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"number"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"date"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"enum"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options
list[object]

Options for enum datapoint.

value
string

Value of the option.

label
string

User-friendly label for the option, shown in the UI.

type
"button"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"number"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"date"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"enum"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options
list[object]

Options for enum datapoint.

value
string

Value of the option.

label
string

User-friendly label for the option, shown in the UI.

type
"button"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

304Not Modified

Object was not modified (e.g. ETag matches If-None-Match header).

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

400Bad Request

Invalid input data.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

401Unauthorized

The username/password is invalid or token is invalid (e.g. expired).

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

403Forbidden

Insufficient permission, missing authentication, invalid CSRF token and similar issue.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

404Not Found

The specified resource was not found.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

409Conflict

Conflict

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

429Too Many Requests

Request rate is too high, wait before sending more requests. See Rate Limiting for more details.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

url
read-only
string

Link to the rate limiting documentation

500Internal Server Error

Server failure while processing the request.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

502Bad Gateway

Invalid response from the upstream server.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

503Service Unavailable

We're temporarily offline for maintenance. Please try again later.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

504

Upstream server could not complete the request in time.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

Partial update schema

Update part of schema object. See Updating schema for more details about consequences of schema update.

This request can only change top-level properties of the schema object. Partial update of schema content is not available. To update a part of the schema content, send the whole schema content in the request, containing the new changes you would like to apply to the original schema.

PATCH
/api/v1/schemas/{schemaID}
curl -X PATCH "https://example.rossum.app/api/v1/schemas/31336" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": 31336,
  "name": "Basic Schema",
  "url": "https://example.rossum.app/api/v1/schemas/31336",
  "queues": [
    "https://example.rossum.app/api/v1/queues/8236"
  ],
  "metadata": {
    "some_key": "some_value"
  },
  "modified_by": "https://example.rossum.app/api/v1/users/10775",
  "modified_at": "2021-04-26T10:08:03.856648Z",
  "content": [
    {
      "category": "section",
      "id": "invoice_info_section",
      "label": "Basic information",
      "icon": null,
      "children": [
        {
          "category": "datapoint",
          "id": "document_id",
          "label": "Invoice number",
          "type": "string",
          "rir_field_names": [
            "document_id"
          ],
          "constraints": {
            "required": false
          },
          "default_value": null
        },
        {
          "category": "datapoint",
          "id": "date_issue",
          "label": "Issue date",
          "type": "date",
          "format": "YYYY-MM-DD",
          "rir_field_names": [
            "date_issue"
          ],
          "constraints": {
            "required": false
          },
          "default_value": null
        },
        {
          "category": "datapoint",
          "id": "document_type",
          "label": "Document type",
          "type": "enum",
          "options": [
            {
              "label": "Invoice Received",
              "value": "21"
            },
            {
              "label": "Invoice Sent",
              "value": "22"
            },
            {
              "label": "Receipt",
              "value": "23"
            }
          ],
          "enum_value_type": "number",
          "default_value": "21",
          "rir_field_names": []
        }
      ]
    },
    {
      "category": "section",
      "id": "line_items_section",
      "label": "Line items",
      "icon": null,
      "children": [
        {
          "category": "multivalue",
          "id": "line_items",
          "label": "Line items",
          "min_occurrences": null,
          "max_occurrences": null,
          "rir_field_names": [
            "line_items"
          ],
          "children": {
            "category": "tuple",
            "id": "line_item",
            "label": "Line item",
            "children": [
              {
                "category": "datapoint",
                "id": "item_desc",
                "label": "Description",
                "type": "string",
                "rir_field_names": [
                  "table_column_description"
                ],
                "constraints": {
                  "required": true
                },
                "stretch": true
              },
              {
                "category": "datapoint",
                "id": "item_quantity",
                "label": "Quantity",
                "type": "number",
                "format": "# ##0.#",
                "rir_field_names": [
                  "table_column_quantity"
                ],
                "constraints": {
                  "required": false
                },
                "width": 15
              },
              {
                "category": "datapoint",
                "id": "item_amount_total",
                "label": "Price w tax",
                "type": "number",
                "format": "# ##0.#",
                "rir_field_names": [
                  "table_column_amount_total"
                ],
                "constraints": {
                  "required": false
                },
                "aggregations": {
                  "sum": {
                    "label": "Total"
                  }
                }
              }
            ]
          }
        }
      ]
    },
    {
      "category": "section",
      "id": "tax_details_section",
      "label": "Tax details",
      "icon": null,
      "children": [
        {
          "category": "multivalue",
          "id": "tax_details",
          "label": "Tax details",
          "min_occurrences": null,
          "max_occurrences": null,
          "rir_field_names": [
            "tax_details"
          ],
          "children": {
            "category": "tuple",
            "id": "tax_detail",
            "label": "Tax detail",
            "children": [
              {
                "category": "datapoint",
                "id": "tax_detail_rate",
                "label": "Tax rate",
                "type": "number",
                "format": "# ##0.#",
                "rir_field_names": [
                  "tax_detail_rate"
                ],
                "constraints": {
                  "required": false
                },
                "width": 15
              },
              {
                "category": "datapoint",
                "id": "tax_detail_base",
                "label": "Tax base",
                "type": "number",
                "format": "# ##0.#",
                "rir_field_names": [
                  "tax_detail_base"
                ],
                "constraints": {
                  "required": false
                }
              },
              {
                "category": "datapoint",
                "id": "tax_detail_tax",
                "label": "Tax amount",
                "type": "number",
                "format": "# ##0.#",
                "rir_field_names": [
                  "tax_detail_tax"
                ],
                "constraints": {
                  "required": false
                }
              }
            ]
          }
        }
      ]
    }
  ]
}
{
  "detail": "Bad Request.",
  "code": "bad_request"
}
{
  "detail": "Invalid token.",
  "code": "authentication_failed"
}
{
  "detail": "Access to the requested resource is forbidden.",
  "code": "access_forbidden"
}
{
  "detail": "Not found.",
  "code": "not_found"
}
{
  "detail": "Conflict.",
  "code": "conflict_status"
}
{
  "detail": "Precondition failed.",
  "code": "precondition_failed"
}
{
  "detail": "Payload Too Large.",
  "code": "payload_too_large"
}
{
  "detail": "Request was rate limited.",
  "code": "rate_limited",
  "url": "https://rossum.app/api/docs/openapi/guides/overview/#rate-limiting"
}
{
  "detail": "Server error.",
  "code": "error"
}
{
  "detail": "Bad Gateway.",
  "code": "bad_gateway"
}
{
  "detail": "Service Unavailable.",
  "code": "service_unavailable"
}
{
  "detail": "Gateway timeout.",
  "code": "gateway_timeout"
}

Request Body

application/json

Attribute
Type
Description
name
string

Name of the schema (not visible in UI).

metadata
object

Client data. May be used to store e.g. external system object IDs. See Metadata for more details.

Default: {}
content
list[object]

Schema content: list of sections.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"section"
icon
string | null

The icon that appears on the left panel in the UI for a given section (not yet supported on UI).

children
list[object]

Specifies objects grouped under a given section. It may contain multivalue or datapoint objects.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"multivalue"
min_occurrences
integer | null

Minimum number of occurrences of nested objects. If condition of min_occurrences is violated corresponding fields should be manually reviewed. Minimum required value for the field is 0. If not specified, it is set to 0 by default.

min: 0Default: 0
max_occurrences
integer | null

Maximum number of occurrences of nested objects. All additional rows above max_occurrences are removed by extraction process. Minimum required value for the field is 1. If not specified, it is set to 1000 by default.

min: 1Default: 1000
show_grid_by_default
boolean

If set to true, the magic-grid is opened instead of footer upon entering the multivalue. Default false. Applied only in UI. Useful when annotating documents for custom training.

Default: false
rir_field_names
list[string]

List of names used to initialize content from the AI engine predictions. If specified, the value of the first field from the array is used, otherwise default name line_items is used. Attribute can be set only for multivalue containing objects with category tuple.

grid
object

Multivalue grid object allows to specify a row type for each row of the grid. Configure magic-grid feature properties.

row_types
list[string]

List of allowed row type values.

Default: ["data"]
default_row_type
string

Row type to be used by default.

Default: "data"
row_types_to_extract
list[string]

Types of rows to be extracted to related table.

Default: ["data"]
children
object

Object specifying type of children. It may contain only objects with categories tuple or datapoint.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"tuple"
rir_field_names
list[string]

List of names used to initialize content from the AI engine predictions. If specified, the value of the first extracted field from the array is used, otherwise, no AI engine initialization is done for the object.

children
list[object]

Array specifying objects that belong to a given tuple. It can contain only objects with category datapoint.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"number"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"date"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"enum"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options
list[object]

Options for enum datapoint.

value
string

Value of the option.

label
string

User-friendly label for the option, shown in the UI.

type
"button"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"number"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"date"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"enum"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options
list[object]

Options for enum datapoint.

value
string

Value of the option.

label
string

User-friendly label for the option, shown in the UI.

type
"button"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"number"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"date"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"enum"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options
list[object]

Options for enum datapoint.

value
string

Value of the option.

label
string

User-friendly label for the option, shown in the UI.

type
"button"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

Response

200OK

OK

Attribute
Type
Description
id
read-only
integer

ID of the schema.

name
string

Name of the schema (not visible in UI).

url
read-only
URL

URL of the schema.

queues
read-only
list[URL]

List of queues that use schema object.

metadata
object

Client data. May be used to store e.g. external system object IDs. See Metadata for more details.

Default: {}
modified_by
read-only
URL

User that last modified the object.

modified_at
read-only
datetime

Timestamp of last modification.

content
list[object]

Schema content: list of sections.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"section"
icon
string | null

The icon that appears on the left panel in the UI for a given section (not yet supported on UI).

children
list[object]

Specifies objects grouped under a given section. It may contain multivalue or datapoint objects.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"multivalue"
min_occurrences
integer | null

Minimum number of occurrences of nested objects. If condition of min_occurrences is violated corresponding fields should be manually reviewed. Minimum required value for the field is 0. If not specified, it is set to 0 by default.

min: 0Default: 0
max_occurrences
integer | null

Maximum number of occurrences of nested objects. All additional rows above max_occurrences are removed by extraction process. Minimum required value for the field is 1. If not specified, it is set to 1000 by default.

min: 1Default: 1000
show_grid_by_default
boolean

If set to true, the magic-grid is opened instead of footer upon entering the multivalue. Default false. Applied only in UI. Useful when annotating documents for custom training.

Default: false
rir_field_names
list[string]

List of names used to initialize content from the AI engine predictions. If specified, the value of the first field from the array is used, otherwise default name line_items is used. Attribute can be set only for multivalue containing objects with category tuple.

grid
object

Multivalue grid object allows to specify a row type for each row of the grid. Configure magic-grid feature properties.

row_types
list[string]

List of allowed row type values.

Default: ["data"]
default_row_type
string

Row type to be used by default.

Default: "data"
row_types_to_extract
list[string]

Types of rows to be extracted to related table.

Default: ["data"]
children
object

Object specifying type of children. It may contain only objects with categories tuple or datapoint.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"tuple"
rir_field_names
list[string]

List of names used to initialize content from the AI engine predictions. If specified, the value of the first extracted field from the array is used, otherwise, no AI engine initialization is done for the object.

children
list[object]

Array specifying objects that belong to a given tuple. It can contain only objects with category datapoint.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"number"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"date"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"enum"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options
list[object]

Options for enum datapoint.

value
string

Value of the option.

label
string

User-friendly label for the option, shown in the UI.

type
"button"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"number"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"date"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"enum"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options
list[object]

Options for enum datapoint.

value
string

Value of the option.

label
string

User-friendly label for the option, shown in the UI.

type
"button"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"number"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"date"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"enum"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options
list[object]

Options for enum datapoint.

value
string

Value of the option.

label
string

User-friendly label for the option, shown in the UI.

type
"button"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

400Bad Request

Invalid input data.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

401Unauthorized

The username/password is invalid or token is invalid (e.g. expired).

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

403Forbidden

Insufficient permission, missing authentication, invalid CSRF token and similar issue.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

404Not Found

The specified resource was not found.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

409Conflict

Conflict

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

412

Precondition failed (e.g. ETag does not match).

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

413

Payload too large (especially for files uploaded).

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

429Too Many Requests

Request rate is too high, wait before sending more requests. See Rate Limiting for more details.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

url
read-only
string

Link to the rate limiting documentation

500Internal Server Error

Server failure while processing the request.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

502Bad Gateway

Invalid response from the upstream server.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

503Service Unavailable

We're temporarily offline for maintenance. Please try again later.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

504

Upstream server could not complete the request in time.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

Delete schema

Delete schema object.

In case the schema is linked to some objects, like queue or annotation, the deletion is not possible and the request will fail with 409 status code.

DELETE
/api/v1/schemas/{schemaID}
curl -X DELETE "https://example.rossum.app/api/v1/schemas/31336"
Empty
{
  "detail": "Bad Request.",
  "code": "bad_request"
}
{
  "detail": "Invalid token.",
  "code": "authentication_failed"
}
{
  "detail": "Access to the requested resource is forbidden.",
  "code": "access_forbidden"
}
{
  "detail": "Not found.",
  "code": "not_found"
}
{
  "detail": "Conflict.",
  "code": "conflict_status"
}
{
  "detail": "Precondition failed.",
  "code": "precondition_failed"
}
{
  "detail": "Request was rate limited.",
  "code": "rate_limited",
  "url": "https://rossum.app/api/docs/openapi/guides/overview/#rate-limiting"
}
{
  "detail": "Server error.",
  "code": "error"
}
{
  "detail": "Bad Gateway.",
  "code": "bad_gateway"
}
{
  "detail": "Service Unavailable.",
  "code": "service_unavailable"
}
{
  "detail": "Gateway timeout.",
  "code": "gateway_timeout"
}

Response

204No Content

No Content

No response body.

400Bad Request

Invalid input data.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

401Unauthorized

The username/password is invalid or token is invalid (e.g. expired).

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

403Forbidden

Insufficient permission, missing authentication, invalid CSRF token and similar issue.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

404Not Found

The specified resource was not found.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

409Conflict

The deletion is not possible because the schema is linked to some objects, like queue or annotation.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

412

Precondition failed (e.g. ETag does not match).

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

429Too Many Requests

Request rate is too high, wait before sending more requests. See Rate Limiting for more details.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

url
read-only
string

Link to the rate limiting documentation

500Internal Server Error

Server failure while processing the request.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

502Bad Gateway

Invalid response from the upstream server.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

503Service Unavailable

We're temporarily offline for maintenance. Please try again later.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

504

Upstream server could not complete the request in time.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

Update schema

Update schema object. See Updating schema for more details about consequences of schema update.

PUT
/api/v1/schemas/{schemaID}
curl -X PUT "https://example.rossum.app/api/v1/schemas/31336" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": 31336,
  "name": "Basic Schema",
  "url": "https://example.rossum.app/api/v1/schemas/31336",
  "queues": [
    "https://example.rossum.app/api/v1/queues/8236"
  ],
  "metadata": {
    "some_key": "some_value"
  },
  "modified_by": "https://example.rossum.app/api/v1/users/10775",
  "modified_at": "2021-04-26T10:08:03.856648Z",
  "content": [
    {
      "category": "section",
      "id": "invoice_info_section",
      "label": "Basic information",
      "icon": null,
      "children": [
        {
          "category": "datapoint",
          "id": "document_id",
          "label": "Invoice number",
          "type": "string",
          "rir_field_names": [
            "document_id"
          ],
          "constraints": {
            "required": false
          },
          "default_value": null
        },
        {
          "category": "datapoint",
          "id": "date_issue",
          "label": "Issue date",
          "type": "date",
          "format": "YYYY-MM-DD",
          "rir_field_names": [
            "date_issue"
          ],
          "constraints": {
            "required": false
          },
          "default_value": null
        },
        {
          "category": "datapoint",
          "id": "document_type",
          "label": "Document type",
          "type": "enum",
          "options": [
            {
              "label": "Invoice Received",
              "value": "21"
            },
            {
              "label": "Invoice Sent",
              "value": "22"
            },
            {
              "label": "Receipt",
              "value": "23"
            }
          ],
          "enum_value_type": "number",
          "default_value": "21",
          "rir_field_names": []
        }
      ]
    },
    {
      "category": "section",
      "id": "line_items_section",
      "label": "Line items",
      "icon": null,
      "children": [
        {
          "category": "multivalue",
          "id": "line_items",
          "label": "Line items",
          "min_occurrences": null,
          "max_occurrences": null,
          "rir_field_names": [
            "line_items"
          ],
          "children": {
            "category": "tuple",
            "id": "line_item",
            "label": "Line item",
            "children": [
              {
                "category": "datapoint",
                "id": "item_desc",
                "label": "Description",
                "type": "string",
                "rir_field_names": [
                  "table_column_description"
                ],
                "constraints": {
                  "required": true
                },
                "stretch": true
              },
              {
                "category": "datapoint",
                "id": "item_quantity",
                "label": "Quantity",
                "type": "number",
                "format": "# ##0.#",
                "rir_field_names": [
                  "table_column_quantity"
                ],
                "constraints": {
                  "required": false
                },
                "width": 15
              },
              {
                "category": "datapoint",
                "id": "item_amount_total",
                "label": "Price w tax",
                "type": "number",
                "format": "# ##0.#",
                "rir_field_names": [
                  "table_column_amount_total"
                ],
                "constraints": {
                  "required": false
                },
                "aggregations": {
                  "sum": {
                    "label": "Total"
                  }
                }
              }
            ]
          }
        }
      ]
    },
    {
      "category": "section",
      "id": "tax_details_section",
      "label": "Tax details",
      "icon": null,
      "children": [
        {
          "category": "multivalue",
          "id": "tax_details",
          "label": "Tax details",
          "min_occurrences": null,
          "max_occurrences": null,
          "rir_field_names": [
            "tax_details"
          ],
          "children": {
            "category": "tuple",
            "id": "tax_detail",
            "label": "Tax detail",
            "children": [
              {
                "category": "datapoint",
                "id": "tax_detail_rate",
                "label": "Tax rate",
                "type": "number",
                "format": "# ##0.#",
                "rir_field_names": [
                  "tax_detail_rate"
                ],
                "constraints": {
                  "required": false
                },
                "width": 15
              },
              {
                "category": "datapoint",
                "id": "tax_detail_base",
                "label": "Tax base",
                "type": "number",
                "format": "# ##0.#",
                "rir_field_names": [
                  "tax_detail_base"
                ],
                "constraints": {
                  "required": false
                }
              },
              {
                "category": "datapoint",
                "id": "tax_detail_tax",
                "label": "Tax amount",
                "type": "number",
                "format": "# ##0.#",
                "rir_field_names": [
                  "tax_detail_tax"
                ],
                "constraints": {
                  "required": false
                }
              }
            ]
          }
        }
      ]
    }
  ]
}
{
  "detail": "Bad Request.",
  "code": "bad_request"
}
{
  "detail": "Invalid token.",
  "code": "authentication_failed"
}
{
  "detail": "Access to the requested resource is forbidden.",
  "code": "access_forbidden"
}
{
  "detail": "Not found.",
  "code": "not_found"
}
{
  "detail": "Conflict.",
  "code": "conflict_status"
}
{
  "detail": "Precondition failed.",
  "code": "precondition_failed"
}
{
  "detail": "Payload Too Large.",
  "code": "payload_too_large"
}
{
  "detail": "Request was rate limited.",
  "code": "rate_limited",
  "url": "https://rossum.app/api/docs/openapi/guides/overview/#rate-limiting"
}
{
  "detail": "Server error.",
  "code": "error"
}
{
  "detail": "Bad Gateway.",
  "code": "bad_gateway"
}
{
  "detail": "Service Unavailable.",
  "code": "service_unavailable"
}
{
  "detail": "Gateway timeout.",
  "code": "gateway_timeout"
}

Request Body

application/json

Attribute
Type
Description
name*
string

Name of the schema (not visible in UI).

metadata
object

Client data. May be used to store e.g. external system object IDs. See Metadata for more details.

Default: {}
content*
list[object]

Schema content: list of sections.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"section"
icon
string | null

The icon that appears on the left panel in the UI for a given section (not yet supported on UI).

children*
list[object]

Specifies objects grouped under a given section. It may contain multivalue or datapoint objects.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"multivalue"
min_occurrences
integer | null

Minimum number of occurrences of nested objects. If condition of min_occurrences is violated corresponding fields should be manually reviewed. Minimum required value for the field is 0. If not specified, it is set to 0 by default.

min: 0Default: 0
max_occurrences
integer | null

Maximum number of occurrences of nested objects. All additional rows above max_occurrences are removed by extraction process. Minimum required value for the field is 1. If not specified, it is set to 1000 by default.

min: 1Default: 1000
show_grid_by_default
boolean

If set to true, the magic-grid is opened instead of footer upon entering the multivalue. Default false. Applied only in UI. Useful when annotating documents for custom training.

Default: false
rir_field_names
list[string]

List of names used to initialize content from the AI engine predictions. If specified, the value of the first field from the array is used, otherwise default name line_items is used. Attribute can be set only for multivalue containing objects with category tuple.

grid
object

Multivalue grid object allows to specify a row type for each row of the grid. Configure magic-grid feature properties.

row_types*
list[string]

List of allowed row type values.

Default: ["data"]
default_row_type*
string

Row type to be used by default.

Default: "data"
row_types_to_extract*
list[string]

Types of rows to be extracted to related table.

Default: ["data"]
children*
object

Object specifying type of children. It may contain only objects with categories tuple or datapoint.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"tuple"
rir_field_names
list[string]

List of names used to initialize content from the AI engine predictions. If specified, the value of the first extracted field from the array is used, otherwise, no AI engine initialization is done for the object.

children*
list[object]

Array specifying objects that belong to a given tuple. It may contain only objects with category datapoint.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type*
"number"

Data type of the object.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category*
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type*
"date"

Data type of the object.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category*
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type*
"enum"

Data type of the object.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category*
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options*
list[object]

Options for enum datapoint.

value*
string

Value of the option.

label*
string

User-friendly label for the option, shown in the UI.

type*
"button"

Data type of the object.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category*
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type*
"number"

Data type of the object.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category*
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type*
"date"

Data type of the object.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category*
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type*
"enum"

Data type of the object.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category*
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options*
list[object]

Options for enum datapoint.

value*
string

Value of the option.

label*
string

User-friendly label for the option, shown in the UI.

type*
"button"

Data type of the object.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category*
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type*
"number"

Data type of the object.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category*
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type*
"date"

Data type of the object.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category*
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type*
"enum"

Data type of the object.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category*
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options*
list[object]

Options for enum datapoint.

value*
string

Value of the option.

label*
string

User-friendly label for the option, shown in the UI.

type*
"button"

Data type of the object.

id*
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label*
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category*
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern*
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

Response

200OK

OK

Attribute
Type
Description
id
read-only
integer

ID of the schema.

name
string

Name of the schema (not visible in UI).

url
read-only
URL

URL of the schema.

queues
read-only
list[URL]

List of queues that use schema object.

metadata
object

Client data. May be used to store e.g. external system object IDs. See Metadata for more details.

Default: {}
modified_by
read-only
URL

User that last modified the object.

modified_at
read-only
datetime

Timestamp of last modification.

content
list[object]

Schema content: list of sections.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"section"
icon
string | null

The icon that appears on the left panel in the UI for a given section (not yet supported on UI).

children
list[object]

Specifies objects grouped under a given section. It may contain multivalue or datapoint objects.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"multivalue"
min_occurrences
integer | null

Minimum number of occurrences of nested objects. If condition of min_occurrences is violated corresponding fields should be manually reviewed. Minimum required value for the field is 0. If not specified, it is set to 0 by default.

min: 0Default: 0
max_occurrences
integer | null

Maximum number of occurrences of nested objects. All additional rows above max_occurrences are removed by extraction process. Minimum required value for the field is 1. If not specified, it is set to 1000 by default.

min: 1Default: 1000
show_grid_by_default
boolean

If set to true, the magic-grid is opened instead of footer upon entering the multivalue. Default false. Applied only in UI. Useful when annotating documents for custom training.

Default: false
rir_field_names
list[string]

List of names used to initialize content from the AI engine predictions. If specified, the value of the first field from the array is used, otherwise default name line_items is used. Attribute can be set only for multivalue containing objects with category tuple.

grid
object

Multivalue grid object allows to specify a row type for each row of the grid. Configure magic-grid feature properties.

row_types
list[string]

List of allowed row type values.

Default: ["data"]
default_row_type
string

Row type to be used by default.

Default: "data"
row_types_to_extract
list[string]

Types of rows to be extracted to related table.

Default: ["data"]
children
object

Object specifying type of children. It may contain only objects with categories tuple or datapoint.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"tuple"
rir_field_names
list[string]

List of names used to initialize content from the AI engine predictions. If specified, the value of the first extracted field from the array is used, otherwise, no AI engine initialization is done for the object.

children
list[object]

Array specifying objects that belong to a given tuple. It can contain only objects with category datapoint.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"number"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"date"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"enum"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options
list[object]

Options for enum datapoint.

value
string

Value of the option.

label
string

User-friendly label for the option, shown in the UI.

type
"button"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"number"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"date"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"enum"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options
list[object]

Options for enum datapoint.

value
string

Value of the option.

label
string

User-friendly label for the option, shown in the UI.

type
"button"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"number"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"date"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"enum"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options
list[object]

Options for enum datapoint.

value
string

Value of the option.

label
string

User-friendly label for the option, shown in the UI.

type
"button"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

400Bad Request

Invalid input data.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

401Unauthorized

The username/password is invalid or token is invalid (e.g. expired).

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

403Forbidden

Insufficient permission, missing authentication, invalid CSRF token and similar issue.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

404Not Found

The specified resource was not found.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

409Conflict

Conflict

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

412

Precondition failed (e.g. ETag does not match).

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

413

Payload too large (especially for files uploaded).

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

429Too Many Requests

Request rate is too high, wait before sending more requests. See Rate Limiting for more details.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

url
read-only
string

Link to the rate limiting documentation

500Internal Server Error

Server failure while processing the request.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

502Bad Gateway

Invalid response from the upstream server.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

503Service Unavailable

We're temporarily offline for maintenance. Please try again later.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

504

Upstream server could not complete the request in time.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

Create schema from template

Create new schema object from template organization, see available templates in organization

POST
/api/v1/schemas/from_template
curl -X POST "https://example.rossum.app/api/v1/schemas/from_template" \  -H "Content-Type: application/json" \  -d '{    "name": "ACME Corp Invoice Schema",    "template_name": "EU Invoice Template"  }'
{
  "id": 31336,
  "name": "Basic Schema",
  "url": "https://example.rossum.app/api/v1/schemas/31336",
  "queues": [
    "https://example.rossum.app/api/v1/queues/8236"
  ],
  "metadata": {
    "some_key": "some_value"
  },
  "modified_by": "https://example.rossum.app/api/v1/users/10775",
  "modified_at": "2021-04-26T10:08:03.856648Z",
  "content": [
    {
      "category": "section",
      "id": "invoice_info_section",
      "label": "Basic information",
      "icon": null,
      "children": [
        {
          "category": "datapoint",
          "id": "document_id",
          "label": "Invoice number",
          "type": "string",
          "rir_field_names": [
            "document_id"
          ],
          "constraints": {
            "required": false
          },
          "default_value": null
        },
        {
          "category": "datapoint",
          "id": "date_issue",
          "label": "Issue date",
          "type": "date",
          "format": "YYYY-MM-DD",
          "rir_field_names": [
            "date_issue"
          ],
          "constraints": {
            "required": false
          },
          "default_value": null
        },
        {
          "category": "datapoint",
          "id": "document_type",
          "label": "Document type",
          "type": "enum",
          "options": [
            {
              "label": "Invoice Received",
              "value": "21"
            },
            {
              "label": "Invoice Sent",
              "value": "22"
            },
            {
              "label": "Receipt",
              "value": "23"
            }
          ],
          "enum_value_type": "number",
          "default_value": "21",
          "rir_field_names": []
        }
      ]
    },
    {
      "category": "section",
      "id": "line_items_section",
      "label": "Line items",
      "icon": null,
      "children": [
        {
          "category": "multivalue",
          "id": "line_items",
          "label": "Line items",
          "min_occurrences": null,
          "max_occurrences": null,
          "rir_field_names": [
            "line_items"
          ],
          "children": {
            "category": "tuple",
            "id": "line_item",
            "label": "Line item",
            "children": [
              {
                "category": "datapoint",
                "id": "item_desc",
                "label": "Description",
                "type": "string",
                "rir_field_names": [
                  "table_column_description"
                ],
                "constraints": {
                  "required": true
                },
                "stretch": true
              },
              {
                "category": "datapoint",
                "id": "item_quantity",
                "label": "Quantity",
                "type": "number",
                "format": "# ##0.#",
                "rir_field_names": [
                  "table_column_quantity"
                ],
                "constraints": {
                  "required": false
                },
                "width": 15
              },
              {
                "category": "datapoint",
                "id": "item_amount_total",
                "label": "Price w tax",
                "type": "number",
                "format": "# ##0.#",
                "rir_field_names": [
                  "table_column_amount_total"
                ],
                "constraints": {
                  "required": false
                },
                "aggregations": {
                  "sum": {
                    "label": "Total"
                  }
                }
              }
            ]
          }
        }
      ]
    },
    {
      "category": "section",
      "id": "tax_details_section",
      "label": "Tax details",
      "icon": null,
      "children": [
        {
          "category": "multivalue",
          "id": "tax_details",
          "label": "Tax details",
          "min_occurrences": null,
          "max_occurrences": null,
          "rir_field_names": [
            "tax_details"
          ],
          "children": {
            "category": "tuple",
            "id": "tax_detail",
            "label": "Tax detail",
            "children": [
              {
                "category": "datapoint",
                "id": "tax_detail_rate",
                "label": "Tax rate",
                "type": "number",
                "format": "# ##0.#",
                "rir_field_names": [
                  "tax_detail_rate"
                ],
                "constraints": {
                  "required": false
                },
                "width": 15
              },
              {
                "category": "datapoint",
                "id": "tax_detail_base",
                "label": "Tax base",
                "type": "number",
                "format": "# ##0.#",
                "rir_field_names": [
                  "tax_detail_base"
                ],
                "constraints": {
                  "required": false
                }
              },
              {
                "category": "datapoint",
                "id": "tax_detail_tax",
                "label": "Tax amount",
                "type": "number",
                "format": "# ##0.#",
                "rir_field_names": [
                  "tax_detail_tax"
                ],
                "constraints": {
                  "required": false
                }
              }
            ]
          }
        }
      ]
    }
  ]
}
{
  "detail": "Bad Request.",
  "code": "bad_request"
}
{
  "detail": "Invalid token.",
  "code": "authentication_failed"
}
{
  "detail": "Access to the requested resource is forbidden.",
  "code": "access_forbidden"
}
{
  "detail": "Not found.",
  "code": "not_found"
}
{
  "detail": "Conflict.",
  "code": "conflict_status"
}
{
  "detail": "Payload Too Large.",
  "code": "payload_too_large"
}
{
  "detail": "Request was rate limited.",
  "code": "rate_limited",
  "url": "https://rossum.app/api/docs/openapi/guides/overview/#rate-limiting"
}
{
  "detail": "Server error.",
  "code": "error"
}
{
  "detail": "Bad Gateway.",
  "code": "bad_gateway"
}
{
  "detail": "Service Unavailable.",
  "code": "service_unavailable"
}
{
  "detail": "Gateway timeout.",
  "code": "gateway_timeout"
}

Request Body

application/json

Attribute
Type
Description
name*
string

Name of the new schema

template_name*
string

Name of the template to use

Response

201Created

Created

Attribute
Type
Description
id
read-only
integer

ID of the schema.

name
string

Name of the schema (not visible in UI).

url
read-only
URL

URL of the schema.

queues
read-only
list[URL]

List of queues that use schema object.

metadata
object

Client data. May be used to store e.g. external system object IDs. See Metadata for more details.

Default: {}
modified_by
read-only
URL

User that last modified the object.

modified_at
read-only
datetime

Timestamp of last modification.

content
list[object]

Schema content: list of sections.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"section"
icon
string | null

The icon that appears on the left panel in the UI for a given section (not yet supported on UI).

children
list[object]

Specifies objects grouped under a given section. It may contain multivalue or datapoint objects.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"multivalue"
min_occurrences
integer | null

Minimum number of occurrences of nested objects. If condition of min_occurrences is violated corresponding fields should be manually reviewed. Minimum required value for the field is 0. If not specified, it is set to 0 by default.

min: 0Default: 0
max_occurrences
integer | null

Maximum number of occurrences of nested objects. All additional rows above max_occurrences are removed by extraction process. Minimum required value for the field is 1. If not specified, it is set to 1000 by default.

min: 1Default: 1000
show_grid_by_default
boolean

If set to true, the magic-grid is opened instead of footer upon entering the multivalue. Default false. Applied only in UI. Useful when annotating documents for custom training.

Default: false
rir_field_names
list[string]

List of names used to initialize content from the AI engine predictions. If specified, the value of the first field from the array is used, otherwise default name line_items is used. Attribute can be set only for multivalue containing objects with category tuple.

grid
object

Multivalue grid object allows to specify a row type for each row of the grid. Configure magic-grid feature properties.

row_types
list[string]

List of allowed row type values.

Default: ["data"]
default_row_type
string

Row type to be used by default.

Default: "data"
row_types_to_extract
list[string]

Types of rows to be extracted to related table.

Default: ["data"]
children
object

Object specifying type of children. It may contain only objects with categories tuple or datapoint.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"tuple"
rir_field_names
list[string]

List of names used to initialize content from the AI engine predictions. If specified, the value of the first extracted field from the array is used, otherwise, no AI engine initialization is done for the object.

children
list[object]

Array specifying objects that belong to a given tuple. It can contain only objects with category datapoint.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"number"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"date"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"enum"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options
list[object]

Options for enum datapoint.

value
string

Value of the option.

label
string

User-friendly label for the option, shown in the UI.

type
"button"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"number"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"date"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"enum"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options
list[object]

Options for enum datapoint.

value
string

Value of the option.

label
string

User-friendly label for the option, shown in the UI.

type
"button"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"string"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"number"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Number format.

Default: "# ##0.#"
aggregations
object

Aggregations allow computation of some informative values, e.g. a sum of a table column with numeric values. These are returned among messages when /v1/annotations/{id}/content/validate endpoint is called. Aggregations can be computed only for tables (multivalues of tuples).

sum
object

Sum of values in a column. Default label is "Sum".

label
string

Label that will be shown in the UI for the sum aggregation.

Default: "Sum"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"date"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

format
string

Enforces a format for date datapoint on the UI.

Default: "YYY-MM-DD"
constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

type
"enum"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

enum_value_type
"string" | "number" | "date"

Data type of the option's value attribute. Must be one of string, number, date.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

options
list[object]

Options for enum datapoint.

value
string

Value of the option.

label
string

User-friendly label for the option, shown in the UI.

type
"button"

Data type of the object.

id
string

Unique identifier of an object. Maximum length is 50 characters.

maxLength: 50
label
string

User-friendly label for an object, shown in the user interface.

hidden
boolean

If set to true, the object is not visible in the user interface, but remains stored in the database and may be exported. Default is false. Note that section is hidden if all its children are hidden.

Default: false
disable_prediction
boolean

Can be set to true to disable field extraction, while still preserving the data shape. Ignored by aurora engines.

Default: false
category
"datapoint"
can_export
boolean

If set to false, datapoint is not exported through export endpoint. Default is true.

Default: true
can_collapse
boolean

If set to true, tabular (multivalue-tuple) datapoint may be collapsed in the UI. Default is false.

Default: false
rir_field_names
list[string]

List of references used to initialize an object value.

default_value
string | number | boolean | null

Default value used either for fields that do not use hints from AI engine predictions (i.e. rir_field_names are not specified), or when the AI engine does not return any data for the field.

ui_configuration
object

UI configuration provides a group of settings, which alter behaviour of the field in the application. This does not affect behaviour of the field via the API.

type
"captured" | "data" | "manual" | "formula" | "reasoning" | null

Logical type of the datapoint. Possible values are captured, data, manual, formula, reasoning or null. Default value is null.

Default: null
edit
"enabled" | "disabled" | "enabled_without_warning"

When set to disabled, value of the datapoint is not editable via UI. When set to enabled_without_warning, no warnings are displayed in the UI regarding this fields editing behaviour. Default value is enabled, this option enables field editing, but user receives dismissible warnings when doing so.

Default: "enabled"
width
integer

Width of the column (in characters). Default widths are number 8, string 20, date 10, enum 20. Only supported for table datapoints.

stretch
boolean

If total width of columns doesn't fill up the screen, datapoints with stretch set to true will be expanded proportionally to other stretching columns. Only supported for table datapoints.

width_chars
deprecated
integer

(Deprecated) Use width and stretch properties instead.

score_threshold
number

Threshold used to automatically validate field content based on AI confidence scores. If not set, queue.default_score_threshold is used.

min: 0, max: 1
formula
string

Formula definition, required only for fields of type formula. rir_field_names should also be empty for these fields.

maxLength: 2000
prompt
string

Prompt definition, required only for fields of type reasoning.

maxLength: 2000
context
list[string]

Context for the prompt, required only for fields of type reasoning.

popup_url
URL

URL of a popup window to be opened when button is pressed.

can_obtain_token
boolean

If set to true the popup window is allowed to ask the main Rossum window for authorization token.

constraints
object
length
object

Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively.

min
integer | null

Minimum length for the datapoint value.

min: 0
max
integer | null

Maximum length for the datapoint value.

min: 0
exact
integer | null

Exact length for the datapoint value.

min: 0
required
boolean

Specifies if the datapoint is required by the schema. Default value is true.

Default: true
regex
object

When specified, content must match a regular expression.

pattern
string

Regular expression pattern that the content must match. To ensure that entire value matches, surround your regular expression with ^ and $.

400Bad Request

Invalid input data.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

401Unauthorized

The username/password is invalid or token is invalid (e.g. expired).

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

403Forbidden

Insufficient permission, missing authentication, invalid CSRF token and similar issue.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

404Not Found

The specified resource was not found.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

409Conflict

Conflict

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

413

Payload too large (especially for files uploaded).

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

429Too Many Requests

Request rate is too high, wait before sending more requests. See Rate Limiting for more details.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

url
read-only
string

Link to the rate limiting documentation

500Internal Server Error

Server failure while processing the request.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

502Bad Gateway

Invalid response from the upstream server.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

503Service Unavailable

We're temporarily offline for maintenance. Please try again later.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

504

Upstream server could not complete the request in time.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

Validate schema

Validate schema object, check for errors.

POST
/api/v1/schemas/validate
curl -X POST "https://example.rossum.app/api/v1/schemas/validate" \  -H "Content-Type: application/json" \  -d '{    "content": [      {        "category": "section",        "id": "invoice_details",        "label": "Invoice Details",        "children": [          {            "category": "datapoint",            "id": "document_id",            "label": "Document ID",            "type": "string"          },          {            "category": "datapoint",            "id": "date_issue",            "label": "Invoice Date",            "type": "date"          }        ]      }    ],    "id": 12345,    "url": "https://example.rossum.app/api/v1/schemas/12345"  }'
{}
{
  "detail": "Bad Request.",
  "code": "bad_request"
}
{
  "detail": "Invalid token.",
  "code": "authentication_failed"
}
{
  "detail": "Access to the requested resource is forbidden.",
  "code": "access_forbidden"
}
{
  "detail": "Not found.",
  "code": "not_found"
}
{
  "detail": "Conflict.",
  "code": "conflict_status"
}
{
  "detail": "Payload Too Large.",
  "code": "payload_too_large"
}
{
  "detail": "Request was rate limited.",
  "code": "rate_limited",
  "url": "https://rossum.app/api/docs/openapi/guides/overview/#rate-limiting"
}
{
  "detail": "Server error.",
  "code": "error"
}
{
  "detail": "Bad Gateway.",
  "code": "bad_gateway"
}
{
  "detail": "Service Unavailable.",
  "code": "service_unavailable"
}
{
  "detail": "Gateway timeout.",
  "code": "gateway_timeout"
}

Request Body

application/json

Attribute
Type
Description
content*
list[object]

Schema content to validate

id
integer

Schema ID (required for Aurora engines)

url
URL

Schema URL (required for Aurora engines)

Response

200OK

Validation result (An error description in case of validation failure).

responseobject
400Bad Request

Invalid input data.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

401Unauthorized

The username/password is invalid or token is invalid (e.g. expired).

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

403Forbidden

Insufficient permission, missing authentication, invalid CSRF token and similar issue.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

404Not Found

The specified resource was not found.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

409Conflict

Conflict

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

413

Payload too large (especially for files uploaded).

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

429Too Many Requests

Request rate is too high, wait before sending more requests. See Rate Limiting for more details.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

url
read-only
string

Link to the rate limiting documentation

500Internal Server Error

Server failure while processing the request.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

502Bad Gateway

Invalid response from the upstream server.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

503Service Unavailable

We're temporarily offline for maintenance. Please try again later.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error

504

Upstream server could not complete the request in time.

Attribute
Type
Description
detail
read-only
string

Detail of the error

code
read-only
string

Code of the error