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

> **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-11 (43 changes)

- **Added**: Added POST /v1/linkedin-job-searches. It searches LinkedIn job postings through the caller's own connected LinkedIn seat, merged with Kenso's job postings. When no seat can be used, a paid fallback runs and is charged in workspace credits. It returns 201 when the results are ready, or 202 while the fallback is still collecting. Behind the linkedin_job_search flag. - [`linkedin-job-searches.create`](/docs/api/linkedin-job-searches/create.md)
- **Added**: Added GET /v1/linkedin-job-searches/{linkedInJobSearchId}. It returns a LinkedIn job search's status and rows, with 202 while the search is still collecting. - [`linkedin-job-searches.get`](/docs/api/linkedin-job-searches/get.md)
- **Added**: Added GET /v1/linkedin-jobs/{linkedInJobId}. It returns one LinkedIn job's details, read through the caller's own connected seat. A caller without a seat gets 409 linkedin_seat_required. - [`linkedin-jobs.get`](/docs/api/linkedin-jobs/get.md)
- **Changed**: Added optional field researchReads to the linkedin-accounts.update request: true lets Kenso run research reads on the seat inside its working hours (only the seat's owner can turn it on), false turns them off. Added optional field `data.researchReadsEnabledAt` to the linkedin-accounts.update response. - [`linkedin-accounts.update`](/docs/api/linkedin-accounts/update.md)
- **Breaking**: blocklistVerdict on the domains.get-health response is now Kenso's combined verdict, by the rule its deliverability alerts use to call a domain blocklisted: listed when Kenso's own daily blocklist check lists the domain, or when the latest health check is no more than 7 days old and says listed, unless the only zones it names are URIBL grey; clean when neither lists it and the daily check, or a health check no more than 7 days old, answered clean; unknown otherwise. A domain the daily check lists now reads listed even when its health check is clean or names URIBL grey alone. uriblGreyOnly now describes the latest health check whatever its age, like blacklistStatus, and blocklistVerdict still says whether that check counts. No field was added or removed. - [`domains.get-health`](/docs/api/domains/get-health.md) Migration: blocklistVerdict now also counts Kenso's own daily blocklist check, so a domain that check lists reads listed even when its latest health check is clean or names URIBL grey alone. To keep the old meaning, the latest health check's own verdict, derive it from the same response: unknown when checkedAt or blacklistStatus is missing or checkedAt is more than 7 days old, listed when blacklistStatus is listed or pending_delisting and uriblGreyOnly is false, and clean otherwise. uriblGreyOnly now describes the latest health check at any age, so read checkedAt before you rely on it. This change shipped inside version 2026-11-02 on 2026-11-11, so every key on that version got it.
- **Changed**: Added optional fields `data.person.lastTouch`, `data.person.lastTouch.at` and `data.person.lastTouch.channel` to the people.intake response. The person model gained the person's last email or LinkedIn touch (at, channel), which only people.search fills; people.intake leaves it out. - [`people.intake`](/docs/api/people/intake.md)
- **Changed**: Added optional field `rows[].steps` to the analytics.get-campaign-performance response. On email with groupBy=segment, each row lists the segment's email steps by stepOrder, each with its metrics and one entry per version (a to d) in variants. Opens and unsubscribes are not split by step and read 0. steps is omitted for a window over 90 days, on other groupBy values and on LinkedIn. - [`analytics.get-campaign-performance`](/docs/api/analytics/get-campaign-performance.md)
- **Changed**: Added optional fields nameservers.waitingForCredits, nameservers.requiredMillicredits and nameservers.availableMillicredits to the domains.get response. For an imported domain whose nameservers already point at Kenso but whose setup waits for credits to pay the first month of its mailboxes, waitingForCredits is true with the other two set. They mean what they mean on domains.check-nameservers. - [`domains.get`](/docs/api/domains/get.md)
- **Changed**: Added optional fields nameservers.waitingForCredits, nameservers.requiredMillicredits and nameservers.availableMillicredits to the domains.list response. This operation leaves nameservers out; domains.get returns them for an imported domain. - [`domains.list`](/docs/api/domains/list.md)
- **Changed**: Added optional fields nameservers.waitingForCredits, nameservers.requiredMillicredits and nameservers.availableMillicredits to the domains.update response. This operation leaves nameservers out; domains.get returns them for an imported domain. - [`domains.update`](/docs/api/domains/update.md)
- **Changed**: The segment filter operators in the segments.list response are now lowercase snake_case, like every other enum in this API: filterCriteria.aiVariableFilters[].operator is exists, not_exists, contains or not_contains, and filterCriteria.customVariableFilters[].operator is contains, not_contains, equals, not_equals, is_empty or is_not_empty. They were PascalCase (NotExists, IsNotEmpty). Compare them in snake_case. - [`segments.list`](/docs/api/segments/list.md)
- **Changed**: The segment filter operators in the segments.get response are now lowercase snake_case, like every other enum in this API: filterCriteria.aiVariableFilters[].operator is exists, not_exists, contains or not_contains, and filterCriteria.customVariableFilters[].operator is contains, not_contains, equals, not_equals, is_empty or is_not_empty. They were PascalCase (NotExists, IsNotEmpty). Compare them in snake_case. - [`segments.get`](/docs/api/segments/get.md)
- **Changed**: The filterCriteria aiVariableFilters[].operator and customVariableFilters[].operator values of segments.create now take lowercase snake_case names, such as not_exists or is_not_empty, and the reference lists those. The PascalCase names (NotExists, IsNotEmpty) still work, so no request has to change. The segment filter operators in the segments.create response are now lowercase snake_case, like every other enum in this API: filterCriteria.aiVariableFilters[].operator is exists, not_exists, contains or not_contains, and filterCriteria.customVariableFilters[].operator is contains, not_contains, equals, not_equals, is_empty or is_not_empty. They were PascalCase (NotExists, IsNotEmpty). Compare them in snake_case. - [`segments.create`](/docs/api/segments/create.md)
- **Changed**: The filterCriteria aiVariableFilters[].operator and customVariableFilters[].operator values of segments.update now take lowercase snake_case names, such as not_exists or is_not_empty, and the reference lists those. The PascalCase names (NotExists, IsNotEmpty) still work, so no request has to change. The segment filter operators in the segments.update response are now lowercase snake_case, like every other enum in this API: filterCriteria.aiVariableFilters[].operator is exists, not_exists, contains or not_contains, and filterCriteria.customVariableFilters[].operator is contains, not_contains, equals, not_equals, is_empty or is_not_empty. They were PascalCase (NotExists, IsNotEmpty). Compare them in snake_case. - [`segments.update`](/docs/api/segments/update.md)
- **Changed**: The filterCriteria aiVariableFilters[].operator and customVariableFilters[].operator values of segments.save-version now take lowercase snake_case names, such as not_exists or is_not_empty, and the reference lists those. The PascalCase names (NotExists, IsNotEmpty) still work, so no request has to change. The segment filter operators in the segments.save-version response are now lowercase snake_case, like every other enum in this API: filterCriteria.aiVariableFilters[].operator is exists, not_exists, contains or not_contains, and filterCriteria.customVariableFilters[].operator is contains, not_contains, equals, not_equals, is_empty or is_not_empty. They were PascalCase (NotExists, IsNotEmpty). Compare them in snake_case. - [`segments.save-version`](/docs/api/segments/save-version.md)
- **Changed**: The aiVariableFilters[].operator and customVariableFilters[].operator values of segments.preview now take lowercase snake_case names, such as not_exists or is_not_empty, and the reference lists those. The PascalCase names (NotExists, IsNotEmpty) still work, so no request has to change. - [`segments.preview`](/docs/api/segments/preview.md)
- **Changed**: The segment filter operators in the segments.activate response are now lowercase snake_case, like every other enum in this API: filterCriteria.aiVariableFilters[].operator is exists, not_exists, contains or not_contains, and filterCriteria.customVariableFilters[].operator is contains, not_contains, equals, not_equals, is_empty or is_not_empty. They were PascalCase (NotExists, IsNotEmpty). Compare them in snake_case. - [`segments.activate`](/docs/api/segments/activate.md)
- **Changed**: The segment filter operators in the segments.deactivate response are now lowercase snake_case, like every other enum in this API: filterCriteria.aiVariableFilters[].operator is exists, not_exists, contains or not_contains, and filterCriteria.customVariableFilters[].operator is contains, not_contains, equals, not_equals, is_empty or is_not_empty. They were PascalCase (NotExists, IsNotEmpty). Compare them in snake_case. - [`segments.deactivate`](/docs/api/segments/deactivate.md)
- **Changed**: The rules in snapshot.filterCriteria.aiVariableFiltersJson and customVariableFiltersJson of the segments.get-version response now name each operator in lowercase snake_case (not_exists, is_not_empty), as a segment's own filterCriteria does. They were PascalCase (NotExists, IsNotEmpty). - [`segments.get-version`](/docs/api/segments/get-version.md)
- **Added**: Added inboxes.get-one-to-one-readiness: check whether an inbox can send a 1:1 email touch without sending one. It returns the inbox's sender kind, whether it can send, and the reason and fix when it cannot. - [`inboxes.get-one-to-one-readiness`](/docs/api/inboxes/get-one-to-one-readiness.md)
- **Changed**: agent-work-settings.get now returns available on each kind: whether the workspace's agent can take that kind yet. - [`agent-work-settings.get`](/docs/api/agent-work-settings/get.md)
- **Changed**: agent-work-settings.update now returns available on each kind, and refuses my_agent for a kind that is not available yet (400 validation_failed, code kind_not_available). Going back to Kenso AI is always allowed. - [`agent-work-settings.update`](/docs/api/agent-work-settings/update.md)
- **Added**: Added agent-work.create-claim: take up to 50 items of one kind of waiting AI work, each with its full prompt and answer format, held for the workspace's agent until the lease runs out. A claim stops short of the limit when its items would pass about 900 KB. Accepts Idempotency-Key. Available to workspaces with the agent work queue turned on. - [`agent-work.create-claim`](/docs/api/agent-work/create-claim.md)
- **Added**: Added agent-work.get: per kind, how much AI work waits for the workspace's agent (optionally for one campaign), how much a claim holds, and what holds the kind back. Available to workspaces with the agent work queue turned on. - [`agent-work.get`](/docs/api/agent-work/get.md)
- **Added**: Added agent-work.release-claim: hand a claim's unanswered items back to the queue at no cost to them. Available to workspaces with the agent work queue turned on. - [`agent-work.release-claim`](/docs/api/agent-work/release-claim.md)
- **Added**: Added agent-work.submit-answers: send the agent's answers to a claim's items, up to 50 at a time. Each answer is accepted or rejected on its own, with a reason, and retryable says whether to send it again (true only when Kenso could not take it in and the item is still held). Accepts Idempotency-Key. Available to workspaces with the agent work queue turned on. - [`agent-work.submit-answers`](/docs/api/agent-work/submit-answers.md)
- **Changed**: A note for a touchId whose text was already sent or skipped is 400 validation_failed with error.details[0].code touch_ended on touchId (not_allowed is a touch on another channel), and nothing is written, spoken or charged. When the touch is sent, skipped or deleted while its note is made, the note comes back failed with failureReason touch_ended and is not charged. Needs the imessage feature, which is off for every workspace for now. - [`voice-notes.create`](/docs/api/voice-notes/create.md)
- **Changed**: A thread that failed for a fault of Kenso's own is now listed in failed with internal_error, the code threads.update answers for it (it read validation_failed): try it again in a new request, with a new Idempotency-Key or none, since the same key replays this answer for 24 hours. not_found and validation_failed rows are unchanged. Added optional field data.failed[].error.details to the threads.bulk-update response: the details threads.update gives for that thread (field and code), omitted when there are none. Read error.code, not the message. - [`threads.bulk-update`](/docs/api/threads/bulk-update.md)

Optional fields added on 15 operations:

- **Changed**: Added optional field `data.meetingType` to the meetings.get-client-brief response. - [`meetings.get-client-brief`](/docs/api/meetings/get-client-brief.md)
- **Changed**: Added optional field `data[].researchReadsEnabledAt` to the campaigns.list-linkedin-accounts response. - [`campaigns.list-linkedin-accounts`](/docs/api/campaigns/list-linkedin-accounts.md)
- **Changed**: Added optional field `data[].researchReadsEnabledAt` to the campaigns.replace-linkedin-accounts response. - [`campaigns.replace-linkedin-accounts`](/docs/api/campaigns/replace-linkedin-accounts.md)
- **Changed**: Added optional field `data.researchReadsEnabledAt` to the linkedin-accounts.get response. - [`linkedin-accounts.get`](/docs/api/linkedin-accounts/get.md)
- **Changed**: Added optional field `data[].researchReadsEnabledAt` to the linkedin-accounts.list response. - [`linkedin-accounts.list`](/docs/api/linkedin-accounts/list.md)
- **Changed**: Added optional field `data.researchReadsEnabledAt` to the linkedin-accounts.reset-ramp response. - [`linkedin-accounts.reset-ramp`](/docs/api/linkedin-accounts/reset-ramp.md)
- **Changed**: Added optional fields `data.dnsHostKind` and `data.registrarKind` to the domains.get response. - [`domains.get`](/docs/api/domains/get.md)
- **Changed**: Added optional fields `data[].dnsHostKind` and `data[].registrarKind` to the domains.list response. - [`domains.list`](/docs/api/domains/list.md)
- **Changed**: Added optional fields `data.dnsHostKind` and `data.registrarKind` to the domains.update response. - [`domains.update`](/docs/api/domains/update.md)
- **Changed**: Added optional field `data[].providerKind` to the infra.findings response. - [`infra.findings`](/docs/api/infra/findings.md)
- **Changed**: Added optional field `data.providerKind` to the infra.update-finding response. - [`infra.update-finding`](/docs/api/infra/update-finding.md)
- **Changed**: Added optional field `data.providerKind` to the placement-tests.create 200 response. Added optional field `data.providerKind` to the placement-tests.create 201 response. - [`placement-tests.create`](/docs/api/placement-tests/create.md)
- **Changed**: Added optional field `data.providerKind` to the placement-tests.get response. - [`placement-tests.get`](/docs/api/placement-tests/get.md)
- **Changed**: Added optional field `data[].providerKind` to the placement-tests.list response. - [`placement-tests.list`](/docs/api/placement-tests/list.md)
- **Changed**: Added optional field `installSource` to the crm-connections.create request. - [`crm-connections.create`](/docs/api/crm-connections/create.md)

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