Callable flows

A callable flow step lets you 'call' another flow in your workflow to run. A callable flow step works in tandem with a callable trigger. You use the callable trigger to build the sequence of steps you want to run and to define what information to pass from the calling flow to the steps connected to the callable trigger. When you add a callable flow step to any of the flows in the same workflow, when the step runs it'll call its associated trigger to initiate the sequence of steps.

For example, if you need the option to initiate a major incident process in more than one of your flows, instead of including the same sequence of steps in each flow (such as posting to a status page, creating or updating chat channels, opening a help desk ticket, sending notifications, etc.), you could build the sequence once — as a separate, reusable flow — and then include a step in your other flows to call that flow to run. If you ever need to change the steps in your process or modify their configuration, you only need to do it in one place.

  1. Drag the callable flow step from the palette onto the canvas (available from Tools > Callable Flows) and connect it to your flow.
  2. Double-click the step to open its configuration screen (or select it and click the pencil icon).
  3. On the Setup tab, fill in the step inputs using text, outputs from previous steps, trigger properties, or a combination of these.
    • This information is available as outputs of the callable trigger that can be used by steps in the flow connected to the trigger.

Typically, a callable flow step is initially configured when its associated callable trigger is added to the canvas.

If you want to edit its configuration, you can click Open Step Configuration in the associated trigger, or click Edit from the callable flow step's settings menu (the gear icon) on the Tools tab of the palette.

As the owner of a callable flow step, you can specify who the step is shared with and what permission levels they have.

  1. Click Edit from the callable flow step's settings menu (the gear icon) on the Tools tab of the palette.
  2. Click Usage Permissions.

For more information, see Share steps and libraries.

  1. Click Edit from the callable flow step's settings menu (the gear icon) on the Tools tab of the palette.
  2. Click the Usage tab to view a list of locations (Canvas > Trigger Name) where the callable flow step is used.
    • The Usage tab only appears on a callable flow step's configuration screen when the step is used on one or more canvas in the workflow.

You can also view a Usage list on the Settings tab of the callable flow step's associated trigger. Click the info ('i') icon for the callable flow step on the Tools tab of the palette to view the Canvas > Trigger Name of its related flow.

Property Description
Request ID The unique identifier (UUID) of the request that initiated the trigger.

Callable flow steps do not currently return any information from the flow they call, apart from the ID of the request that initiated the callable flow trigger.