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

> **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 to the Kenso API, newest first. Each breaking change is tagged Breaking and has a migration note. Breaking changes ship in a new dated version, and your key stays on its version until you move it: see [Versioning](/docs/versioning). A fix that changed behavior inside a version says so in its note.

Newest version: `Ken-Version: 2026-11-02`. RSS feed: [/docs/changelog/rss.xml](/docs/changelog/rss.xml).

## Version 2026-11-02

### 2026-11-22 (3 changes)

- **Changed**: Added optional field leadsWithEmail to the credit-estimates.create request: on kind leads, how many of the leads already hold an email, which then need no email found. Added field data.capacity.quotedLeads to the response: the leads the quote and aiLimitPercent are for. A quote stage can carry the note price_unknown when its price depends on something the estimate does not have yet. - [`credit-estimates.create`](/docs/api/credit-estimates/create.md)
- **Added**: Added optional query parameter keepExistingOutput to prompts.update. Set it to true to save a prompt change without clearing the AI results Kenso already made: leads that have output keep it, and leads processed from now on use the new prompt. - [`prompts.update`](/docs/api/prompts/update.md)

Optional fields added on 1 operation:

- **Changed**: Added optional field `run` to the credit-estimates.create request. Added optional field `data.leadsWithCopy` to the credit-estimates.create response. - [`credit-estimates.create`](/docs/api/credit-estimates/create.md)

### 2026-11-21 (60 changes)

- **Changed**: A new estimate kind, capacity, answers what the plan covers in a month. Send kind capacity with an optional leadsPerMonth (1 to 1,000,000) and depth (default personalized): data.capacity says whether the plan's monthly credits and its AI limit cover that goal, and if not, the extra credits it needs (extraMillicredits) and their price in US cents (extraUsdCents). Without leadsPerMonth, data.capacity.coveredLeadsPerMonth is about how many leads a month the plan covers at that depth, and limitedBy says whether its credits or its AI limit caps it. The comparison uses the plan's monthly credits, not the balance. leadsPerMonth on any other kind is refused with 400 validation_failed. - [`credit-estimates.create`](/docs/api/credit-estimates/create.md)
- **Added**: Added POST /v1/email-copy-sameness-checks: send up to 500 texts one campaign's prompt wrote and get how many open the same way or nearly or exactly copy each other, with flag and reject findings. No AI model runs. API keys count it as a Heavy call in the rate limits. - [`email-copy-sameness-checks.check-sameness`](/docs/api/email-copy-sameness-checks/check-sameness.md)
- **Changed**: Added the optional quote object to the credit estimate response: the cost quote behind the estimate, with the expected, low and high credits and their dollar value, the share of the AI limit, the balance after the work, what the rates are based on, and the stages and savings behind the numbers. It is omitted until Kenso starts quoting estimates, and every existing field keeps its name and value. - [`credit-estimates.create`](/docs/api/credit-estimates/create.md)
- **Changed**: A non-null forecastCategory is now 400 validation_failed (field forecastCategory) while the workspace's forecast feature is off, where it used to be stored and pinned. Omitting it, or sending null to clear it, works as before. With forecast on nothing changes. - [`opportunities.create`](/docs/api/opportunities/create.md)
- **Changed**: `pool` object added to the warm-up read and update responses; null unless the workspace uses the pool - [`inboxes.get-warmup`](/docs/api/inboxes/get-warmup.md)
- **Changed**: `pool` object added to the warm-up read and update responses; null unless the workspace uses the pool - [`inboxes.update-warmup`](/docs/api/inboxes/update-warmup.md)
- **Changed**: A non-null forecastCategory is now 400 validation_failed (field forecastCategory) while the workspace's forecast feature is off, where it used to be stored and pinned. Omitting it, or sending null to clear it, works as before. With forecast on nothing changes. - [`opportunities.update`](/docs/api/opportunities/update.md)
- **Changed**: Replacing a kind's reasons now needs Accounts edit as well as the workspace_settings permission, and refuses a Client seat. A key or seat with Accounts view only now gets 403 permission_denied. - [`opportunity-reasons.replace`](/docs/api/opportunity-reasons/replace.md)
- **Changed**: Setting a stage's required fields now needs Accounts edit as well as the workspace_settings permission, and refuses a Client seat. A key or seat with Accounts view only now gets 403 permission_denied. - [`opportunity-stages.set-required-fields`](/docs/api/opportunity-stages/set-required-fields.md)
- **Changed**: A Client seat is now refused with 403 permission_denied, even on a template that grants Accounts edit. Every other seat is unchanged: a merge still needs Accounts edit. - [`accounts.merge`](/docs/api/accounts/merge.md)
- **Changed**: A stage history entry that moved the deal between pipelines now has optional fields pipeline and fromPipeline ({id, name}): the pipeline the deal moved into and the one it left. - [`opportunities.get-stage-history`](/docs/api/opportunities/get-stage-history.md)
- **Changed**: Merging accounts now fills the kept account's blank custom fields with the merged account's values. Each one reads as custom.<key> in mergeSummary.fieldChanges, on a dry run too. Before, those values stayed only in the merge log. - [`accounts.merge`](/docs/api/accounts/merge.md)
- **Changed**: The person can carry mergeSummary. Only a people.merge sent with dryRun fills it; this operation's responses are unchanged. - [`people.create`](/docs/api/people/create.md)
- **Changed**: The person can carry mergeSummary. Only a people.merge sent with dryRun fills it; this operation's responses are unchanged. - [`people.delete-photo`](/docs/api/people/delete-photo.md)
- **Changed**: The person can carry mergeSummary. Only a people.merge sent with dryRun fills it; this operation's responses are unchanged. - [`people.get`](/docs/api/people/get.md)
- **Changed**: The person can carry mergeSummary. Only a people.merge sent with dryRun fills it; this operation's responses are unchanged. - [`people.intake`](/docs/api/people/intake.md)
- **Changed**: The person can carry mergeSummary. Only a people.merge sent with dryRun fills it; this operation's responses are unchanged. - [`people.list`](/docs/api/people/list.md)
- **Changed**: Merging people accepts dryRun: true, which writes nothing and returns the kept person with mergeSummary: isDryRun, fieldChanges (the blank fields the merge would fill, each with from and to) and moved (accountCount, combinedAccountCount, opportunityCount, meetingCount, taskCount, noteCount, timelineEventCount). A dry run refuses what the merge would refuse, and is 400 validation_failed with detail code not_available where the workspace has no dry run yet. While another write holds either person or an account one of them is on, a dry run answers 409 conflict with detail code busy at once, and the same call can be sent again. A merge now also fills the kept person's blank custom fields and moves the merged person's captured email and meetings. - [`people.merge`](/docs/api/people/merge.md)
- **Changed**: The person can carry mergeSummary. Only a people.merge sent with dryRun fills it; this operation's responses are unchanged. - [`people.replace-photo`](/docs/api/people/replace-photo.md)
- **Changed**: The person can carry mergeSummary. Only a people.merge sent with dryRun fills it; this operation's responses are unchanged. - [`people.search`](/docs/api/people/search.md)
- **Changed**: The person can carry mergeSummary. Only a people.merge sent with dryRun fills it; this operation's responses are unchanged. - [`people.update`](/docs/api/people/update.md)
- **Changed**: A stage history entry can carry imported: true, on the created entry of a deal a CSV import brought in. A deal imported in a won or lost stage now reads as entered on its file's close date (enteredAt), with isCurrent true and the history complete, where it read as incomplete before. - [`opportunities.get-stage-history`](/docs/api/opportunities/get-stage-history.md)
- **Added**: Campaign performance accepts an optional views query parameter: a comma-separated list of previous, linkedin, linkedin_previous, segment, language and sender_route. It reads one campaign several ways in one call and needs campaignId, from and to, with groupBy day and channel email (the defaults). - [`analytics.get-campaign-performance`](/docs/api/analytics/get-campaign-performance.md)
- **Changed**: A campaign performance call with views returns the optional field data.views: one more read per view asked for (previous, linkedin, linkedinPrevious, segment, language, senderRoute), each equal to the response of its own call, and errors (view, code, message) for a view that could not be read. Without views the response is unchanged. - [`analytics.get-campaign-performance`](/docs/api/analytics/get-campaign-performance.md)
- **Added**: Added optional query parameters includeTotal and bodyFormat to threads.list. includeTotal=false leaves the total out of pagination, and the list of every channel then skips its count, except on an inbound tab, whose page reads its count with its rows. bodyFormat=snippet returns each row without htmlBody and with preview cut to 280 characters of text; bodyFormat=none returns neither. Omitted, the list answers as before: every page carries the total and whole bodies. - [`threads.list`](/docs/api/threads/list.md)
- **Added**: GET /v1/contacts takes an optional fields query parameter: a comma-separated list of contact properties to return, such as fields=id,email,companyName. Without it every property is returned, as before. - [`contacts.list`](/docs/api/contacts/list.md)
- **Changed**: POST /v1/contacts/search takes an optional fields array in the body: the contact properties to return, such as id, email and companyName. Without it every property is returned, as before. - [`contacts.search`](/docs/api/contacts/search.md)
- **Added**: Added GET /v1/threads/messages?threadIds=: the messages of up to 50 email threads in one call, each thread's oldest first, instead of one GET /v1/threads/{threadId}/messages per thread. htmlBody is left out unless includeHtml=true. An id that is malformed, not in the workspace or not an email thread is listed in data.failed with its error. - [`threads.batch-messages`](/docs/api/threads/batch-messages.md)
- **Added**: Added campaigns.bulk-pause: pause up to 50 campaigns in one call, with a result for each campaign. - [`campaigns.bulk-pause`](/docs/api/campaigns/bulk-pause.md)
- **Added**: Added campaigns.bulk-resume: resume up to 50 campaigns in one call, with a result for each campaign, including each refusal's details. - [`campaigns.bulk-resume`](/docs/api/campaigns/bulk-resume.md)
- **Changed**: limit now takes up to 1,000 contacts a page, up from 200. The default stays 50. - [`contacts.list`](/docs/api/contacts/list.md)
- **Changed**: The placement test schema gains the optional listedForCampaignId. Only a list with campaignIds sets it; starting a test never returns it. - [`placement-tests.create`](/docs/api/placement-tests/create.md)
- **Changed**: The placement test schema gains the optional listedForCampaignId. Only a list with campaignIds sets it; getting one test never returns it. - [`placement-tests.get`](/docs/api/placement-tests/get.md)
- **Added**: List placement tests takes campaignIds: 1 to 100 campaign ids, comma-separated, to read each campaign's newest limit tests (1 to 20, default 20) in one call, grouped in the order of campaignIds. It takes no cursor and has no further pages, and an id that is not a campaign of the workspace has no items. - [`placement-tests.list`](/docs/api/placement-tests/list.md)
- **Changed**: With campaignIds, each item carries listedForCampaignId, the campaign whose list it is in: a weekly test of a domain several listed campaigns send from is in each of their lists. Other lists omit the field. - [`placement-tests.list`](/docs/api/placement-tests/list.md)

Optional fields added on 25 operations:

- **Changed**: Added optional field `data.warmStart` to the campaigns.archive response. - [`campaigns.archive`](/docs/api/campaigns/archive.md)
- **Changed**: Added optional field `data.warmStart` to the campaigns.clear-launch-schedule response. - [`campaigns.clear-launch-schedule`](/docs/api/campaigns/clear-launch-schedule.md)
- **Changed**: Added optional field `data.warmStart` to the campaigns.create response. - [`campaigns.create`](/docs/api/campaigns/create.md)
- **Changed**: Added optional field `data.warmStart` to the campaigns.duplicate response. - [`campaigns.duplicate`](/docs/api/campaigns/duplicate.md)
- **Changed**: Added optional field `data.warmStart` to the campaigns.get response. - [`campaigns.get`](/docs/api/campaigns/get.md)
- **Changed**: Added optional field `data.warmStart` to the campaigns.launch response. - [`campaigns.launch`](/docs/api/campaigns/launch.md)
- **Changed**: Added optional field `data[].warmStart` to the campaigns.list response. - [`campaigns.list`](/docs/api/campaigns/list.md)
- **Changed**: Added optional field `data.warmStart` to the campaigns.pause response. - [`campaigns.pause`](/docs/api/campaigns/pause.md)
- **Changed**: Added optional field `data.warmStart` to the campaigns.restart response. - [`campaigns.restart`](/docs/api/campaigns/restart.md)
- **Changed**: Added optional field `data.warmStart` to the campaigns.resume response. - [`campaigns.resume`](/docs/api/campaigns/resume.md)
- **Changed**: Added optional field `data.warmStart` to the campaigns.set-launch-schedule response. - [`campaigns.set-launch-schedule`](/docs/api/campaigns/set-launch-schedule.md)
- **Changed**: Added optional field `data.warmStart` to the campaigns.unarchive response. - [`campaigns.unarchive`](/docs/api/campaigns/unarchive.md)
- **Changed**: Added optional field `warmStart` to the campaigns.update request. Added optional field `data.warmStart` to the campaigns.update response. - [`campaigns.update`](/docs/api/campaigns/update.md)
- **Changed**: Added optional field `data.pollAfterSeconds` to the campaigns.create-enrichment-run response. - [`campaigns.create-enrichment-run`](/docs/api/campaigns/create-enrichment-run.md)
- **Changed**: Added optional field `data.pollAfterSeconds` to the campaigns.run-scoring response. - [`campaigns.run-scoring`](/docs/api/campaigns/run-scoring.md)
- **Changed**: Added optional field `data.pollAfterSeconds` to the contact-exports.create response. - [`contact-exports.create`](/docs/api/contact-exports/create.md)
- **Changed**: Added optional field `data.pollAfterSeconds` to the contact-imports.create response. - [`contact-imports.create`](/docs/api/contact-imports/create.md)
- **Changed**: Added optional field `data.pollAfterSeconds` to the domain-health-checks.create response. - [`domain-health-checks.create`](/docs/api/domain-health-checks/create.md)
- **Changed**: Added optional field `data.pollAfterSeconds` to the inbox-imports.create response. - [`inbox-imports.create`](/docs/api/inbox-imports/create.md)
- **Changed**: Added optional field `data.pollAfterSeconds` to the jobs.cancel response. - [`jobs.cancel`](/docs/api/jobs/cancel.md)
- **Changed**: Added optional field `data.pollAfterSeconds` to the jobs.get response. - [`jobs.get`](/docs/api/jobs/get.md)
- **Changed**: Added optional field `data[].pollAfterSeconds` to the jobs.list response. - [`jobs.list`](/docs/api/jobs/list.md)
- **Changed**: Added optional field `data.pollAfterSeconds` to the scraping.create-batch-scrape response. - [`scraping.create-batch-scrape`](/docs/api/scraping/create-batch-scrape.md)
- **Changed**: Added optional field `data.pollAfterSeconds` to the scraping.create-crawl response. - [`scraping.create-crawl`](/docs/api/scraping/create-crawl.md)
- **Changed**: Added optional field `data.pollAfterSeconds` to the scraping.create-extraction response. - [`scraping.create-extraction`](/docs/api/scraping/create-extraction.md)

### 2026-11-20 (5 changes)

- **Added**: Published opportunities.get-stage-history: each stage a deal entered, when, who moved it and how long it sat there. - [`opportunities.get-stage-history`](/docs/api/opportunities/get-stage-history.md)
- **Added**: Published opportunity-reasons.get: the workspace's lost and won reasons. - [`opportunity-reasons.get`](/docs/api/opportunity-reasons/get.md)
- **Added**: Published opportunity-reasons.replace: replace the workspace's lost or won reasons. - [`opportunity-reasons.replace`](/docs/api/opportunity-reasons/replace.md)
- **Added**: Published opportunity-stages.set-required-fields: set the fields a deal should have in a stage. - [`opportunity-stages.set-required-fields`](/docs/api/opportunity-stages/set-required-fields.md)

Optional fields added on 1 operation:

- **Changed**: Added optional fields `data.reasons[].refusal.requiredTier`, `data.reasons[].refusal.upgradeUrl`, `data.warnings[].refusal.requiredTier` and `data.warnings[].refusal.upgradeUrl` to the campaigns.get-launch-readiness response. - [`campaigns.get-launch-readiness`](/docs/api/campaigns/get-launch-readiness.md)

### 2026-11-19 (20 changes)

- **Changed**: Added optional field qualificationFields to the opportunity-settings.update request: 1 to 5 {key, label, hint?} fields Ken drafts from a call, or null to go back to budget, authority, need and timeline. - [`opportunity-settings.update`](/docs/api/opportunity-settings/update.md)
- **Added**: Added reply-agent-simulations.create (POST /v1/reply-agent-simulations, no body): queues a simulation of Ken's replies on the workspace's recent real replies. Nothing is sent and no credits are charged. 202 with {id, status, createdAt}; 409 conflict while one is queued or running. Behind the reply_agent_rules feature. - [`reply-agent-simulations.create`](/docs/api/reply-agent-simulations/create.md)
- **Added**: Added GET /v1/reply-agent-activity: what Ken did with replies, newest first (held, sent, drafted and handed-off replies, rules changes, answered questions), each item with the undo that works now. Answers 404 until the reply_agent_rules feature is on for the workspace. - [`reply-agent-activity.list`](/docs/api/reply-agent-activity/list.md)
- **Added**: Added POST /v1/reply-agent-jobs/{jobId}/cancel: stops a reply Ken holds before an auto-send and keeps it as a draft in the thread. Answers 404 until the reply_agent_rules feature is on for the workspace. - [`reply-agent-jobs.cancel`](/docs/api/reply-agent-jobs/cancel.md)
- **Added**: Added GET /v1/reply-agent-simulations/{simulationId}/items: what Ken would have done with each reply in a simulation run, the answer actually sent and any verdict, filtered by type and verdict. Needs the reply_agent_rules feature. - [`reply-agent-simulation-items.list`](/docs/api/reply-agent-simulation-items/list.md)
- **Added**: Added PATCH /v1/reply-agent-simulation-items/{itemId}: mark a simulation item good, would_edit or wrong, with eval codes. Needs the reply_agent_rules feature. - [`reply-agent-simulation-items.update`](/docs/api/reply-agent-simulation-items/update.md)
- **Added**: Added GET /v1/reply-agent-simulations/{simulationId}: one reply agent simulation run with its status and verdict counts per reply type. Needs the reply_agent_rules feature. - [`reply-agent-simulations.get`](/docs/api/reply-agent-simulations/get.md)
- **Added**: Added GET /v1/reply-agent-simulations: the reply agent's simulation runs, newest first, with verdict counts per reply type. Needs the reply_agent_rules feature. - [`reply-agent-simulations.list`](/docs/api/reply-agent-simulations/list.md)
- **Changed**: Added the optional field data.fieldEvidence to the opportunities.create response: the call quote behind each custom field value a rep accepted from a meeting, keyed customFields.<key> (quote, meetingId, transcriptMs, at). Omitted when the opportunity has none. - [`opportunities.create`](/docs/api/opportunities/create.md)
- **Changed**: Added the optional field data.fieldEvidence to the opportunities.get response: the call quote behind each custom field value a rep accepted from a meeting, keyed customFields.<key> (quote, meetingId, transcriptMs, at). Omitted when the opportunity has none. - [`opportunities.get`](/docs/api/opportunities/get.md)
- **Changed**: Added the optional field data[].fieldEvidence to the opportunities.list response: the call quote behind each custom field value a rep accepted from a meeting, keyed customFields.<key> (quote, meetingId, transcriptMs, at). Omitted when the opportunity has none. - [`opportunities.list`](/docs/api/opportunities/list.md)
- **Changed**: Added the optional field data.fieldEvidence to the opportunities.update response: the call quote behind each custom field value a rep accepted from a meeting, keyed customFields.<key> (quote, meetingId, transcriptMs, at). Omitted when the opportunity has none. - [`opportunities.update`](/docs/api/opportunities/update.md)
- **Changed**: Added the optional field data.settings.qualificationFields to the opportunity-settings.change-currency response: the fields Ken drafts from a sales call (key, label, hint; key names the custom field the answer is written to): the workspace's own 1 to 5, else Budget, Authority, Need and Timeline. - [`opportunity-settings.change-currency`](/docs/api/opportunity-settings/change-currency.md)
- **Changed**: Added the optional field data.qualificationFields to the opportunity-settings.get response: the fields Ken drafts from a sales call (key, label, hint; key names the custom field the answer is written to): the workspace's own 1 to 5, else Budget, Authority, Need and Timeline. - [`opportunity-settings.get`](/docs/api/opportunity-settings/get.md)
- **Changed**: Added the optional field data.qualificationFields to the opportunity-settings.update response: the fields Ken drafts from a sales call (key, label, hint; key names the custom field the answer is written to): the workspace's own 1 to 5, else Budget, Authority, Need and Timeline. - [`opportunity-settings.update`](/docs/api/opportunity-settings/update.md)
- **Changed**: Added optional fields data.gapId and data.gapQuestion to the threads.get-draft response: the open question Ken needs answered before it can finish this email draft, whose body holds a {gap} blank. Omitted otherwise. - [`threads.get-draft`](/docs/api/threads/get-draft.md)
- **Changed**: Added optional fields data.gapId and data.gapQuestion to the threads.replace-draft response: the open question Ken needs answered before it can finish this email draft, whose body holds a {gap} blank. Omitted otherwise. - [`threads.replace-draft`](/docs/api/threads/replace-draft.md)
- **Changed**: Added the optional field pipelineId to the opportunities.create request: the pipeline the deal opens in, at that pipeline's first open stage. With neither pipelineId nor stage the deal opens in the default pipeline. A workspace has one pipeline until the pipelines feature is on for it. - [`opportunities.create`](/docs/api/opportunities/create.md)
- **Added**: Added the optional query parameter pipelineId to opportunities.list: only that pipeline's deals. - [`opportunities.list`](/docs/api/opportunities/list.md)
- **Changed**: Added the optional field pipelineId to the opportunities.update request: it moves the deal to that pipeline and keeps it open, won or lost, in the stage with the same label, else the first stage of that kind. Send stage with it to pick the stage. - [`opportunities.update`](/docs/api/opportunities/update.md)

### 2026-11-18 (38 changes)

- **Changed**: Added the optional field data.whyNotNow to the account-domains.create response: the account's current reason not to reach out now (reason, outcome, text, sourceUrl, sourceDate, replyId, until, setBy, setAt). Omitted when the account has none. - [`account-domains.create`](/docs/api/account-domains/create.md)
- **Changed**: Added the optional field data.whyNotNow to the account-domains.delete response: the account's current reason not to reach out now (reason, outcome, text, sourceUrl, sourceDate, replyId, until, setBy, setAt). Omitted when the account has none. - [`account-domains.delete`](/docs/api/account-domains/delete.md)
- **Changed**: Added the optional field data.results[].account.whyNotNow to the accounts.bulk-create response: the account's current reason not to reach out now (reason, outcome, text, sourceUrl, sourceDate, replyId, until, setBy, setAt). Omitted when the account has none. - [`accounts.bulk-create`](/docs/api/accounts/bulk-create.md)
- **Changed**: Added the optional field data.whyNotNow to the accounts.create response: the account's current reason not to reach out now (reason, outcome, text, sourceUrl, sourceDate, replyId, until, setBy, setAt). Omitted when the account has none. - [`accounts.create`](/docs/api/accounts/create.md)
- **Changed**: Added the optional field data.whyNotNow to the accounts.get response: the account's current reason not to reach out now (reason, outcome, text, sourceUrl, sourceDate, replyId, until, setBy, setAt). Omitted when the account has none. - [`accounts.get`](/docs/api/accounts/get.md)
- **Added**: Added the optional query parameter whyNotNow to accounts.list: comma-separated stop and wait (OR) lists the accounts whose current whyNotNow has that outcome. A wait whose until has passed, and one that was undone or released, does not match. - [`accounts.list`](/docs/api/accounts/list.md)
- **Changed**: Added the optional field data[].whyNotNow to the accounts.list response: the account's current reason not to reach out now (reason, outcome, text, sourceUrl, sourceDate, replyId, until, setBy, setAt). Omitted when the account has none. - [`accounts.list`](/docs/api/accounts/list.md)
- **Changed**: Added the optional field data.whyNotNow to the accounts.merge response: the account's current reason not to reach out now (reason, outcome, text, sourceUrl, sourceDate, replyId, until, setBy, setAt). Omitted when the account has none. - [`accounts.merge`](/docs/api/accounts/merge.md)
- **Changed**: Added the optional field data.whyNotNow to the accounts.update response: the account's current reason not to reach out now (reason, outcome, text, sourceUrl, sourceDate, replyId, until, setBy, setAt). Omitted when the account has none. - [`accounts.update`](/docs/api/accounts/update.md)
- **Changed**: Added optional field data.tierReason to the account-domains.create response: why Kenso placed the account at its tier (tier, tierName, who, confidence, probabilities, facts, next, placedAt). This response always omits it; read it from accounts.get. - [`account-domains.create`](/docs/api/account-domains/create.md)
- **Changed**: Added optional field data.tierReason to the account-domains.delete response: why Kenso placed the account at its tier (tier, tierName, who, confidence, probabilities, facts, next, placedAt). This response always omits it; read it from accounts.get. - [`account-domains.delete`](/docs/api/account-domains/delete.md)
- **Changed**: Added optional field data.results[].account.tierReason to the accounts.bulk-create response: why Kenso placed the account at its tier (tier, tierName, who, confidence, probabilities, facts, next, placedAt). This response always omits it; read it from accounts.get. - [`accounts.bulk-create`](/docs/api/accounts/bulk-create.md)
- **Changed**: Added optional field data.tierReason to the accounts.create response: why Kenso placed the account at its tier (tier, tierName, who, confidence, probabilities, facts, next, placedAt). This response always omits it; read it from accounts.get. - [`accounts.create`](/docs/api/accounts/create.md)
- **Changed**: Added optional field data.tierReason to the accounts.get response: why Kenso placed the account at its tier (tier, tierName, who, confidence, probabilities, facts, next, placedAt). Omitted while the workspace has account why off, before Kenso places the account, after its tier changes, and once a person sets its tier by hand. - [`accounts.get`](/docs/api/accounts/get.md)
- **Changed**: Added optional field data[].tierReason to the accounts.list response: why Kenso placed the account at its tier (tier, tierName, who, confidence, probabilities, facts, next, placedAt). Omitted while the workspace has account why off, before Kenso places the account, after its tier changes, and once a person sets its tier by hand. - [`accounts.list`](/docs/api/accounts/list.md)
- **Changed**: Added optional field data.tierReason to the accounts.merge response: why Kenso placed the account at its tier (tier, tierName, who, confidence, probabilities, facts, next, placedAt). This response always omits it; read it from accounts.get. - [`accounts.merge`](/docs/api/accounts/merge.md)
- **Changed**: Added optional field data.tierReason to the accounts.update response: why Kenso placed the account at its tier (tier, tierName, who, confidence, probabilities, facts, next, placedAt). This response always omits it; read it from accounts.get. - [`accounts.update`](/docs/api/accounts/update.md)
- **Changed**: Test sends are now limited in every workspace, not only in a developer sandbox: 30 a minute and 1,000 a day per workspace. Past either limit the call answers 429 rate_limited with Retry-After; wait that many seconds and try again. A test Svix does not take does not count. - [`webhook-endpoints.test`](/docs/api/webhook-endpoints/test.md)
- **Changed**: Added data.waitingCountedAt (when the waiting counts were taken; Kenso keeps them between reads, up to 15 minutes old) and data.uncountedKinds (kinds whose waiting was not counted for this answer and reads 0) to the agent-work.get response. - [`agent-work.get`](/docs/api/agent-work/get.md)
- **Changed**: Added field data.connectionNoteMaxChars to the linkedin-sequences.get response. It is the longest written connection note (body of a connection_request step) Kenso saves for the campaign: 200 when a LinkedIn account in its sender pool has no Premium, since LinkedIn takes no more from such an account, else 275. A longer note is refused with 400 validation_failed. - [`linkedin-sequences.get`](/docs/api/linkedin-sequences/get.md)
- **Changed**: Added field data.connectionNoteMaxChars to the linkedin-sequences.replace response. It is the longest written connection note (body of a connection_request step) Kenso saves for the campaign: 200 when a LinkedIn account in its sender pool has no Premium, since LinkedIn takes no more from such an account, else 275. A longer note is refused with 400 validation_failed. - [`linkedin-sequences.replace`](/docs/api/linkedin-sequences/replace.md)
- **Changed**: Added field data.connectionNoteMaxChars to the segment-linkedin-sequences.get response. It is the longest written connection note (body of a connection_request step) Kenso saves for the campaign: 200 when a LinkedIn account in its sender pool has no Premium, since LinkedIn takes no more from such an account, else 275. A longer note is refused with 400 validation_failed. - [`segment-linkedin-sequences.get`](/docs/api/segment-linkedin-sequences/get.md)
- **Changed**: Added field data.connectionNoteMaxChars to the segment-linkedin-sequences.replace response. It is the longest written connection note (body of a connection_request step) Kenso saves for the campaign: 200 when a LinkedIn account in its sender pool has no Premium, since LinkedIn takes no more from such an account, else 275. A longer note is refused with 400 validation_failed. - [`segment-linkedin-sequences.replace`](/docs/api/segment-linkedin-sequences/replace.md)
- **Changed**: Failed calls answered before an operation runs now use the standard error body, {success: false, error: {code, message, requestId, docUrl}}. A request with no API key answers 401 missing_credential whatever its Ken-Version, where a request with no Ken-Version answered an empty 404. A refused key answers 401 with its own code: malformed_key, invalid_key, key_expired, key_revoked or key_owner_inactive, where it answered {"error": "Invalid or revoked API key"} or an empty body. A path under /v1 that is not an operation answers 404 not_found with the body, where it was empty. The rate-limit 429s are 429 rate_limited with the body and Retry-After, where they were plain text or {"error": "Rate limit exceeded"}, and the 503 when Kenso cannot check a key is 503 auth_unavailable. If your client reads error as a string, read error.message instead, and branch on error.code.
- **Changed**: Added field data.workspaces[].wordmarkDarkUrl, the workspace's wide logo for dark backgrounds (null when none is set), to the me.get response. - [`me.get`](/docs/api/me/get.md)
- **Changed**: Added field data.wordmarkDarkUrl, the workspace's wide logo for dark backgrounds (null when none is set), to the workspaces.get response. - [`workspaces.get`](/docs/api/workspaces/get.md)
- **Changed**: Added field data[].wordmarkDarkUrl, the workspace's wide logo for dark backgrounds (null when none is set), to the workspaces.list response. - [`workspaces.list`](/docs/api/workspaces/list.md)
- **Changed**: Added field data.wordmarkDarkUrl, the workspace's wide logo for dark backgrounds (null when none is set), to the workspaces.update response. - [`workspaces.update`](/docs/api/workspaces/update.md)
- **Changed**: Added optional field data.mergeSummary to the account-domains.create response schema. The account model gained it for accounts.merge, the only operation that sets it: account-domains.create never returns it. - [`account-domains.create`](/docs/api/account-domains/create.md)
- **Changed**: Added optional field data.mergeSummary to the account-domains.delete response schema. The account model gained it for accounts.merge, the only operation that sets it: account-domains.delete never returns it. - [`account-domains.delete`](/docs/api/account-domains/delete.md)
- **Changed**: Added optional field data.results[].account.mergeSummary to the accounts.bulk-create response schema. The account model gained it for accounts.merge, the only operation that sets it: accounts.bulk-create never returns it. - [`accounts.bulk-create`](/docs/api/accounts/bulk-create.md)
- **Changed**: Added optional field data.mergeSummary to the accounts.create response schema. The account model gained it for accounts.merge, the only operation that sets it: accounts.create never returns it. - [`accounts.create`](/docs/api/accounts/create.md)
- **Changed**: Added optional field data.mergeSummary to the accounts.get response schema. The account model gained it for accounts.merge, the only operation that sets it: accounts.get never returns it. - [`accounts.get`](/docs/api/accounts/get.md)
- **Changed**: Added optional field data[].mergeSummary to the accounts.list response schema. The account model gained it for accounts.merge, the only operation that sets it: accounts.list never returns it. - [`accounts.list`](/docs/api/accounts/list.md)
- **Changed**: Added optional field dryRun to the accounts.merge request and optional field data.mergeSummary to its response (isDryRun, mergeId, fieldChanges[] with field, from and to, and moved with a count per kind of record). Where the workspace has CRM import and export, a merge answers with what it changed on the kept account and what it moved to it, and dryRun: true writes nothing and answers with what the merge would do; without it, dryRun is 400 validation_failed with not_available. On a dry run the account's tier and lastTouchAt read as merged too, its score and recentSignalKinds are its values before the merge, and the call answers 409 conflict with busy while another write holds one of the two accounts. - [`accounts.merge`](/docs/api/accounts/merge.md)
- **Changed**: Added optional field data.mergeSummary to the accounts.update response schema. The account model gained it for accounts.merge, the only operation that sets it: accounts.update never returns it. - [`accounts.update`](/docs/api/accounts/update.md)

Optional fields added on 2 operations:

- **Changed**: Added optional field `data.sequence.connectionNoteMaxChars` to the linkedin-sequences.save-version response. - [`linkedin-sequences.save-version`](/docs/api/linkedin-sequences/save-version.md)
- **Changed**: Added optional field `data.sequence.connectionNoteMaxChars` to the segment-linkedin-sequences.save-version response. - [`segment-linkedin-sequences.save-version`](/docs/api/segment-linkedin-sequences/save-version.md)

### 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)

### 2026-11-16 (195 changes)

- **Added**: Added optional query parameters limit and cursor to sandboxes.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount. - [`sandboxes.list`](/docs/api/sandboxes/list.md)
- **Added**: Added optional query parameters limit and cursor to agent-sandbox-connections.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount. - [`agent-sandbox-connections.list`](/docs/api/agent-sandbox-connections/list.md)
- **Added**: Added optional query parameters limit and cursor to ai-feedback.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount. - [`ai-feedback.list`](/docs/api/ai-feedback/list.md)
- **Added**: Added optional query parameters limit and cursor to ai-lines.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount. - [`ai-lines.list`](/docs/api/ai-lines/list.md)
- **Added**: Added optional query parameters limit and cursor to blocklist-rules.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount. - [`blocklist-rules.list`](/docs/api/blocklist-rules/list.md)
- **Added**: Added optional query parameters limit and cursor to campaign-images.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount. - [`campaign-images.list`](/docs/api/campaign-images/list.md)
- **Added**: Added optional query parameters limit and cursor to campaign-localizations.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount. - [`campaign-localizations.list`](/docs/api/campaign-localizations/list.md)
- **Added**: Added optional query parameters limit and cursor to crm-connections.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount. - [`crm-connections.list`](/docs/api/crm-connections/list.md)
- **Added**: Added optional query parameters limit and cursor to crm-fields.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount. - [`crm-fields.list`](/docs/api/crm-fields/list.md)
- **Added**: Added optional query parameters limit and cursor to crm-lists.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount. - [`crm-lists.list`](/docs/api/crm-lists/list.md)
- **Added**: Added optional query parameters limit and cursor to crm-pipelines.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount. - [`crm-pipelines.list`](/docs/api/crm-pipelines/list.md)
- **Added**: Added optional query parameters limit and cursor to permission-templates.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount. - [`permission-templates.list`](/docs/api/permission-templates/list.md)
- **Added**: Added optional query parameters limit and cursor to trigger-schemas.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount. - [`trigger-schemas.list`](/docs/api/trigger-schemas/list.md)
- **Added**: Added optional query parameters limit and cursor to voices.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount. - [`voices.list`](/docs/api/voices/list.md)
- **Added**: Added optional query parameters limit and cursor to webhook-event-types.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount. - [`webhook-event-types.list`](/docs/api/webhook-event-types/list.md)
- **Changed**: Documentation fix: the reference showed a generic problem body (type, title, status, detail, instance) for some errors of bookings.bulk-cancel, bookings.bulk-reassign, bookings.no-show, email-copy-grades.grade, external-bookings.get, external-bookings.list and translations.create, which always answered with the standard Kenso error body that the reference now shows, so no response changed.
- **Changed**: Documentation fix: request fields the API already required are now listed as required, and fields that are never null (response fields Kenso always sends, and required request fields) are no longer marked nullable, so generated samples and SDK types match what the API accepts and returns.
- **Changed**: Added optional field customFields to the accounts.update request: values of the account's custom fields by key, merged per key, with null clearing a key. Each value is checked against its field's type. Refused with validation_failed (not_enabled) until custom fields are on for the workspace. - [`accounts.update`](/docs/api/accounts/update.md)
- **Changed**: Added optional fields data.customFields and data.customFieldMeta to the account-domains.create response: the account's custom field values by key, and for each key that has a record of it, who or what set the value (source, at and memberId). - [`account-domains.create`](/docs/api/account-domains/create.md)
- **Changed**: Added optional fields data.customFields and data.customFieldMeta to the account-domains.delete response: the account's custom field values by key, and for each key that has a record of it, who or what set the value (source, at and memberId). - [`account-domains.delete`](/docs/api/account-domains/delete.md)
- **Changed**: Added optional fields data.results[].account.customFields and data.results[].account.customFieldMeta to the accounts.bulk-create response: the account's custom field values by key, and for each key that has a record of it, who or what set the value (source, at and memberId). - [`accounts.bulk-create`](/docs/api/accounts/bulk-create.md)
- **Changed**: Added optional fields data.customFields and data.customFieldMeta to the accounts.create response: the account's custom field values by key, and for each key that has a record of it, who or what set the value (source, at and memberId). - [`accounts.create`](/docs/api/accounts/create.md)
- **Changed**: Added optional fields data.customFields and data.customFieldMeta to the accounts.get response: the account's custom field values by key, and for each key that has a record of it, who or what set the value (source, at and memberId). - [`accounts.get`](/docs/api/accounts/get.md)
- **Changed**: Added optional fields data[].customFields and data[].customFieldMeta to the accounts.list response: the account's custom field values by key, and for each key that has a record of it, who or what set the value (source, at and memberId). - [`accounts.list`](/docs/api/accounts/list.md)
- **Changed**: Added optional fields data.customFields and data.customFieldMeta to the accounts.merge response: the account's custom field values by key, and for each key that has a record of it, who or what set the value (source, at and memberId). - [`accounts.merge`](/docs/api/accounts/merge.md)
- **Changed**: Added optional fields data.customFields and data.customFieldMeta to the accounts.update response: the account's custom field values by key, and for each key that has a record of it, who or what set the value (source, at and memberId). - [`accounts.update`](/docs/api/accounts/update.md)
- **Changed**: Added optional fields data.person.customFields and data.person.customFieldMeta to the people.intake response: the person's custom field values by key, and for each key that has a record of it, who or what set the value (source, at and memberId). - [`people.intake`](/docs/api/people/intake.md)
- **Added**: Added optional query parameters sort (createdAt or -createdAt), createdAfter and createdBefore to campaigns.list. - [`campaigns.list`](/docs/api/campaigns/list.md)
- **Changed**: Field data.emailVerified in the me.get response is now omitted when Kenso has no record either way (a password sign-in whose verification was never recorded), where it read false before. true and false keep their meaning. The field was never required. - [`me.get`](/docs/api/me/get.md)
- **Added**: GET /v1/contacts takes `personId`: the person's contact in each campaign they are in. - [`contacts.list`](/docs/api/contacts/list.md)
- **Changed**: Added field data.emailVerified to the me.get response: whether Kenso treats the caller's email as verified (confirmed from the verification email, or a Google, LinkedIn or Microsoft sign-in). - [`me.get`](/docs/api/me/get.md)
- **Breaking**: Removed agent-team.create-action. - `agent-team.create-action` Migration: The in-app AI team was stopped on 2026-10-29 and its code is deleted. Its flags (agent_teams, agent_templates) were off for every workspace, so these operations already answered 404. They have no replacement. Campaign pause, resume and settings keep their own operations.
- **Breaking**: Removed agent-team.create-proposal. - `agent-team.create-proposal` Migration: The in-app AI team was stopped on 2026-10-29 and its code is deleted. Its flags (agent_teams, agent_templates) were off for every workspace, so these operations already answered 404. They have no replacement. Campaign pause, resume and settings keep their own operations.
- **Breaking**: Removed agent-team.get-runway. - `agent-team.get-runway` Migration: The in-app AI team was stopped on 2026-10-29 and its code is deleted. Its flags (agent_teams, agent_templates) were off for every workspace, so these operations already answered 404. They have no replacement. Campaign pause, resume and settings keep their own operations.
- **Breaking**: Removed agent-team.list-changes. - `agent-team.list-changes` Migration: The in-app AI team was stopped on 2026-10-29 and its code is deleted. Its flags (agent_teams, agent_templates) were off for every workspace, so these operations already answered 404. They have no replacement. Campaign pause, resume and settings keep their own operations.
- **Breaking**: Removed agent-team.list-proposals. - `agent-team.list-proposals` Migration: The in-app AI team was stopped on 2026-10-29 and its code is deleted. Its flags (agent_teams, agent_templates) were off for every workspace, so these operations already answered 404. They have no replacement. Campaign pause, resume and settings keep their own operations.
- **Breaking**: Removed agent-team.undo-action. - `agent-team.undo-action` Migration: The in-app AI team was stopped on 2026-10-29 and its code is deleted. Its flags (agent_teams, agent_templates) were off for every workspace, so these operations already answered 404. They have no replacement. Campaign pause, resume and settings keep their own operations.
- **Changed**: Takes optional sendsFromImessageLineId, the iMessage line the account's texts usually send from: a line of this workspace that has not ended, owned by a current member, checked as on accounts.update. Like the other Sends from ids, only the member who will own the account, a workspace admin or staff sets it; anyone else gets 403 forbidden with error.details[].code sends_from_not_allowed on it, and nothing is saved. The account returned carries it, omitted when none is set. Needs the imessage feature, which is off for every workspace for now. - [`accounts.create`](/docs/api/accounts/create.md)
- **Changed**: Takes optional sendsFromImessageLineId, the iMessage line the account's texts usually send from: a line of this workspace that has not ended, owned by a current member; null clears it, and the account owner's first active line then stands in for it. A first text goes from an active line in the person's country (this one, else the account owner's, else the workspace's oldest), else from this line; a person with a thread keeps its line. The account returned carries it, omitted when none is set. Needs the imessage feature, which is off for every workspace for now. - [`accounts.update`](/docs/api/accounts/update.md)
- **Changed**: Each item takes optional sendsFromImessageLineId, the iMessage line the account's texts usually send from, as accounts.create does, and each result's account carries it, omitted when none is set. Needs the imessage feature, which is off for every workspace for now. - [`accounts.bulk-create`](/docs/api/accounts/bulk-create.md)
- **Changed**: The account now carries sendsFromImessageLineId, the iMessage line the account's texts usually send from, omitted when none is set. Needs the imessage feature, which is off for every workspace for now. - [`accounts.get`](/docs/api/accounts/get.md)
- **Changed**: Each account now carries sendsFromImessageLineId, the iMessage line the account's texts usually send from, omitted when none is set. Needs the imessage feature, which is off for every workspace for now. - [`accounts.list`](/docs/api/accounts/list.md)
- **Changed**: The merged account now carries sendsFromImessageLineId, the iMessage line the account's texts usually send from, omitted when none is set. Needs the imessage feature, which is off for every workspace for now. - [`accounts.merge`](/docs/api/accounts/merge.md)
- **Changed**: The account now carries sendsFromImessageLineId, the iMessage line the account's texts usually send from, omitted when none is set. Needs the imessage feature, which is off for every workspace for now. - [`account-domains.create`](/docs/api/account-domains/create.md)
- **Changed**: The account now carries sendsFromImessageLineId, the iMessage line the account's texts usually send from, omitted when none is set. Needs the imessage feature, which is off for every workspace for now. - [`account-domains.delete`](/docs/api/account-domains/delete.md)
- **Added**: Published opportunities.create: create a deal on an account. - [`opportunities.create`](/docs/api/opportunities/create.md)
- **Added**: Published opportunities.delete: delete a deal. - [`opportunities.delete`](/docs/api/opportunities/delete.md)
- **Added**: Published opportunities.get: read one deal with its account, primary person and the people on it. - [`opportunities.get`](/docs/api/opportunities/get.md)
- **Added**: Published opportunities.list: list deals by account, stage, owner, source campaign or close date. - [`opportunities.list`](/docs/api/opportunities/list.md)
- **Added**: Published opportunities.update: change a deal's stage, amount, close date, owner and other fields, or move it to another account. - [`opportunities.update`](/docs/api/opportunities/update.md)
- **Added**: Published opportunity-people.create: put a person on a deal with a role. - [`opportunity-people.create`](/docs/api/opportunity-people/create.md)
- **Added**: Published opportunity-people.delete: take a person off a deal. - [`opportunity-people.delete`](/docs/api/opportunity-people/delete.md)
- **Added**: Published opportunity-people.list: list the people on a deal with their roles. - [`opportunity-people.list`](/docs/api/opportunity-people/list.md)
- **Added**: Published opportunity-people.update: change a person's role on a deal, or make them its primary person. - [`opportunity-people.update`](/docs/api/opportunity-people/update.md)
- **Added**: Published opportunity-settings.change-currency: change the workspace currency and keep, convert or clear every deal amount. - [`opportunity-settings.change-currency`](/docs/api/opportunity-settings/change-currency.md)
- **Added**: Published opportunity-settings.get: read the workspace's deal settings and supported currencies. - [`opportunity-settings.get`](/docs/api/opportunity-settings/get.md)
- **Added**: Published opportunity-settings.update: change when Kenso opens deals, the currency and the won-deal and quiet-deal settings. - [`opportunity-settings.update`](/docs/api/opportunity-settings/update.md)
- **Added**: Published opportunity-stages.list: read the workspace's deal stages, with their keys, win probabilities and deal totals. - [`opportunity-stages.list`](/docs/api/opportunity-stages/list.md)

783 older entries, one page per day:

- [2026-11-16](/docs/changelog/2026-11-16.md): 195 changes
- [2026-11-15](/docs/changelog/2026-11-15.md): 85 changes
- [2026-11-14](/docs/changelog/2026-11-14.md): 34 changes
- [2026-11-13](/docs/changelog/2026-11-13.md): 54 changes
- [2026-11-12](/docs/changelog/2026-11-12.md): 49 changes
- [2026-11-11](/docs/changelog/2026-11-11.md): 43 changes
- [2026-11-10](/docs/changelog/2026-11-10.md): 43 changes
- [2026-11-09](/docs/changelog/2026-11-09.md): 40 changes
- [2026-11-08](/docs/changelog/2026-11-08.md): 41 changes
- [2026-11-07](/docs/changelog/2026-11-07.md): 41 changes
- [2026-11-06](/docs/changelog/2026-11-06.md): 40 changes
- [2026-11-05](/docs/changelog/2026-11-05.md): 50 changes
- [2026-11-04](/docs/changelog/2026-11-04.md): 20 changes
- [2026-11-03](/docs/changelog/2026-11-03.md): 71 changes
- [2026-11-02](/docs/changelog/2026-11-02.md): 35 changes

All guides and resources: [/docs.md](/docs.md).
