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

> **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-10 (43 changes)

- **Added**: Added agent-work-settings.get: read who runs each kind of AI work that can wait in the workspace (briefs, workflow prompts, qualification, segmentation, personalization, rewriting): Kenso AI or the workspace's own agent. Available to workspaces with the agent work queue turned on. - [`agent-work-settings.get`](/docs/api/agent-work-settings/get.md)
- **Added**: Added agent-work-settings.update: choose, per kind, whether Kenso AI or the workspace's own agent runs that AI work. Only the kinds named change. Needs the workspace settings permission. Available to workspaces with the agent work queue turned on. - [`agent-work-settings.update`](/docs/api/agent-work-settings/update.md)
- **Changed**: Added optional fields `data.blocklistVerdict` and `data.uriblGreyOnly` to the domains.get-health response. blocklistVerdict is the latest health check's own verdict (listed, clean or unknown), and unknown when that check is more than 7 days old; a check that lists the domain on URIBL grey alone is clean there and has uriblGreyOnly true. blacklistStatus, listedCount and listedZones are unchanged. - [`domains.get-health`](/docs/api/domains/get-health.md)
- **Changed**: Added the opt-in branding kind: with kinds=branding, in a workspace where Kenso turned it on, the response carries optional field data.branding (logoUrl, faviconUrl, socialImageUrl, colors with primary, secondary, accent, background, text and link, fonts[] with family and role, colorScheme, source, fetchedAt). A lookup that finds branding costs credits as one page read; branding is never part of the default kinds, and a workspace without credits for it gets 402 plan_limit_reached. - [`company-data.get`](/docs/api/company-data/get.md)
- **Changed**: Each line now has waitingForCredits: true on an ordered line Kenso does not buy yet because the workspace's paid credits (and its free credits, where Kenso staff allowed them for the workspace) don't cover its first month, together with the first months of older orders still waiting and every month the live lines still owe (15,000 credits each); Today tells the workspace's billing members, and Kenso buys it once a top-up covers it. Null on an ordered line when Kenso could not read the workspace's orders and credits just now: whether it waits is not known, so read the line again rather than show it as not waiting. False on every other line, an order already handed to Kenso's buyer included. Needs the imessage feature, which is off for every workspace for now. - [`imessage-lines.list`](/docs/api/imessage-lines/list.md)
- **Changed**: The line now carries waitingForCredits, as imessage-lines.list describes. Needs the imessage feature, which is off for every workspace for now. - [`imessage-lines.get`](/docs/api/imessage-lines/get.md)
- **Changed**: The line now carries waitingForCredits, as imessage-lines.list describes. An owner who is a network member is 400 owner_not_member with error.details[0].code network_member: a line's texts go out in its owner's name. Needs the imessage feature, which is off for every workspace for now. - [`imessage-lines.update`](/docs/api/imessage-lines/update.md)
- **Changed**: The line now carries waitingForCredits, as imessage-lines.list describes. Needs the imessage feature, which is off for every workspace for now. - [`imessage-lines.resume`](/docs/api/imessage-lines/resume.md)
- **Changed**: The line now carries waitingForCredits, as imessage-lines.list describes. The docs now say a line a member paused still sends the members' own replies from the inbox, unless its monthly credits are unpaid: a line whose month is unpaid sends nothing, members' replies and tapbacks included (409 imessage_line_unpaid), whether its pausedReason is unpaid or member. Pausing a line paused for unpaid credits makes it the member's pause (pausedReason member), so it stays paused after the payment until a member resumes it. Nothing changed in what the line sends. Needs the imessage feature, which is off for every workspace for now. - [`imessage-lines.pause`](/docs/api/imessage-lines/pause.md)
- **Changed**: The line now carries waitingForCredits, as imessage-lines.list describes. 409 imessage_line_down covers a line down because its number stopped working and one down because iMessage refused every text from it for a day. Its message now reads "This line is down, so it can't be cancelled now. It is not billed while it is down, and Kenso releases it by itself after 7 days and refunds those days." (it said "This line is disconnected, ..."). Read the line's downReason, not the message. Needs the imessage feature, which is off for every workspace for now. - [`imessage-lines.cancel`](/docs/api/imessage-lines/cancel.md)
- **Changed**: The returned line now carries waitingForCredits. An order the workspace's paid credits (free credits too, where Kenso staff allowed them for the workspace) do not cover is still refused 402 with error.refusal. An order they cover is handed to Kenso's buyer at once, can take up to 24 hours to set up, turns active once bought and is charged its first month then; if those credits no longer cover that month by then, the line is paused unpaid (pausedReason unpaid) until a top-up pays it and is released if it is still unpaid 14 days later. An order whose cover is gone by the time Kenso hands it over (another order placed at the same time took the credits, or they were spent first) is not bought: it stays ordered with waitingForCredits true, Today tells the workspace's billing members, and Kenso buys it once a top-up covers it. The docs now list the 400 validation_failed answers: a missing or over-long Idempotency-Key (details[0].field Idempotency-Key, code required or too_long), a missing body, a country other than US or UK, or no ownerMemberId from a caller that is not a member. An owner who is a network member is 400 owner_not_member with error.details[0].code network_member, a workspace that is closing is 409 workspace_closing, and while Kenso is not taking line orders a new order is 503 service_unavailable and nothing is ordered. Needs the imessage feature, which is off for every workspace for now. - [`imessage-lines.order`](/docs/api/imessage-lines/order.md)
- **Changed**: kind infra now prices imessage_line_monthly, an iMessage line at 15,000 credits a month. Free and bonus credits cannot pay it unless the workspace is exempt or Kenso staff allowed its free credits for them (inboxDomainEligibleMillicredits is then the whole balance), so sufficient is false when inboxDomainEligibleMillicredits does not cover the inbox, domain and iMessage line items. Ordering a line needs the imessage feature, which is off for every workspace for now. - [`credit-estimates.create`](/docs/api/credit-estimates/create.md)
- **Changed**: While the workspace's imessage feature is on, allCount, accountsCount, toReplyCount, unreadCount, latestMessageAt and inboxChangedAt include iMessage threads (their people with groupBy=person); campaignsCount and campaigns never do. Needs the imessage feature, which is off for every workspace for now. - [`threads.counts`](/docs/api/threads/counts.md)
- **Changed**: While the workspace's imessage feature is on, every unread iMessage conversation is marked read too, in Kenso only, and counts in updatedCount. Needs the imessage feature, which is off for every workspace for now. - [`threads.mark-all-read`](/docs/api/threads/mark-all-read.md)
- **Changed**: On an iMessage thread, reminderAt is 400 validation_failed (iMessage threads take no reminders), interest needs a text from the person on the thread (400 validation_failed otherwise, with error.details[0].code imessage_no_inbound on interest), and a newer text that arrives before the write is 400 validation_failed with error.details[0].code imessage_newer_text on interest, with neither the interest nor the other fields changed: reload the thread and set interest again in a new request, with a new Idempotency-Key or none (the same key replays this answer for 24 hours). Needs the imessage feature, which is off for every workspace for now. - [`threads.update`](/docs/api/threads/update.md)
- **Changed**: On an iMessage thread, images go only with a text: mediaIds with a blank body is 400 validation_failed on body. subject, to, cc, bcc, replyAll, attachmentIds, contentType, voiceProvider, voiceId and imageIds are each 400 validation_failed on that field. A text before the person replied that holds a link, an email address, a phone number or a money amount is 400 with error.details[0].code first_message_content. Retrying an outcome_unknown text with the same Idempotency-Key after nextAllowedAt answers 201 when it went, 503 imessage_reply_not_sent when it never went (the key is free again: send it under the same key or a new one), 409 outcome_unknown again with a later nextAllowedAt while Kenso cannot read the thread, or 404 / 409 invalid_state imessage_line_gone when the thread or its line is gone. While iMessage sending is paused, that retry answers 503 with error.details[0].code imessage_first_try_unknown on threadId instead: it sent nothing, but the first try may have gone out, so read the thread or retry later under the same key; a key whose text went or waits for approval answers that 201 or 202 again. A body over 4,096 characters is 400 validation_failed with error.details[0].code imessage_text_too_long on body, and nothing is sent. Needs the imessage feature, which is off for every workspace for now. - [`threads.create-message`](/docs/api/threads/create-message.md)
- **Changed**: On an iMessage thread it is 400 validation_failed on threadId, an empty body included: iMessage threads keep no draft. Needs the imessage feature, which is off for every workspace for now. - [`threads.replace-draft`](/docs/api/threads/replace-draft.md)
- **Changed**: An iMessage thread has no draft: 404. Needs the imessage feature, which is off for every workspace for now. - [`threads.get-draft`](/docs/api/threads/get-draft.md)
- **Changed**: A reaction that is not love, like, dislike, laugh, emphasize, question or one emoji is 400 validation_failed with error.details[0].code invalid on reaction. Needs the imessage feature, which is off for every workspace for now. - [`threads.react-message`](/docs/api/threads/react-message.md)
- **Changed**: The 402 with error.refusal also counts 15,000 credits for every live line whose month went unpaid, besides this line and every ordered line that is not live yet. Kenso buys an ordered line only while the paid credits (free credits too, where Kenso staff allowed them) cover it after the workspace's older orders and unpaid line months; until then it stays ordered. Needs the imessage feature, which is off for every workspace for now. - [`imessage-lines.order`](/docs/api/imessage-lines/order.md)
- **Changed**: An iMessage thread's contactId is now its person's newest contact (null when the person has none), as on a WhatsApp thread. Needs the imessage feature, which is off for every workspace for now. - [`threads.get`](/docs/api/threads/get.md)
- **Changed**: iMessage rows now carry contactId, their person's newest contact (null when the person has none), as WhatsApp rows do. Needs the imessage feature, which is off for every workspace for now. - [`threads.list`](/docs/api/threads/list.md)
- **Changed**: On an iMessage thread, interest unsubscribe opts the number out of texts, as the person's own STOP does, so Kenso texts it no more, and a later interest does not undo it. Kenso checks that the thread exists and holds a text from the person before it writes the opt-out, so a thread already gone when Kenso checks it (404) or with no text from the person (400, imessage_no_inbound) gets none. The opt-out is written before the interest: a text or a delete that lands while it is written answers 400 (detail imessage_newer_text) or 404, and the opt-out stands. If the opt-out cannot be written, the answer is 500 internal_error and the interest is not stored, but part of the opt-out may already stand. personId on an iMessage thread is 400 validation_failed: its person comes from its number. An iMessage thread's contactId is its person's newest contact. Needs the imessage feature, which is off for every workspace for now. - [`threads.update`](/docs/api/threads/update.md)
- **Changed**: On an iMessage thread, interest unsubscribe opts the number out of texts, as on threads.update; a thread whose opt-out cannot be written is listed in failed with internal_error, and part of its opt-out may already stand. A thread already gone when Kenso checks it (not_found), or with no text from the person (validation_failed, error.details[0].code imessage_no_inbound), fails before its opt-out and gets none; one that a new text or a delete reaches while its opt-out is written fails (validation_failed with error.details[0].code imessage_newer_text, or not_found) and keeps the opt-out. Needs the imessage feature, which is off for every workspace for now. - [`threads.bulk-update`](/docs/api/threads/bulk-update.md)
- **Changed**: An order now needs paid credits (free credits too, where Kenso staff allowed them for the workspace) for the first month of every line still on order plus the new one (15,000 credits each), else 402 with error.refusal. Kenso buys an ordered line only while those credits cover it; until then it stays ordered. Needs the imessage feature, which is off for every workspace for now. - [`imessage-lines.order`](/docs/api/imessage-lines/order.md)
- **Changed**: A member's iMessage reply in a thread where the person has written is no longer refused with 409 do_not_call when a data provider flagged the person do not call. It is still 409 invalid_state with error.details[0].code phone_opt_out for a STOP on the number or the person's own opt-out of texts, and with suppressed:<reason> for the blocklist, do-not-contact or an unsubscribe. An agent's or API key's reply, and a member's text on a thread where the person has not written, are still 409 do_not_call. Needs the imessage feature, which is off for every workspace for now. - [`threads.create-message`](/docs/api/threads/create-message.md)
- **Changed**: A member's tapback on an iMessage text is no longer refused with 409 do_not_call when a data provider flagged the person do not call. It is still 409 invalid_state with error.details[0].code phone_opt_out for a STOP on the number or the person's own opt-out of texts, and with suppressed:<reason> for the blocklist, do-not-contact or an unsubscribe. An agent's or API key's tapback is still 409 do_not_call. Needs the imessage feature, which is off for every workspace for now. - [`threads.react-message`](/docs/api/threads/react-message.md)

Optional fields added on 16 operations:

- **Changed**: Added optional field `data.sendAsPlainText` to the campaigns.archive response. - [`campaigns.archive`](/docs/api/campaigns/archive.md)
- **Changed**: Added optional field `data.sendAsPlainText` to the campaigns.clear-launch-schedule response. - [`campaigns.clear-launch-schedule`](/docs/api/campaigns/clear-launch-schedule.md)
- **Changed**: Added optional field `data.sendAsPlainText` to the campaigns.create response. - [`campaigns.create`](/docs/api/campaigns/create.md)
- **Changed**: Added optional field `data.sendAsPlainText` to the campaigns.duplicate response. - [`campaigns.duplicate`](/docs/api/campaigns/duplicate.md)
- **Changed**: Added optional field `data.sendAsPlainText` to the campaigns.get response. - [`campaigns.get`](/docs/api/campaigns/get.md)
- **Changed**: Added optional field `data.sendAsPlainText` to the campaigns.launch response. - [`campaigns.launch`](/docs/api/campaigns/launch.md)
- **Changed**: Added optional field `data[].sendAsPlainText` to the campaigns.list response. - [`campaigns.list`](/docs/api/campaigns/list.md)
- **Changed**: Added optional field `data.sendAsPlainText` to the campaigns.pause response. - [`campaigns.pause`](/docs/api/campaigns/pause.md)
- **Changed**: Added optional field `data.sendAsPlainText` to the campaigns.restart response. - [`campaigns.restart`](/docs/api/campaigns/restart.md)
- **Changed**: Added optional field `data.sendAsPlainText` to the campaigns.resume response. - [`campaigns.resume`](/docs/api/campaigns/resume.md)
- **Changed**: Added optional field `data.sendAsPlainText` to the campaigns.set-launch-schedule response. - [`campaigns.set-launch-schedule`](/docs/api/campaigns/set-launch-schedule.md)
- **Changed**: Added optional field `data.sendAsPlainText` to the campaigns.unarchive response. - [`campaigns.unarchive`](/docs/api/campaigns/unarchive.md)
- **Changed**: Added optional field `sendAsPlainText` to the campaigns.update request. Added optional field `data.sendAsPlainText` to the campaigns.update response. - [`campaigns.update`](/docs/api/campaigns/update.md)
- **Changed**: Added optional field `data.quoteDroppedReason` to the threads.create response. - [`threads.create`](/docs/api/threads/create.md)
- **Changed**: Added optional field `data.quoteDroppedReason` to the threads.create-message 201 response. - [`threads.create-message`](/docs/api/threads/create-message.md)
- **Changed**: Added optional field `data[].quoteDroppedReason` to the threads.list-messages response. - [`threads.list-messages`](/docs/api/threads/list-messages.md)

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