> 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-02

> **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-02 (35 changes)

- **Added**: Added GET /v1/saved-list-members: search the people and companies on the workspace's own saved lists and lists shared with it (never library lists) by name, title or company with q (2-200 characters). Each result is a member as saved-lists.list-members shows it, plus savedListId, savedListName and savedListKind; a person on two lists comes back once per list. Cursor pagination, no total; a page can hold fewer results than limit, even none, with hasMore true, so keep paging with nextCursor. - [`saved-list-members.list`](/docs/api/saved-list-members/list.md)
- **Changed**: Added the optional q parameter: matches a part of a member's full name, title or company name, any case. Up to 200 characters; shorter than 2 is ignored. With q, includeTotal counts the matches. - [`saved-lists.list-members`](/docs/api/saved-lists/list-members.md)
- **Changed**: Documentation fix: enum fields in this reference now show the string values the API has always sent and accepted (for example "active"), not integer codes. No request or response changed.
- **Changed**: Accepts an optional Idempotency-Key header (at most 200 characters, per workspace). A retry with the same key and the same request within 24 hours returns the first response, with Idempotent-Replayed: true, and does not run the write again. The same key with a different request is 422 idempotency_key_reused. - [`threads.bulk-update`](/docs/api/threads/bulk-update.md)
- **Changed**: Accepts an optional Idempotency-Key header (at most 200 characters, per workspace). A retry with the same key and the same request within 24 hours returns the first response, with Idempotent-Replayed: true, and does not run the write again. The same key with a different request is 422 idempotency_key_reused. - [`threads.mark-all-read`](/docs/api/threads/mark-all-read.md)
- **Changed**: Accepts an optional Idempotency-Key header (at most 200 characters, per workspace). A retry with the same key and the same request within 24 hours returns the first response, with Idempotent-Replayed: true, and does not run the write again. The same key with a different request is 422 idempotency_key_reused. - [`threads.update`](/docs/api/threads/update.md)
- **Changed**: Added the optional view query parameter to search.search-people. view=summary returns each person with only the fields a list shows (names, headline, LinkedIn URL, photo, current title and company, location, seniority, function, job-change signals, hasKenEmail, kenEmailStatus, lookalike), about 1-2 KB a person instead of 17-28 KB. Without view, or with view=full, the response is unchanged. - [`search.search-people`](/docs/api/search/search-people.md)
- **Changed**: Each LinkedIn engagement in the list now carries optional fields: reactionType for a reaction, commentId and parentCommentId for a comment or a reply under one, postText, an intent label on comments and replies (requesting, positive, question, neutral or negative) with its intentReason, and ownPost, which is false when the post was pasted in and is not by a connected seat or your company page. Existing fields are unchanged. - [`triggers.list-linkedin-engagements`](/docs/api/triggers/list-linkedin-engagements.md)
- **Added**: Added cli-logins.create, which starts a Kenso CLI browser login and returns the code to approve. It answers 404 until Kenso CLI browser login is turned on. - [`cli-logins.create`](/docs/api/cli-logins/create.md)
- **Added**: Added cli-logins.token, which the Kenso CLI polls until its browser login is approved, denied or expired. It answers 404 until Kenso CLI browser login is turned on. - [`cli-logins.token`](/docs/api/cli-logins/token.md)
- **Changed**: The response adds data.results: one item per submitted contact, in request order, with its index, status (created, updated, skipped or failed), the contact id when saved, a reason and message when not, and sendable. succeeded and failed are unchanged. - [`contacts.create`](/docs/api/contacts/create.md)
- **Changed**: Documented the request body. customVariables merges into the contact's custom variables; a null or empty value removes that key. - [`contacts.update`](/docs/api/contacts/update.md)
- **Changed**: Documented the items: each is a contactId (required) plus any field contacts.update accepts, customVariables included. - [`contacts.bulk-update`](/docs/api/contacts/bulk-update.md)
- **Changed**: The response schema it shares with contacts.create now lists data.results. Only contacts.create fills it, so this operation's responses do not change. - [`contacts.bulk-delete`](/docs/api/contacts/bulk-delete.md)
- **Changed**: The response schema it shares with contacts.create now lists data.results. Only contacts.create fills it, so this operation's responses do not change. - [`contacts.bulk-pause`](/docs/api/contacts/bulk-pause.md)
- **Changed**: The response schema it shares with contacts.create now lists data.results. Only contacts.create fills it, so this operation's responses do not change. - [`contacts.bulk-resume`](/docs/api/contacts/bulk-resume.md)
- **Changed**: Documented the JSON and multipart request bodies: source, target, contacts, columnMappings, the uploaded file and the import options. The endpoint already accepted these fields. - [`contact-imports.create`](/docs/api/contact-imports/create.md)
- **Changed**: Documented the request body: kind, the campaign, segment and workspace filters, fields and the events range. The endpoint already accepted these fields. - [`contact-exports.create`](/docs/api/contact-exports/create.md)
- **Changed**: Added optional field catchAllLaneEnabled to the campaigns.update request: true opts the campaign in to the catch-all lane (off by default, and no effect until Kenso turns the lane on). Added optional fields data.catchAllLaneEnabled and data.catchAllLanePausedAt to the campaigns.update response. - [`campaigns.update`](/docs/api/campaigns/update.md)
- **Added**: Added the optional campaignId, since and stage query parameters to search.list-lookalike-seeds. campaignId is required with source campaign and filters interested and replies; since (a day as YYYY-MM-DD, UTC) counts only replies or visits on or after it for interested, replies and website_visitors; stage picks the CRM deals for source crm: won (default), open or any. - [`search.list-lookalike-seeds`](/docs/api/search/list-lookalike-seeds.md)
- **Changed**: Added optional field data[].kind to the contacts.events response: on a video_event row, which video activity it is (video_viewed, video_played, video_watched, video_liked or video_cta_clicked). Omitted on every other row. - [`contacts.events`](/docs/api/contacts/events.md)
- **Added**: First dated version of the Kenso API. Its shapes are identical to Ken-Version: 1.1, which stays an alias of this version. Send Ken-Version: 2026-11-02 and your integration keeps these shapes until the version retires, 12 months after the next version ships. A request without the header uses the version its API key is pinned to.

Optional fields added on 13 operations:

- **Changed**: Added optional field `data.phoneCountryAssumed` to the contacts.get response. - [`contacts.get`](/docs/api/contacts/get.md)
- **Changed**: Added optional field `data[].phoneCountryAssumed` to the contacts.list response. - [`contacts.list`](/docs/api/contacts/list.md)
- **Changed**: Added optional field `data[].phoneCountryAssumed` to the contacts.search response. - [`contacts.search`](/docs/api/contacts/search.md)
- **Changed**: Added optional field `data.phoneCountryAssumed` to the contacts.update response. - [`contacts.update`](/docs/api/contacts/update.md)
- **Changed**: Added optional fields `data.catchAllLaneEnabled` and `data.catchAllLanePausedAt` to the campaigns.archive response. - [`campaigns.archive`](/docs/api/campaigns/archive.md)
- **Changed**: Added optional fields `data.catchAllLaneEnabled` and `data.catchAllLanePausedAt` to the campaigns.create response. - [`campaigns.create`](/docs/api/campaigns/create.md)
- **Changed**: Added optional fields `data.catchAllLaneEnabled` and `data.catchAllLanePausedAt` to the campaigns.duplicate response. - [`campaigns.duplicate`](/docs/api/campaigns/duplicate.md)
- **Changed**: Added optional fields `data.catchAllLaneEnabled` and `data.catchAllLanePausedAt` to the campaigns.get response. - [`campaigns.get`](/docs/api/campaigns/get.md)
- **Changed**: Added optional fields `data.catchAllLaneEnabled` and `data.catchAllLanePausedAt` to the campaigns.launch response. - [`campaigns.launch`](/docs/api/campaigns/launch.md)
- **Changed**: Added optional fields `data[].catchAllLaneEnabled` and `data[].catchAllLanePausedAt` to the campaigns.list response. - [`campaigns.list`](/docs/api/campaigns/list.md)
- **Changed**: Added optional fields `data.catchAllLaneEnabled` and `data.catchAllLanePausedAt` to the campaigns.pause response. - [`campaigns.pause`](/docs/api/campaigns/pause.md)
- **Changed**: Added optional fields `data.catchAllLaneEnabled` and `data.catchAllLanePausedAt` to the campaigns.restart response. - [`campaigns.restart`](/docs/api/campaigns/restart.md)
- **Changed**: Added optional fields `data.catchAllLaneEnabled` and `data.catchAllLanePausedAt` to the campaigns.resume response. - [`campaigns.resume`](/docs/api/campaigns/resume.md)

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