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, 402 monthly quota exhausted,
404 not found, 406 / 422 validation, 429 rate limited (back off and
retry), 5xx server error.
Request quota
Every organization-scoped request counts against the workspace's monthly
allowance, including ones that fail validation or authorization. Each
response carries X-API-Quota-Limit, X-API-Quota-Remaining and
X-API-Quota-Reset.
Once the allowance is spent, requests return 402 with the code
api_quota_exceeded and a Retry-After header. Do not retry a 402 —
unlike 429, an exhausted monthly quota stays exhausted for days. Pro and
Team workspaces can raise the ceiling by enabling usage billing on the
Developers tab. See Conventions
for the per-plan numbers.
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 |