Files files
Call it from an MCP client connected to https://mcp.ken.so/mcp: reads go through files_read and changes through files_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: content, file-comments-create, create, file-comments-delete, delete, get, file-comments-list, list, file-comments-update, update, upload
content
Read. GET https://api.ken.so/v1/files/{fileId}/content
Path: fileId
Read file content. Internal. Markdown comes back as text. PDF and DOCX come back as base64.
GET /api/v1/files/{fileId}/content. Sends Ken-Version 1.1 and X-Ken-Workspace-Id.
Requires Knowledge view.
A PDF or DOCX returns data with fileName, contentType, size (bytes) and
contentBase64, the file's bytes in base64. One over 2 MiB (2,097,152 bytes)
is refused with a validation error: open it in the Kenso app instead.
file-comments-create
Write. POST https://api.ken.so/v1/files/{fileId}/comments
Path: fileId
Body (json): blockIndex integer, content string, parentCommentId integer
Add a comment on a file. Internal. Requires full access. content is required.
POST /api/v1/files/{fileId}/comments. Sends Ken-Version 1.1 and X-Ken-Workspace-Id.
blockIndex and parentCommentId are optional.
create
Write. POST https://api.ken.so/v1/files
Body (json): campaignId integer, content string, name string
Create a Markdown file. Internal. Requires full access. campaign_id attaches it to a campaign.
POST /api/v1/files. Sends Ken-Version 1.1 and X-Ken-Workspace-Id. content is sent as a string. name is required.
file-comments-delete
Write. DELETE https://api.ken.so/v1/files/{fileId}/comments/{commentId}
Path: fileId, commentId
Delete a file comment. Internal. Requires full access. Returns 204.
DELETE /api/v1/files/{fileId}/comments/{commentId}.
Sends Ken-Version 1.1 and X-Ken-Workspace-Id.
delete
Write. DELETE https://api.ken.so/v1/files/{fileId}
Path: fileId
Delete a file. Internal. Requires full access. Returns 204.
DELETE /api/v1/files/{fileId}. Sends Ken-Version 1.1 and X-Ken-Workspace-Id.
get
Read. GET https://api.ken.so/v1/files/{fileId}
Path: fileId
Get one file. Internal. A file outside the workspace is not_found.
GET /api/v1/files/{fileId}. Sends Ken-Version 1.1 and X-Ken-Workspace-Id.
Requires Knowledge view.
file-comments-list
Read. GET https://api.ken.so/v1/files/{fileId}/comments
Path: fileId
Query: cursor string, limit integer
List comments on a file. Internal. limit is 1 to 200.
GET /api/v1/files/{fileId}/comments. Sends Ken-Version 1.1 and X-Ken-Workspace-Id.
Requires Knowledge view.
list
Read. GET https://api.ken.so/v1/files
Query: campaignId integer, cursor string, limit integer
List workspace files, or one campaign's files. Internal. campaign_id selects campaign files.
GET /api/v1/files. Sends Ken-Version 1.1 and X-Ken-Workspace-Id. Requires Knowledge view. A campaign outside the workspace is not_found.
file-comments-update
Write. PATCH https://api.ken.so/v1/files/{fileId}/comments/{commentId}
Path: fileId, commentId
Body (json): content string
Update a file comment. Internal. Requires full access. content is required.
PATCH /api/v1/files/{fileId}/comments/{commentId}.
Sends Ken-Version 1.1 and X-Ken-Workspace-Id.
update
Write. PATCH https://api.ken.so/v1/files/{fileId}
Path: fileId
Body (json): content string, name string
Update a file name or content. Internal. Requires full access. Omitted fields stay unchanged.
PATCH /api/v1/files/{fileId}. Sends Ken-Version 1.1 and X-Ken-Workspace-Id.
upload
Write. POST https://api.ken.so/v1/files/uploads
Query: campaignId integer
Upload a PDF or DOCX onto a campaign. Internal. Requires full access. campaign_id is required. Limit is 50 MB.
POST /api/v1/files/uploads. Sends Ken-Version 1.1 and X-Ken-Workspace-Id. Multipart field file, optional form name, and query campaignId. file_content_base64 is the document's bytes in base64 and file_name its name (.pdf or .docx). The hosted MCP refuses file_path, because it cannot read your machine; off the hosted MCP, file_path opens only a file inside the MCP export directory.