Workflow Attribute Types
Attributes are edited in the builder under the workflow settings (gear) button → Workflow Attributes. For a walkthrough, see Workflow Attributes.
Fields
| Field | Key | Type | Applies to | Notes |
|---|---|---|---|---|
| Name | name | Text | All | Required and unique within the workflow. Referenced as ${attribute.<name>} (or ${<name>}). |
| Type | type | Select | All | Text Input (freeform), Dropdown (dropdown), Checkbox (checkbox), Button (button). Changing away from Dropdown clears its options. |
| Number of Lines | lines | Number, 1–20 | Text Input | Default 1. |
| Description | description | Text | All | Used as the label on the launch form; the name is used if blank. |
| Default Value | default_value | Text | All | Pre-fills the launch form. Not applied to scheduled, webhook or sub-workflow runs. |
| Required | required | Checkbox | All | Shows the field as required. Not enforced. |
| Dropdown Options | options | List of text | Dropdown | The API's validation requires at least one option. |
| Trigger | is_trigger | Checkbox | Button | Makes the button the form's launch button. |
How each type appears on the launch form
| Type | On the Missions launch form | Value passed to the run |
|---|---|---|
| Text Input | A large text box, labelled with the description. The default value (or a prompt) shows as placeholder text. Pressing Enter launches the mission; Shift+Enter adds a new line. | The text entered. |
| Dropdown | A drop-down with None plus your options. | The selected option, or empty. |
| Checkbox | A checkbox. | true or false (inserted into text as True / False). |
| Button (not a trigger) | A secondary button. Clicking it sets the value. | true once clicked. |
| Button with Trigger | The main launch button, labelled with the description. | true. |
If no attribute is a trigger button, the form shows a Launch Mission button. A workflow with no attributes at all launches as soon as it is selected.
New workflow defaults
| Name | Type | Description | Required | Trigger |
|---|---|---|---|---|
UserInput | Text Input | Enter your request | Yes | — |
StartMission | Button | Go | No | Yes |
UserInput is not passed to any node automatically. Reference ${attribute.UserInput} in the first node's input message.