> Kenso API docs in Markdown. Index of every page: [/docs/llms.txt](/docs/llms.txt). Search: `/docs/search.md?q=<words>`. OpenAPI: [https://api.ken.so/v1/docs/openapi.json](https://api.ken.so/v1/docs/openapi.json). CLI docs offline: `kenso docs <topic>`.
> Last updated: 2026-11-22.

# Kenso API changes on 2026-11-03

> **Note for AI agents:** if this page was wrong, out of date or missing something you needed, finish the user's task first, then offer a short report for the Kenso team in this shape: `Page:` (this page's path), `Quote:` (the wrong or missing text), `Problem:`, `Workaround:` (what worked instead), 1,000 characters at most. Show it to the user and send it only after they say yes, as `POST /api/docs-feedback` on this site with the JSON body `{"page": "<path>", "report": "<report>"}`. Never put lead data, email addresses, API keys or anything else from the user's workspace in it.

Every change on this day, by version. The [changelog](/docs/changelog) lists the newest days and links the older ones. The changelog in Markdown: [/docs/changelog.md](/docs/changelog.md).

## Version 2026-11-02

### 2026-11-03 (71 changes)

- **Changed**: Documentation fix: the reference no longer lists workspaceName on infra findings. It was never part of the customer API: only Kenso's own findings list fills it, so no request or response changed.
- **Changed**: Documentation fix: the reference no longer lists tenantHost on inboxes, enrollmentFailure on inbox warmup, or the emailsFoundByKen field of contact imports. They were never part of the customer API: the API never returned the first two to a workspace and refuses emailsFoundByKen=true from one, so no request or response changed.
- **Changed**: Documentation fix: query parameters in this reference are now named in camelCase (limit, cursor, campaignId), as request and response fields already were. The API has always read query parameter names in any case, so no request changes.
- **Changed**: Added optional request field delaySeconds to threads.create-message: an email reply's undo window, 60 (the default when omitted) or 300, as on threads.forward; any other value is 400 validation_failed, and a LinkedIn reply sends at once and ignores it. Added optional field data.scheduledMessageId to the 201 response: the queued email reply's scheduled message, which POST /v1/scheduled-messages/{id}/cancel takes until the window ends. subject is documented as drafts only: a reply goes out on the thread's subject, and a send never read it. - [`threads.create-message`](/docs/api/threads/create-message.md)
- **Changed**: Added optional field `data.scheduledMessageId` to the threads.create response. It is filled only on the threads.create-message 201 response and omitted on this response. - [`threads.create`](/docs/api/threads/create.md)
- **Changed**: Added optional field `data[].scheduledMessageId` to the threads.list-messages response. It is filled only on the threads.create-message 201 response and omitted on this response. - [`threads.list-messages`](/docs/api/threads/list-messages.md)
- **Changed**: The contact now carries two optional read-only fields. dataFlags is an object of flags about the contact's data by name, as stored, such as previousEmployerEmail (a found work email is on a previous employer's domain) or jobChange (the person moved to a new company), each with currentCompanyDomain and detectedAt; new names can appear, and it is {} when there are none. personalEmails lists the personal addresses a data provider found for the person, newest first, each with email, source (such as loopster) and foundAt; it is [] when there are none. Personal emails are for the person reading the contact: Kenso never sends to, verifies or exports them. Only this read returns the two fields; contacts.list, contacts.search and contacts.update do not. - [`contacts.get`](/docs/api/contacts/get.md)
- **Changed**: Added optional field `data.linkedInOnly` to the campaigns.archive response. It is filled only on campaigns.list items and omitted on this response. - [`campaigns.archive`](/docs/api/campaigns/archive.md)
- **Changed**: Added optional field `data.linkedInOnly` to the campaigns.create response. It is filled only on campaigns.list items and omitted on this response. - [`campaigns.create`](/docs/api/campaigns/create.md)
- **Changed**: Added optional field `data.linkedInOnly` to the campaigns.duplicate response. It is filled only on campaigns.list items and omitted on this response. - [`campaigns.duplicate`](/docs/api/campaigns/duplicate.md)
- **Changed**: Added optional field `data.linkedInOnly` to the campaigns.get response. It is filled only on campaigns.list items and omitted on this response. - [`campaigns.get`](/docs/api/campaigns/get.md)
- **Changed**: Added optional field `data.linkedInOnly` to the campaigns.launch response. It is filled only on campaigns.list items and omitted on this response. - [`campaigns.launch`](/docs/api/campaigns/launch.md)
- **Changed**: Added optional field `data[].linkedInOnly` to the campaigns.list response. True when the campaign is LinkedIn-only. - [`campaigns.list`](/docs/api/campaigns/list.md)
- **Changed**: Added optional field `data.linkedInOnly` to the campaigns.pause response. It is filled only on campaigns.list items and omitted on this response. - [`campaigns.pause`](/docs/api/campaigns/pause.md)
- **Changed**: Added optional field `data.linkedInOnly` to the campaigns.restart response. It is filled only on campaigns.list items and omitted on this response. - [`campaigns.restart`](/docs/api/campaigns/restart.md)
- **Changed**: Added optional field `data.linkedInOnly` to the campaigns.resume response. It is filled only on campaigns.list items and omitted on this response. - [`campaigns.resume`](/docs/api/campaigns/resume.md)
- **Changed**: Added optional field `data.linkedInOnly` to the campaigns.update response. It is filled only on campaigns.list items and omitted on this response. - [`campaigns.update`](/docs/api/campaigns/update.md)
- **Added**: Added GET /v1/contacts/{contactId}/behavior: what Kenso learned about the person behind a contact from outreach outcomes. workspace holds this workspace's tags (such as cold_responder, prefers_linkedin, best_window:weekday_morning, away_until:2026-11-18), signal records {key, value, rate, touches, responses}, touches and computedAt; network holds the same from every Kenso workspace, anonymous, plus workspaces (how many other workspaces touched the person), only where the workspace has network signals on. Absent means null, and a contact with no profile returns an empty object. Answers not_found until behavior signals are on for the workspace. - [`contact-behavior.get`](/docs/api/contact-behavior/get.md)
- **Changed**: Each contact can now carry the optional field customVideo, the lead's own video when it has one: status (pending, ready or failed), provider, source, watchUrl, previewUrl and previewExpiresAt (a short-lived thumbnail preview) and error. It is present only when campaign videos are on for the workspace, which are in early access. Existing fields are unchanged. - [`contacts.get`](/docs/api/contacts/get.md)
- **Changed**: Each contact in the list can now carry the optional field customVideo, the lead's own video when it has one: status (pending, ready or failed), provider, source, watchUrl, previewUrl and previewExpiresAt (a short-lived thumbnail preview) and error. It is present only when campaign videos are on for the workspace, which are in early access. Existing fields are unchanged. - [`contacts.list`](/docs/api/contacts/list.md)
- **Changed**: Each contact in the results can now carry the optional field customVideo, the lead's own video when it has one: status (pending, ready or failed), provider, source, watchUrl, previewUrl and previewExpiresAt (a short-lived thumbnail preview) and error. It is present only when campaign videos are on for the workspace, which are in early access. Existing fields are unchanged. - [`contacts.search`](/docs/api/contacts/search.md)
- **Changed**: Added the optional request field customVideo, the lead's own video: a Loom, YouTube, Vimeo, Wistia, Vidyard, Sendspark or HeyGen share link or embed code. Empty or null clears it. The contact must be in a campaign. A video a sent or queued step already uses cannot change: 409 video_in_use. The response carries customVideo as on contacts.get. It needs campaign videos on the workspace, which are in early access. - [`contacts.update`](/docs/api/contacts/update.md)
- **Changed**: Each item accepts the optional field customVideo, with the same rules as contacts.update. An item whose video a sent or queued step already uses gets the status video_in_use. It needs campaign videos on the workspace, which are in early access. - [`contacts.bulk-update`](/docs/api/contacts/bulk-update.md)
- **Changed**: Each contact accepts the optional field customVideo, the lead's own video as a share link or embed code. An empty string clears it. A video a sent or queued step already uses fails its row with code video_in_use, and the contact is still saved. It needs campaign videos on the workspace, which are in early access. - [`contacts.create`](/docs/api/contacts/create.md)
- **Changed**: Added optional field `savedListKind` to the contact-imports.scan request. With target saved_list, send people or companies instead of savedListId to check a file for a list not created yet: rows are read and keyed as a new list of that kind reads them, nothing is on the list yet so duplicateInList is 0, and willAdd is the rows the new list gets. Send exactly one of savedListId and savedListKind, else 400. - [`contact-imports.scan`](/docs/api/contact-imports/scan.md)
- **Changed**: Added optional field data.steps[].voice: a voice_note step's voice settings (provider, voiceId, speed, wordsMode, instructions, script, model, matchLeadLanguage). - [`linkedin-sequences.get`](/docs/api/linkedin-sequences/get.md)
- **Changed**: Added optional field data.steps[].voice: a voice_note step's voice settings, as linkedin-sequences.get returns them. - [`linkedin-sequences.get-version`](/docs/api/linkedin-sequences/get-version.md)
- **Changed**: Added optional field steps[].voice (provider, voiceId, speed, wordsMode, instructions, script, model, matchLeadLanguage): the voice settings of a voice_note LinkedIn step, the AI voice note Ken writes and speaks for each lead. The response returns it on data.steps[].voice. Needs the linkedin_voice_notes feature, which is off for every workspace for now. - [`linkedin-sequences.replace`](/docs/api/linkedin-sequences/replace.md)
- **Changed**: Added optional field steps[].voice (provider, voiceId, speed, wordsMode, instructions, script, model, matchLeadLanguage): the voice settings of a voice_note LinkedIn step, the AI voice note Ken writes and speaks for each lead. The response returns it on data.sequence.steps[].voice. Needs the linkedin_voice_notes feature, which is off for every workspace for now. - [`linkedin-sequences.save-version`](/docs/api/linkedin-sequences/save-version.md)
- **Changed**: Added optional field data.steps[].voice: a voice_note step's voice settings, as linkedin-sequences.get returns them. - [`segment-linkedin-sequences.get`](/docs/api/segment-linkedin-sequences/get.md)
- **Changed**: Added optional field data.steps[].voice: a voice_note step's voice settings, as linkedin-sequences.get returns them. - [`segment-linkedin-sequences.get-version`](/docs/api/segment-linkedin-sequences/get-version.md)
- **Changed**: Added optional field steps[].voice (provider, voiceId, speed, wordsMode, instructions, script, model, matchLeadLanguage): the voice settings of a voice_note LinkedIn step, the AI voice note Ken writes and speaks for each lead. The response returns it on data.steps[].voice. Needs the linkedin_voice_notes feature, which is off for every workspace for now. - [`segment-linkedin-sequences.replace`](/docs/api/segment-linkedin-sequences/replace.md)
- **Changed**: Added optional field steps[].voice (provider, voiceId, speed, wordsMode, instructions, script, model, matchLeadLanguage): the voice settings of a voice_note LinkedIn step, the AI voice note Ken writes and speaks for each lead. The response returns it on data.sequence.steps[].voice. Needs the linkedin_voice_notes feature, which is off for every workspace for now. - [`segment-linkedin-sequences.save-version`](/docs/api/segment-linkedin-sequences/save-version.md)
- **Changed**: Added optional field data.voiceNote to the response: the voice note a LinkedIn message carries (voiceNoteId, status, durationMs, provider, voiceId, language, scriptText, audioAvailable, audioUrl, failureReason). - [`threads.create`](/docs/api/threads/create.md)
- **Changed**: Added optional field data.voiceNote to the 201 response: the voice note a LinkedIn message carries, as threads.list-messages returns it. - [`threads.create-message`](/docs/api/threads/create-message.md)
- **Changed**: Added optional field data[].voiceNote: the voice note a LinkedIn message carries (voiceNoteId, status, durationMs, provider, voiceId, language, scriptText, audioAvailable, audioUrl, failureReason). A voice note Kenso did not send has no voiceNoteId. - [`threads.list-messages`](/docs/api/threads/list-messages.md)
- **Added**: Added POST /v1/voice-note-previews: preview a voice_note step for up to 3 leads of a campaign, 15 leads a day per workspace. Needs the linkedin_voice_notes feature, which is off for every workspace for now. - [`voice-note-previews.create`](/docs/api/voice-note-previews/create.md)
- **Added**: Added GET /v1/voice-notes/{voiceNoteId}/audio: a 302 to a one-hour link to a voice note's audio. Requires Inbox view. Needs the linkedin_voice_notes feature, which is off for every workspace for now. - [`voice-notes.audio`](/docs/api/voice-notes/audio.md)
- **Added**: Added POST /v1/voices: import an ElevenLabs voice from the workspace's own ElevenLabs account. Needs the linkedin_voice_notes feature, which is off for every workspace for now. - [`voices.import`](/docs/api/voices/import.md)
- **Added**: Added GET /v1/voices: the Deepgram and ElevenLabs voices a voice_note step can use, with samples. Needs the linkedin_voice_notes feature, which is off for every workspace for now. - [`voices.list`](/docs/api/voices/list.md)
- **Added**: Added GET /v1/voices/importable: the voices on the workspace's ElevenLabs account that it can import. Needs the linkedin_voice_notes feature, which is off for every workspace for now. - [`voices.list-importable`](/docs/api/voices/list-importable.md)
- **Added**: Added DELETE /v1/voices/{provider}/{voiceId}: remove an imported voice. Needs the linkedin_voice_notes feature, which is off for every workspace for now. - [`voices.remove`](/docs/api/voices/remove.md)
- **Changed**: Added optional field browserRun to the threads.create response: set when the mail came from a site a workflow's browser step submitted a form to (DEV-6958). runId names that browser run, and automated is true for the site's own automatic mail rather than a person's reply. It is omitted on every other thread. - [`threads.create`](/docs/api/threads/create.md)
- **Changed**: Added optional field browserRun to the threads.create-message 201 response: set when the mail came from a site a workflow's browser step submitted a form to (DEV-6958). runId names that browser run, and automated is true for the site's own automatic mail rather than a person's reply. It is omitted on every other thread. - [`threads.create-message`](/docs/api/threads/create-message.md)
- **Changed**: Added optional field browserRun to the threads.get response: set when the mail came from a site a workflow's browser step submitted a form to (DEV-6958). runId names that browser run, and automated is true for the site's own automatic mail rather than a person's reply. It is omitted on every other thread. - [`threads.get`](/docs/api/threads/get.md)
- **Changed**: Added optional field browserRun to each thread in the threads.list response: set when the mail came from a site a workflow's browser step submitted a form to (DEV-6958). runId names that browser run, and automated is true for the site's own automatic mail rather than a person's reply. It is omitted on every other thread. - [`threads.list`](/docs/api/threads/list.md)
- **Changed**: Added optional field browserRun to each message in the threads.list-messages response: set when the mail came from a site a workflow's browser step submitted a form to (DEV-6958). runId names that browser run, and automated is true for the site's own automatic mail rather than a person's reply. It is omitted on every other thread. - [`threads.list-messages`](/docs/api/threads/list-messages.md)
- **Changed**: Added optional field browserRun to the threads.update response: set when the mail came from a site a workflow's browser step submitted a form to (DEV-6958). runId names that browser run, and automated is true for the site's own automatic mail rather than a person's reply. It is omitted on every other thread. - [`threads.update`](/docs/api/threads/update.md)
- **Changed**: Added optional field `savedListId` to the contact-imports.scan request. With target saved_list it runs the List check against one of the workspace's own saved lists: rows already on the list, duplicates inside the file, the workspace blocklist and Kenso's email checks. For a saved list, keys.cleanup defaults to false, as the list's upload does. A saved_list scan also needs Search view and the saved lists feature. - [`contact-imports.scan`](/docs/api/contact-imports/scan.md)
- **Changed**: Added optional fields records and searchId to the contact-imports.create request, for source loopster: records holds 1 to 1,000 people picked in the Loopster tab of Search (each record's id, position and fields, as the search returned it), and searchId is the meta.searchId of that search, needed when a picked record has no linkedInUrl. - [`contact-imports.create`](/docs/api/contact-imports/create.md)
- **Changed**: Added optional field data[].photoUrl to the saved-list-members.list response: the member's profile photo, as saved-lists.list-members returns it. - [`saved-list-members.list`](/docs/api/saved-list-members/list.md)
- **Changed**: Added optional field data[].photoUrl to the saved-lists.list-members response: the member's profile photo, saved when the member is added or refreshed from a Search or campaign source. It is omitted when there is no photo, for a LinkedIn placeholder image, or for an expired photo link. - [`saved-lists.list-members`](/docs/api/saved-lists/list-members.md)
- **Changed**: Added optional fields `data.filterCriteria.behaviorTags` and `data.filterCriteria.behaviorTagsExclude` to the segments.activate response. They echo the segment's behavior tag criteria, unset when the segment has none. - [`segments.activate`](/docs/api/segments/activate.md)
- **Changed**: Added optional fields `filterCriteria.behaviorTags` and `filterCriteria.behaviorTagsExclude` to the segments.create request. Added optional fields `data.filterCriteria.behaviorTags` and `data.filterCriteria.behaviorTagsExclude` to the segments.create response. behaviorTags keeps contacts whose behavior tags include any of these (what Kenso learned from outreach outcomes, e.g. cold_responder or prefers_linkedin), and behaviorTagsExclude drops contacts that carry any of them. Each takes up to 50 tags; email_confirmed, email_dead_end and left_company cannot be filtered. Workspace tags always count, network tags only with the behavior_signals_network feature. They echo the segment's behavior tag criteria, unset when the segment has none. - [`segments.create`](/docs/api/segments/create.md)
- **Changed**: Added optional fields `data.filterCriteria.behaviorTags` and `data.filterCriteria.behaviorTagsExclude` to the segments.deactivate response. They echo the segment's behavior tag criteria, unset when the segment has none. - [`segments.deactivate`](/docs/api/segments/deactivate.md)
- **Changed**: Added optional fields `data.filterCriteria.behaviorTags` and `data.filterCriteria.behaviorTagsExclude` to the segments.get response. They echo the segment's behavior tag criteria, unset when the segment has none. - [`segments.get`](/docs/api/segments/get.md)
- **Changed**: Added optional fields `data.snapshot.filterCriteria.behaviorTags` and `data.snapshot.filterCriteria.behaviorTagsExclude` to the segments.get-version response. They echo the segment's behavior tag criteria, unset when the segment has none. - [`segments.get-version`](/docs/api/segments/get-version.md)
- **Changed**: Added optional fields `data[].filterCriteria.behaviorTags` and `data[].filterCriteria.behaviorTagsExclude` to the segments.list response. They echo the segment's behavior tag criteria, unset when the segment has none. - [`segments.list`](/docs/api/segments/list.md)
- **Changed**: Added optional fields `behaviorTags` and `behaviorTagsExclude` to the segments.preview request. behaviorTags previews the contacts whose behavior tags include any of these (what Kenso learned from outreach outcomes, e.g. cold_responder or prefers_linkedin), and behaviorTagsExclude leaves out contacts that carry any of them. Each takes up to 50 tags; email_confirmed, email_dead_end and left_company cannot be filtered. Workspace tags always count, network tags only with the behavior_signals_network feature. - [`segments.preview`](/docs/api/segments/preview.md)
- **Changed**: Added optional fields `data.snapshot.filterCriteria.behaviorTags` and `data.snapshot.filterCriteria.behaviorTagsExclude` to the segments.restore-version response. They echo the segment's behavior tag criteria, unset when the segment has none. - [`segments.restore-version`](/docs/api/segments/restore-version.md)
- **Changed**: Added optional fields `filterCriteria.behaviorTags` and `filterCriteria.behaviorTagsExclude` to the segments.save-version request. Added optional fields `data.segment.filterCriteria.behaviorTags` and `data.segment.filterCriteria.behaviorTagsExclude` to the segments.save-version response. behaviorTags keeps contacts whose behavior tags include any of these (what Kenso learned from outreach outcomes, e.g. cold_responder or prefers_linkedin), and behaviorTagsExclude drops contacts that carry any of them. Each takes up to 50 tags; email_confirmed, email_dead_end and left_company cannot be filtered. Workspace tags always count, network tags only with the behavior_signals_network feature. They echo the segment's behavior tag criteria, unset when the segment has none. - [`segments.save-version`](/docs/api/segments/save-version.md)
- **Changed**: Added optional fields `filterCriteria.behaviorTags` and `filterCriteria.behaviorTagsExclude` to the segments.update request. Added optional fields `data.filterCriteria.behaviorTags` and `data.filterCriteria.behaviorTagsExclude` to the segments.update response. behaviorTags keeps contacts whose behavior tags include any of these (what Kenso learned from outreach outcomes, e.g. cold_responder or prefers_linkedin), and behaviorTagsExclude drops contacts that carry any of them. Each takes up to 50 tags; email_confirmed, email_dead_end and left_company cannot be filtered. Workspace tags always count, network tags only with the behavior_signals_network feature. They echo the segment's behavior tag criteria, unset when the segment has none. - [`segments.update`](/docs/api/segments/update.md)
- **Added**: Added optional query parameter GroupBy to threads.counts. - [`threads.counts`](/docs/api/threads/counts.md)
- **Added**: Added optional query parameter GroupBy to threads.list. Added optional query parameter PersonKey to threads.list. - [`threads.list`](/docs/api/threads/list.md)
- **Added**: Added optional query parameter includeEvents to threads.list-messages. - [`threads.list-messages`](/docs/api/threads/list-messages.md)

Optional fields added on 6 operations:

- **Changed**: Added optional field `contacts[].useKenEmail` to the contacts.create request. - [`contacts.create`](/docs/api/contacts/create.md)
- **Changed**: Added optional field `useKenEmail` to the people.intake request. - [`people.intake`](/docs/api/people/intake.md)
- **Changed**: Added optional fields `data[].channels`, `data[].channels.email`, `data[].channels.linkedin`, `data[].personId`, `data[].personKey`, `data[].personName`, `data[].threadIds` and `data[].waitingCount` to the threads.list response. - [`threads.list`](/docs/api/threads/list.md)
- **Changed**: Added optional field `data.kind` to the threads.create response. - [`threads.create`](/docs/api/threads/create.md)
- **Changed**: Added optional field `data.kind` to the threads.create-message 201 response. - [`threads.create-message`](/docs/api/threads/create-message.md)
- **Changed**: Added optional field `data[].kind` to the threads.list-messages response. - [`threads.list-messages`](/docs/api/threads/list-messages.md)

- Newer day: [2026-11-04](/docs/changelog/2026-11-04.md)
- Older day: [2026-11-02](/docs/changelog/2026-11-02.md)
- Every change: [/docs/changelog.md](/docs/changelog.md)
