Skip to Content

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.

41 changesRSS feed
Markdown

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 field data.researchReadsEnabledAt to 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 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.
  • Changed analytics.get-campaign-performance
    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.
  • 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 field data.meetingType to the meetings.get-client-brief response.
  • Changed campaigns.list-linkedin-accounts
    Added optional field data[].researchReadsEnabledAt to the campaigns.list-linkedin-accounts response.
  • Changed campaigns.replace-linkedin-accounts
    Added optional field data[].researchReadsEnabledAt to the campaigns.replace-linkedin-accounts response.
  • Changed linkedin-accounts.get
    Added optional field data.researchReadsEnabledAt to the linkedin-accounts.get response.
  • Changed linkedin-accounts.list
    Added optional field data[].researchReadsEnabledAt to the linkedin-accounts.list response.
  • Changed linkedin-accounts.reset-ramp
    Added optional field data.researchReadsEnabledAt to the linkedin-accounts.reset-ramp response.
  • Changed domains.get
    Added optional fields data.dnsHostKind and data.registrarKind to the domains.get response.
  • Changed domains.list
    Added optional fields data[].dnsHostKind and data[].registrarKind to the domains.list response.
  • Changed domains.update
    Added optional fields data.dnsHostKind and data.registrarKind to the domains.update response.
  • Changed infra.findings
    Added optional field data[].providerKind to the infra.findings response.
  • Changed infra.update-finding
    Added optional field data.providerKind to the infra.update-finding response.
  • Changed placement-tests.create
    Added optional field data.providerKind to the placement-tests.create 200 response. Added optional field data.providerKind to the placement-tests.create 201 response.
  • Changed placement-tests.get
    Added optional field data.providerKind to the placement-tests.get response.
  • Changed placement-tests.list
    Added optional field data[].providerKind to the placement-tests.list response.
  • Changed crm-connections.create
    Added optional field installSource to the crm-connections.create request.

More