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

> **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-06 (40 changes)

- **Added**: Added ai-feedback.list (GET /v1/ai-feedback), which returns the caller's own ratings of up to 100 outputs on one surface (surface and a repeated targetRef), at most one per output, so an app can show the thumb a person picked after a reload. Each targetRef is matched by the spelling the save stores and comes back in it. Other people's ratings, cleared ratings and implicit signals never appear. It answers 404 until AI feedback is turned on for the workspace. - [`ai-feedback.list`](/docs/api/ai-feedback/list.md)
- **Changed**: On an iMessage thread, a text sent with an agent's or API key's credential, the line owner's own included, always waits for the line owner's approval: 202 awaiting_approval with a touch pinned to this thread, and the 202 adds approverName (the approver's first name). Only a person approves it. When the thread's line can no longer send, that text is 409 invalid_state with error.details[0].code imessage_line_gone (the line was released: nothing goes on the thread again), imessage_line_down or imessage_line_owner_left. A voice note, or a person on no live account, is 403 forbidden with error.details[0].code imessage_agent_voice_note or imessage_person_on_no_account. A member's text on a line whose owner can't send from it anymore is 409 invalid_state with imessage_line_owner_left and no nextAllowedAt or Retry-After: nothing goes from that line until an admin gives it a new owner in Delivery. unfilled_template_key errors add details[0].marker, the marker as written; square brackets a member types are ordinary text. 503 with details[0].code imessage_unavailable means Kenso could not check the line's new-conversation lock and nothing was sent. An agent's or API key's text to a person who has not engaged (no reply, click, accepted connection or booked meeting) is 409 invalid_state with error.details[0].code imessage_not_engaged; a member can send it. A text to a number that opted out of texts, or to a person who opted out of texts, is 409 invalid_state with error.details[0].code phone_opt_out, and one to a blocklisted, do-not-contact or unsubscribed person is 409 invalid_state with suppressed:<reason>. The route now declares its 202, 400, 403, 404, 409, 422 and 503 answers. Needs the imessage feature, which is off for every workspace for now. - [`threads.create-message`](/docs/api/threads/create-message.md)
- **Changed**: A tapback on a line whose owner can't send from it anymore is 409 invalid_state with error.details[0].code imessage_line_owner_left (it was a 503) until an admin gives the line a new owner in Delivery. A tapback sent with an agent's or API key's credential, the line owner's own included, follows the agent rules: on a line a member paused it is held with error.details[0].code imessage_line_paused until a member resumes the line. A line that cannot react now (paused, unpaid, down or not connected) is 409 invalid_state with error.details[0].code the line's state, details[0].nextAllowedAt and Retry-After (it was a 503); 503 now means only that nothing was sent and a retry is safe. A tapback to a number that opted out of texts, or to a person who opted out of texts, is 409 invalid_state with error.details[0].code phone_opt_out, and one to a blocklisted, do-not-contact or unsubscribed person is 409 invalid_state with suppressed:<reason>, for adding and removing it alike. Needs the imessage feature, which is off for every workspace for now. - [`threads.react-message`](/docs/api/threads/react-message.md)
- **Changed**: The line's health carries contacts24hLimitCount and contacts30dLimitCount, the most distinct people the line may text in 24 hours and in 30 days (health stays null until the first usage sync). Needs the imessage feature, which is off for every workspace for now. - [`imessage-lines.list`](/docs/api/imessage-lines/list.md)
- **Changed**: The line's health carries contacts24hLimitCount and contacts30dLimitCount, the most distinct people the line may text in 24 hours and in 30 days (health stays null until the first usage sync). Needs the imessage feature, which is off for every workspace for now. - [`imessage-lines.get`](/docs/api/imessage-lines/get.md)
- **Changed**: Retrying with the Idempotency-Key of an order that went through returns that line (201) even while Kenso is not taking orders. The route now declares its 400, 402, 403, 409 and 422 answers. The line's health carries contacts24hLimitCount and contacts30dLimitCount, the most distinct people the line may text in 24 hours and in 30 days (health stays null until the first usage sync). Needs the imessage feature, which is off for every workspace for now. - [`imessage-lines.order`](/docs/api/imessage-lines/order.md)
- **Changed**: Cancelling a paid line a member paused keeps it until the end of its paid month (status cancelling, pausedReason member, cancelEffectiveAt the end of the month) instead of releasing it at once; it sends nothing unless resumed. A line with no paid month left (its renewal unpaid, its month ran out, or never billed), sending or paused, and a line paused for unpaid credits, are released at once. The line's health carries contacts24hLimitCount and contacts30dLimitCount, the most distinct people the line may text in 24 hours and in 30 days (health stays null until the first usage sync). Needs the imessage feature, which is off for every workspace for now. - [`imessage-lines.cancel`](/docs/api/imessage-lines/cancel.md)
- **Changed**: A cancelling line can be paused: it stays cancelling with pausedReason member and sends nothing until resumed or released. The line's health carries contacts24hLimitCount and contacts30dLimitCount, the most distinct people the line may text in 24 hours and in 30 days (health stays null until the first usage sync). Needs the imessage feature, which is off for every workspace for now. - [`imessage-lines.pause`](/docs/api/imessage-lines/pause.md)
- **Changed**: Resumes a cancelling line a member paused: it sends again until the end of its paid month. The line's health carries contacts24hLimitCount and contacts30dLimitCount, the most distinct people the line may text in 24 hours and in 30 days (health stays null until the first usage sync). Needs the imessage feature, which is off for every workspace for now. - [`imessage-lines.resume`](/docs/api/imessage-lines/resume.md)
- **Changed**: The new owner takes over the line's unsent texts: Ken's unedited drafts are written again in their name, and a text approved by anyone else goes back for their approval. This unblocks a line whose owner can't send from it anymore (imessage_line_owner_left). The line's health carries contacts24hLimitCount and contacts30dLimitCount, the most distinct people the line may text in 24 hours and in 30 days (health stays null until the first usage sync). Needs the imessage feature, which is off for every workspace for now. - [`imessage-lines.update`](/docs/api/imessage-lines/update.md)
- **Changed**: Each iMessage row now carries the imessage block (lineId, phone, hasReplied, isSmsThread and personId), as on threads.get, so the list shows whether the person replied without reading each thread. Needs the imessage feature, which is off for every workspace for now. - [`threads.list`](/docs/api/threads/list.md)
- **Changed**: In the message in the response, each attachment the person sent on an iMessage text carries url, the threads.get-message-attachment route that downloads it (omitted when Kenso has no link for it). Needs the imessage feature, which is off for every workspace for now. - [`threads.create`](/docs/api/threads/create.md)
- **Changed**: In the 201 message, each attachment the person sent on an iMessage text carries url, the threads.get-message-attachment route that downloads it (omitted when Kenso has no link for it). Needs the imessage feature, which is off for every workspace for now. - [`threads.create-message`](/docs/api/threads/create-message.md)
- **Changed**: An iMessage thread's imessage block carries personId, the person the conversation is with (the personId voice-notes.create takes); omitted when the conversation has no person. Needs the imessage feature, which is off for every workspace for now. - [`threads.get`](/docs/api/threads/get.md)
- **Added**: Added GET /v1/threads/{threadId}/messages/{messageId}/attachments/{index}: the bytes of a file the person sent on an iMessage text, index its 0-based position in imessage.attachments (each attachment's url is this route). Images are served inline and other files as a download, with Cache-Control private, max-age=3600. Another workspace's thread, an index with no attachment, or a link Kenso will not fetch is 404; a file over 10,000,000 bytes is 422 attachment_too_large; 503 or 504 when the file's host fails. Needs the Inbox permission. Needs the imessage feature, which is off for every workspace for now. - [`threads.get-message-attachment`](/docs/api/threads/get-message-attachment.md)
- **Changed**: The imessage block on each iMessage row gains personId, as on threads.get. Needs the imessage feature, which is off for every workspace for now. - [`threads.list`](/docs/api/threads/list.md)
- **Changed**: In each message, each attachment the person sent on an iMessage text carries url, the threads.get-message-attachment route that downloads it (omitted when Kenso has no link for it). Needs the imessage feature, which is off for every workspace for now. - [`threads.list-messages`](/docs/api/threads/list-messages.md)
- **Changed**: An iMessage thread's imessage block carries personId, as on threads.get. Needs the imessage feature, which is off for every workspace for now. - [`threads.update`](/docs/api/threads/update.md)

Optional fields added on 22 operations:

- **Changed**: Added optional field `data.stopAllChannelsOnReply` to the campaigns.get-linkedin-settings response. - [`campaigns.get-linkedin-settings`](/docs/api/campaigns/get-linkedin-settings.md)
- **Changed**: Added optional field `stopAllChannelsOnReply` to the campaigns.replace-linkedin-settings request. Added optional field `data.stopAllChannelsOnReply` to the campaigns.replace-linkedin-settings response. - [`campaigns.replace-linkedin-settings`](/docs/api/campaigns/replace-linkedin-settings.md)
- **Changed**: Added optional field `data.steps[].waitFromCondition` to the linkedin-sequences.get response. - [`linkedin-sequences.get`](/docs/api/linkedin-sequences/get.md)
- **Changed**: Added optional field `data.steps[].waitFromCondition` to the linkedin-sequences.get-version response. - [`linkedin-sequences.get-version`](/docs/api/linkedin-sequences/get-version.md)
- **Changed**: Added optional field `steps[].waitFromCondition` to the linkedin-sequences.replace request. Added optional field `data.steps[].waitFromCondition` to the linkedin-sequences.replace response. - [`linkedin-sequences.replace`](/docs/api/linkedin-sequences/replace.md)
- **Changed**: Added optional field `steps[].waitFromCondition` to the linkedin-sequences.save-version request. Added optional field `data.sequence.steps[].waitFromCondition` to the linkedin-sequences.save-version response. - [`linkedin-sequences.save-version`](/docs/api/linkedin-sequences/save-version.md)
- **Changed**: Added optional field `data.steps[].waitFromCondition` to the segment-linkedin-sequences.get response. - [`segment-linkedin-sequences.get`](/docs/api/segment-linkedin-sequences/get.md)
- **Changed**: Added optional field `data.steps[].waitFromCondition` to the segment-linkedin-sequences.get-version response. - [`segment-linkedin-sequences.get-version`](/docs/api/segment-linkedin-sequences/get-version.md)
- **Changed**: Added optional field `steps[].waitFromCondition` to the segment-linkedin-sequences.replace request. Added optional field `data.steps[].waitFromCondition` to the segment-linkedin-sequences.replace response. - [`segment-linkedin-sequences.replace`](/docs/api/segment-linkedin-sequences/replace.md)
- **Changed**: Added optional field `steps[].waitFromCondition` to the segment-linkedin-sequences.save-version request. Added optional field `data.sequence.steps[].waitFromCondition` to the segment-linkedin-sequences.save-version response. - [`segment-linkedin-sequences.save-version`](/docs/api/segment-linkedin-sequences/save-version.md)
- **Changed**: Added optional fields `format`, `frameCount` and `frameDurationMs` to the image-variables.create request. Added optional fields `data.format`, `data.frameCount` and `data.frameDurationMs` to the image-variables.create response. - [`image-variables.create`](/docs/api/image-variables/create.md)
- **Changed**: Added optional fields `format`, `frameCount` and `frameDurationMs` to the image-variables.estimate request. - [`image-variables.estimate`](/docs/api/image-variables/estimate.md)
- **Changed**: Added optional fields `data.format`, `data.frameCount` and `data.frameDurationMs` to the image-variables.get response. - [`image-variables.get`](/docs/api/image-variables/get.md)
- **Changed**: Added optional fields `data[].format`, `data[].frameCount`, `data[].frameDurationMs` and `models[].supportsGif` to the image-variables.list response. - [`image-variables.list`](/docs/api/image-variables/list.md)
- **Changed**: Added optional fields `data.format`, `data.frameCount` and `data.frameDurationMs` to the image-variables.set-shared-image response. - [`image-variables.set-shared-image`](/docs/api/image-variables/set-shared-image.md)
- **Changed**: Added optional fields `format`, `frameCount` and `frameDurationMs` to the image-variables.update request. Added optional fields `data.format`, `data.frameCount` and `data.frameDurationMs` to the image-variables.update response. - [`image-variables.update`](/docs/api/image-variables/update.md)
- **Changed**: Added optional field `depth` to the credit-estimates.create request. Added optional fields `data.depth`, `data.targetLeads`, `data.totalAmount`, `data.totalAmount.amount` and `data.totalAmount.currency` to the credit-estimates.create response. - [`credit-estimates.create`](/docs/api/credit-estimates/create.md)
- **Changed**: Added optional fields `data.depths`, `data.depths[].depth`, `data.depths[].lines`, `data.depths[].lines[].action`, `data.depths[].lines[].description`, `data.depths[].lines[].millicreditsPerLead`, `data.depths[].lines[].unitsPerLead` and `data.depths[].millicreditsPerLead` to the credit-rate-card.get response. - [`credit-rate-card.get`](/docs/api/credit-rate-card/get.md)
- **Changed**: Added optional field `data.voiceTranscript` to the threads.create response. - [`threads.create`](/docs/api/threads/create.md)
- **Changed**: Added optional fields `mediaIds`, `voiceId` and `voiceProvider` to the threads.create-message request. Added optional field `data.voiceTranscript` to the threads.create-message 201 response. - [`threads.create-message`](/docs/api/threads/create-message.md)
- **Changed**: Added optional field `data[].channels.whatsapp` to the threads.list response. - [`threads.list`](/docs/api/threads/list.md)
- **Changed**: Added optional field `data[].voiceTranscript` to the threads.list-messages response. - [`threads.list-messages`](/docs/api/threads/list-messages.md)

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