Sender Voice sender_voice
Sender voice: Ken drafts in the voice of the member who owns the sending inbox or LinkedIn account. get and update are the caller's own switches and owner requests; the inbox and LinkedIn account owner operations read or set whose voice an inbox or account writes in. Settings and ids only. Needs the sender_voice flag.
Call it from an MCP client connected to https://mcp.ken.so/mcp: reads go through sender_voice_read and changes through sender_voice_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: confirm-owner-request, decline-owner-request, get, get-inbox-owner, get-linkedin-account-owner, set-inbox-owner, set-linkedin-account-owner, update
confirm-owner-request
Write. Early access: needs sender_voice on for the workspace. POST https://api.ken.so/v1/me/voice/owner-requests/{kind}/{resourceId}/confirm
Path: kind, resourceId
Confirm a request to become the voice owner of an inbox or LinkedIn account. Ken then drafts in the caller's voice for it. Only when the user said yes.
POST /api/v1/me/voice/owner-requests/{kind}/{resourceId}/confirm with Ken-Version 1.1.
Needs the sender_voice flag. kind is inbox or linkedin_account and resource_id the
inbox or LinkedIn account id, as sender_voice(operation="get") lists them in
ownerRequests. Only the member who was asked can confirm: another member, or no such
request, gets 404 not_found, and a caller who is not a member gets 403. Returns the voice owner: ownerUserId, pendingUserId,
requestedByUserId and confirmedAt (each omitted when none).
decline-owner-request
Write. Early access: needs sender_voice on for the workspace. POST https://api.ken.so/v1/me/voice/owner-requests/{kind}/{resourceId}/decline
Path: kind, resourceId
Decline a request to become the voice owner of an inbox or LinkedIn account. The request is cleared; the current owner stays.
POST /api/v1/me/voice/owner-requests/{kind}/{resourceId}/decline with Ken-Version 1.1.
Needs the sender_voice flag. kind is inbox or linkedin_account and resource_id the
inbox or LinkedIn account id, as sender_voice(operation="get") lists them. Only the
member who was asked can decline: anyone else, or no such request, gets 404
not_found. Returns the voice owner as it now stands.
get
Read. Early access: needs sender_voice on for the workspace. GET https://api.ken.so/v1/me/voice
Return your voice settings, the sources Ken learns from and your voice owner requests.
GET /api/v1/me/voice with Ken-Version 1.1. Needs the sender_voice flag. Any member; only the caller's own settings. Never writes. data: learning (the "Learn how I write" switch, false until turned on), keepTypos (default true), status (idle, backfilling, ready, paused, deleting), messagesKept, lastLearnedAt (omitted until the first voice), sources (kind gmail, outlook, linkedin, calls or kenso; connectionId; state reading, done, paused or waiting; pausedUntil and reason on a paused one) and ownerRequests (kind inbox or linkedin_account, id, label, requestedBy): the inboxes and LinkedIn accounts the caller was asked to become the voice owner of. Answer one with sender_voice(operation="confirm-owner-request") or sender_voice(operation="decline-owner-request").
get-inbox-owner
Read. Early access: needs sender_voice on for the workspace. GET https://api.ken.so/v1/inboxes/{inboxId}/voice-owner
Path: inboxId
Return whose voice Ken writes in for a sending inbox.
GET /api/v1/inboxes/{inboxId}/voice-owner with Ken-Version 1.1. Needs the
sender_voice flag. Any member. data: ownerUserId (the confirmed voice owner, a
member id), pendingUserId (a member asked to confirm), requestedByUserId (who asked)
and confirmedAt, each omitted when none. Without an owner, drafts fall back to the
campaign owner, then the workspace owner. 404 for an inbox not in the workspace.
get-linkedin-account-owner
Read. Early access: needs sender_voice on for the workspace. GET https://api.ken.so/v1/linkedin-accounts/{linkedinAccountId}/voice-owner
Path: linkedinAccountId
Return whose voice Ken writes in for a LinkedIn account.
GET /api/v1/linkedin-accounts/{linkedinAccountId}/voice-owner with Ken-Version 1.1.
Needs the sender_voice flag. Any member. data: ownerUserId, pendingUserId,
requestedByUserId and confirmedAt, each omitted when none. 404 for an account not in
the workspace.
set-inbox-owner
Write. Early access: needs sender_voice on for the workspace. PUT https://api.ken.so/v1/inboxes/{inboxId}/voice-owner
Path: inboxId
Body (json): userId integer
Set whose voice Ken writes in for a sending inbox: yourself at once, another member after they confirm. Send user_id, or clear true to remove the owner and any pending request.
PUT /api/v1/inboxes/{inboxId}/voice-owner with Ken-Version 1.1. Needs the
sender_voice flag. A workspace admin (members permission), Kenso staff (for a
done-for-you client, set the client founder, who then confirms), or the member whose
own mailbox the inbox is; a campaign pool inbox records no connecting member, so only
an admin or staff sets its owner. Anyone else gets 403.
- user_id: the caller's own member id sets the caller at once. Another member's id
asks that member, who becomes the owner when they confirm (the current owner stays
until then). A user_id that is not a member of the workspace is 404.
- clear: true removes the owner and any pending request. Send it instead of user_id;
a call with neither is refused before it reaches Kenso.
Returns the voice owner as it now stands, the same shape as
sender_voice(operation="get-inbox-owner").
set-linkedin-account-owner
Write. Early access: needs sender_voice on for the workspace. PUT https://api.ken.so/v1/linkedin-accounts/{linkedinAccountId}/voice-owner
Path: linkedinAccountId
Body (json): userId integer
Set whose voice Ken writes in for a LinkedIn account: yourself at once, another member after they confirm. Send user_id, or clear true to remove the owner and any pending request.
PUT /api/v1/linkedin-accounts/{linkedinAccountId}/voice-owner with Ken-Version 1.1.
Needs the sender_voice flag. A workspace admin (members permission), the member who
connected the account, or Kenso staff; anyone else gets 403. user_id and clear work
as for sender_voice(operation="set-inbox-owner"): the caller's own id sets the caller
at once, another member is asked to confirm, clear true removes the owner and any
pending request. A user_id that is not a member of the workspace is 404. Returns the
voice owner as it now stands.
update
Write. Early access: needs sender_voice on for the workspace. PATCH https://api.ken.so/v1/me/voice
Body (json): keepTypos boolean, learning boolean
Turn your "Learn how I write" or "Keep my typos" switch on or off. Omit a field to leave it unchanged. learning false deletes your voice data within 24 hours.
PATCH /api/v1/me/voice with Ken-Version 1.1. Needs the sender_voice flag. Changes only the caller's own switches. Send at least one field. - learning: true turns learning on and Ken starts reading the caller's sources; it needs a paid plan (402 plan_limit_reached otherwise), and a delete already asked for still runs first. false turns it off: status becomes deleting and the caller's voice data is deleted within 24 hours. Turning it off is always allowed. Only change it when the user asked. Sending the value it already has changes nothing. - keep_typos: true keeps the caller's usual typos in drafts, false fixes them. Only a member of the workspace has voice settings there: any other caller gets 403. Returns the same shape as sender_voice(operation="get").