> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# Create and run workflows

> How to create, build, and run workflows in Itential Platform's Studio.

Itential Platform includes **Studio** for defining and building automations that can be used by applications in the system. Studio provides a clean, modern interface for arranging and connecting tasks and transitions on a canvas to create flow-based workflows.

![](/_fern-img/9516cc662d1d265ed090f4cff87316e6bce2bda09673918272f13ee8c684f670.webp)

## Terminology

The following terms apply to Studio and workflow design in Itential Platform.

| Term        | Description                                                                                                                                                                                                                                                                          |
| :---------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Automation  | A collection of tasks in a logical order, beginning and ending with terminator tasks (start/end). Also known as a workflow.                                                                                                                                                          |
| Job         | An instance of an automation. It takes a snapshot of the associated automation when created.                                                                                                                                                                                         |
| Metrics     | Measurements of job execution statistics for automations and tasks.                                                                                                                                                                                                                  |
| Queue       | Tasks live in queues where operators with the appropriate permissions can locate available, claimed, scheduled, and completed tasks.                                                                                                                                                 |
| Scheduler   | The process within Itential Platform that scans for automated tasks to be invoked.                                                                                                                                                                                                   |
| Task        | A functional block within an automation. Automated tasks (green) are configured with a run window and execute automatically. Manual tasks (blue) can return multiple values and are assigned to groups to restrict who can work them.                                                |
| Transitions | Connections between tasks that define the direction of workflow execution. Transitions can be success (green), error (red), or failure (red), and follow either a standard (solid line) or revert (dashed line) route. Use revert transitions when moving backwards in the workflow. |
| Variable    | A value that can change depending on the data passed between applications on the network.                                                                                                                                                                                            |

## Workflows in Studio

To start building an automation, select **Studio** (formerly Studio) from the Itential Platform homepage. From the Studio landing page, you can search for an existing automation or create a new one.

### Searching for workflows

To find an existing workflow, click the search icon (magnifying glass) in the Studio top toolbar. From the **Workflows** tab of the **Collection** dialog, browse or search for an existing workflow and click it to open its canvas.

![](/_fern-img/4b17f1ff814e7900bfba076f72a29de8249b900d57a124d3e5c5b24f7029e080.webp)

### Creating workflows

#### Open the Create dialog

Click the **plus (+)** icon on the Studio homepage.

#### Select Automation

Select **Automation** from the type dropdown and enter a name for the new automation.

#### Create

Click **Create**. The workflow opens in the canvas.

#### Build the workflow

The new canvas opens with **Start** and **End** tasks displayed. Add more tasks from the Task Palette by drag and drop:

* The Task Palette appears on the left side of the canvas. It can be moved or closed to free up canvas space. Click **Show Task Palette** in the task toolbar to reopen it.
* Search for a task by typing in the **Filter Tasks** field.
* Drag the desired task from the search results onto the canvas.
* To add a transition, hover over the border of a task until the border highlights, then press and hold the mouse button and drag toward the destination task. Release the mouse when the transition snaps to the destination task.

![](/_fern-img/63bd002f0e48e557e361ab846a5c8d8a6e91f7c026b0fa9364ede3a4f3b90b97.webp)

| Label | UI element           | Function                                                                                                                  |
| :---: | :------------------- | :------------------------------------------------------------------------------------------------------------------------ |
|   1   | Actions Toolbar      | Create a new automation, go to Studio homepage, search, import, and open Projects.                                        |
|   2   | Search Bar           | Find available automations in the system.                                                                                 |
|   3   | Task Toolbar         | Undo, redo, show task palette, recent tasks, search, and spread tasks on canvas.                                          |
|   4   | Automation Title Bar | Validate workflow, save automation, start job, and open secondary actions menu (edit details, duplicate, export, delete). |
|   5   | Task Search          | Search and filter available tasks.                                                                                        |
|   6   | Task Palette         | List of available tasks for the automation.                                                                               |
|   7   | Applications Menu    | Applications that comprise the Studio suite.                                                                              |
|   8   | Sidebar Control      | Shrink or expand the sidebar navigation.                                                                                  |

## Canvas task types

An automation in the canvas consists of four task types: automatic tasks (green), manual tasks (grey), start/end terminators (grey and black), and operational tasks (purple).

Arrows represent transitions and show the direction of the workflow. Studio also supports optional role-based access control (RBAC) by restricting task ownership to authorized groups. Only group members are authorized to work tasks.

![](/_fern-img/c0a81f4e50cc310a03d9d51462e3b36828ff08a2d0c8a45b96aa0a3ba434dfbb.webp)

Transitions are identified by two properties: the exit status of the leading task, and the direction of the transition (standard or revert). Different transitions allow automations to correct anomalies, repeat parts of an automation, skip tasks, manually intervene, or follow the planned execution path.

![](/_fern-img/e3956b7bc71e3920861a698df195e85a4516ffa8c9caa6dbeb61c8f10579d870.webp)

## Automation lifecycle

### Job status

Upon start, a job is set to running status. Running jobs can move into cancelled, completed, or error states.

![](/_fern-img/43b3cd389b16b41dfef219089be398a39f8dca125ce4747015a595386f5d4573.webp)

### Task status

When a job starts, its tasks are set to an incomplete status. From incomplete, tasks move into running or scheduled states. A running task can move to completed, cancelled, or error states.

![](/_fern-img/546642ecd3f0d1d73658ecb9daf8a805797c3fd92805cd3722f9d540cc37a537.webp)

### Variable types

In Studio, variables hold values that can be referenced by devices and applications. Three variable types can be used in a reference task on the canvas.

**Static variables** are hard-coded and maintain the same value for the entire automation run. They cannot be changed programmatically and are used for settings that should not change once a workflow has started.

**Job variables** allow you to use changeable values in the configuration and execution of a job. You create a variable, give it a name and a value, and reference it by name throughout the workflow. Job variables can be passed as inputs each time a workflow is executed, and any task can update their value mid-run. Use task variables instead of job variables whenever possible.

**Task variables** are values produced by a previously executed task in the workflow. They provide reference information for a subsequent task — you choose a prior task, take its output, and use that as the input for the selected task.

## Actors in workflow management

In the context of workflow management, actors execute tasks within a workflow. Setting up an authorization layer ensures tasks are carried out with the appropriate user context and are not executed by unauthorized individuals.

### Assigning actors

When editing an automatic task, you can select the actor — the user that executes the task in a job. By default, the actor is the Itential user, but any platform user can serve as an actor. Available options are Itential (default), Job Initiator (the user that started the job), or any prior manual task user in the workflow.

When an automatic task runs, it calls the method, writes to an audit trail, and is authorized as if that user had called the method via the Northbound API. If the task calls an external system API, Itential Platform uses the actor's credentials in that API call.

Users from manual tasks inside a prior child job are not available as actors. If an actor is selected from a manual task branch that does not run, the automation engine falls back to the Itential user.

![](/_fern-img/692440278b2f8417ca5ee49e912cdcbdb72558093a566a4fe07550cf745632b2.webp)

## Transitions and task states

Transitions connect tasks to each other and control the order of task execution. A transition has two properties: a **binding value** corresponding to a possible finish state of its leading task, and a **direction** determining whether execution moves forward or backward.

### Task finish states

| Finish state | Description                                                                                                                                 |
| :----------- | :------------------------------------------------------------------------------------------------------------------------------------------ |
| Success      | The task executed without error, or matched an evaluation expression.                                                                       |
| Error        | The task encountered errors during execution.                                                                                               |
| Failure      | The task failed to match an evaluation expression, or returned as undefined (as seen with the `evaluation` and `query` tasks respectively). |

The table above assumes automatic tasks. When using **actionable tasks**, finish states are determined and set manually by the end user.

### Transition binding values

The binding value of a transition corresponds to one of the finish states. Success transitions are green, error transitions are red, and failure transitions are purple. After a task is assigned a finish state, the workflow follows any transitions with a matching binding value.

**Example:** A workflow uses `stringConcat` to combine two strings. If no errors occur, the workflow advances to the `evaluation` task. If the combined strings match the evaluation expression, the workflow ends via the success transition. Otherwise, the workflow moves to `runShellCommand` via the failure transition.

![](/_fern-img/e210aac30b29914a45fc24366e836735bafd93d6c749466ffa09eee48e3b8cd7.webp)

### Transition direction

| Direction | Description                                                                                                                       |
| :-------- | :-------------------------------------------------------------------------------------------------------------------------------- |
| Standard  | Moves workflow execution forward toward the End task. Drawn with a solid line.                                                    |
| Revert    | Moves workflow execution backward to a revert point. All tasks from the revert point forward are reset. Drawn with a dashed line. |

**Example:** A workflow uses `getTime` to get the current time. On success, a standard transition advances to `ViewData`. If the user wants to re-run the workflow, the revert failure transition on `ViewData` returns execution to `getTime`.

![](/_fern-img/0401ea0b28c702a40ef199ec1061752b2afd1f12d3ce49c0f7690443910b791b.webp)

### Adding transitions

#### Select the source task

Click the task you want to transition from. The task highlights with a dashed border.

![](/_fern-img/aa7964275cd13a5c8741ea965b25ab6486bfc85d59a969f76e23ece4bc1d5a31.webp)

#### Drag the transition

Click within the dashed border and drag toward the destination task. Transition direction is automatic — it is standard unless you are dragging to an earlier point in the workflow.

#### Set the binding value

While dragging, press **S** for success, **E** for error, or **F** for failure to assign a binding value.

#### Connect to destination

When the transition snaps to the destination task, release the mouse button.

![](/_fern-img/c9da8479dee63771fd74ed576ee6c24737eb7220be9b6823ed404e340bede5bf.webp)

### Changing a binding value

To change the binding value of an existing transition, click the transition to select it (it becomes bold), then press **S**, **E**, or **F** to assign a new binding value. Alternatively, right-click the transition and select a binding value from the context menu.

### Task status symbols (Ops Manager)

Task status symbols on the canvas are used by **Operations Manager** to track task status in a job instance.

| Symbol               | Meaning                                  |
| :------------------- | :--------------------------------------- |
| Green check mark     | Task completed successfully.             |
| Red exclamation mark | Task has errored.                        |
| Blue circular arrows | Task is currently running (manual task). |

## Using canvas search

Studio supports searching automation content through the **Canvas Search** function. The search icon is located at the top left of the main canvas.

![](/_fern-img/3589cfea507a1bf912f05790f8b4639339bb15ad200ff1c6466067f4663e665e.webp)

Canvas Search can also be accessed by right-clicking the canvas and selecting **Show Canvas Search**, or by pressing the keyboard shortcut **Q**.

![](/_fern-img/73e556505e51c61e0a6d603b0a395ed64dcb9d19ca0de842c3ac169c5546e46e.webp)

Clicking the search icon reveals the **Search Palette**, which lists all tasks currently on the canvas.

![](/_fern-img/cc4b7a90c365cebbe117b81717bfe98d64f86445abebdffb3260dad0c558ce2a.webp)

Enter a search term in the **Search your canvas** field. The function queries task summary and description, looking for three words before and three words after the search term. Search options include app, description, id, job variable, name, and summary. Matching terms are highlighted at the bottom of each relevant task. To clear a search, delete the search term.

When a search matches a task that appears in multiple places, all instances are listed and each is brought into focus on the canvas, making them easier to find in complex workflows.

![](/_fern-img/179fdce07b78445bca6d4bd32e1fa55104799cf5755e8b9a8e45e4905730afc4.webp)

Clicking a task in the search list selects and centers it on the canvas.

![](/_fern-img/7e5c2d99d6a7888f649aac09909675ab4ccbae56a90dcb3bddbbd44b7d4fa1cc.webp)

Double-clicking a task in the search list selects, centers, and opens it.

![](/_fern-img/a95a3c1e96e357af2040535dc72843f6d22e63933b31311209ee356ab80f688e.webp)

If multiple results match within the same task, an icon showing the count of **Other Results Not Shown** appears (up to **+4**). In the example below, a search on "stub" matched the Task Summary first, with additional matches hidden behind a **+1** icon. Hover over the icon to see the additional details.

![](/_fern-img/8970cec60430d8ab748e1ae4880d5e45d8e1e7e8895c4c52fffbf6a91cccb846.webp)

## Using reference view

**Reference View** is an interface tool that allows you to see the flow of data through a workflow before making changes. Use it to understand what a task is connected to and how any changes will affect other tasks.

### Enable reference view

Click a task and press **R**, or right-click the task and select **View References** from the context menu.

![](/_fern-img/088bf0a9d584f8ec45843f9d12781c74943d25bcf9dc1b5db5c64b7a7db77fb9.webp)

When Reference View is enabled, all prior tasks (those providing variable inputs to the selected task) and subsequent tasks (those using its output) are shown in a custom node template. All other tasks and transitions are reduced in opacity.

While in Reference View, you can interact with the canvas normally, except for actions that would change a task's references — these trigger a notification suggesting you exit Reference View first.

### Reference view visualizations

The origin task (the one you selected) is outlined with four gray floating corner accents. Prior tasks are highlighted in orange, indicating data flowing into the origin task. Subsequent tasks are highlighted in blue, indicating where data is going.

**Example:** Below, the `Stub` task is the origin task. It is pulling data from the `New Variable` and `Modify` tasks (orange). It is passing data to the `Evaluation` task and another `Stub` task (blue).

![](/_fern-img/24020f1f2d19f0fe293da0de856afe88ab37502b5dcc8cb61d4c0de4ef03e3c4.webp)

When you attempt an action that would change references — such as deleting the origin task — delete options in the context menu are disabled and a warning notification appears in the upper-right corner of the canvas.

![](/_fern-img/bd84bc55aa3c7b09d90cd9b248640327afc325e216d005a9adb265e15eabef36.webp)