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

> **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-17 (42 changes)

- **Added**: Added optional query parameter schemaVersion to webhook-event-types.get-schema: 2026-11 (the default) or 2026-12, the body an endpoint that opted into schemaVersion 2026-12 receives (workspaceId, the dotted eventType, no null keys). The eventType path segment also takes the dotted alias. - [`webhook-event-types.get-schema`](/docs/api/webhook-event-types/get-schema.md)
- **Changed**: Documented the image-variables.set-shared-image request body as required. Added the application/json request body to image-variables.set-shared-image. Added the multipart/form-data request body to image-variables.set-shared-image. - [`image-variables.set-shared-image`](/docs/api/image-variables/set-shared-image.md)
- **Changed**: Documented the saved-lists.create-upload request body as required. Added the multipart/form-data request body to saved-lists.create-upload. - [`saved-lists.create-upload`](/docs/api/saved-lists/create-upload.md)
- **Changed**: Documentation fix: funding-rounds.export and job-postings.export with format csv have always answered the CSV file itself (text/csv; charset=utf-8, an attachment named funding-rounds-{yyyyMMdd-HHmmss}.csv or job-postings-{yyyyMMdd-HHmmss}.csv). The reference listed only the JSON body on their 200 and now lists the text/csv body beside it, so no response changed.
- **Changed**: Documentation fix: a social record's data field (social-lookups.create, social-lookups.get, social-records.list, social-searches.create and social-searches.get) was shown as a map of a JsonNode schema with options, parent and root fields, which no real value fits. The reference now shows it as an object whose values may be any JSON, as the API always returned it, so no response changed.
- **Changed**: A campaign's email sequence test send takes an optional providerTrack (google, microsoft or other) and sends the emails as that provider track sends them, as the segment test send already does. - [`email-sequences.test-send`](/docs/api/email-sequences/test-send.md)
- **Changed**: Added locationKind and locationDetail to the bookings.get response: the location the booking was made with, null on bookings made before it was stored. - [`bookings.get`](/docs/api/bookings/get.md)
- **Changed**: Added data[].locationKind and data[].locationDetail to the bookings.list response: the location each booking was made with, null on bookings made before it was stored. - [`bookings.list`](/docs/api/bookings/list.md)
- **Changed**: Added locationKind and locationDetail to the bookings.no-show response: the location the booking was made with, null on bookings made before it was stored. - [`bookings.no-show`](/docs/api/bookings/no-show.md)
- **Changed**: Added optional otherLocations ([{kind, detail}]) to the meeting-types.create request and response: up to 5 more locations the booker can pick besides locationKind. - [`meeting-types.create`](/docs/api/meeting-types/create.md)
- **Changed**: Added otherLocations ([{kind, detail}]) to the meeting-types.get response: the other locations the booker can pick besides locationKind, [] when none. - [`meeting-types.get`](/docs/api/meeting-types/get.md)
- **Changed**: Added data[].otherLocations ([{kind, detail}]) to the meeting-types.list response: the other locations the booker can pick besides locationKind, [] when none. - [`meeting-types.list`](/docs/api/meeting-types/list.md)
- **Changed**: Added optional otherLocations ([{kind, detail}]) to the meeting-types.update request and response: replaces the list when sent, [] clears it. - [`meeting-types.update`](/docs/api/meeting-types/update.md)
- **Changed**: The search.get-sample response now documents each tab field by field: profiles, companies and funding each have their own tab type, and every tab's request and page are typed. Each page uses the schema of the operation the tab mirrors (search.search-people, search.search-companies, job-post-searches.companies, job-post-searches.people and triggers.preview), and each request lists the filters the sample sent. The SearchSampleTab schema is replaced by SearchSampleProfilesTab, SearchSampleCompaniesTab and SearchSampleFundingTab. The JSON itself is unchanged. - [`search.get-sample`](/docs/api/search/get-sample.md)
- **Changed**: Documentation fix: the threads.bulk-update body now lists its fields: ids (required, 1 to 1,000 thr_ ids) plus the isRead, isArchived, isSaved, interest and reminderAt fields of a thread update. The endpoint accepts the same bodies as before. - [`threads.bulk-update`](/docs/api/threads/bulk-update.md)
- **Changed**: Documentation fix: the threads.update body now lists its fields: isRead, isArchived, isSaved, interest, reminderAt and personId. Each is optional, and the body needs at least one. The endpoint accepts the same bodies as before. - [`threads.update`](/docs/api/threads/update.md)
- **Changed**: agent-work.create-claim takes scope: live hands out a campaign kind (qualification, segmentation, personalization, rewriting) only from the campaigns Kenso's AI works on by itself, never a Draft, finished or errored one. all, the default, hands out every campaign's as before. - [`agent-work.create-claim`](/docs/api/agent-work/create-claim.md)
- **Added**: agent-work.get takes scope: live counts the campaign kinds only in the campaigns Kenso's AI works on by itself, so an unattended runner sees only the work Kenso's AI would have done. all, the default, counts every campaign as before. - [`agent-work.get`](/docs/api/agent-work/get.md)
- **Changed**: threads.create answers a reused Idempotency-Key sent with a different request with 422 idempotency_key_reused, the status every other operation uses, instead of 409. The error code is unchanged, so a client that branches on the code needs no change; one that branched on the 409 status should read the code. A repeat of the same request with the same key behaves as before. - [`threads.create`](/docs/api/threads/create.md)
- **Changed**: threads.create-message answers a reused Idempotency-Key sent with a different request with 422 idempotency_key_reused, the status every other operation uses, instead of 409, on email, LinkedIn, WhatsApp and Facebook replies alike. The error code is unchanged, so a client that branches on the code needs no change; one that branched on the 409 status should read the code. A repeat of the same request with the same key behaves as before. - [`threads.create-message`](/docs/api/threads/create-message.md)
- **Changed**: Documentation fix: the 401, 429 and 503 responses now show the bodies the API key check and the gateway in front of the operations answer, not only the error body. A 401 can be { "error": "Invalid or revoked API key" } (ApiKeyError) or have no body, a 429 can be { "error": "Rate limit exceeded" } or the plain text "Number of requests exceeded. Please try again later." (RateLimitedText), and a 503 can be { "error": "Authentication is temporarily unavailable" }. Error details also list the class and window that a workspace rate limit's 429 already sends. No request or response changed: handle both shapes and branch on the HTTP status.
- **Changed**: Any workspace member can now create their own sandbox, and reset it, create test keys for it and delete it (sandboxes.reset, sandboxes.create-test-key, sandboxes.delete), a view-only member included. These calls no longer need the integrations permission. A Client or Network member seat, a test key and any key held to a permission template are still refused with 403 permission_denied. - [`sandboxes.create`](/docs/api/sandboxes/create.md)
- **Changed**: Added optional field data.customFieldErrors to the people.intake response: the customFields values Kenso left out because they are not their field's type, each with field (customFields.<key>), code and message. The person is still taken in. Where custom fields are on, a customFields value is read as its field's type, and text is read as a CSV cell would be. - [`people.intake`](/docs/api/people/intake.md)
- **Changed**: Added optional field `data.phoneFind.reason` to the people.create response. The person model's phoneFind gained reason: suppressed when the newest phone find failed because Kenso may not contact the person (on the blocklist, unsubscribed, marked do not contact, or opted out of phone contact), so it asked no source and charged nothing, and the app should not offer to try again; absent otherwise. Only the people get, list and search reads fill phoneFind; people.create leaves it out. Only an iMessage phone find carries it, which needs the imessage feature, off for every workspace for now. - [`people.create`](/docs/api/people/create.md)
- **Changed**: Added optional field `data.phoneFind.reason` to the people.delete-photo response. The person model's phoneFind gained reason: suppressed when the newest phone find failed because Kenso may not contact the person (on the blocklist, unsubscribed, marked do not contact, or opted out of phone contact), so it asked no source and charged nothing, and the app should not offer to try again; absent otherwise. Only the people get, list and search reads fill phoneFind; people.delete-photo leaves it out. Only an iMessage phone find carries it, which needs the imessage feature, off for every workspace for now. - [`people.delete-photo`](/docs/api/people/delete-photo.md)
- **Changed**: Added optional field `data.phoneFind.reason` to the people.get response. The person model's phoneFind gained reason: suppressed when the newest phone find failed because Kenso may not contact the person (on the blocklist, unsubscribed, marked do not contact, or opted out of phone contact), so it asked no source and charged nothing, and the app should not offer to try again; absent otherwise. people.get fills phoneFind with the person's newest phone find. Only an iMessage phone find carries it, which needs the imessage feature, off for every workspace for now. - [`people.get`](/docs/api/people/get.md)
- **Changed**: Added optional field `data[].phoneFind.reason` to the people.list response. The person model's phoneFind gained reason: suppressed when the newest phone find failed because Kenso may not contact the person (on the blocklist, unsubscribed, marked do not contact, or opted out of phone contact), so it asked no source and charged nothing, and the app should not offer to try again; absent otherwise. people.list fills phoneFind with each person's newest phone find. Only an iMessage phone find carries it, which needs the imessage feature, off for every workspace for now. - [`people.list`](/docs/api/people/list.md)
- **Changed**: Added optional field `data.phoneFind.reason` to the people.merge response. The person model's phoneFind gained reason: suppressed when the newest phone find failed because Kenso may not contact the person (on the blocklist, unsubscribed, marked do not contact, or opted out of phone contact), so it asked no source and charged nothing, and the app should not offer to try again; absent otherwise. Only the people get, list and search reads fill phoneFind; people.merge leaves it out. Only an iMessage phone find carries it, which needs the imessage feature, off for every workspace for now. - [`people.merge`](/docs/api/people/merge.md)
- **Changed**: Added optional field `data.phoneFind.reason` to the people.replace-photo response. The person model's phoneFind gained reason: suppressed when the newest phone find failed because Kenso may not contact the person (on the blocklist, unsubscribed, marked do not contact, or opted out of phone contact), so it asked no source and charged nothing, and the app should not offer to try again; absent otherwise. Only the people get, list and search reads fill phoneFind; people.replace-photo leaves it out. Only an iMessage phone find carries it, which needs the imessage feature, off for every workspace for now. - [`people.replace-photo`](/docs/api/people/replace-photo.md)
- **Changed**: Added optional field `data[].phoneFind.reason` to the people.search response. The person model's phoneFind gained reason: suppressed when the newest phone find failed because Kenso may not contact the person (on the blocklist, unsubscribed, marked do not contact, or opted out of phone contact), so it asked no source and charged nothing, and the app should not offer to try again; absent otherwise. people.search fills phoneFind with each person's newest phone find. Only an iMessage phone find carries it, which needs the imessage feature, off for every workspace for now. - [`people.search`](/docs/api/people/search.md)
- **Changed**: Added optional field `data.phoneFind.reason` to the people.update response. The person model's phoneFind gained reason: suppressed when the newest phone find failed because Kenso may not contact the person (on the blocklist, unsubscribed, marked do not contact, or opted out of phone contact), so it asked no source and charged nothing, and the app should not offer to try again; absent otherwise. Only the people get, list and search reads fill phoneFind; people.update leaves it out. Only an iMessage phone find carries it, which needs the imessage feature, off for every workspace for now. - [`people.update`](/docs/api/people/update.md)
- **Changed**: The autonomous reply settings can carry the per-type reply rules, for workspaces with the reply_agent_rules feature: typeRules (what Ken does with interested, question and objection replies: draft, auto_send or escalate), autoSendHoldMinutes, dailyAutoSendCap, autoSendsToday, autoSendPaused, escalateToUserId and trialEndsAt. Without the feature these optional fields are omitted. - [`autonomous-reply-settings.get`](/docs/api/autonomous-reply-settings/get.md)
- **Changed**: Updating the autonomous reply settings accepts typeRules, autoSendPaused, escalateToUserId and trial for workspaces with the reply_agent_rules feature, and returns the same optional rule fields as the get. Without the feature these fields are refused with 400 validation_failed, detail code feature_disabled. - [`autonomous-reply-settings.update`](/docs/api/autonomous-reply-settings/update.md)

Optional fields added on 9 operations:

- **Changed**: Added optional field `overrideContactLimits` to the threads.create request. - [`threads.create`](/docs/api/threads/create.md)
- **Changed**: Added optional fields `data.fieldSources`, `data.foundedYear`, `data.hqCity`, `data.hqCountry` and `data.revenueRange` to the account-domains.create response. - [`account-domains.create`](/docs/api/account-domains/create.md)
- **Changed**: Added optional fields `data.fieldSources`, `data.foundedYear`, `data.hqCity`, `data.hqCountry` and `data.revenueRange` to the account-domains.delete response. - [`account-domains.delete`](/docs/api/account-domains/delete.md)
- **Changed**: Added optional fields `items[].foundedYear`, `items[].hqCity`, `items[].hqCountry` and `items[].revenueRange` to the accounts.bulk-create request. Added optional fields `data.results[].account.fieldSources`, `data.results[].account.foundedYear`, `data.results[].account.hqCity`, `data.results[].account.hqCountry` and `data.results[].account.revenueRange` to the accounts.bulk-create response. - [`accounts.bulk-create`](/docs/api/accounts/bulk-create.md)
- **Changed**: Added optional fields `foundedYear`, `hqCity`, `hqCountry` and `revenueRange` to the accounts.create request. Added optional fields `data.fieldSources`, `data.foundedYear`, `data.hqCity`, `data.hqCountry` and `data.revenueRange` to the accounts.create response. - [`accounts.create`](/docs/api/accounts/create.md)
- **Changed**: Added optional fields `data.fieldSources`, `data.foundedYear`, `data.hqCity`, `data.hqCountry` and `data.revenueRange` to the accounts.get response. - [`accounts.get`](/docs/api/accounts/get.md)
- **Changed**: Added optional fields `data[].fieldSources`, `data[].foundedYear`, `data[].hqCity`, `data[].hqCountry` and `data[].revenueRange` to the accounts.list response. - [`accounts.list`](/docs/api/accounts/list.md)
- **Changed**: Added optional fields `data.fieldSources`, `data.foundedYear`, `data.hqCity`, `data.hqCountry` and `data.revenueRange` to the accounts.merge response. - [`accounts.merge`](/docs/api/accounts/merge.md)
- **Changed**: Added optional fields `foundedYear`, `hqCity`, `hqCountry` and `revenueRange` to the accounts.update request. Added optional fields `data.fieldSources`, `data.foundedYear`, `data.hqCity`, `data.hqCountry` and `data.revenueRange` to the accounts.update response. - [`accounts.update`](/docs/api/accounts/update.md)

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