List playbooks
ai-sdr:read scope (or a broader one that includes it).
Use this endpoint when you need to browse the AI SDR playbooks you can work with — each playbook holds the tone, voice and writing guidance the AI SDR follows when it drafts messages. Pass type to keep a single scope — global for the Reply-curated playbooks, organization for the ones shared across your organization, or team for the ones scoped to your team — or omit it to get all three merged into one list. Results are returned as a page controlled by the top and skip query parameters; top defaults to 100 and cannot exceed 1000, and search keeps only the playbooks whose name matches the given text. Each entry carries the playbook id, name, description, type, lastUpdatedAt and authorUserId — read a single playbook by its id to see its body and its style files. 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.
Query Parameters
Maximum number of items to return (default 100, max 1000)
Number of items to skip
Filter to a single scope. Omit to merge all scopes. 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.
global, organization, team Case-insensitive substring match on playbook name