Knowledge Transcripts knowledge_transcripts
The transcripts you sent Kenso from outside: by your transcript webhook URL, your email-in address or your Fathom connection, one per call. list shows each one's status (processing, ready, failed, removing) and the account Kenso matched it to. delete takes one back and deletes the facts, evidence and pending suggestions Ken made from it; the same delivery sent again stays out.
Call it from an MCP client connected to https://mcp.ken.so/mcp: reads go through knowledge_transcripts_read and changes through knowledge_transcripts_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.
delete
Write. Early access: needs knowledge on for the workspace. DELETE https://api.ken.so/v1/knowledge/transcript-deliveries/{deliveryId}
Path: deliveryId
Take back a transcript you sent Kenso and delete everything Ken learned from it.
DELETE /api/v1/knowledge/transcript-deliveries/{delivery_id}. Needs the
knowledge flag. Cannot be undone. The delivery is switched off, then its
pending suggestions, facts and evidence are deleted, then the delivery.
Returns {suggestions, facts, evidence, interactions, handledRefs}
(interactions and handledRefs are 0 for a transcript). Kenso remembers that
it was removed, so the same webhook body or email sent again is answered
as a duplicate and stays out. 409 source_busy while Ken is reading it: it
is already off and listed as removing, so try again in a few minutes. Your
own delivery only: a teammate's is 404 for everyone, admins included.
get
Read. Early access: needs knowledge on for the workspace. GET https://api.ken.so/v1/knowledge/transcript-deliveries/{deliveryId}
Path: deliveryId
Get one transcript you sent Kenso, with its status.
GET /api/v1/knowledge/transcript-deliveries/{delivery_id}. Needs the
knowledge flag. Returns the delivery as list does. A teammate's delivery,
and one still being stored, is 404.
list
Read. Early access: needs knowledge on for the workspace. GET https://api.ken.so/v1/knowledge/transcript-deliveries
Query: cursor string, limit integer
List the transcripts you sent Kenso by webhook, email-in or Fathom, newest first.
GET /api/v1/knowledge/transcript-deliveries. Needs the knowledge flag. Sends
Ken-Version 1.1 and X-Ken-Actor: agent. Returns {data, pagination}. Each
delivery is {id, via, title, receivedAt, status, errorCode, accountId,
shared, turns, truncated}: via is webhook, email or fathom; status is
removing (a removal that has not finished), processing, ready or failed;
errorCode says why, for example chunks_missing; accountId is the account
Kenso matched the call to, and shared is true when the call is visible to
the workspace on that account (false: private to you). Only your own
deliveries, never a teammate's; one still being stored is not listed yet.
No transcript text, sender, subject or delivery key is returned. limit 1
to 200 (default 50). Pass pagination.nextCursor back unchanged.