Playbook

Playbook API

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

Documentation GitHub OpenAPI

Operations 24

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. #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/playbook-com:playbook-com-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.1.0
info:
  title: Playbook API
  version: '2026-10-25'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-25: 24 operation(s) read from 24 public documentation page(s) (each
    operation names its page in x-source). This is not the provider''s published contract; Playbook has published no machine-readable contract
    that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 0
    documentation: 24
    pages-with-code: 0
    pages-read: 24
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-25'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://dev.playbook.com/docs/api/me
  - https://dev.playbook.com/docs/api/get-user
  - https://dev.playbook.com/docs/api/get-import
  - https://dev.playbook.com/docs/api/list-users
  - https://dev.playbook.com/docs/api/copy-assets
  - https://dev.playbook.com/docs/api/delete-user
  - https://dev.playbook.com/docs/api/move-assets
  - https://dev.playbook.com/docs/api/group-assets
  - https://dev.playbook.com/docs/api/playbook-api
  - https://dev.playbook.com/docs/api/revert-asset
  - https://dev.playbook.com/docs/api/start-import
  - https://dev.playbook.com/docs/api/asset-children
  - https://dev.playbook.com/docs/api/asset-comments
  - https://dev.playbook.com/docs/api/asset-versions
  - https://dev.playbook.com/docs/api/create-trigger
  - https://dev.playbook.com/docs/api/delete-trigger
  - https://dev.playbook.com/docs/api/download-asset
  - https://dev.playbook.com/docs/api/ungroup-assets
  - https://dev.playbook.com/docs/api/get-organization
  - https://dev.playbook.com/docs/api/get-user-uploads
  - https://dev.playbook.com/docs/api/my-organizations
  - https://dev.playbook.com/docs/api/assets-batch-show
  - https://dev.playbook.com/docs/api/change-asset-tags
  - https://dev.playbook.com/docs/api/collection-assets
servers:
- url: https://api.playbook.com/v1
paths:
  /v1/{slug}/assets/{token}/change_tags:
    post:
      operationId: post_v1_slug_assets_token_change_tags
      tags:
      - Assets
      summary: Updates asset tags
      x-source: https://dev.playbook.com/docs/api/change-asset-tags
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      - name: token
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/{slug}/assets/{token}/children:
    get:
      operationId: get_v1_slug_assets_token_children
      tags:
      - Assets
      summary: Get children for asset if it is a group
      x-source: https://dev.playbook.com/docs/api/asset-children
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      - name: token
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/{slug}/assets/{token}/comments:
    get:
      operationId: get_v1_slug_assets_token_comments
      tags:
      - Assets
      summary: Asset comments
      x-source: https://dev.playbook.com/docs/api/asset-comments
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      - name: token
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1SlugAssetsTokenCommentsResponse'
      x-evidence:
        kind: documentation
  /v1/{slug}/assets/{token}/download:
    get:
      operationId: get_v1_slug_assets_token_download
      tags:
      - Assets
      summary: Download Asset
      x-source: https://dev.playbook.com/docs/api/download-asset
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      - name: token
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1SlugAssetsTokenDownloadResponse'
      x-evidence:
        kind: documentation
  /v1/{slug}/assets/{token}/revert:
    post:
      operationId: post_v1_slug_assets_token_revert
      tags:
      - Assets
      summary: Revert Asset to a Version
      description: Restores the asset head content to a prior stored version_number. Revert moves the head forward, snapshots the pre‑revert head
        as a new source, and returns the new head_version_number. Optional comment is recorded on the snapshot.
      x-source: https://dev.playbook.com/docs/api/revert-asset
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      - name: token
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/{slug}/assets/{token}/versions:
    get:
      operationId: get_v1_slug_assets_token_versions
      tags:
      - Assets
      summary: Lists an asset's immutable version history newest-first (paginated).
      x-source: https://dev.playbook.com/docs/api/asset-versions
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      - name: token
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/{slug}/assets/batch_show:
    post:
      operationId: post_v1_slug_assets_batch_show
      tags:
      - Assets
      summary: Read Many Assets
      x-source: https://dev.playbook.com/docs/api/assets-batch-show
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1SlugAssetsBatchShowRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1SlugAssetsBatchShowResponse'
      x-evidence:
        kind: documentation
  /v1/{slug}/assets/copy_assets:
    post:
      operationId: post_v1_slug_assets_copy_assets
      tags:
      - Assets
      summary: Bulk copy assets to a different board (async operation)
      description: Enqueues a bulk copy of assets to another board.
      x-source: https://dev.playbook.com/docs/api/copy-assets
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '202':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/{slug}/assets/group_assets:
    post:
      operationId: post_v1_slug_assets_group_assets
      tags:
      - Assets
      summary: Groups multiple assets together under a parent asset
      x-source: https://dev.playbook.com/docs/api/group-assets
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1SlugAssetsGroupAssetsResponse'
      x-evidence:
        kind: documentation
  /v1/{slug}/assets/move_assets:
    post:
      operationId: post_v1_slug_assets_move_assets
      tags:
      - Assets
      summary: Bulk move assets to a different board
      x-source: https://dev.playbook.com/docs/api/move-assets
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/{slug}/assets/ungroup_assets:
    post:
      operationId: post_v1_slug_assets_ungroup_assets
      tags:
      - Assets
      summary: Removes assets from their groups, making them individual assets again.
      x-source: https://dev.playbook.com/docs/api/ungroup-assets
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/{slug}/boards/{boardToken}/assets:
    get:
      operationId: get_v1_slug_boards_boardToken_assets
      tags:
      - Boards
      summary: Get collection's assets
      x-source: https://dev.playbook.com/docs/api/collection-assets
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      - name: boardToken
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/{slug}/imports:
    post:
      operationId: post_v1_slug_imports
      tags:
      - Imports
      summary: Imports Google Drive or Dropbox folders into a board; the provider is the one of the source_token connection.
      x-source: https://dev.playbook.com/docs/api/start-import
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/{slug}/imports/{token}:
    get:
      operationId: get_v1_slug_imports_token
      tags:
      - Imports
      summary: Returns an import's status and file counts.
      x-source: https://dev.playbook.com/docs/api/get-import
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      - name: token
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/{slug}/users:
    get:
      operationId: get_v1_slug_users
      tags:
      - Users
      summary: Get list of users
      x-source: https://dev.playbook.com/docs/api/list-users
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1SlugUsersResponse'
      x-evidence:
        kind: documentation
  /v1/me:
    get:
      operationId: get_v1_me
      tags:
      - Me
      summary: Get current user's info
      x-source: https://dev.playbook.com/docs/api/me
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/organizations:
    get:
      operationId: get_v1_organizations
      tags:
      - Organizations
      summary: Get current user's organizations
      x-source: https://dev.playbook.com/docs/api/my-organizations
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1OrganizationsResponse'
      x-evidence:
        kind: documentation
  /v1/organizations/{slug}:
    get:
      operationId: get_v1_organizations_slug
      tags:
      - Organizations
      summary: Get info about one organization
      x-source: https://dev.playbook.com/docs/api/get-organization
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '2000':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/trigger:
    post:
      operationId: post_v1_trigger
      tags:
      - Trigger
      summary: Create a new webhook trigger.
      x-source: https://dev.playbook.com/docs/api/create-trigger
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1TriggerResponse'
      x-evidence:
        kind: documentation
  /v1/trigger/{id}:
    delete:
      operationId: delete_v1_trigger_id
      tags:
      - Trigger
      summary: Delete a webhook trigger.
      x-source: https://dev.playbook.com/docs/api/delete-trigger
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/users/{token}:
    delete:
      operationId: delete_v1_users_token
      tags:
      - Users
      summary: Delete user
      x-source: https://dev.playbook.com/docs/api/delete-user
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    get:
      operationId: get_v1_users_token
      tags:
      - Users
      summary: Get info about one user
      x-source: https://dev.playbook.com/docs/api/get-user
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/users/{token}/uploads:
    get:
      operationId: get_v1_users_token_uploads
      tags:
      - Users
      summary: Get info about user's uploads
      x-source: https://dev.playbook.com/docs/api/get-user-uploads
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/{org}/assets/{token}:
    get:
      operationId: get_v1_org_assets_token
      tags:
      - Assets
      summary: Poll an asset until it is no longer a skeleton.
      description: Used for asynchronous ingest; repeatedly GET this endpoint until the returned asset's `is_skeleton` field is false.
      x-source: https://dev.playbook.com/docs/api/playbook-api
      parameters:
      - name: org
        in: path
        required: true
        schema:
          type: string
      - name: token
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1OrgAssetsTokenResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetV1SlugAssetsTokenCommentsResponse:
      type: object
      properties:
        '200':
          type: string
          description: successful
    GetV1SlugAssetsTokenDownloadResponse:
      type: object
      properties:
        '200':
          type: string
          description: successful
    PostV1SlugAssetsBatchShowRequest:
      type: object
      properties:
        asset_tokens:
          type: array
          description: Array of up to 100 asset tokens to retrieve.
      required:
      - asset_tokens
    PostV1SlugAssetsBatchShowResponse:
      type: object
      properties:
        '200':
          type: string
          description: Full metadata for the requested assets.
        '406':
          type: string
          description: Successful asset_tokens missing, empty, or not an array of tokens.
        '422':
          type: string
          description: More than 100 tokens provided.
    PostV1SlugAssetsGroupAssetsResponse:
      type: object
      properties:
        '200':
          type: string
          description: successfully grouped assets
        '401':
          type: string
          description: unauthenticated token without the write scope
        '403':
          type: string
          description: child assets not found
        '404':
          type: string
          description: empty child asset tokens
        '406':
          type: string
          description: cannot group into an asset that is already part of a group
        '422':
          type: string
          description: Previous Retry Video Processing
    GetV1SlugUsersResponse:
      type: object
      properties:
        '200':
          type: string
          description: successful
    GetV1OrganizationsResponse:
      type: object
      properties:
        '200':
          type: string
          description: successful
        '401':
          type: string
          description: unauthenticated
    PostV1TriggerResponse:
      type: object
      properties:
        '200':
          type: string
        '400':
          type: string
    GetV1OrgAssetsTokenResponse:
      type: object
      properties:
        data:
          type: object
          description: Asset payload wrapped in a top‑level data key.
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      x-source: https://dev.playbook.com/docs/api/create-organization-board-access-token/
tags:
- name: Assets
- name: Boards
- name: Imports
- name: Me
- name: Organizations
- name: Trigger
- name: Users
security:
- Bearer: []