---
title: "Get a playbook"
method: GET
path: "/v3/ai-sdr/playbooks/{id}"
tags: ["AI SDR Playbooks"]
---

# Get a playbook

`GET /v3/ai-sdr/playbooks/{id}`

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

Returns a single playbook by its composite id (`g-N` / `o-N` / `t-N`).

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

## Path parameters

- `id` string, required

## Response `200`

Playbook found

- object — Detailed representation of a playbook, returned by get/create/update responses.
  - `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
  - `body` string — Full playbook body — typically Markdown or plain text instructions the AI SDR follows when this playbook is applied.
  - `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.
  - `styleFiles` object[] — Style files attached to the playbook. Managed via the `/style-files` sub-resource — uploads are immediate, deletes are immediate; the field is read-only on the playbook payload.
    - `id` integer — Unique identifier for the style file
    - `fileName` string — Original name of the uploaded file

## Other responses

- `400` — Malformed playbook id
- `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
- `404` — Playbook not found
- `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)