---
title: "List workflows"
method: GET
path: "/workflows"
---

# List workflows

`GET /workflows`

## Query parameters

- `page` integer

## Response `200`

Paginated list of workflows

- object[]
  - `uid` string
  - `name` string
  - `description` string, nullable
  - `tags` string[]
  - `inputs` object — Inputs this workflow accepts, keyed by name. Each value is { type, required }. `url`-typed inputs are validated as http(s) URLs when a run is created.
  - `steps` object[] — Steps in run order
    - `key` string — Stable handle for this step; later steps reference it as {{steps.<key>.<output>}}
    - `type` 'tool' | 'image' | 'animation' — What kind of operation this step performs
    - `ref` string — Tool slug, or template UID for image / animation steps
    - `label` string — Human name of the step's target — the tool's label or the template's name
    - `inputs` object — Step payload, with {{inputs.x}} / {{steps.x.y}} references unresolved
  - `ui_write_access` 'owner_only' | 'team'
  - `api_write_access` 'team' | 'owner_only' | 'nobody' — Who may run this workflow via the API
  - `created_at` string, date-time

---

[API](https://skmtc.dev/bannerbear/apis/bannerbear-v5-api.md) · [All operations](https://skmtc.dev/bannerbear/apis/bannerbear-v5-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bannerbear/bannerbear-v5-api/revisions/6aa425420a10/schema)