Voices voices
The voices a workspace can use for LinkedIn AI voice notes: list them, list the voices on the workspace's own ElevenLabs account, import one (only after the user confirms the rights) or remove an imported one.
Call it from an MCP client connected to https://mcp.ken.so/mcp: reads go through voices_read and changes through voices_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: import, list, list-importable, remove
import
Write. Early access: needs linkedin_voice_notes or whatsapp on for the workspace. POST https://api.ken.so/v1/voices
Body (json): provider string, rightsConfirmed boolean, voiceId string
Import a voice from the workspace's ElevenLabs account into its voice list. rights_confirmed must be true: only after the user confirms the workspace may use this voice.
POST /api/v1/voices. Sends Ken-Version 1.1. Needs the linkedin_voice_notes feature and the integrations permission. provider is elevenlabs. Answers 201 with the voice, or 200 when it was already imported. 404 when the voice is not on the workspace's ElevenLabs account.
list
Read. Early access: needs linkedin_voice_notes or whatsapp on for the workspace. GET https://api.ken.so/v1/voices
Query: includeImported boolean, language string, provider string
List the voices this workspace can use for LinkedIn voice notes. Deepgram voices, ElevenLabs stock voices and the workspace's imported ElevenLabs voices.
GET /api/v1/voices. Sends Ken-Version 1.1. Needs the linkedin_voice_notes feature. provider is deepgram or elevenlabs (omitted: both). language is a language (fr matches every French voice) or a locale (fr-CA); multilingual voices (language multi, every ElevenLabs voice) match every language. include_imported defaults to true. Each item has provider, voiceId, name, family, language, languageName, accent, gender, age, traits, imported, featured and sampleUrl (a link valid for one hour). Use voiceId and provider in a voice_note step's voice. Any workspace member.
list-importable
Read. Early access: needs linkedin_voice_notes or whatsapp on for the workspace. GET https://api.ken.so/v1/voices/importable
List the voices on the workspace's own ElevenLabs account that it can import. Needs the workspace's ElevenLabs key in Settings, Integrations.
GET /api/v1/voices/importable. Sends Ken-Version 1.1. Needs the linkedin_voice_notes feature and the integrations permission. Each item has voiceId, name, category (cloned, professional, generated or library), labels, previewUrl and imported. 409 provider_key_missing without a workspace ElevenLabs key; 502 provider_rejected when ElevenLabs refuses it.
remove
Write. Early access: needs linkedin_voice_notes or whatsapp on for the workspace. DELETE https://api.ken.so/v1/voices/{provider}/{voiceId}
Path: provider, voiceId
Remove an imported voice from this workspace. Returns 204. Sequence steps that use it send their text instead of a voice note.
DELETE /api/v1/voices/{provider}/{voiceId}. Sends Ken-Version 1.1. Needs the
linkedin_voice_notes feature and the integrations permission. 404 when the voice is not
imported in this workspace.