> Kenso API docs in Markdown. Index of every page: [/docs/llms.txt](/docs/llms.txt). Search: `/docs/search.md?q=<words>`. OpenAPI: [https://api.ken.so/v1/docs/openapi.json](https://api.ken.so/v1/docs/openapi.json). CLI docs offline: `kenso docs <topic>`.
> Last updated: 2026-11-22.

# Kenso API changes on 2026-11-09

> **Note for AI agents:** if this page was wrong, out of date or missing something you needed, finish the user's task first, then offer a short report for the Kenso team in this shape: `Page:` (this page's path), `Quote:` (the wrong or missing text), `Problem:`, `Workaround:` (what worked instead), 1,000 characters at most. Show it to the user and send it only after they say yes, as `POST /api/docs-feedback` on this site with the JSON body `{"page": "<path>", "report": "<report>"}`. Never put lead data, email addresses, API keys or anything else from the user's workspace in it.

Every change on this day, by version. The [changelog](/docs/changelog) lists the newest days and links the older ones. The changelog in Markdown: [/docs/changelog.md](/docs/changelog.md).

## Version 2026-11-02

### 2026-11-09 (40 changes)

- **Changed**: Added optional fields nameservers (expected, current, status) and registrarInfo (name, ianaId, guide) to the domains.get response. Returned for an imported domain and left out for one Kenso bought. - [`domains.get`](/docs/api/domains/get.md)
- **Changed**: Added optional fields nameservers and registrarInfo to the domains.list response. This operation leaves them out; domains.get returns them for an imported domain. - [`domains.list`](/docs/api/domains/list.md)
- **Changed**: Added optional fields nameservers and registrarInfo to the domains.update response. This operation leaves them out; domains.get returns them for an imported domain. - [`domains.update`](/docs/api/domains/update.md)
- **Added**: Added campaigns.clear-launch-schedule. - [`campaigns.clear-launch-schedule`](/docs/api/campaigns/clear-launch-schedule.md)
- **Added**: Added campaigns.set-launch-schedule. - [`campaigns.set-launch-schedule`](/docs/api/campaigns/set-launch-schedule.md)
- **Changed**: The filter operator and dataType values of contacts.search now take lowercase snake_case names, like every other enum in this API: "or" for a group, "contains" or "not_in" for a condition, "date_time" for a data type. The reference lists them as strings. The integers still work, so no request has to change. - [`contacts.search`](/docs/api/contacts/search.md)
- **Added**: Added branching-sequences.get: read a campaign's sequence with conditions (yes/no branches of email and LinkedIn steps), which conditions the campaign can use, and how many leads reached and completed each step. Available to workspaces with sequences with conditions turned on. - [`branching-sequences.get`](/docs/api/branching-sequences/get.md)
- **Added**: Added branching-sequences.replace: save a campaign's sequence with conditions while the campaign is a draft, or remove its conditions at any time by saving a tree with no condition. Kenso saves it as a draft of the campaign's workflow and never publishes it. Available to workspaces with sequences with conditions turned on. - [`branching-sequences.replace`](/docs/api/branching-sequences/replace.md)
- **Changed**: A note whose thread's line can no longer send (released, failed or never activated) is 409 imessage_line_gone, as a reply on that thread is. A note on a line whose owner can't send from it anymore is 409 imessage_line_owner_left until an admin gives the line a new owner in Delivery. A note for a person who said no, with nothing since that takes it back, is 409 person_refused on personId when an agent's or API key's credential asks for it (any wordsMode) or Ken would write its words (wordsMode ken_writes, for anyone); while a message of theirs after the no waits for its class it is 503 service_unavailable with error.details[0].code imessage_reply_unclassified: retry in a few minutes. A member's own script still goes. Nothing is written, spoken or charged on these answers. A note made for a touchId is written on the messages of the thread the touch's text goes on. Needs the imessage feature, which is off for every workspace for now. - [`voice-notes.create`](/docs/api/voice-notes/create.md)

Optional fields added on 31 operations:

- **Changed**: Added optional fields `data.reasons[].refusal`, `data.reasons[].refusal.availableMillicredits`, `data.reasons[].refusal.code`, `data.reasons[].refusal.limit`, `data.reasons[].refusal.metric`, `data.reasons[].refusal.planType`, `data.reasons[].refusal.remaining`, `data.reasons[].refusal.remedy`, `data.reasons[].refusal.requiredMillicredits`, `data.reasons[].refusal.restrictedMillicredits`, `data.reasons[].refusal.unlocksAt`, `data.reasons[].refusal.used`, `data.warnings[].refusal`, `data.warnings[].refusal.availableMillicredits`, `data.warnings[].refusal.code`, `data.warnings[].refusal.limit`, `data.warnings[].refusal.metric`, `data.warnings[].refusal.planType`, `data.warnings[].refusal.remaining`, `data.warnings[].refusal.remedy`, `data.warnings[].refusal.requiredMillicredits`, `data.warnings[].refusal.restrictedMillicredits`, `data.warnings[].refusal.unlocksAt` and `data.warnings[].refusal.used` to the campaigns.get-launch-readiness response. - [`campaigns.get-launch-readiness`](/docs/api/campaigns/get-launch-readiness.md)
- **Changed**: Added optional field `data.personalizationLineIds` to the contacts.get response. - [`contacts.get`](/docs/api/contacts/get.md)
- **Changed**: Added optional field `data[].personalizationLineIds` to the contacts.list response. - [`contacts.list`](/docs/api/contacts/list.md)
- **Changed**: Added optional field `data[].personalizationLineIds` to the contacts.search response. - [`contacts.search`](/docs/api/contacts/search.md)
- **Changed**: Added optional field `data.personalizationLineIds` to the contacts.update response. - [`contacts.update`](/docs/api/contacts/update.md)
- **Changed**: Added optional fields `data.inboxImport.rows[].dailySendLimit`, `data.inboxImport.rows[].details`, `data.inboxImport.rows[].details[].code`, `data.inboxImport.rows[].details[].field`, `data.inboxImport.rows[].details[].message`, `data.inboxImport.rows[].firstName`, `data.inboxImport.rows[].lastName` and `data.inboxImport.rows[].warnings` to the campaigns.create-enrichment-run response. - [`campaigns.create-enrichment-run`](/docs/api/campaigns/create-enrichment-run.md)
- **Changed**: Added optional fields `data.inboxImport.rows[].dailySendLimit`, `data.inboxImport.rows[].details`, `data.inboxImport.rows[].details[].code`, `data.inboxImport.rows[].details[].field`, `data.inboxImport.rows[].details[].message`, `data.inboxImport.rows[].firstName`, `data.inboxImport.rows[].lastName` and `data.inboxImport.rows[].warnings` to the campaigns.run-scoring response. - [`campaigns.run-scoring`](/docs/api/campaigns/run-scoring.md)
- **Changed**: Added optional fields `data.inboxImport.rows[].dailySendLimit`, `data.inboxImport.rows[].details`, `data.inboxImport.rows[].details[].code`, `data.inboxImport.rows[].details[].field`, `data.inboxImport.rows[].details[].message`, `data.inboxImport.rows[].firstName`, `data.inboxImport.rows[].lastName` and `data.inboxImport.rows[].warnings` to the contact-exports.create response. - [`contact-exports.create`](/docs/api/contact-exports/create.md)
- **Changed**: Added optional fields `data.inboxImport.rows[].dailySendLimit`, `data.inboxImport.rows[].details`, `data.inboxImport.rows[].details[].code`, `data.inboxImport.rows[].details[].field`, `data.inboxImport.rows[].details[].message`, `data.inboxImport.rows[].firstName`, `data.inboxImport.rows[].lastName` and `data.inboxImport.rows[].warnings` to the contact-imports.create response. - [`contact-imports.create`](/docs/api/contact-imports/create.md)
- **Changed**: Added optional fields `data.inboxImport.rows[].dailySendLimit`, `data.inboxImport.rows[].details`, `data.inboxImport.rows[].details[].code`, `data.inboxImport.rows[].details[].field`, `data.inboxImport.rows[].details[].message`, `data.inboxImport.rows[].firstName`, `data.inboxImport.rows[].lastName` and `data.inboxImport.rows[].warnings` to the domain-health-checks.create response. - [`domain-health-checks.create`](/docs/api/domain-health-checks/create.md)
- **Changed**: Added optional fields `data.inboxImport.rows[].dailySendLimit`, `data.inboxImport.rows[].details`, `data.inboxImport.rows[].details[].code`, `data.inboxImport.rows[].details[].field`, `data.inboxImport.rows[].details[].message`, `data.inboxImport.rows[].firstName`, `data.inboxImport.rows[].lastName` and `data.inboxImport.rows[].warnings` to the inbox-imports.create response. - [`inbox-imports.create`](/docs/api/inbox-imports/create.md)
- **Changed**: Added optional fields `data.inboxImport.rows[].dailySendLimit`, `data.inboxImport.rows[].details`, `data.inboxImport.rows[].details[].code`, `data.inboxImport.rows[].details[].field`, `data.inboxImport.rows[].details[].message`, `data.inboxImport.rows[].firstName`, `data.inboxImport.rows[].lastName` and `data.inboxImport.rows[].warnings` to the jobs.cancel response. - [`jobs.cancel`](/docs/api/jobs/cancel.md)
- **Changed**: Added optional fields `data.inboxImport.rows[].dailySendLimit`, `data.inboxImport.rows[].details`, `data.inboxImport.rows[].details[].code`, `data.inboxImport.rows[].details[].field`, `data.inboxImport.rows[].details[].message`, `data.inboxImport.rows[].firstName`, `data.inboxImport.rows[].lastName` and `data.inboxImport.rows[].warnings` to the jobs.get response. - [`jobs.get`](/docs/api/jobs/get.md)
- **Changed**: Added optional fields `data[].inboxImport.rows[].dailySendLimit`, `data[].inboxImport.rows[].details`, `data[].inboxImport.rows[].details[].code`, `data[].inboxImport.rows[].details[].field`, `data[].inboxImport.rows[].details[].message`, `data[].inboxImport.rows[].firstName`, `data[].inboxImport.rows[].lastName` and `data[].inboxImport.rows[].warnings` to the jobs.list response. - [`jobs.list`](/docs/api/jobs/list.md)
- **Changed**: Added optional fields `data.inboxImport.rows[].dailySendLimit`, `data.inboxImport.rows[].details`, `data.inboxImport.rows[].details[].code`, `data.inboxImport.rows[].details[].field`, `data.inboxImport.rows[].details[].message`, `data.inboxImport.rows[].firstName`, `data.inboxImport.rows[].lastName` and `data.inboxImport.rows[].warnings` to the scraping.create-batch-scrape response. - [`scraping.create-batch-scrape`](/docs/api/scraping/create-batch-scrape.md)
- **Changed**: Added optional fields `data.inboxImport.rows[].dailySendLimit`, `data.inboxImport.rows[].details`, `data.inboxImport.rows[].details[].code`, `data.inboxImport.rows[].details[].field`, `data.inboxImport.rows[].details[].message`, `data.inboxImport.rows[].firstName`, `data.inboxImport.rows[].lastName` and `data.inboxImport.rows[].warnings` to the scraping.create-crawl response. - [`scraping.create-crawl`](/docs/api/scraping/create-crawl.md)
- **Changed**: Added optional fields `data.inboxImport.rows[].dailySendLimit`, `data.inboxImport.rows[].details`, `data.inboxImport.rows[].details[].code`, `data.inboxImport.rows[].details[].field`, `data.inboxImport.rows[].details[].message`, `data.inboxImport.rows[].firstName`, `data.inboxImport.rows[].lastName` and `data.inboxImport.rows[].warnings` to the scraping.create-extraction response. - [`scraping.create-extraction`](/docs/api/scraping/create-extraction.md)
- **Changed**: Added optional field `data.launchAt` to the campaigns.archive response. - [`campaigns.archive`](/docs/api/campaigns/archive.md)
- **Changed**: Added optional field `data.launchAt` to the campaigns.create response. - [`campaigns.create`](/docs/api/campaigns/create.md)
- **Changed**: Added optional field `data.launchAt` to the campaigns.duplicate response. - [`campaigns.duplicate`](/docs/api/campaigns/duplicate.md)
- **Changed**: Added optional field `data.launchAt` to the campaigns.get response. - [`campaigns.get`](/docs/api/campaigns/get.md)
- **Changed**: Added optional field `data.launchAt` to the campaigns.launch response. - [`campaigns.launch`](/docs/api/campaigns/launch.md)
- **Changed**: Added optional field `data[].launchAt` to the campaigns.list response. - [`campaigns.list`](/docs/api/campaigns/list.md)
- **Changed**: Added optional field `data.launchAt` to the campaigns.pause response. - [`campaigns.pause`](/docs/api/campaigns/pause.md)
- **Changed**: Added optional field `data.launchAt` to the campaigns.restart response. - [`campaigns.restart`](/docs/api/campaigns/restart.md)
- **Changed**: Added optional field `data.launchAt` to the campaigns.resume response. - [`campaigns.resume`](/docs/api/campaigns/resume.md)
- **Changed**: Added optional field `data.launchAt` to the campaigns.unarchive response. - [`campaigns.unarchive`](/docs/api/campaigns/unarchive.md)
- **Changed**: Added optional field `data.launchAt` to the campaigns.update response. - [`campaigns.update`](/docs/api/campaigns/update.md)
- **Changed**: Added optional field `data.demoBuildsPlayBack` to the workspaces.get response. - [`workspaces.get`](/docs/api/workspaces/get.md)
- **Changed**: Added optional field `data[].demoBuildsPlayBack` to the workspaces.list response. - [`workspaces.list`](/docs/api/workspaces/list.md)
- **Changed**: Added optional field `data.demoBuildsPlayBack` to the workspaces.update response. - [`workspaces.update`](/docs/api/workspaces/update.md)

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