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/contentBrowse content
List or title-search documents, flowcharts, media, uploaded files, courses, projects and workflows you can see. 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/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/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/…"
}