Configure workflows

Published

September 11, 2026

Set up workflows to match your organizational needs. Workflows can be as simple or as complex as required, with multiple and discrete workflows supported for unique triggers and scenarios.

Prerequisites

Create custom workflows

To set up a new custom workflow, you’ll need to complete these four steps in sequence:

  1. Add a new workflow — Create a new workflow in Draft status.
  2. Configure the workflow steps — Configure the workflow steps to define the workflow’s logic.
  3. Link the workflow together — Link the workflow steps together to define the workflow’s flow.
  4. Publish the workflow — Publish the workflow to make it available for use.

1. Add new workflows

To add a new blank workflow:

  1. In the left sidebar, click Settings.

  2. Under Governance, select Workflows.

  3. Click Add Workflow.

  4. Select the Workflow Target type to add:

    • Inventory Record — Workflows that apply to records in your inventory.3
    • Artifact — Workflows that apply to logged artifacts.4
    • Risk Tiering — Workflows that govern risk tier assessments or templates.5 To add one, select the Risk Tiering Workflows tab and click Add Risk Tiering Workflow.

  1. Enter a Title and a Description for the workflow.

  2. Select the Record Type6 this workflow applies to.

  3. Under Workflow Start, select when the workflow should be initiated:

  • Manually — Start this workflow manually.7
  • On Inventory Record Registration — Start this workflow when a record is registered in your inventory.8
  • On Field Change — Start this workflow on a change to a specific record inventory field.9 To configure, select a field under Inventory Record Field To Monitor.
  • On Monitoring Threshold Breach — Start this workflow when an ongoing monitoring metric breaches its threshold.10 To configure, keep Any metric breach enabled, or disable it and select the metrics to watch under Metrics to monitor.
  • Via Webhook — Start this workflow when a webhook event is received.
8 
NonePlease note that only one workflow can be configured to initiate on record registration.


Register records in the inventory

9 Edit inventory fields

When selecting date or date time fields, check Schedule workflow start for this date to set the workflow to trigger on the existing date captured in the field rather than when its value changes.

10 Trigger workflows on threshold breach

The workflow starts when a metric enters a breached state, not on every breaching reading — a monitoring job that keeps reporting the same breach starts one workflow, not one per run.

  1. Under Workflow Expected Duration, define the SLA for the workflow based on the start date in days, weeks, months, or years.

  2. Click Save Draft to save your blank workflow, and then configure your workflow steps.

  1. Enter a Title and a Description for the workflow.

  2. Select the Artifact Type11 this workflow applies to.

  3. Select the Inventory Record Type12 this artifact workflow is scoped to.

  4. Under Workflow Start, select when the workflow should be initiated:

12 Manage inventory record types

  • Record stages and record fields available to this workflow are defined by the inventory record type selected.
  • The type of inventory record an artifact workflow is scoped to cannot be changed after creation.
  • Manually — Start this workflow manually.13
  • On Artifact Registration — Start this workflow when an artifact is logged on a record.14
  • On Field Change — Start this workflow when a specific artifact field changes.15 To configure, select a field under Artifact Field to Monitor.
  • Via Webhook — Start this workflow when a webhook event is received.
14 
NonePlease note that only one workflow can be configured to initiate on registration for each type of artifact.


Log artifacts

15 Manage artifact fields

Only artifact fields available to the selected artifact type appear. Artifact fields that apply to all artifact types also appear. Record fields displayed from the parent record are not available as triggers.

When selecting date or date time fields, check Schedule workflow start for this date to set the workflow to trigger on the existing date captured in the field rather than when its value changes.

  1. Under Workflow Expected Duration, define the SLA for the workflow based on the start date in days, weeks, months, or years.
  1. Click Save Draft to save your blank workflow, and then configure your workflow steps.

  1. Enter a Title and a Description for the workflow.

  2. Under Applies to, select whether the workflow governs a Risk Tier Assessment or a Risk Tier Template.16

  3. Select the workflow’s scope — the Inventory Record Type (assessment workflows) or the Risk Tier Template (template workflows).

  4. Under Workflow Start, select when the workflow should be initiated:

16 Set up risk tiering workflows

The subject and scope are structural and cannot be changed after the workflow is created.

  • Manually — Start this workflow manually from the assessment or template page.
  • On Risk Assessment Published — Start this workflow when an assessment is published. (Assessment workflows only.)17
  • On Risk Tier Template Published — Start this workflow when a version of the template is published. (Template workflows only.)18
17 
NonePlease note that only one workflow can be configured to start on publish for each inventory record type (assessments) or template (templates).


Set up risk tiering workflows

18 
NonePlease note that only one workflow can be configured to start on publish for each inventory record type (assessments) or template (templates).


Set up risk tiering workflows

  1. Click Save Draft to save your blank workflow, and then configure your workflow steps.

2. Configure workflow steps

To add or edit workflow steps:

  1. In the left sidebar, click Settings.

  2. Under Governance, select Workflows.

  3. Click on the workflow you’d like to modify to open that workflow’s details page.19

  4. Click Edit Workflow to open the workflow editor, then:

    • For workflows that start when a webhook is received, double-click the Start node to configure the webhook.20
    • To add a step, drag and drop a new step onto the canvas.
    • Double-click the new step to open up the configuration modal.

  5. After you’re finished with step configuration, click Update Step to apply your changes.

  6. After you’ve configured a step,21 you can then link your workflow together.

    20 
  1. Click Copy to the right of URL to copy the webhook URL to your clipboard. This webhook URL is where you should send your POST request.
  2. Under Select Target {record-type} Record for Payload, choose a record from your inventory to populate the target for the payload.
  3. Click Copy to the right of Payload to copy the payload to include in your POST request to your clipboard.
  4. Click to the right of x-api-key and x-api-secret and their values to copy them to your clipboard.
  5. Send your POST request to the webhook URL and include these headers with your request to authenticate your call.

21 To delete a step, refer to: Delete workflow steps

Refer to Introduction to workflows for information on available step types and details on how to set up conditional requirements.

3. Link workflow together

To initiate the beginning of your workflow:22

22 After you’ve configured your workflow steps, you can then link your workflow together.

  1. Locate the Start of your workflow.

  2. Drag from the at the bottom of Start to the top on the first step of your workflow.

  3. Continue with linking the rest your steps together.

To link subsequent steps together:

  • Click the below or to the right or left of the earlier step and drag it to connect to the top on the subsequent step.
  • You’re also able to link several different steps together at various points in the workflow, including stages that may circle back to previous steps.

Hover over a workflow step to view an animation of the steps connecting to and from that step.

Link approval steps

Approval steps need to be subsequently linked to both a Rejected and an Approved Inventory Record Stage Change step:23

  1. First, configure an Approval step.

  2. Then, drag two Inventory Record Stage Change steps onto the canvas:

    • Assign a stage associated with rejection to one in the Set Inventory Record Stage To field.
    • Assign a stage associated with approval to the other in the Set Inventory Record Stage To field.

  3. Then, from the bottom of your Approval step:

  • Connect the left (red) to your rejection step.24
  • Connect the right (green) to your approval step.25

24 When complete, the workflow arrow will display as Rejected.

25 When complete, the workflow arrow will display as Approved.

When all your workflow steps have been linked together:

  1. Designate the end of your workflow by dragging an End step onto the canvas.

  2. Link relevant previous steps to the End step by clicking on the bottom of those steps, and dragging to the top of the End step.

  3. When you are finished configuring your workflow, click Save to apply your changes.


Click Tidy Layout at any time for a linear view of your workflow.

4. Publish workflow

ImportantOnce a workflow is published, it cannot be reverted to draft status.

You can continue to make changes to published workflows by creating new versions of workflows.26

Once you are satisfied with the setup of your workflow, publish the workflow for use:

  1. In the left sidebar, click Settings.

  2. Under Governance, select Workflows.

  3. Locate the workflow you want to publish.

  4. Under the Actions column, click and select Publish Workflow.

    You can also publish a draft workflow from its details page — under Actions, click Publish Workflow.

  5. Click Yes, Publish to confirm the publication of the workflow.

Clone existing workflows

To create a copy of an existing workflow as a new draft workflow:27

27 If a cloned workflow’s Workflow Start trigger conflicts with an existing workflow, the cloned workflow will be set to manual initiation instead.

  1. In the left sidebar, click Settings.

  2. Under Governance, select Workflows.

  3. Locate the workflow you’d like to clone.28

  4. Under the Actions column, click and select Clone Workflow.

    You can also clone a workflow from its details page29 — under Actions, click Clone Workflow.

  5. Make your changes to the workflow’s Title and Workflow Type.

    Additional changes can be made to the cloned workflow after cloning by editing.

Once you are satisfied with the setup of your workflow, publish the workflow for use.

Edit existing workflows

NoneSaving edits to a workflow already executed on records or artifacts will create a new version of the workflow.
  • Workflows executed on records or artifacts will not be updated to the new version. To apply the latest version of a workflow, abort the existing version of the workflow and manually initiate the workflow again.30
  • Older versions of a workflow are read-only and cannot be edited or initiated on records or artifacts.

You can edit a workflow in several ways:

  1. In the left sidebar, click Settings.

  2. Under Governance, select Workflows.

  3. Click on the workflow you’d like to modify to open that workflow’s details page.31

  4. On the details page, click Edit Workflow to open the workflow editor.

    Edit Workflow is available when viewing the latest version of the workflow. To edit the workflow’s details instead, such as its title and description, click Edit Details under Actions.

  1. In the left sidebar, click Inventory.

  2. Select a record or find your record by applying a filter or searching for it.32

  3. On the landing page of your record, locate the Active Workflows section.

  4. Click on the name of the workflow you’d like to edit to open that specific workflow’s details.

  5. On the workflow’s detail modal, click on the in the top-right hand corner and select Edit Workflow.

  1. On the details page of your artifact,33 locate the Active Workflows section.

  2. Click on the name of the workflow you’d like to edit to open that specific workflow’s details.

  3. On the workflow’s detail modal, click on the in the top-right hand corner and select Edit Workflow.

  1. Make your desired changes to step configuration34 and step relationships35 on your workflow.

  2. When you are finished, click Save New Version to apply your changes.

  3. Enter your Version Notes to describe your changes.

  4. Close the workflow editor to return to the workflow’s details page, where the diagram reflects your saved changes.

Delete workflow steps

ImportantWorkflow step deletion is permanent.

Deleting workflow steps on workflows active on records may result in malfunctioning workflows.

  1. Hover over the step you want to delete.

  2. When the menu appears, click on it and select Delete.

  3. Click Yes, Delete Step to confirm removal of the step.

  4. When you are finished, click Save New Version to apply your changes.

Delete existing workflows

ImportantWorkflow deletion is permanent.
  • If a workflow is in use on a record, that record will not be impacted.
  • Deletion will prevent any future runs of that workflow.

  1. In the left sidebar, click Settings.

  2. Under Governance, select Workflows.

  3. Locate the workflow you would like to remove.36

  4. Under the Actions column, click and select Delete Workflow.

    You can also delete a workflow from its details page37 — under Actions, click Delete Workflow.

  5. Click Yes, Delete Workflow to permanently remove that workflow and make it inaccessible for any future runs.

Learn more