Knowledge Review knowledge_review
Knowledge Review: decide the changes Ken, members and agents suggest, read the change log and undo a change, and set how much Ken applies without review. Accept or dismiss one suggestion, or bulk accept a file's or one source's. settings-update with auto_approve_paused false lifts the spot-check pause. Export Knowledge as a zip, or draft skills from a member's last hand tasks. tree-get reads every folder and file in one call, bodies only on request. upload-content reads the original of an uploaded file. The sources-* operations list, turn on, turn off and disconnect what Ken learns from (your mail and calendars, HubSpot, watched pages).
Call it from an MCP client connected to https://mcp.ken.so/mcp: reads go through knowledge_review_read and changes through knowledge_review_write. Each takes operation plus that operation's parameters, and your workspace role decides which operations you see.
Each operation with a route calls the Kenso API at https://api.ken.so with Authorization: Bearer <Kenso API key>, Ken-Version: 1.1 and X-Ken-Workspace-Id: <workspace id>. You can call that route directly with the same headers.
Operations: suggestion-accept, suggestion-bulk-accept, upload-content, suggestion-counts, export-create, skill-draft-create, sources-create, sources-disconnect, suggestion-dismiss, change-get, settings-get, sources-get, suggestion-get, tree-get, change-list, sources-list, suggestion-list, change-undo, settings-update, sources-update
suggestion-accept
Write. Early access: needs knowledge on for the workspace. POST https://api.ken.so/v1/knowledge/suggestions/{suggestionId}/accept
Path: suggestionId
Accept a pending suggestion: Kenso applies it to its file, folder or facts.
POST /api/v1/knowledge/suggestions/{suggestionId}/accept. Needs the knowledge flag.
Sends Ken-Version 1.1. Returns the suggestion, now accepted, and writes a file version
labelled "<user> via <client>". One already decided is 409 invalid_state; one whose
file changed so its text no longer applies is 409 invalid_state with code superseded. A
suggestion on something the caller cannot edit is 403; ask a workspace admin.
suggestion-bulk-accept
Write. Early access: needs knowledge on for the workspace. POST https://api.ken.so/v1/knowledge/suggestions/bulk-accept
Body (json): fileId integer, sourceRef string, sourceType string
Accept the pending suggestions on one file, or from one source. Call again while hasMore is true.
POST /api/v1/knowledge/suggestions/bulk-accept. Needs the knowledge flag. Sends
Ken-Version 1.1. Send file_id, or source_type with source_ref (from a suggestion's
source), not both. Accepts up to 200 a call, oldest first, each on its own. Returns
accepted, superseded, failed ([{suggestionId, code}]) and hasMore.
upload-content
Read. Early access: needs knowledge on for the workspace. GET https://api.ken.so/v1/knowledge/files/{fileId}/upload/content
Path: fileId
Download the original file a Knowledge file was uploaded from.
GET /api/v1/knowledge/files/{fileId}/upload/content. Needs the knowledge flag. Sends Ken-Version 1.1.
file_id is the Knowledge file (knowledge(operation="get") shows upload.hasOriginal). Returns data with
fileName, ext and size (bytes). A text upload (md, txt, csv, json, html) of at most 200,000 characters
also returns its text; for any other upload (PDF, DOCX, slides, images) read the text Kenso parsed out of
it as the file's body with knowledge(operation="get"), and send the member to the file in Knowledge in
the app to download it. Whoever can read the file can download it: another member's private file, a
file that was not uploaded and an upload whose bytes Kenso no longer has are 404. Requires Knowledge view.
suggestion-counts
Read. Early access: needs knowledge on for the workspace. GET https://api.ken.so/v1/knowledge/suggestions/counts
Count the pending suggestions the caller can see: the Review badge.
GET /api/v1/knowledge/suggestions/counts. Needs the knowledge flag. Sends Ken-Version 1.1. Returns pendingCount and isCapped. The count is exact for every caller, so isCapped is always false.
export-create
Write. Early access: needs knowledge on for the workspace. POST https://api.ken.so/v1/knowledge/exports
Body (json): folderId integer
Start a Knowledge export: a zip of markdown of the workspace or one folder.
POST /api/v1/knowledge/exports. Needs the knowledge flag. Sends Ken-Version 1.1. folder_id: one folder with its subfolders; absent exports everything the caller can read. Returns a knowledge_export job (202), already succeeded. Its downloadUrl serves the zip for 24 hours to the member who asked only, and only to a client that sends Ken-Version 1.1, X-Ken-Workspace-Id and that member's credentials, such as the Kenso app. It is not a link to open in a browser: knowledge_library(operation="export-content", export_id=<the job id>) downloads it. An API key with no member is refused: 403, or 409 member_required for a staff key.
skill-draft-create
Write. Early access: needs knowledge on for the workspace. POST https://api.ken.so/v1/knowledge/skill-drafts
Body (json): channel string, count integer
Draft skills from the member's last finished hand tasks, like their last 3 intro emails.
POST /api/v1/knowledge/skill-drafts. Needs the knowledge flag. Sends Ken-Version 1.1. channel: email, linkedin_connect, linkedin_message, linkedin_follow, linkedin_like, linkedin_comment, instagram_dm, instagram_follow, instagram_like, instagram_comment, whatsapp_message, call, event, intro, asset or task; absent reads every channel. count: 3 to 30 tasks (default 3) from the learning lookback (90 days by default). Returns status (drafted or nothing_drafted), suggestionIds and taskCount. Each draft is a pending new_file suggestion in Skills: decide it with suggestion-accept or suggestion-dismiss. Fewer than 3 tasks is 409 too_few_tasks; no Skills folder is 409 no_skills_folder; a draft already running for the member is 429. An API key with no member is refused: 403, or 409 member_required for a staff key.
sources-create
Write. Early access: needs knowledge on for the workspace. POST https://api.ken.so/v1/knowledge/sources
Body (json): connectionId integer, ingestEnabled boolean, kind string, shareWithWorkspace boolean
Make the Knowledge source of one of your connected mailboxes or calendars, the entry sources-list shows with id null.
POST /api/v1/knowledge/sources with {kind, connectionId, ingestEnabled?,
shareWithWorkspace?}. Needs the knowledge flag. kind is gmail, outlook,
google_calendar or outlook_calendar; connection_id is the connectionId
sources-list shows. ingest_enabled and share_with_workspace are off when
not sent, as the entry sources-list shows them: send
share_with_workspace=true only when the member chose to share what Ken
learns with the team. Returns the source: 201 when this call made it,
200 when you already had one of that kind (the switches sent apply to
it, as sources-update does). Needs Knowledge edit. 409 not_connected
when the connection is not your own connected mailbox; turning ingest on
also gives 409 ingestion_off while Ken may not read mail in the
workspace, and 409 reconnect_required when the mailbox needs
reconnecting in Settings.
sources-disconnect
Write. Early access: needs knowledge on for the workspace. DELETE https://api.ken.so/v1/knowledge/sources/{sourceId}
Path: sourceId
Disconnect a Knowledge source and delete everything Ken learned from it.
DELETE /api/v1/knowledge/sources/{source_id}. Needs the knowledge flag.
Cannot be undone. For mail, a calendar or HubSpot: the switch goes off,
then the source's facts, evidence, pending suggestions, mail interactions
and handled message refs are deleted, then the source. Returns
{suggestions, facts, evidence, interactions, handledRefs}. A transcript
webhook URL or email-in address is revoked instead (all counts 0); what it
delivered stays. 409 source_busy while Ken is reading the source: it is
already off, so try again in a few minutes. 409 not_disconnectable for a
watched page (use website-pages-replace) or a GitHub repo (removed in the
Kenso app's GitHub settings). Your own source only; HubSpot needs a
workspace admin. A teammate's source is 404.
suggestion-dismiss
Write. Early access: needs knowledge on for the workspace. POST https://api.ken.so/v1/knowledge/suggestions/{suggestionId}/dismiss
Path: suggestionId
Body (json): reason string
Dismiss a pending suggestion, with an optional reason for the change log.
POST /api/v1/knowledge/suggestions/{suggestionId}/dismiss. Needs the knowledge flag. Sends
Ken-Version 1.1. reason: up to 1000 characters. Returns the suggestion, now dismissed. Spot
checks a person dismisses in Review count toward the auto-approve pause; a dismissal through
this tool is an agent's decision and does not.
change-get
Read. Early access: needs knowledge on for the workspace. GET https://api.ken.so/v1/knowledge/changes/{changeId}
Path: changeId
Return one change from the Knowledge change log.
GET /api/v1/knowledge/changes/{changeId}. Needs the knowledge flag. Sends
Ken-Version 1.1. A change the caller cannot see, or one in another workspace, is
404.
settings-get
Read. Early access: needs knowledge on for the workspace. GET https://api.ken.so/v1/knowledge/settings
Return the workspace's Knowledge review settings.
GET /api/v1/knowledge/settings. Needs the knowledge flag. Sends Ken-Version 1.1. Returns reviewMode (review_all, exceptions, auto), spotCheckRate (0 to 1), autoApprovePaused with autoApprovePausedUntil and autoApprovePausedReason, retentionMonths and canEdit.
sources-get
Read. Early access: needs knowledge on for the workspace. GET https://api.ken.so/v1/knowledge/sources/{sourceId}
Path: sourceId
Get one Knowledge source with its switches and what you may do with it.
GET /api/v1/knowledge/sources/{source_id}. Needs the knowledge flag.
Returns the source as sources-list does. A teammate's source, an import
and a delivery are 404. A workspace source needs Knowledge view.
suggestion-get
Read. Early access: needs knowledge on for the workspace. GET https://api.ken.so/v1/knowledge/suggestions/{suggestionId}
Path: suggestionId
Return one suggestion of any status, with its text, file name, facts and source.
GET /api/v1/knowledge/suggestions/{suggestionId}. Needs the knowledge flag. Sends
Ken-Version 1.1. A suggestion the caller cannot see, or one in another workspace,
is 404.
tree-get
Read. Early access: needs knowledge on for the workspace. GET https://api.ken.so/v1/knowledge/tree
Query: includeBodies boolean
Return the whole Knowledge tree in one call: every folder and every file the caller can read.
GET /api/v1/knowledge/tree. Needs the knowledge flag. Sends Ken-Version 1.1. data.folders: the top folders, then each folder's children, a level at a time (as knowledge(operation="folders-list") walked by parent_id finds them). data.files: newest first, each as knowledge(operation="get") returns it but without its body; include_bodies=true keeps the bodies. Without bodies each item also leaves out what it implies: a file's tags when empty, visibility when workspace, active and canEdit when false, skillFileCount when 0, createdAt when it equals updatedAt and updatedBy when it equals createdBy; a folder's canEdit when false and createdAt when it equals updatedAt. An answer past 200,000 characters of JSON is refused: with include_bodies, call again without it and read the files you need with knowledge(operation="get"); a tree too big even without bodies is read a folder at a time with knowledge(operation="folders-list") and knowledge(operation="list"). Private files and You folders show only to their owner. A workspace whose readable bodies pass 10,000,000 characters is 409 with details[0].code tree_too_big.
change-list
Read. Early access: needs knowledge on for the workspace. GET https://api.ken.so/v1/knowledge/changes
Query: accountId integer, cursor string, fileId integer, kind string, limit integer
List changes to the workspace's Knowledge, newest first: the change log.
GET /api/v1/knowledge/changes. Needs the knowledge flag. Sends Ken-Version 1.1.
Filters: file_id, account_id, kind (fact_added, file_edited, file_created,
suggestion_accepted, suggestion_dismissed, restored, undone, prompt_created,
prompt_edited, prompt_deleted, prompt_restored). Each change has its summary, file name
(kept after the file is deleted), actor ("<user> via <client>") and undoable. A
Knowledge prompt change carries knowledgePromptId; only a prompt delete can be undone,
which restores the prompt. limit 1 to 200 (default 50). Pass pagination.nextCursor back
unchanged with the same filters.
sources-list
Read. Early access: needs knowledge on for the workspace. GET https://api.ken.so/v1/knowledge/sources
List the Knowledge sources in Settings: mail, calendars, HubSpot, watched pages, GitHub repos and your transcript URL.
GET /api/v1/knowledge/sources. Needs the knowledge flag. Sends Ken-Version
1.1 and X-Ken-Actor: agent. Returns {data, pagination: {hasMore: false}}.
Each source is {id, kind, ownerUserId, connectionId, label, url, switchable,
ingestEnabled, shareWithWorkspace, status, lastSyncedAt, lastErrorCode,
createdAt, canManage, canWithdraw, canDisconnect, filesRead, filesSkipped};
connectionId is set only on a placeholder (id null), never on a saved
source. kind is gmail, outlook, google_calendar, outlook_calendar, hubspot,
website_page, transcript_webhook, transcript_email or github_repo. A
github_repo row is a tracked GitHub repo: label is owner/repo, url its
GitHub page, status pending, changed (files still to read), ok, failed or
disabled (installation removed or suspended; see lastErrorCode),
lastSyncedAt its last branch check, and filesRead and filesSkipped its file
counts (null on other kinds). Repos are chosen and removed in the Kenso app's
GitHub settings, not here. Only your own mail, calendars, URL and address
are listed, never a teammate's; HubSpot, watched pages and GitHub repos
need Knowledge view. A connected mailbox or calendar of yours with no
source yet is listed with id null, its connectionId and both switches off:
turn it on with sources-create. This read changes nothing. No token or
secret is returned.
suggestion-list
Read. Early access: needs knowledge on for the workspace. GET https://api.ken.so/v1/knowledge/suggestions
Query: accountId integer, cursor string, fileId integer, folderId integer, isSpotCheck boolean, kind string, limit integer, sourceRef string, sourceType string, status string
List the suggestions in Knowledge Review, newest first.
GET /api/v1/knowledge/suggestions. Needs the knowledge flag. Sends Ken-Version 1.1. status: pending (default), accepted, dismissed or superseded. kind: change, addition, new_file or fact. Filters: file_id, folder_id, account_id, source_type with source_ref (one source, as a Review chip names it), is_spot_check. Each suggestion has its old and new text, file name, facts, source and author. Suggestions the caller cannot see are left out. limit 1 to 200 (default 50). Pass pagination.nextCursor back unchanged with the same filters.
change-undo
Write. Early access: needs knowledge on for the workspace. POST https://api.ken.so/v1/knowledge/changes/{changeId}/undo
Path: changeId
Undo a change from the Knowledge change log.
POST /api/v1/knowledge/changes/{changeId}/undo. Needs the knowledge flag. Sends
Ken-Version 1.1. Returns the change, now undone (undoneAt set). A file saved again
since is 409 invalid_state with code later_saves; a change that cannot be undone is
not_undoable, and one already undone is already_undone.
settings-update
Write. Early access: needs knowledge on for the workspace. PATCH https://api.ken.so/v1/knowledge/settings
Body (json): autoApprovePaused boolean, reviewMode string, spotCheckRate number
Change the review mode or spot-check rate, or lift the spot-check pause. Admins only.
PATCH /api/v1/knowledge/settings. Needs the knowledge flag. Sends Ken-Version 1.1. review_mode: review_all, exceptions or auto. spot_check_rate: 0 to 1, at most three decimals. auto_approve_paused: only false, which lifts the pause Ken sets after people reject too many spot checks; from then on only later decisions count. Absent fields stay. A member who is not an admin gets 403.
sources-update
Write. Early access: needs knowledge on for the workspace. PATCH https://api.ken.so/v1/knowledge/sources/{sourceId}
Path: sourceId
Body (json): ingestEnabled boolean, shareWithWorkspace boolean
Turn a source's "Learn from ..." or "Share what Ken learns ..." switch on or off.
PATCH /api/v1/knowledge/sources/{source_id} with {ingestEnabled?,
shareWithWorkspace?}. Needs the knowledge flag. Send at least one.
ingest_enabled is the "Learn from ..." switch (mail, calendars, HubSpot);
share_with_workspace is "Share what Ken learns from my mail with my team"
(mail and calendars). Turning a switch on needs Knowledge edit and your own
source (HubSpot: a workspace admin); turning one off needs only your own
source. Returns the source. 409 ingestion_off while Ken may not read mail,
calendars or HubSpot in the workspace; 409 reconnect_required or
not_connected when your mailbox needs reconnecting in Settings; 409
source_busy when Ken is still working on an old mailbox; 409 not_switchable
for watched pages and transcript URLs. A teammate's source is 404. A source
with id null in sources-list is turned on with sources-create.