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

> **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-07 (41 changes)

- **Changed**: Added optional field purpose to the attachments.create multipart/form-data request. - [`attachments.create`](/docs/api/attachments/create.md)
- **Changed**: Added optional field `accountStages` to the blocklist-rules.create request. Added optional field `data.accountStages` to the blocklist-rules.create response. A rule can block the domains of accounts in chosen account stages (every stage but new and researching, at most 16); accountTypes still works. - [`blocklist-rules.create`](/docs/api/blocklist-rules/create.md)
- **Changed**: Added optional field `data[].accountStages` to the blocklist-rules.list response. It lists the account stages each rule blocks. - [`blocklist-rules.list`](/docs/api/blocklist-rules/list.md)
- **Added**: Added optional query parameter accountStages to blocklist-rules.preview. A comma-separated list of account stages: the preview counts what a rule on them would block. - [`blocklist-rules.preview`](/docs/api/blocklist-rules/preview.md)
- **Changed**: Added optional field `accountStages` to the blocklist-rules.update request. Added optional field `data.accountStages` to the blocklist-rules.update response. Send [] to clear the rule's account stages. - [`blocklist-rules.update`](/docs/api/blocklist-rules/update.md)
- **Added**: Added threads.create-image. - [`threads.create-image`](/docs/api/threads/create-image.md)
- **Changed**: Added optional fields `data.person.facebook`, `data.person.facebook.confidence`, `data.person.facebook.source`, `data.person.facebook.status` and `data.person.facebook.url` to the people.intake response. The person model gained the person's Facebook profile (url, source, confidence, status); people.intake leaves it out. - [`people.intake`](/docs/api/people/intake.md)
- **Added**: Added campaigns.unarchive (POST /v1/campaigns/{campaignId}/unarchive). It brings an archived campaign back without sending: completed when it had finished, paused when it launched, a draft when it never launched. Requires Campaigns edit and the launch permission. - [`campaigns.unarchive`](/docs/api/campaigns/unarchive.md)
- **Changed**: campaigns.archive now cancels the campaign's queued emails and keeps its leads, replies and stats. It requires the launch permission as well as Campaigns edit, as pause and resume do. - [`campaigns.archive`](/docs/api/campaigns/archive.md)
- **Added**: Added sequence-imports.preview (POST /v1/sequence-imports/previews), which reads a sequence pasted or exported from another tool (Origami, lemlist, Instantly, La Growth Machine: JSON, CSV or plain text) into proposed email and LinkedIn steps with warnings for anything changed or dropped. It saves nothing. Plain text is read by a model and counts against a quota of 30 an hour per workspace (429 quota_exceeded); JSON and CSV do not. It answers 422 no_steps_found when nothing reads as a step and 503 provider_unavailable when the model is unavailable. - [`sequence-imports.preview`](/docs/api/sequence-imports/preview.md)
- **Changed**: Added optional field `data.leadsNeedingEmailFind` to the credit-estimates.create response. A campaign estimate now prices the email find only for leads that have no Safe email yet, so a campaign imported with emails is no longer over-quoted. - [`credit-estimates.create`](/docs/api/credit-estimates/create.md)
- **Changed**: Added optional response field requiresApproval on each step. On a like_post, endorse_skill or comment_post step, true means each like, endorsement or comment waits in Approvals (type campaign.linkedin_engagement) until a person approves it; false on every other step type. - [`linkedin-sequences.get`](/docs/api/linkedin-sequences/get.md)
- **Changed**: Added optional response field requiresApproval on each like_post, endorse_skill or comment_post step of a saved version: whether its actions waited for a person's approval. Versions saved earlier omit it. - [`linkedin-sequences.get-version`](/docs/api/linkedin-sequences/get-version.md)
- **Changed**: Added optional request field requiresApproval on each step, and the same field on each step of the response. On a like_post, endorse_skill or comment_post step, true holds each like, endorsement or comment in Approvals (type campaign.linkedin_engagement) until a person approves it, with the exact comment as the preview. Omit it to keep the stored value; a new step of these types starts at true. Other step types ignore it and store false. - [`linkedin-sequences.replace`](/docs/api/linkedin-sequences/replace.md)
- **Changed**: Added optional request field requiresApproval on each step of a saved version, with the same meaning as on linkedin-sequences.replace, and the field on each step of the returned sequence. A restore of a version saved without it keeps each live step's value, and a restored like, endorse or comment step with no live row starts at true. - [`linkedin-sequences.save-version`](/docs/api/linkedin-sequences/save-version.md)
- **Changed**: Added optional response field requiresApproval on each step. On a like_post, endorse_skill or comment_post step, true means each like, endorsement or comment waits in Approvals (type campaign.linkedin_engagement) until a person approves it; false on every other step type. - [`segment-linkedin-sequences.get`](/docs/api/segment-linkedin-sequences/get.md)
- **Changed**: Added optional response field requiresApproval on each like_post, endorse_skill or comment_post step of a saved version: whether its actions waited for a person's approval. Versions saved earlier omit it. - [`segment-linkedin-sequences.get-version`](/docs/api/segment-linkedin-sequences/get-version.md)
- **Changed**: Added optional request field requiresApproval on each step, and the same field on each step of the response. On a like_post, endorse_skill or comment_post step, true holds each like, endorsement or comment in Approvals (type campaign.linkedin_engagement) until a person approves it, with the exact comment as the preview. Omit it to keep the stored value; a new step of these types starts at true. Other step types ignore it and store false. - [`segment-linkedin-sequences.replace`](/docs/api/segment-linkedin-sequences/replace.md)
- **Changed**: Added optional request field requiresApproval on each step of a saved version, with the same meaning as on linkedin-sequences.replace, and the field on each step of the returned sequence. A restore of a version saved without it keeps each live step's value, and a restored like, endorse or comment step with no live row starts at true. - [`segment-linkedin-sequences.save-version`](/docs/api/segment-linkedin-sequences/save-version.md)
- **Changed**: Added optional field data.freeMillicredits to the credits.get response: the remaining credits of every open free grant (signup, bonus, feedback and free credits from Kenso staff). Free credits pay for data, AI and sending but not for Kenso inboxes or domains, so paid credits are balanceMillicredits minus freeMillicredits. - [`credits.get`](/docs/api/credits/get.md)
- **Added**: Added voice-notes.get (GET /v1/voice-notes/{voiceNoteId}). It returns an iMessage voice note made with voice-notes.create: its status (generating, ready, sent, failed or expired), the touchId or threadId it was made for, failureReason, createdAt, readyAt and its audio fields. Poll it while the status is generating and stop at any other status. Another workspace's note, or one for a person you cannot see, is 404. Requires Inbox edit, and a member with the Client role cannot call it. Needs the imessage feature, which is off for every workspace for now. - [`voice-notes.get`](/docs/api/voice-notes/get.md)
- **Changed**: An iMessage voice note made for a threadId while an earlier one for that thread is still generating returns that note (201, the same note, with status generating) and charges nothing. A note made for a touchId goes on the touch by itself once it is ready, when the touch can still take one, and a note for a thread is written from that thread's recent messages. An agent sends a voice note on the person's iMessage touch (touchId), which a member approves; a note made for a threadId goes out only when a member sends it from the thread. Needs the imessage feature, which is off for every workspace for now. - [`voice-notes.create`](/docs/api/voice-notes/create.md)
- **Changed**: Added optional fields `data.imessage.ownerLeft`, `data.imessage.ownerName`, `data.imessage.voiceNoteInProgress`, `data.imessage.voiceNoteInProgress.id` and `data.imessage.voiceNoteInProgress.status` to the threads.get response. data.imessage.ownerName names the member who owns the thread's line, and data.imessage.ownerLeft is true while that owner can't send from it anymore (nothing goes from the line until an admin gives it a new owner in Delivery). data.imessage.voiceNoteInProgress names the voice note Kenso is still making for this thread (id and status), or is null: poll voice-notes.get for it instead of making another. Needs the imessage feature, which is off for every workspace for now. - [`threads.get`](/docs/api/threads/get.md)
- **Changed**: Added optional fields `data[].imessage.ownerLeft`, `data[].imessage.ownerName`, `data[].imessage.voiceNoteInProgress`, `data[].imessage.voiceNoteInProgress.id` and `data[].imessage.voiceNoteInProgress.status` to the threads.list response. data[].imessage.ownerName names the member who owns the thread's line, and data[].imessage.ownerLeft is true while that owner can't send from it anymore (nothing goes from the line until an admin gives it a new owner in Delivery). data[].imessage.voiceNoteInProgress names the voice note Kenso is still making for this thread (id and status), or is null: poll voice-notes.get for it instead of making another. Needs the imessage feature, which is off for every workspace for now. - [`threads.list`](/docs/api/threads/list.md)
- **Changed**: Added optional fields `data.imessage.ownerLeft`, `data.imessage.ownerName`, `data.imessage.voiceNoteInProgress`, `data.imessage.voiceNoteInProgress.id` and `data.imessage.voiceNoteInProgress.status` to the threads.update response. data.imessage.ownerName names the member who owns the thread's line, and data.imessage.ownerLeft is true while that owner can't send from it anymore (nothing goes from the line until an admin gives it a new owner in Delivery). data.imessage.voiceNoteInProgress names the voice note Kenso is still making for this thread (id and status), or is null: poll voice-notes.get for it instead of making another. Needs the imessage feature, which is off for every workspace for now. - [`threads.update`](/docs/api/threads/update.md)
- **Changed**: A tapback Kenso got no answer for is 409 outcome_unknown (it was 503): it may have gone, so read the thread before sending it again, and a retry under the same Idempotency-Key replays that answer. 503 service_unavailable now means only that nothing was sent; with error.details[0].code imessage_unavailable, iMessage cannot send for now (a payment or service problem on Kenso's side), so try again later. A 4xx answer that carries Retry-After (a line that cannot react until a time) is no longer stored under the Idempotency-Key, so the same key after that time tries again. A tapback on a thread whose line is gone (released, failed or never activated) is 409 invalid_state with error.details[0].code imessage_line_gone, and an agent's or API key's tapback, or its removal, on an SMS thread is 409 invalid_state with error.details[0].code imessage_sms_thread: nothing is sent. Needs the imessage feature, which is off for every workspace for now. - [`threads.react-message`](/docs/api/threads/react-message.md)
- **Changed**: On an iMessage thread, 503 with error.details[0].code imessage_unavailable also covers a payment or service problem on Kenso's side: iMessage cannot send for now, nothing was sent, try again later. voiceNoteId on a text from an agent's or API key's credential is 403 forbidden with imessage_agent_voice_note: an agent puts the voice note on the person's iMessage touch instead, which a member approves. Needs the imessage feature, which is off for every workspace for now. - [`threads.create-message`](/docs/api/threads/create-message.md)

Optional fields added on 14 operations:

- **Changed**: Added optional fields `voiceNoteId` and `imageIds` to the threads.create-message request. - [`threads.create-message`](/docs/api/threads/create-message.md)
- **Changed**: Added optional fields `data[].channels.instagram` and `data[].historyStartsAt` to the threads.list response. - [`threads.list`](/docs/api/threads/list.md)
- **Changed**: Added optional fields `data.person.engagement`, `data.person.relationship`, `data.person.relationshipSet`, `data.person.suggestion`, `data.person.suggestion.kind`, `data.person.suggestion.reason`, `data.person.suggestion.relationship`, `data.person.suggestion.suggestedAt`, `data.person.facebook`, `data.person.facebook.confidence`, `data.person.facebook.source`, `data.person.facebook.status` and `data.person.facebook.url` to the people.intake response. - [`people.intake`](/docs/api/people/intake.md)
- **Changed**: Added optional field `data.facebookUnreadCount` to the threads.counts response. - [`threads.counts`](/docs/api/threads/counts.md)
- **Changed**: Added optional field `data.historyStartsAt` to the threads.get response. - [`threads.get`](/docs/api/threads/get.md)
- **Changed**: Added optional field `data.historyStartsAt` to the threads.update response. - [`threads.update`](/docs/api/threads/update.md)
- **Changed**: Added optional fields `data[].networkOnly` and `data[].removedFromCampaignIds` to the campaigns.list-linkedin-accounts response. - [`campaigns.list-linkedin-accounts`](/docs/api/campaigns/list-linkedin-accounts.md)
- **Changed**: Added optional fields `data[].networkOnly` and `data[].removedFromCampaignIds` to the campaigns.replace-linkedin-accounts response. - [`campaigns.replace-linkedin-accounts`](/docs/api/campaigns/replace-linkedin-accounts.md)
- **Changed**: Added optional field `networkOnly` to the linkedin-accounts.create-connect-session request. - [`linkedin-accounts.create-connect-session`](/docs/api/linkedin-accounts/create-connect-session.md)
- **Changed**: Added optional fields `data.networkOnly` and `data.removedFromCampaignIds` to the linkedin-accounts.get response. - [`linkedin-accounts.get`](/docs/api/linkedin-accounts/get.md)
- **Changed**: Added optional fields `data[].networkOnly` and `data[].removedFromCampaignIds` to the linkedin-accounts.list response. - [`linkedin-accounts.list`](/docs/api/linkedin-accounts/list.md)
- **Changed**: Added optional fields `data.networkOnly` and `data.removedFromCampaignIds` to the linkedin-accounts.reset-ramp response. - [`linkedin-accounts.reset-ramp`](/docs/api/linkedin-accounts/reset-ramp.md)
- **Changed**: Added optional field `networkOnly` to the linkedin-accounts.update request. Added optional fields `data.networkOnly` and `data.removedFromCampaignIds` to the linkedin-accounts.update response. - [`linkedin-accounts.update`](/docs/api/linkedin-accounts/update.md)
- **Changed**: Added optional fields `data.linkedInWait`, `data.linkedInWait.linkedinAccountId`, `data.linkedInWait.message`, `data.linkedInWait.pendingInviteCap`, `data.linkedInWait.pendingInvites` and `data.linkedInWait.reason` to the contacts.get response. - [`contacts.get`](/docs/api/contacts/get.md)

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