API reference
Every endpoint, its parameters and its answer. Each one is also an MCP tool with the same name.
The base URL is https://developers.playbookops.ai/v1. Send your key in the Authorization header, and JSON bodies with Content-Type: application/json.
curl https://developers.playbookops.ai/v1/me \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"Open any endpoint and click Try it to call it with your key. The full spec is at /v1/openapi.json for code generators and API clients.
Account
Who the key belongs to and what it can do.
People
The people in your organization and their job roles.
Projects and items
Projects, their groups and columns, and the items in them.
- GET
/v1/projectsList projects - GET
/v1/projects/{project_id}Get a project - GET
/v1/projects/{project_id}/itemsList a project's items - GET
/v1/items/searchSearch items - GET
/v1/items/{item_id}Get an item - GET
/v1/items/{item_id}/commentsList an item's updates - POST
/v1/projects/{project_id}/itemsCreate an item - POST
/v1/items/{item_id}/commentsPost an update on an item - POST
/v1/items/{item_id}/moveMove an item to another project - POST
/v1/items/{item_id}/completeComplete an item - PATCH
/v1/items/{item_id}Update an item
Tasks
Your own tasks across every project.
Knowledge
Playbooks, documents in Markdown, and AI search across them.
- GET
/v1/playbooksList playbooks - GET
/v1/contentBrowse content - GET
/v1/documents/{document_id}Read a document - POST
/v1/knowledge/searchSearch the knowledge base - POST
/v1/knowledge/who-knowsWho knows about… - POST
/v1/playbooks/{playbook_id}/documentsCreate a document - PATCH
/v1/documents/{document_id}Update a document
Automations
Automations, their runs, and starting them by hand.
Apps
Your organization's apps and the records in them.
- GET
/v1/appsList apps - GET
/v1/apps/{app_id}Get an app - GET
/v1/apps/{app_id}/collections/{collection}/records/{record_id}Get an app record - GET
/v1/apps/{app_id}/collections/{collection}/recordsList an app's records - POST
/v1/apps/{app_id}/collections/{collection}/recordsCreate an app record - PATCH
/v1/apps/{app_id}/collections/{collection}/records/{record_id}Update an app record
KPIs
KPIs and their values over time.