---
title: "List workbooks and their saved flows"
method: GET
path: "/list_workbooks"
tags: ["Data Access"]
---

# List workbooks and their saved flows

`GET /list_workbooks`

## Query parameters

- `user_id` string
- `project_id` string

## Response `200`

Successful retrieval of workbooks and their saved items

- object
  - `workbooks` object[] — List of workbooks and their associated saved flows
    - `workbook_id` string — The id of the workbook.
    - `name` string — The name of the workbook.
    - `description` string — The description of the workbook.
    - `created_ts` string, date-time — Timestamp for when the workbook was created.
    - `saved_items` object[]
      - `saved_item_id` string — The id of the saved flow.
      - `name` string — The name of the saved flow.
      - `description` string — The description of the saved flow.
      - `created_ts` string, date-time — Timestamp for when the saved flow was created.

## Other responses

- `400` — Bad request (missing parameters)
- `401` — Unauthorized (missing or invalid API key)
- `403` — Forbidden (API key does not match)
- `500` — Internal server error

---

[API](https://skmtc.net/gumloop/apis/public-api.md) · [All operations](https://skmtc.net/gumloop/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gumloop/public-api/versions/115f2d6ce387/schema)