Get a playbook
ai-sdr:read scope (or a broader one that includes it).
Use this endpoint when you need the full content of a single playbook, identified by its composite id — the prefix encodes the scope, g- for global, o- for organization and t- for team, exactly as returned in the list response. Alongside the name, description, type, lastUpdatedAt and authorUserId you already see in the list, the response carries body, the tone and writing guidance itself, and styleFiles, the reference documents attached to the playbook. The AI SDR feature must be enabled for your team.
Authorizations
Authenticate every request with a Bearer token. Pass your Reply API key in the
Authorization header:
Get your API key from the Reply dashboard: Settings → API Key.
Path Parameters
Composite playbook id (g-N for global, o-N for organization, t-N for team)
Response
Playbook found
Detailed representation of a playbook, returned by get/create/update responses.
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).
Display name of the playbook
Short description of the playbook's purpose
Full playbook body — typically Markdown or plain text instructions the AI SDR follows when this playbook is applied.
Visibility scope of the playbook. Set on create and immutable thereafter.
global, organization, team Timestamp of the last modification
User ID of the playbook author. null for global playbooks and when the original author is no longer a team member.
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.