---
title: "List workflows"
method: GET
path: "/api/v1/workflows"
tags: ["Workflows"]
---

# List workflows

`GET /api/v1/workflows`

Returns workflow definitions available to the browser workflow pages. Real-mode servers may return 501 until workflow cataloging is implemented.

## Query parameters

- `page[limit]` integer
- `page[offset]` integer

## Response `200`

Paginated workflow summaries

- PaginatedWorkflowListResponse — Paginated list of workflows.
  - `data` WorkflowListItem[], required
    - `name` string, required
    - `slug` string, required
    - `filename` string, required
    - `last_run` WorkflowLastRunSummary — Most recent run timestamp for a workflow.
      - `ran_at` string, date-time, nullable
    - `schedule` WorkflowScheduleSummary — Workflow schedule summary shown in workflow lists.
      - `expression` string, required
      - `next_run` string, date-time, nullable
  - `pagination` PaginationMeta — Pagination metadata included in every paginated response.
    - `has_more` boolean, required — Whether additional pages of results are available.
    - `total` integer — Total number of items matching the current filters. Optional — only populated by endpoints that compute the full count cheaply (e.g. in-memory filtering). When omitted, clients should rely on `has_more` and cursor through pages.

## Other responses

- `501` — Workflow cataloging is not implemented in real mode

---

[API](https://skmtc.net/fabro-sh/apis/fabro-run-api.md) · [All operations](https://skmtc.net/fabro-sh/apis/fabro-run-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fabro-sh/fabro-run-api/revisions/bee030053823/schema)