---
title: "ListWorkflows Workflows V2"
method: GET
path: "/v2/workflows"
tags: ["Workflows V2"]
---

# ListWorkflows Workflows V2

`GET /v2/workflows`

List all workflows

## Response `200`

OK response.

- WorkflowsV2ListWorkflowsResponseBody
  - `workflows` WorkflowSlim[], required
    - `condition_groups` ConditionGroupV2[], required — Conditions that apply to the workflow trigger
      - `conditions` ConditionV2[], required — All conditions in this list must be satisfied for the group to be satisfied
        - `operation` ConditionOperationV2, required
          - `label` string, required — Human readable label to be displayed for user to select
          - `value` string, required — Unique identifier for this option
        - `param_bindings` EngineParamBindingV2[], required — Bindings for the operation parameters
          - `array_value` EngineParamBindingValueV2[] — If array_value is set, this helps render the values
            - `label` string, required — Human readable label to be displayed for user to select
            - `literal` string — If set, this is the literal value of the step parameter
            - `reference` string — If set, this is the reference into the trigger scope that is the value of this parameter
          - `value` EngineParamBindingValueV2
            - `label` string, required — Human readable label to be displayed for user to select
            - `literal` string — If set, this is the literal value of the step parameter
            - `reference` string — If set, this is the reference into the trigger scope that is the value of this parameter
        - `subject` ConditionSubjectV2, required
          - `label` string, required — Human readable identifier for the subject
          - `reference` string, required — Reference into the scope for the value of the subject
    - `continue_on_step_error` boolean, required — Whether to continue executing the workflow if a step fails
    - `delay` WorkflowDelay
      - `conditions_apply_over_delay` boolean, required — If this workflow is delayed, whether the conditions should be rechecked between trigger firing and execution
      - `for_seconds` integer, required — Delay in seconds between trigger firing and running the workflow
    - `expressions` ExpressionV2[], required — Expressions that make variables available in the scope
      - `else_branch` ExpressionElseBranchV2
        - `result` EngineParamBindingV2, required
          - `array_value` EngineParamBindingValueV2[] — If array_value is set, this helps render the values
            - `label` string, required — Human readable label to be displayed for user to select
            - `literal` string — If set, this is the literal value of the step parameter
            - `reference` string — If set, this is the reference into the trigger scope that is the value of this parameter
          - `value` EngineParamBindingValueV2
            - `label` string, required — Human readable label to be displayed for user to select
            - `literal` string — If set, this is the literal value of the step parameter
            - `reference` string — If set, this is the reference into the trigger scope that is the value of this parameter
      - `label` string, required — The human readable label of the expression
      - `operations` ExpressionOperationV2[], required
        - `branches` ExpressionBranchesOptsV2
          - `branches` ExpressionBranchV2[], required — The branches to apply for this operation
            - `condition_groups` ConditionGroupV2[], required — When one of these condition groups are satisfied, this branch will be evaluated
              - …
            - `result` EngineParamBindingV2, required
              - …
          - `returns` ReturnsMetaV2, required
            - `array` boolean, required — Whether the return value should be single or multi-value
            - `type` string, required — Expected return type of this expression (what to try casting the result to)
        - `filter` ExpressionFilterOptsV2
          - `condition_groups` ConditionGroupV2[], required — The condition groups to apply in this filter. Only one group needs to be satisfied for the filter to pass.
            - `conditions` ConditionV2[], required — All conditions in this list must be satisfied for the group to be satisfied
              - …
        - `navigate` ExpressionNavigateOptsV2
          - `reference` string, required — The reference within the scope to navigate to
          - `reference_label` string, required — The name of the reference to navigate to
        - `operation_type` 'navigate' | 'filter' | 'count' | 'min' | 'max' | 'sum' | 'random' | 'first' | 'parse' | 'branches', required — The type of the operation
        - `parse` ExpressionParseOptsV2
          - `returns` ReturnsMetaV2, required
            - `array` boolean, required — Whether the return value should be single or multi-value
            - `type` string, required — Expected return type of this expression (what to try casting the result to)
          - `source` string, required — Source expression that is evaluated to a result
        - `returns` ReturnsMetaV2, required
          - `array` boolean, required — Whether the return value should be single or multi-value
          - `type` string, required — Expected return type of this expression (what to try casting the result to)
      - `reference` string, required — A short ID that can be used to reference the expression
      - `returns` ReturnsMetaV2, required
        - `array` boolean, required — Whether the return value should be single or multi-value
        - `type` string, required — Expected return type of this expression (what to try casting the result to)
      - `root_reference` string, required — The root reference for this expression (i.e. where the expression starts)
    - `folder` string — Folder to display the workflow in
    - `id` string, required — Unique identifier for the workflow
    - `include_private_incidents` boolean, required — Whether to include private incidents
    - `name` string, required — The human-readable name of the workflow
    - `once_for` EngineReferenceV2[], required — This workflow will run 'once for' a list of references
      - `array` boolean, required — If true, the reference can refer to 0 to many items
      - `key` string, required — The key of the field this is a reference to
      - `label` string, required — Human readable label for the field (with context)
      - `type` string, required — The type of this resource in the engine
    - `runs_from` string, date-time — The time from which this workflow will run on incidents
    - `runs_on_incident_modes` string[], required — Which modes of incident this should run on (defaults to just standard incidents)
    - `runs_on_incidents` 'newly_created' | 'newly_created_and_active', required — Which incidents should the workflow be applied to? (newly_created or newly_created_and_active)
    - `shortform` string — Shortform used to trigger manual workflows in Slack - e.g. `/inc workflows page-ceo`
    - `state` 'active' | 'disabled' | 'draft' | 'error', required — The state of the workflow (e.g. is it draft, or disabled)
    - `steps` StepConfigSlim[], required — Steps that are executed as part of the workflow
      - `label` string, required — Human readable identifier for this step
      - `name` string, required — Unique name of the step in the engine
    - `trigger` TriggerSlim, required
      - `label` string, required — Human readable identifier for this trigger
      - `name` string, required — Unique name of the trigger
    - `version` integer, required — Revision of the workflow, uniquely identifying its version

---

[API](https://skmtc.net/incident/apis/incident-io.md) · [All operations](https://skmtc.net/incident/apis/incident-io/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/incident/incident-io/revisions/602fc25ddd76/schema)
