Skip to content

Reserved Form mode names

We use form modes to specify what data can be read or written to documents using the form name in their form item. While you are generally free to pick any name (lower case, no special characters), there are names with a special purpose, namely:

default

The default mode is, as the name implies, the default when creating or reading documents and in the absence of an explicityly specified mode= parameter

dql

When data is queried by DQL, forms need a dql mode to return values. The mode specified what data gets returned. If a form doesn't have a dql mode, no data will be returned for that form in a DQL query.

odata

The odata mode lets you define the data that comes through our odata endpoints. The API support the odata standard Open Data Protocol(oData). If a form does not have a odata mode, then an odata will not return any data for that form.

raw

Needed for /api/v1/raw endpoint. The endpoint /api/v1/raw will only return data when the mode raw exists for the form requested exists and the user has the permission, expressed in the @formula of the raw mode definition. Typically you want to restrict raw access to admin and support users.

Note

 `raw` mode returns all fields without translation or adjustment.

Last update: November 25, 2023