Invitation
Users can enter data into the system using an invitation. An invitation is roughly a template that indicates required and valid values that will be saved to the database. The invitation contains a list of fields that need to be completed by the user.
When modifying an Invitation's reply field, each field must be a valid JSON with a title and the following optional properties (with the exception of field type, which is required):
field type: the type of the field, which includes value(s), value(s)-regex, value-radio, value(s)-checkbox, value(s)-dropdown, value-file
description: a string describing how users should fill this field
order: a number representing the position in which the field will appear on the form
required: a boolean representing whether the field is required (true) or optional (false)
default: the default value of the field
markdown: a boolean representing whether Markdown is enabled for the field (only valid for value-regex field type)
You can have different types of fields:
value, values: string or array of strings; the value(s) cannot be modified by the user.
value-regex, values-regex: string or array of strings; the value entered by the user should pass the regex validation.
value-radio: string or array of strings; the user can only choose one option.
value-checkbox, values-checkbox: string or array of strings; the user can select one or more options.
value-dropdown, values-dropdown: array of strings; the user can select one or more options from a dropdown.
value-file: a valid JSON specifying the expected upload file type and size in MB; the user can upload one file.
The fileTypes field expects an array of strings specifying the permitted file types that the user can upload. Supported field types are pdf, csv, zip and mp4.
Last updated