Workflow Inputs

Define the UI and API input values for your Workflows

How to Add Input Variables

Workflow Inputs are variables you can set at runtime and use inside of your Workflows.

1. Click the "Configure" button on your Start step

Define the input(s) to your Workflow

2. Select your input type

You will be prompted to first choose your desired "Input Type." This determines both the user interface and the data type of your input value:

3. Customize the input field

See the next section for a full list of supported types to decide what works best for your use-case. Continue to populate the remaining fields of your Workflow Input:

• Label: a descriptive label for the name of your input

• Variable Name: the name of your input as a variable, which will be referenced as liquid syntax in your steps. By default, the variable name is automatically generated when you add a label, but it can be customized to be separate

• Hint: helper text that appears below your input on the Workflow page

• Placeholder: example value that will be overwritten by your input value

• Default Value: a default value used if no other input value is provided, this is useful for API calls

• Required: determines whether or not the input is required for your Workflow to run successfully

Input Types

Choosing the correct input type is important for the success of your Workflow.

Basic Input Types

Basic input types allow users to type information or select options from a dropdown:

• Short Text: A single-line text field

• Long Text: A multi-line text field

• Single Select: Allows the user to choose one option from a list

• Multi Select: Allows the user to choose multiple options from a list

Basic Input Types

Advanced Input Types

Advanced input types allow users to pass in JSON, files, databases, or numbers as inputs:

Workflows with file inputs cannot be published as public Workflows

• JSON: Allows the user to pass a JSON object or list

• File Text: Allows the user to upload a .pdf, .txt, .docx, .md file that is converted into text

• File Media: Allows the user to upload a .mp3, .mp4, .wav, .jpg, .png, .webp file which is converted into a downloadable link

• File CSV: Allows the user to upload a .csv file which is transformed into a list of JSON objects

• Data Sources: Allows the user to connect to a data source that has been added in AirOps

• Number: Allows the user to pass a numerical string that is interpreted as a number instead of a string

If you input a number using Short Text or Long Text, it will be interpreted as a string - e.g. 3 will be interpreted as "3". Instead, use the Number input type to pass a number.

Input Specifications

Detailed specifications on the input types and resulting data types:

Input Name	Input Type	Resulting Data Type	Use Cases
Short Text		String
Long Text		String
Single-Select		String	Allow the user to select one option
Multi-Select		String	Allow the user to select multiple options
JSON	JSON or List	JSON or List	Create an API that accepts a JSON payload
File Text	.pdf, .txt, .docx, .md	String	Generate summaries or insights from PDFs
File Media	.mp3, .mp4, .wav, .jpg, .png, .webp	Downloadable link to file	Transcribe and analyze interviews
File CSV	.csv	A list of JSON objects	Iterate over each row of a csv and analyze the results
Database		Database	Run a query on your database
Number		Number

Please note: Files do not have a specific size limit, but large files could impact upload time and server load.

Example

Let's walkthrough defining an input for a Workflow that converts historical text into modern day English.