Playbook API
The Playbook API lets you host, organize, search, and ship visual media: a media library and full digital asset manager (DAM) exposed over REST.
Base URL: https://api.playbook.com/v1. Most endpoints are scoped to an
organization (workspace) slug, for example /v1/{org}/assets.
Authentication
Send a Bearer token in the Authorization header:
Authorization: Bearer YOUR_TOKEN. Create and manage tokens yourself in the
Playbook app, with no approval step. Tokens carry read and write scopes,
enforced at the API layer, so a write call made with a read-only token
returns 403.
Response envelope
Successful responses wrap the payload in a top-level data key. List
endpoints return data as an array.
Status codes
401 bad token, 403 missing scope, 404 not found, 406 / 422
validation, 429 rate limited (back off and retry), 5xx server error.
Pagination
List endpoints accept page and per_page query parameters.
Async ingest
Uploads are asynchronous. Creating an asset returns a skeleton immediately;
poll GET /v1/{org}/assets/{token} until is_skeleton is false.
Build with AI
Every operation here is also available to AI assistants through the hosted MCP server. New to the API? Start with Getting Started.
Authentication
- HTTP: Bearer Auth
Security Scheme Type: | http |
|---|---|
HTTP Authorization Scheme: | bearer |