Kenso API changes on 2026-11-11
Every change on this day, by version. The changelog lists the newest days and links the older ones.
Version 2026-11-02
2026-11-11 41 changes
- Added
linkedin-job-searches.create
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. - Added
linkedin-job-searches.get
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. - Added
linkedin-jobs.get
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. - Changed
linkedin-accounts.update
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 fielddata.researchReadsEnabledAtto the linkedin-accounts.update response. - Breaking
domains.get-health
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.
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
people.intake
Added optional fieldsdata.person.lastTouch,data.person.lastTouch.atanddata.person.lastTouch.channelto 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. - Changed
analytics.get-campaign-performance
Added optional fieldrows[].stepsto 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. - Changed
domains.get
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. - Changed
domains.list
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. - Changed
domains.update
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. - Changed
segments.list
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. - Changed
segments.get
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. - Changed
segments.create
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. - Changed
segments.update
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. - Changed
segments.save-version
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. - Changed
segments.preview
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. - Changed
segments.activate
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. - Changed
segments.deactivate
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. - Changed
segments.get-version
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). - Added
inboxes.get-one-to-one-readiness
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. - Changed
agent-work-settings.get
agent-work-settings.get now returns available on each kind: whether the workspace's agent can take that kind yet. - Changed
agent-work-settings.update
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. - Added
agent-work.create-claim
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. - Added
agent-work.get
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. - Added
agent-work.release-claim
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. - Added
agent-work.submit-answers
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.
Optional fields added on 15 operations
- Changed
meetings.get-client-brief
Added optional fielddata.meetingTypeto the meetings.get-client-brief response. - Changed
campaigns.list-linkedin-accounts
Added optional fielddata[].researchReadsEnabledAtto the campaigns.list-linkedin-accounts response. - Changed
campaigns.replace-linkedin-accounts
Added optional fielddata[].researchReadsEnabledAtto the campaigns.replace-linkedin-accounts response. - Changed
linkedin-accounts.get
Added optional fielddata.researchReadsEnabledAtto the linkedin-accounts.get response. - Changed
linkedin-accounts.list
Added optional fielddata[].researchReadsEnabledAtto the linkedin-accounts.list response. - Changed
linkedin-accounts.reset-ramp
Added optional fielddata.researchReadsEnabledAtto the linkedin-accounts.reset-ramp response. - Changed
domains.get
Added optional fieldsdata.dnsHostKindanddata.registrarKindto the domains.get response. - Changed
domains.list
Added optional fieldsdata[].dnsHostKindanddata[].registrarKindto the domains.list response. - Changed
domains.update
Added optional fieldsdata.dnsHostKindanddata.registrarKindto the domains.update response. - Changed
infra.findings
Added optional fielddata[].providerKindto the infra.findings response. - Changed
infra.update-finding
Added optional fielddata.providerKindto the infra.update-finding response. - Changed
placement-tests.create
Added optional fielddata.providerKindto the placement-tests.create 200 response. Added optional fielddata.providerKindto the placement-tests.create 201 response. - Changed
placement-tests.get
Added optional fielddata.providerKindto the placement-tests.get response. - Changed
placement-tests.list
Added optional fielddata[].providerKindto the placement-tests.list response. - Changed
crm-connections.create
Added optional fieldinstallSourceto the crm-connections.create request.