# Playbook API

**Canonical:** https://apis.io/apis/playbook-com/playbook-com-api/  
**Provider:** Playbook — https://apis.io/providers/playbook-com/  
**Base URL:** https://api.playbook.com/v1  
**Documentation:** https://dev.playbook.com/docs/api/me

Playbook API is published by [Playbook](https://apis.io/providers/playbook-com/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Playbook API as documented publicly: 24 operations. Contract generated from the documentation by API Evangelist (2026-10-25); not the provider's own document.

## Operations (24)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/{slug}/assets/{token}/change_tags` | Updates asset tags |
| GET | `/v1/{slug}/assets/{token}/children` | Get children for asset if it is a group |
| GET | `/v1/{slug}/assets/{token}/comments` | Asset comments |
| GET | `/v1/{slug}/assets/{token}/download` | Download Asset |
| POST | `/v1/{slug}/assets/{token}/revert` | Revert Asset to a Version |
| GET | `/v1/{slug}/assets/{token}/versions` | Lists an asset's immutable version history newest-first (paginated). |
| POST | `/v1/{slug}/assets/batch_show` | Read Many Assets |
| POST | `/v1/{slug}/assets/copy_assets` | Bulk copy assets to a different board (async operation) |
| POST | `/v1/{slug}/assets/group_assets` | Groups multiple assets together under a parent asset |
| POST | `/v1/{slug}/assets/move_assets` | Bulk move assets to a different board |
| POST | `/v1/{slug}/assets/ungroup_assets` | Removes assets from their groups, making them individual assets again. |
| GET | `/v1/{slug}/boards/{boardToken}/assets` | Get collection's assets |
| POST | `/v1/{slug}/imports` | Imports Google Drive or Dropbox folders into a board; the provider is the one of the source_token connection. |
| GET | `/v1/{slug}/imports/{token}` | Returns an import's status and file counts. |
| GET | `/v1/{slug}/users` | Get list of users |
| GET | `/v1/me` | Get current user's info |
| GET | `/v1/organizations` | Get current user's organizations |
| GET | `/v1/organizations/{slug}` | Get info about one organization |
| POST | `/v1/trigger` | Create a new webhook trigger. |
| DELETE | `/v1/trigger/{id}` | Delete a webhook trigger. |
| DELETE | `/v1/users/{token}` | Delete user |
| GET | `/v1/users/{token}` | Get info about one user |
| GET | `/v1/users/{token}/uploads` | Get info about user's uploads |
| GET | `/v1/{org}/assets/{token}` | Poll an asset until it is no longer a skeleton. |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/playbook-com/openapi/_ae-authored/playbook-com-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/playbook-com/json-schema/playbook-com-post-v1-slug-assets-group-assets-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/playbook-com/json-schema/playbook-com-post-v1-slug-assets-batch-show-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/playbook-com/json-schema/playbook-com-post-v1-slug-assets-batch-show-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/playbook-com/json-schema/playbook-com-get-v1-organizations-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/playbook-com/json-schema/playbook-com-get-v1-org-assets-token-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/playbook-com/json-schema/playbook-com-get-v1-slug-assets-token-comments-response-schema.json
- **APIsJSON** — https://artifacts.apis.io/playbook-com/apis.yml

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/playbook-com/playbook-com-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/playbook-com/.
