---
title: "List playbooks"
method: GET
path: "/v3/ai-sdr/playbooks"
tags: ["AI SDR Playbooks"]
---

# List playbooks

`GET /v3/ai-sdr/playbooks`

<small>_Requires the `ai-sdr:read` scope (or a broader one that includes it)._</small>

Returns a paginated list of playbooks visible to the caller. When `type` is omitted, results from all three scopes (`global`, `organization`, `team`) are merged.

Requires the AI SDR feature on the caller's team.

## Query parameters

- `top` integer
- `skip` integer
- `type` 'global' | 'organization' | 'team' — Identifies the visibility scope of a playbook. - `global` — Reply-curated, read-only across all teams. - `organization` — visible to every team in the caller's organization. - `team` — visible to the caller's team only. `global` playbooks are never created or modified via the API; only `organization` and `team` are accepted on create.
- `search` string

## Response `200`

Paginated list of playbooks

- object
  - `items` object[]
    - `id` string — Composite identifier formatted as `{prefix}-{numericId}` where the prefix encodes the playbook scope: `g` for `global`, `o` for `organization`, `t` for `team` (e.g. `g-1`, `o-42`, `t-7`).
    - `name` string — Display name of the playbook
    - `description` string — Short description of the playbook's purpose
    - `type` 'global' | 'organization' | 'team' — Identifies the visibility scope of a playbook. - `global` — Reply-curated, read-only across all teams. - `organization` — visible to every team in the caller's organization. - `team` — visible to the caller's team only. `global` playbooks are never created or modified via the API; only `organization` and `team` are accepted on create.
    - `lastUpdatedAt` string, date-time — Timestamp of the last modification
    - `authorUserId` integer, nullable — User ID of the playbook author. `null` for `global` playbooks and when the original author is no longer a team member.
  - `hasMore` boolean

## Other responses

- `400` — Invalid pagination parameters
- `401` — Unauthorized. The response body is empty; check the `WWW-Authenticate` header for the expected scheme.
- `403` — AI SDR feature is not available for the caller's team
- `502` — Upstream AI SDR service failure

---

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