Workflow YAML

Any Workflow has a YAML format representation which looks like this:

​

Viewing your Workflow in YAML format

1. In the Workflow Editor, in the top-right corner, click the
   icon and then select the Edit YAML option . Your Workflow is presented in YAML format.

​

Workflow YAML Grammar

The Workflow YAML is used to describe the Workflow and is defined as YAML . These attributes are present in the Workflow YAML file:

• name - Name of the Workflow.

• type - Can be either a Flow or Subflow Workflow.

• Workflow_type - The Workflow type represents how the Workflow will be used: on_demand, event or scheduled

• active - True while the Workflow is running, false otherwise.

• desc - Description of the Workflow.

• connections- The Workflow’s connection, in the following format: connection-type:connection-name.

• workflow- The workflow representation. Workflow is built by sections that contains a name and steps

• steps - There are two types of steps: Action and Text. Each type contains different attributes: Action

• action - The full name of the action.

• id - ID of the step.

• name - Name of the step.

• desc- Description of the step.

• inputs- The Action’s inputs, in the following format:input-field-name:value

Action inputs might be encapsulated, for example:

input-field-name:
  sub-input-field: value
  sub-input-field-2: value2

• connections - The connection of the step, in the following format: connection-type: connection-name.

• steps - Flow Control actions such as internal.for iterates over all the steps and executes them.

• transitions - Flow control actions such as internal.if contains the transitions field built as following:

transitions:
  - on: true
    steps: ...
  - on: false
    steps: ...

One of the steps branches will execute depending on the evaluated condition, which is provided on the if action.

Text

• text - Free text. (this is unrelated to the steps attribute.)

• counting_steps - The number of steps in the Workflow.

​

YAML Format Examples

• Input and Output Parameters
• If Condition with Input Parameters
• Connection
• Scheduled Workflow
• Event-Based Workflow

name: output parameters
type: Flow
automation_type: on_demand
inputs:
  name:
    default: Ofir
    display_name: Name
    name: name
    placeholder: Enter your name
    required: true
    type: text
outputs:
  Welcome Message: "{{ steps.S1.output }}"
workflow:
  - section: Formatting
    steps:
      - action: core.bash
        id: S1
        name: Format welcome message
        inputs:
          code: echo "Welcome, {{inputs.name}}!"
counting_steps: 0

​

Download YAML Format of a Workflow

1. In the Workflow Editor, in the top-right corner, click the

   icon and then select the Download YAML option .

2. It will automatically download a file containing the YAML format of your workflow.