Knowledge
Playbooks, documents in Markdown, and AI search across them.
/v1/playbooksList playbooks
Playbooks you can see, newest first (up to 15), with how many documents each has.
knowledge:readMCP tool list_playbooksQuery parameters
searchstring or nullPart of a playbook's name or description
Response
datalist of PlaybookRequired
curl "https://developers.playbookops.ai/v1/playbooks" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"{
"data": [
{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"name": "Ana Ruiz",
"description": "Confirm the date and ask about parking.",
"document_count": 0,
"url": "https://app.playbookops.ai/…"
}
]
}/v1/playbooks/{playbook_id}/foldersList a playbook's folders
Every folder in a playbook, with its parent and its path, like "Runbooks / Database".
knowledge:readMCP tool list_foldersPath parameters
playbook_idstringRequired
Response
datalist of FolderRequired
curl "https://developers.playbookops.ai/v1/playbooks/PLAYBOOK_ID/folders" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"{
"data": [
{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"name": "Ana Ruiz",
"description": "Confirm the date and ask about parking.",
"parent_folder_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"path": "…",
"playbook_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42"
}
]
}/v1/contentBrowse content
List or title-search documents, flowcharts, media, uploaded files, courses, projects and workflows you can see, most recently changed first. Pass playbook_id to list what's in one playbook.
knowledge:readMCP tool list_contentQuery parameters
searchstring or nullPart of a title
kindslist of one of "playbook", "document", "flowchart", "video", "audio", "image", "pdf", "word_document", "spreadsheet", "powerpoint", "learning", "project", "workflow" or nullOnly these kinds of content
playbook_idstring or nullOnly content inside this playbook
offsetintegerAt least 0, default 0.
limitinteger1–100, default 30.
Response
has_morebooleanRequiredMore results after these; ask again with offset=next_offset
next_offsetinteger or nulldatalist of ContentItemRequired
curl "https://developers.playbookops.ai/v1/content?limit=10" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"{
"has_more": false,
"next_offset": 0,
"data": [
{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"kind": "document",
"title": "Call the venue",
"playbook_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"playbook_name": "Support",
"updated_at": "2026-11-21T15:04:05Z",
"url": "https://app.playbookops.ai/…"
}
]
}/v1/document-changesWhat changed in documents
Documents created, changed, deleted or moved out of a playbook since a time, for keeping a copy in step. Start with any past time, then send next_since each time.
knowledge:readMCP tool list_document_changesQuery parameters
sincestring (date and time)RequiredChanges after this time, in ISO 8601. Send next_since from your last answer.
playbook_idstring or nullOnly changes in this playbook
limitinteger1–500, default 100.
Response
changedlist of DocumentChangeRequiredDocuments created or changed since
since, oldest change firstremovedlist of DocumentRemovalRequiredDocuments deleted, or moved to another playbook, since
sincehas_morebooleanRequiredMore changes after these; ask again with since=next_since
next_sincestring (date and time)RequiredSend this as
sincenext time. Answers can overlap a little, so expect to see a document twice.
curl "https://developers.playbookops.ai/v1/document-changes?since=2026-11-21T15%3A04%3A05Z&limit=10" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"{
"changed": [
{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"title": "Call the venue",
"playbook_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"folder_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"version": 0,
"status": "in_progress",
"updated_at": "2026-11-21T15:04:05Z",
"url": "https://app.playbookops.ai/…"
}
],
"removed": [
{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"playbook_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"removed_at": "2026-11-21T15:04:05Z"
}
],
"has_more": false,
"next_since": "2026-11-21T15:04:05Z"
}/v1/documents/{document_id}Read a document
A playbook document as Markdown, with its version, or the text of an uploaded PDF, Word document or PowerPoint. Up to 24,000 characters unless you ask for full=true.
knowledge:readMCP tool read_documentPath parameters
document_idstringRequired
Query parameters
fullbooleanReturn all of a document's Markdown instead of the first 24,000 characters
Default false.
Response
idstringRequiredtitlestringRequiredkindstringRequiredcontentstringRequiredMarkdown for documents; extracted text for uploaded files
truncatedbooleanRequiredThe content was cut short. Ask for full=true to get all of a document.
versioninteger or nullDocuments only. Send it back as base_version when you change the document.
statusone of "draft", "published", "archived" or nullplaybook_idstring or nullfolder_idstring or nulltagslist of stringupdated_atstring (date and time) or nullnotestring or nullurlstring or null
curl "https://developers.playbookops.ai/v1/documents/DOCUMENT_ID" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"title": "Call the venue",
"kind": "document",
"content": "## Refunds\n\nRefunds over $500 need a manager's approval…",
"truncated": false,
"version": 0,
"status": "draft",
"playbook_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"folder_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"tags": [
"…"
],
"updated_at": "2026-11-21T15:04:05Z",
"note": "Up after the spring campaign",
"url": "https://app.playbookops.ai/…"
}/v1/knowledge/searchSearch the knowledge base
Semantic search across the documents and uploaded files you can see. Returns the best passages with their documents. Uses 1 AI credit per search.
knowledge:readMCP tool search_knowledgeBody
querystringRequiredA question or topic, in plain words
Up to 500 characters.
Response
querystringRequireddatalist of SearchHitRequiredcredits_usedintegerRequired
curl -X POST "https://developers.playbookops.ai/v1/knowledge/search" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "How do we handle refunds over $500?"
}'{
"query": "How do we handle refunds over $500?",
"data": [
{
"document_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"file_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"title": "Call the venue",
"passage": "Refunds over $500 need a manager's approval…",
"similarity": 0,
"playbook_name": "Support",
"url": "https://app.playbookops.ai/…"
}
],
"credits_used": 0
}/v1/knowledge/who-knowsWho knows about…
The people to ask about a topic, ranked by the documents they own, review or work from. Uses 1 AI credit.
knowledge:readMCP tool who_knowsBody
topicstringRequiredUp to 500 characters.
Response
topicstringRequireddatalist of ExpertRequiredcredits_usedintegerRequired
curl -X POST "https://developers.playbookops.ai/v1/knowledge/who-knows" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"topic": "payroll"
}'{
"topic": "payroll",
"data": [
{
"name": "Ana Ruiz",
"why": [
"…"
]
}
],
"credits_used": 0
}/v1/playbooksCreate a playbook
Make a new playbook to hold documents and folders. Everyone in the organization can see it until someone limits access in the app.
knowledge:writeChanges data · supports Idempotency-KeyMCP tool create_playbookBody
namestringRequiredUp to 200 characters.
descriptionstringWhat the playbook is for, shown in lists
Up to 2,000 characters, default "".
Response
idstringRequirednamestringRequireddescriptionstring or nulldocument_countintegerDefault 0.
urlstringRequired
curl -X POST "https://developers.playbookops.ai/v1/playbooks" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"name": "Ana Ruiz"
}'{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"name": "Ana Ruiz",
"description": "Confirm the date and ask about parking.",
"document_count": 0,
"url": "https://app.playbookops.ai/…"
}/v1/playbooks/{playbook_id}/foldersCreate a folder
Add a folder to a playbook, at the top or inside another folder (up to 6 levels deep).
knowledge:writeChanges data · supports Idempotency-KeyMCP tool create_folderPath parameters
playbook_idstringRequired
Body
namestringRequiredUp to 255 characters.
descriptionstringUp to 2,000 characters, default "".
parent_folder_idstring or nullPut it inside this folder; leave out for the top of the playbook
Response
idstringRequirednamestringRequireddescriptionstring or nullparent_folder_idstring or nullThe folder this one is in; null at the top of the playbook
pathstringRequiredIts place in the playbook, like "Runbooks / Database"
playbook_idstringRequired
curl -X POST "https://developers.playbookops.ai/v1/playbooks/PLAYBOOK_ID/folders" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"name": "Ana Ruiz"
}'{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"name": "Ana Ruiz",
"description": "Confirm the date and ask about parking.",
"parent_folder_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"path": "…",
"playbook_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42"
}/v1/playbooks/{playbook_id}/documentsCreate a document
Add a document to a playbook, written in Markdown. Returns it with its id and version.
knowledge:writeChanges data · supports Idempotency-KeyMCP tool create_documentPath parameters
playbook_idstringRequired
Body
titlestringRequiredUp to 300 characters.
contentstringThe body as Markdown: headings, lists, checklists, tables, code, callouts (:::note), toggles (<details>), images and @mentions. See the Markdown guide in the docs.
Up to 500,000 characters, default "".
descriptionstringA one-line summary shown in lists
Up to 2,000 characters, default "".
document_typeone of "sop", "process", "training", "policy", "procedure", "manual", "workflow", "internal_document", "job_description", "project_plan", "general", "proven_process"What kind of document it is. It can't change later.
Default "general".
statusone of "draft", "published"Shown on the document in the app. It doesn't change who can see it.
Default "draft".
tagslist of stringfolder_idstring or nullA folder in this playbook; leave out for the top level
Response
idstringRequiredtitlestringRequiredkindstringRequiredcontentstringRequiredMarkdown for documents; extracted text for uploaded files
truncatedbooleanRequiredThe content was cut short. Ask for full=true to get all of a document.
versioninteger or nullDocuments only. Send it back as base_version when you change the document.
statusone of "draft", "published", "archived" or nullplaybook_idstring or nullfolder_idstring or nulltagslist of stringupdated_atstring (date and time) or nullnotestring or nullurlstring or null
curl -X POST "https://developers.playbookops.ai/v1/playbooks/PLAYBOOK_ID/documents" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"title": "Refund policy",
"content": "## Who can ask\n\nAnyone who paid in the last 30 days.\n\n:::note\nRefunds over $500 need a manager'\''s approval.\n:::",
"status": "published"
}'{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"title": "Call the venue",
"kind": "document",
"content": "## Refunds\n\nRefunds over $500 need a manager's approval…",
"truncated": false,
"version": 0,
"status": "draft",
"playbook_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"folder_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"tags": [
"…"
],
"updated_at": "2026-11-21T15:04:05Z",
"note": "Up after the spring campaign",
"url": "https://app.playbookops.ai/…"
}/v1/documents/{document_id}Update a document
Change a document's Markdown and details. Send content to replace the whole body, or edits to change part of it: replace_text, replace_section, append, insert or remove_section. Send base_version to avoid overwriting someone else's change.
knowledge:writeChanges data · supports Idempotency-KeyMCP tool update_documentPath parameters
document_idstringRequired
Body
base_versioninteger or nullThe version you read. If someone changed the document since, nothing changes and you get a 409.
At least 1.
contentstring or nullReplace the whole body with this Markdown
Up to 500,000 characters.
editslist of ReplaceText or ReplaceSection or Append or Insert or RemoveSection or nullPrecise changes, applied in order; all of them apply or none do. Each has an op: replace_text, replace_section, append, insert or remove_section. Don't send with content.
titlestring or nullUp to 300 characters.
descriptionstring or nullUp to 2,000 characters.
statusone of "draft", "published", "archived" or nullOnly the document's owner can change this. Archived documents drop out of title search.
tagslist of string or nullReplaces all of the document's tags
folder_idstring or nullMove it to this folder in the same playbook; null moves it to the top level
Response
idstringRequiredtitlestringRequiredkindstringRequiredcontentstringRequiredMarkdown for documents; extracted text for uploaded files
truncatedbooleanRequiredThe content was cut short. Ask for full=true to get all of a document.
versioninteger or nullDocuments only. Send it back as base_version when you change the document.
statusone of "draft", "published", "archived" or nullplaybook_idstring or nullfolder_idstring or nulltagslist of stringupdated_atstring (date and time) or nullnotestring or nullurlstring or null
curl -X PATCH "https://developers.playbookops.ai/v1/documents/DOCUMENT_ID" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"base_version": 3,
"edits": [
{
"op": "replace_section",
"section": "Who can ask",
"markdown": "Anyone who paid in the last 60 days."
},
{
"op": "append",
"markdown": "## Questions\n\nAsk in #support."
}
]
}'{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"title": "Call the venue",
"kind": "document",
"content": "## Refunds\n\nRefunds over $500 need a manager's approval…",
"truncated": false,
"version": 0,
"status": "draft",
"playbook_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"folder_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"tags": [
"…"
],
"updated_at": "2026-11-21T15:04:05Z",
"note": "Up after the spring campaign",
"url": "https://app.playbookops.ai/…"
}