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

> **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-15 (85 changes)

- **Added**: Added sandboxes.create (POST /v1/sandboxes): creates your developer sandbox, a workspace where sends, orders and charges are simulated, and returns it with one test key (kenso_test_). One sandbox per member. Available where developer sandboxes are turned on. - [`sandboxes.create`](/docs/api/sandboxes/create.md)
- **Added**: Added sandboxes.get (GET /v1/sandboxes/{sandboxId}): reads your developer sandbox. Available where developer sandboxes are turned on. - [`sandboxes.get`](/docs/api/sandboxes/get.md)
- **Added**: Added sandboxes.list (GET /v1/sandboxes): lists your developer sandbox, zero or one. Available where developer sandboxes are turned on. - [`sandboxes.list`](/docs/api/sandboxes/list.md)
- **Changed**: The job-post-searches.count response is now documented field by field: totalResults and hiringSet. The answer itself is unchanged. - [`job-post-searches.count`](/docs/api/job-post-searches/count.md)
- **Changed**: The job-post-searches.people response is now documented field by field: the people page, each person's jobPost, hiringSet and, with companyIds, companies. The answer itself is unchanged. - [`job-post-searches.people`](/docs/api/job-post-searches/people.md)
- **Changed**: The search.expand-titles response is now documented field by field: expandedTitles and error. The answer itself is unchanged. - [`search.expand-titles`](/docs/api/search/expand-titles.md)
- **Changed**: The search.get-people-facets response is now documented field by field: each facet's values with their counts. The answer itself is unchanged. - [`search.get-people-facets`](/docs/api/search/get-people-facets.md)
- **Changed**: The search.get-person response is now documented field by field: the whole person record, with hasKenEmail, kenEmailStatus and searchToken. The answer itself is unchanged. - [`search.get-person`](/docs/api/search/get-person.md)
- **Changed**: The search.lookup-person response is now documented field by field: the whole person record, with hasKenEmail, kenEmailStatus and searchToken. The answer itself is unchanged. - [`search.lookup-person`](/docs/api/search/lookup-person.md)
- **Changed**: The search.search-company-people response is now documented field by field, as the same people page search.search-people returns. The answer itself is unchanged. - [`search.search-company-people`](/docs/api/search/search-company-people.md)
- **Changed**: The search.search-people response is now documented field by field: the page fields, lookalikeSeeds and each person with hasKenEmail, kenEmailStatus, searchToken and behaviorTags. The answer itself is unchanged. - [`search.search-people`](/docs/api/search/search-people.md)
- **Added**: Published account-domains.create: add a domain to an account. - [`account-domains.create`](/docs/api/account-domains/create.md)
- **Added**: Published account-domains.delete: remove a domain from an account. - [`account-domains.delete`](/docs/api/account-domains/delete.md)
- **Added**: Published accounts.add-to-campaign: add an account's people to a campaign. - [`accounts.add-to-campaign`](/docs/api/accounts/add-to-campaign.md)
- **Added**: Published accounts.bulk-create: create up to 100 accounts in one call, with a result per item. - [`accounts.bulk-create`](/docs/api/accounts/bulk-create.md)
- **Added**: Published accounts.create: create an account from its domains. A domain another account owns answers 409 conflict with that account's id. - [`accounts.create`](/docs/api/accounts/create.md)
- **Added**: Published accounts.delete: delete an account. - [`accounts.delete`](/docs/api/accounts/delete.md)
- **Added**: Published accounts.get: read one account with its domains, scores and deal totals. - [`accounts.get`](/docs/api/accounts/get.md)
- **Added**: Published accounts.links: read an account's website, LinkedIn page and careers page. - [`accounts.links`](/docs/api/accounts/links.md)
- **Added**: Published accounts.list: list your accounts, the companies you sell to, filtered by domain, stage, owner, tags and more, or search names and domains with q. - [`accounts.list`](/docs/api/accounts/list.md)
- **Added**: Published accounts.merge: merge a duplicate account into another. - [`accounts.merge`](/docs/api/accounts/merge.md)
- **Added**: Published accounts.update: change an account's stage, owner, type and company fields. - [`accounts.update`](/docs/api/accounts/update.md)
- **Added**: Published meeting-notes.create: add call notes or a transcript to an account. - [`meeting-notes.create`](/docs/api/meeting-notes/create.md)
- **Added**: Published meeting-notes.delete: delete a meeting note. - [`meeting-notes.delete`](/docs/api/meeting-notes/delete.md)
- **Added**: Published meeting-notes.get: read one meeting note in full. - [`meeting-notes.get`](/docs/api/meeting-notes/get.md)
- **Added**: Published meeting-notes.list: list an account's meeting notes. - [`meeting-notes.list`](/docs/api/meeting-notes/list.md)
- **Added**: Published stakeholders.create: put a person on an account. - [`stakeholders.create`](/docs/api/stakeholders/create.md)
- **Added**: Published stakeholders.delete: take a person off an account. The person stays. - [`stakeholders.delete`](/docs/api/stakeholders/delete.md)
- **Added**: Published stakeholders.list: list the people on an account with their role, priority and coverage. - [`stakeholders.list`](/docs/api/stakeholders/list.md)
- **Added**: Published stakeholders.update: change a stakeholder's role, priority, coverage or note. - [`stakeholders.update`](/docs/api/stakeholders/update.md)
- **Added**: Accepts an optional Idempotency-Key header (at most 200 characters, per workspace). A retry with the same key and the same request within 24 hours returns the first response, with Idempotent-Replayed: true, and does not launch the campaign again. The same key with a different request is 422 idempotency_key_reused. Only a 2xx response is kept, so a retry after a 4xx or 5xx runs the launch again. - [`campaigns.launch`](/docs/api/campaigns/launch.md)
- **Added**: Accepts an optional Idempotency-Key header (at most 200 characters, per workspace). A retry with the same key and the same request within 24 hours returns the first response, with Idempotent-Replayed: true, and does not connect the inbox again. The same key with a different request is 422 idempotency_key_reused. Only a 2xx response is kept, so a retry after a 4xx or 5xx runs the connect again. Kenso leaves password out of what it compares and keeps no trace of it, so a repeat that changes only the password gets the first response: send a new key when you change it. - [`inboxes.create`](/docs/api/inboxes/create.md)
- **Changed**: The reference now lists the Idempotency-Key header threads.create has always required (at most 200 characters, per workspace). A request without it answered 400 before and still does, so no request has to change. A reused key with a different request answers idempotency_key_reused with status 409 for now. Kenso will move it to 422, the status every other operation uses, and this changelog will announce the date: branch on the code, not the status. - [`threads.create`](/docs/api/threads/create.md)
- **Added**: The reference now lists the optional Idempotency-Key header this operation already read (at most 200 characters, per workspace). Kenso records the key with the reply, so a repeat with the same key does not send it twice. A reused key with a different request answers idempotency_key_reused with status 409 for now. Kenso will move it to 422, the status every other operation uses, and this changelog will announce the date: branch on the code, not the status. - [`threads.create-message`](/docs/api/threads/create-message.md)
- **Added**: Accepts an optional Idempotency-Key header (at most 200 characters, per workspace). A retry with the same key and the same request within 24 hours returns the first response, with Idempotent-Replayed: true, and does not forward the message again. The same key with a different request is 422 idempotency_key_reused. Only a 2xx response is kept, so a retry after a 4xx or 5xx runs the forward again. - [`threads.forward`](/docs/api/threads/forward.md)
- **Added**: Added POST /v1/webhook-endpoints/{webhookEndpointId}/signing-secret/rotate: replaces an endpoint's signing secret and returns the new secret with previousSecretExpiresAt. For 24 hours every delivery carries a signature for each secret, so receivers can switch without dropping a delivery. - [`webhook-endpoints.rotate-signing-secret`](/docs/api/webhook-endpoints/rotate-signing-secret.md)
- **Added**: New GET /v1/status returns the status of the Kenso API, sending and webhooks (operational, degraded, outage or unknown) and the worst of them. Sending is operational while a dispatch pass succeeded in the last 3 minutes, and webhooks while a dispatch run delivered or had nothing to deliver in the last 5 minutes. It takes no credential and no Ken-Version header, and is cacheable for 30 seconds. - [`status.get`](/docs/api/status/get.md)
- **Added**: New GET /v1/webhook-event-types/{eventType}/schema returns the JSON Schema of the body Kenso delivers for one webhook event type, so you can validate deliveries against it. - [`webhook-event-types.get-schema`](/docs/api/webhook-event-types/get-schema.md)
- **Added**: The credit ledger can now be filtered by what each line was for: trigger, actorUserId, contactId, accountId, listId, workflowId, chatId (a Ken chat's lines, its Ken run included), runId (every line of one run) and q (text search over the description, title, web URL and the name of the line's object). action now takes several comma-separated actions. All are optional and combine with AND. - [`credit-ledger.list`](/docs/api/credit-ledger/list.md)
- **Changed**: Added optional field data.reservedItems[].nextRenewalAt to the credits.get response: when the next item of that action renews. - [`credits.get`](/docs/api/credits/get.md)
- **Added**: Added optional header parameter X-Ken-Workspace-Id to credit-rate-card.get: send it to get the rate card of a workspace on the new plans. - [`credit-rate-card.get`](/docs/api/credit-rate-card/get.md)
- **Changed**: Added optional field data.version (1, or 2 for a workspace on the new plans) and optional field data.items[].freePerDay (free uses a day) to the credit-rate-card.get response. - [`credit-rate-card.get`](/docs/api/credit-rate-card/get.md)
- **Changed**: Added optional field data.aiLimit (percentUsed, and state: ok, warning from 80% or reached) to the credits.get response: how much of the workspace's monthly AI limit is used, as a percent, never a dollar amount. It is present only while the workspace is on the new pricing with the AI limit enforced, and omitted otherwise. - [`credits.get`](/docs/api/credits/get.md)
- **Changed**: Added optional field emailVerifiers to the campaigns.update request: the verifiers that check the campaign's emails (kenso, leadmagic, findymail, zerobounce, neverbounce). zerobounce and neverbounce run on the workspace's own key; adding one without a working key is refused with provider_key_missing. Added optional field `data.emailVerifiers` to the campaigns.update response. - [`campaigns.update`](/docs/api/campaigns/update.md)
- **Changed**: Added optional field clicksTracked to the metrics of the analytics.get-campaign-performance response (window metrics, rows, and a segment row's steps and versions), beside opensTracked. false means the campaign sends as plain text, whose emails carry no click-tracking link, so its clickCount and clickRate are not real: clicks are partial (steps kept as HTML), not none. Omitted where opensTracked is omitted for the call, past billing grace, and on an imported campaign that would read false; where omitted, clicks are partly tracked or unknown: read clickRate as a floor. - [`analytics.get-campaign-performance`](/docs/api/analytics/get-campaign-performance.md)
- **Changed**: The response of saved-searches.create is now documented field by field: the saved search's id, name, type, filters, sharing and your access to it. - [`saved-searches.create`](/docs/api/saved-searches/create.md)
- **Changed**: The response of saved-searches.get is now documented field by field: the saved search's id, name, type, filters, sharing and your access to it. - [`saved-searches.get`](/docs/api/saved-searches/get.md)
- **Changed**: The response of saved-searches.share is now documented field by field: the saved search's id, name, type, filters, sharing and your access to it. - [`saved-searches.share`](/docs/api/saved-searches/share.md)
- **Changed**: The response of saved-searches.update is now documented field by field: the saved search's id, name, type, filters, sharing and your access to it. - [`saved-searches.update`](/docs/api/saved-searches/update.md)
- **Changed**: The response of search.create-import is now documented field by field: the new import's jobId and its status. - [`search.create-import`](/docs/api/search/create-import.md)
- **Changed**: The response of search.expand-industries is now documented field by field: expandedIndustries maps each industry you sent to its related industries, and error says why when the expansion failed. - [`search.expand-industries`](/docs/api/search/expand-industries.md)
- **Changed**: The response of search.get-filters is now documented field by field: each filter's list of values (value, label, count and parent value), the location tree, and the country, state and company size counts. - [`search.get-filters`](/docs/api/search/get-filters.md)
- **Changed**: The response of search.get-import is now documented field by field: the import's status, phase and counts, the people it skipped by reason, and its batch-by-batch progress. - [`search.get-import`](/docs/api/search/get-import.md)
- **Changed**: The response of search.get-metadata is now documented field by field: with a category, one page of that category's values with pagination; without one, the whole filter catalog that search.get-filters returns. - [`search.get-metadata`](/docs/api/search/get-metadata.md)
- **Changed**: Documentation fix: search.get-metadata always answered either a page of one category's values or the whole filter catalog; the reference now shows the two bodies as alternatives instead of one untyped body.

Optional fields added on 30 operations:

- **Changed**: Added optional field `data.isSandbox` to the workspaces.get response. - [`workspaces.get`](/docs/api/workspaces/get.md)
- **Changed**: Added optional field `data[].isSandbox` to the workspaces.list response. - [`workspaces.list`](/docs/api/workspaces/list.md)
- **Changed**: Added optional field `data.isSandbox` to the workspaces.update response. - [`workspaces.update`](/docs/api/workspaces/update.md)
- **Changed**: Added optional field `data.companies[].people[].contact.searchToken` to the contact-imports.buyer-preview response. - [`contact-imports.buyer-preview`](/docs/api/contact-imports/buyer-preview.md)
- **Changed**: Added optional field `contacts[].searchToken` to the contact-imports.create request. - [`contact-imports.create`](/docs/api/contact-imports/create.md)
- **Changed**: Added optional fields `data.reasons[].refusal.feature`, `data.reasons[].refusal.requiredPlan`, `data.warnings[].refusal.feature` and `data.warnings[].refusal.requiredPlan` to the campaigns.get-launch-readiness response. - [`campaigns.get-launch-readiness`](/docs/api/campaigns/get-launch-readiness.md)
- **Changed**: Added optional field `data.listedSince` to the domains.get-health response. - [`domains.get-health`](/docs/api/domains/get-health.md)
- **Changed**: Added optional field `data[].listedSince` to the domains.list-health response. - [`domains.list-health`](/docs/api/domains/list-health.md)
- **Changed**: Added optional fields `data[].oneToOneReadiness.signatureMessage` and `data[].oneToOneReadiness.signatureWarning` to the campaigns.list-inboxes response. - [`campaigns.list-inboxes`](/docs/api/campaigns/list-inboxes.md)
- **Changed**: Added optional fields `data[].oneToOneReadiness.signatureMessage` and `data[].oneToOneReadiness.signatureWarning` to the campaigns.replace-inboxes response. - [`campaigns.replace-inboxes`](/docs/api/campaigns/replace-inboxes.md)
- **Changed**: Added optional fields `data.oneToOneReadiness.signatureMessage` and `data.oneToOneReadiness.signatureWarning` to the inboxes.create response. - [`inboxes.create`](/docs/api/inboxes/create.md)
- **Changed**: Added optional fields `data.oneToOneReadiness.signatureMessage` and `data.oneToOneReadiness.signatureWarning` to the inboxes.disconnect response. - [`inboxes.disconnect`](/docs/api/inboxes/disconnect.md)
- **Changed**: Added optional field `data.emailVerifiers` to the campaigns.archive response. - [`campaigns.archive`](/docs/api/campaigns/archive.md)
- **Changed**: Added optional field `data.emailVerifiers` to the campaigns.clear-launch-schedule response. - [`campaigns.clear-launch-schedule`](/docs/api/campaigns/clear-launch-schedule.md)
- **Changed**: Added optional field `data.emailVerifiers` to the campaigns.create response. - [`campaigns.create`](/docs/api/campaigns/create.md)
- **Changed**: Added optional field `data.emailVerifiers` to the campaigns.duplicate response. - [`campaigns.duplicate`](/docs/api/campaigns/duplicate.md)
- **Changed**: Added optional field `data.emailVerifiers` to the campaigns.get response. - [`campaigns.get`](/docs/api/campaigns/get.md)
- **Changed**: Added optional field `data.emailVerifiers` to the campaigns.launch response. - [`campaigns.launch`](/docs/api/campaigns/launch.md)
- **Changed**: Added optional field `data[].emailVerifiers` to the campaigns.list response. - [`campaigns.list`](/docs/api/campaigns/list.md)
- **Changed**: Added optional field `data.emailVerifiers` to the campaigns.pause response. - [`campaigns.pause`](/docs/api/campaigns/pause.md)
- **Changed**: Added optional field `data.emailVerifiers` to the campaigns.restart response. - [`campaigns.restart`](/docs/api/campaigns/restart.md)
- **Changed**: Added optional field `data.emailVerifiers` to the campaigns.resume response. - [`campaigns.resume`](/docs/api/campaigns/resume.md)
- **Changed**: Added optional field `data.emailVerifiers` to the campaigns.set-launch-schedule response. - [`campaigns.set-launch-schedule`](/docs/api/campaigns/set-launch-schedule.md)
- **Changed**: Added optional field `data.emailVerifiers` to the campaigns.unarchive response. - [`campaigns.unarchive`](/docs/api/campaigns/unarchive.md)
- **Changed**: Added optional fields `data.oneToOneReadiness.signatureMessage` and `data.oneToOneReadiness.signatureWarning` to the inboxes.get response. - [`inboxes.get`](/docs/api/inboxes/get.md)
- **Changed**: Added optional fields `data.signatureMessage` and `data.signatureWarning` to the inboxes.get-one-to-one-readiness response. - [`inboxes.get-one-to-one-readiness`](/docs/api/inboxes/get-one-to-one-readiness.md)
- **Changed**: Added optional fields `data[].oneToOneReadiness.signatureMessage` and `data[].oneToOneReadiness.signatureWarning` to the inboxes.list response. - [`inboxes.list`](/docs/api/inboxes/list.md)
- **Changed**: Added optional fields `data.inbox.oneToOneReadiness.signatureMessage` and `data.inbox.oneToOneReadiness.signatureWarning` to the inboxes.rename response. - [`inboxes.rename`](/docs/api/inboxes/rename.md)
- **Changed**: Added optional fields `data.oneToOneReadiness.signatureMessage` and `data.oneToOneReadiness.signatureWarning` to the inboxes.update response. - [`inboxes.update`](/docs/api/inboxes/update.md)
- **Changed**: Added optional fields `data.oneToOneReadiness.signatureMessage` and `data.oneToOneReadiness.signatureWarning` to the inboxes.verify response. - [`inboxes.verify`](/docs/api/inboxes/verify.md)

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