Skip to main content
POST
Add Config Field

Authorizations

Authorization
string
header
required

API key authentication. Get your API key from the Duvo dashboard.

Path Parameters

automation_id
string<uuid>
required

The automation's unique identifier

Body

application/json
label
string
required

Short name for the field, shown as its row heading

Required string length: 1 - 200
question
string
required

The setup question asked for this field

Required string length: 1 - 2000
type
enum<string>
required

Value type; compound and sourcePointer are template-only

Available options:
freeText,
identifier,
number,
select,
multiSelect,
list,
orderedList,
personList,
table
key
string

Code for the field, unique within the automation; derived from the label when left out

Required string length: 1 - 120
Pattern: ^[a-z0-9][a-z0-9_]*$
guidance
string | null

What to fill in for the question, in plain sentences; left out or null for none

Required string length: 1 - 2000
example
string | null

An example answer to the question; left out or null for none

Required string length: 1 - 500
section
string | null

Section to add the field to, or null for none

Required string length: 1 - 200
fill_mode
enum<string>
default:interview

How the field is filled (interview, setup)

Available options:
interview,
setup
options
string[]

Required for select and multiSelect, refused otherwise

Required array length: 1 - 100 elements
Required string length: 1 - 200
columns
string[]

Required for table, refused otherwise

Required array length: 1 - 20 elements
Required string length: 1 - 100
bindings
enum<string>[]

How the value reaches the automation (context, tool)

Minimum array length: 1
Available options:
context,
tool
roles
string[]

Keys of the process roles whose holders answer this question; empty means anyone

Maximum array length: 100
Required string length: 1 - 120

Response

Default Response

field
object
required