---
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

## Changes

- **2026-05-23** `f86b728d9d17` — 1 info
  - added the optional property `pagination/total` to the response with the `200` status

[Change history](https://skmtc.dev/fabro-sh/apis/fabro-run-api/changes/api/v1/workflows/get.md)

---

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