---
title: "List Playbooks"
method: GET
path: "/v1/playbooks/"
tags: ["playbooks"]
---

# List Playbooks

`GET /v1/playbooks/`

Retrieve a paginated list of playbooks for your organization.

- Results are sorted by playbook creation time in descending order
  (newest first).
- `updated_at` reflects the latest version's update timestamp,
  falling back to its creation time, and finally to the playbook's
  own creation time when no version exists. (Because results are
  sorted by playbook creation time, this field is not monotonic
  across pages.)
- Soft-deleted playbooks are excluded.

## Query parameters

- `cursor` string, nullable — Cursor for pagination
- `limit` integer — Number of items per page
- `direction` 'next' | 'prev' — Pagination direction

## Response `200`

Successful Response

- PaginatedResponsePlaybookPreview
  - `data` PlaybookPreview[], required
    - `id` string, required
    - `title` string, nullable
    - `playbook_type` 'sales' | 'customer_success' | 'autogen_us' | 'autogen_emea' | 'autogen_apac', required — Enum for playbook types.
    - `team_label` string, nullable
    - `updated_at` string, date-time, required
  - `pagination` CursorPagination, required — Cursor-based pagination.
    - `next_cursor` string, nullable
    - `previous_cursor` string, nullable

## Other responses

- `401` — Unauthorized - Invalid or missing API key
- `422` — Validation Error

---

[API](https://skmtc.dev/glyphic/apis/airspeed-api.md) · [All operations](https://skmtc.dev/glyphic/apis/airspeed-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/glyphic/airspeed-api/revisions/87cd819002a7/schema)