Voices
Voices are the speakers Kenso can use for LinkedIn AI voice notes: Deepgram voices, ElevenLabs stock voices and voices the workspace imports from its own ElevenLabs account. A voice note step names its voice by provider and voiceId. Importing a voice needs the workspace's ElevenLabs API key in Settings, Integrations. Every call answers 503 voice_notes_unavailable while voice notes are not available.
Headers
The endpoints on this page take these headers. Each endpoint's curl shows the ones it sends.
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Ken-Version | header | string, one of: 2026-11-02, 1.1 | optional | The API version, a date in YYYY-MM-DD form. 1.1 is another name for the first dated version. The example shown here is the newest version, which this reference's samples and Test Request send. Leave it out to use your API key's pinned version. Keys created in the Kenso app are pinned to the newest version; keys minted by the CLI login are not. A key with no pinned version and no header gets the legacy shape where the path has one, and 404 where the path exists only in this version. A date that is not a version answers 400 unsupported_version; any other value that is not a version is treated as legacy. |
X-Ken-Workspace-Id | header | integer (int64) | optional | The id of the workspace to act in. Leave it out when your API key reaches only one workspace. When the key reaches more than one, a request without this header answers 400 workspace_required. A workspace you are not a member of answers 404 not_found. |
List voices
/v1/voicesvoices.list- Permission
- Any workspace member except a Network member
- Rate limit
- 12,000 requests a minute per API key
Returns every voice the workspace can use in a voice note step: Deepgram voices, ElevenLabs stock voices and the workspace's imported voices. Early-access voices are left out. The whole list comes in one page: nextCursor is null and hasMore is false.
Narrow the list with provider, language and includeImported. A language such as fr matches every French voice, and a locale such as fr-CA matches only that locale. A multilingual voice (language is multi, as on every ElevenLabs voice) matches every language filter.
Errors:
400 validation_failed:provideris notdeepgramorelevenlabs.503 voice_notes_unavailable: voice notes are not available right now, or ElevenLabs did not answer. Try again later.
Open to any workspace member.
Needs the linkedin_voice_notes or whatsapp feature on your workspace. Until one of them is on, calls answer 404.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
provider | query | string | optional | Only this provider's voices: deepgram or elevenlabs. Omit it to list both. |
language | query | string | optional | Only voices that speak this language (such as fr, every French locale) or locale (such as fr-CA). Multilingual voices match every language. Omit it to list every language. |
includeImported | query | boolean | optional | Whether to include the workspace's imported ElevenLabs voices. Defaults to true. |
limit | query | integer (int32) | optional | Items per page, from 1 to 200. Omit limit and cursor to get every item in one response, as before; with only cursor, 50 per page. |
cursor | query | string | optional | The nextCursor of the previous page. Omit it for the first page. |
curl -X GET "https://api.ken.so/v1/voices?limit=1" \
-H "Authorization: Bearer $KENSO_API_KEY" \
-H "Ken-Version: 2026-11-02" \
-H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"Response 200
data is a list of Voice. Each item has these fields. The response also carries pagination.
Show the 14 response fields and an example
The fields and an example are also on this endpoint's Markdown page.
Import an ElevenLabs voice
/v1/voicesvoices.import- Permission
- The
integrationspermission - Rate limit
- 4,800 requests a minute per API key
Adds a voice from the workspace's own ElevenLabs account to the workspace's voices, so voice note steps can use it. Returns 201 with the voice, or 200 when the workspace had already imported it. You can import a removed voice again.
Send provider: "elevenlabs", the voiceId and rightsConfirmed: true, which confirms that the workspace has the rights to use the voice. Kenso checks that the voice is on the workspace's ElevenLabs account at the time of the call. ElevenLabs stock voices need no import.
Errors:
400 validation_failed:rightsConfirmedis not true,provideris notelevenlabs,voiceIdis not an ElevenLabs voice id, or the voice is a stock voice.404 not_found: the voice is not on the workspace's ElevenLabs account.409 provider_key_missing: the workspace has no ElevenLabs API key, or cannot use its own keys yet.502 provider_rejected: ElevenLabs refused the workspace's key. Check it in Settings, Integrations.503 voice_notes_unavailable: voice notes are not available right now, Kenso could not read the key, or ElevenLabs did not answer. Try again later.
Requires the integrations permission, and a member with the Client role cannot call it.
Needs the linkedin_voice_notes or whatsapp feature on your workspace. Until one of them is on, calls answer 404.
Request body
application/json, optional.
The voice to import.
| Field | Type | Required | Description |
|---|---|---|---|
provider | string | optional | Must be elevenlabs, the only provider whose voices you import. |
voiceId | string | optional | The voice's id on the workspace's ElevenLabs account, at most 64 letters and digits. |
rightsConfirmed | boolean | optional | Must be true. It confirms that the workspace has the rights to use the voice. |
curl -X POST "https://api.ken.so/v1/voices" \
-H "Authorization: Bearer $KENSO_API_KEY" \
-H "Ken-Version: 2026-11-02" \
-H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID" \
-H "Content-Type: application/json" \
-d '{
"provider": "string",
"voiceId": "string",
"rightsConfirmed": true
}'Response 201
Also answers 200. data is a Voice.
Show the 14 response fields and an example
The fields and an example are also on this endpoint's Markdown page.
List importable ElevenLabs voices
/v1/voices/importablevoices.list-importable- Permission
- The
integrationspermission - Rate limit
- 240 requests a minute per API key
Returns the voices on the workspace's own ElevenLabs account, so you can pick one to import. Stock voices are left out, because GET /v1/voices lists them already. imported marks the voices this workspace has imported. The whole list comes in one page.
This call needs the workspace's ElevenLabs API key, which you add in Settings, Integrations.
Errors:
409 provider_key_missing: the workspace has no ElevenLabs API key, or cannot use its own keys yet.502 provider_rejected: ElevenLabs refused the workspace's key. Check it in Settings, Integrations.503 voice_notes_unavailable: voice notes are not available right now, Kenso could not read the key, or ElevenLabs did not answer. Try again later.
Requires the integrations permission, and a member with the Client role cannot call it.
Needs the linkedin_voice_notes or whatsapp feature on your workspace. Until one of them is on, calls answer 404.
curl -X GET "https://api.ken.so/v1/voices/importable" \
-H "Authorization: Bearer $KENSO_API_KEY" \
-H "Ken-Version: 2026-11-02" \
-H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"Response 200
data is a list of ImportableVoice. Each item has these fields. The response also carries pagination.
Show the 6 response fields and an example
The fields and an example are also on this endpoint's Markdown page.
Remove an imported voice
/v1/voices/{provider}/{voiceId}voices.remove- Permission
- The
integrationspermission - Rate limit
- 4,800 requests a minute per API key
Removes an imported voice from the workspace. Returns 204. Voice note steps that use the voice keep their settings, but their notes now fail with voice_removed and Kenso sends the step's text instead.
Errors:
404 not_found: the workspace has not imported this voice.503 voice_notes_unavailable: voice notes are not available right now. Try again later.
Requires the integrations permission, and a member with the Client role cannot call it.
Needs the linkedin_voice_notes or whatsapp feature on your workspace. Until one of them is on, calls answer 404.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
provider | path | string | required | Provider of the voice. Only elevenlabs voices are imported. |
voiceId | path | string | required | The voice's id on ElevenLabs. |
curl -X DELETE "https://api.ken.so/v1/voices/elevenlabs/01JC8Z3K6Q2W4M7N9P5R1T3V5X" \
-H "Authorization: Bearer $KENSO_API_KEY" \
-H "Ken-Version: 2026-11-02" \
-H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"Response 204
HTTP/1.1 204 No ContentMore in Copy and personalization:Custom variablesAI promptsPrompt versionsImage variablesCopy gradesCopy checksVoice notesVoice note previewsMessage templatesAll resources