---
title: "List Sub Workflows"
method: GET
path: "/v3/workflow-editor/sub-workflows"
tags: ["workflow-editor"]
---

# List Sub Workflows

`GET /v3/workflow-editor/sub-workflows`

## Request

- Base URL: `https://api.mentium.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mentium.io/v3/workflow-editor/sub-workflows`
- Auth: HTTP bearer

List workflows that can be called as sub-workflows.

Returns all STANDARD workflows in the user's workspace that have a
trigger node of type ``sub-workflow-trigger``, along with their
input field contract. ``runnable`` narrows them to what an agent may start.

## Query parameters

- `runnable` boolean: Only the workflows an agent's run_workflow tool may start: active, not a test copy or a version child, on the v3 engine

## Headers

- `mentium-workspace-id` string, nullable

## Response `200`

Successful Response

- SubWorkflowListOut: List of callable sub-workflows.
  - `items` SubWorkflowOut[], required
    - `id` string, required
    - `name` string, required
    - `description` string, nullable
    - `is_active` boolean
    - `input_fields` SubWorkflowInputFieldOut[]
      - `name` string, required
      - `type` string
      - `description` string
      - `required` boolean
      - `default` unknown
      - `object_fields` SubWorkflowInputFieldOut[]
      - `item_fields` SubWorkflowInputFieldOut[]
      - `item_type` string, nullable
  - `total` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mentium/apis/mentium-api.md) - [All operations](https://skmtc.dev/mentium/apis/mentium-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mentium/apis/mentium-api/revisions/b4ed8e59432e?raw)