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

> **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-14 (34 changes)

- **Added**: Added agent-permission-settings.get: read what Ken may do on its own in the workspace, per action (send email, send LinkedIn messages, research accounts, scan for signals, build assets, run CRM workflows, book meetings): asks first or runs on its own. Available to workspaces with Ken agent permissions turned on. - [`agent-permission-settings.get`](/docs/api/agent-permission-settings/get.md)
- **Added**: Added agent-permission-settings.update: set whether Ken asks first or runs on its own for the actions named. Only the actions named change, each change is recorded in the audit log, and only a person in the Kenso app can let Ken send without approval. Needs the workspace settings permission. Available to workspaces with Ken agent permissions turned on. - [`agent-permission-settings.update`](/docs/api/agent-permission-settings/update.md)
- **Added**: Added GET /v1/campaigns/{campaignId}/agent-work: whether Kenso's AI or the workspace's own agent writes the campaign's personalization (its override, null to follow the workspace), behind the agent_work feature. - [`campaigns.get-agent-work`](/docs/api/campaigns/get-agent-work.md)
- **Added**: Added PATCH /v1/campaigns/{campaignId}/agent-work: set a campaign's personalization to kenso_ai or my_agent whatever the workspace setting says, or null to follow the workspace. - [`campaigns.update-agent-work`](/docs/api/campaigns/update-agent-work.md)
- **Changed**: Added optional fields instagramUrl, xUrl, youtubeUrl and githubUrl to the workspaces.get response: the company's profile links, each in one canonical form. A link that is not set is omitted. - [`workspaces.get`](/docs/api/workspaces/get.md)
- **Changed**: Added optional fields instagramUrl, xUrl, youtubeUrl and githubUrl to the workspaces.update request and response: the company's profile links, stored in one canonical form (a twitter.com link becomes https://x.com/{handle}). Null or an empty string clears one. A link that is not a profile on its platform is 400 validation_failed with detail code wrong_platform, not_a_profile or invalid_url on that field. linkedinCompanyUrl is now stored canonical when it is a LinkedIn company, school or showcase page. - [`workspaces.update`](/docs/api/workspaces/update.md)
- **Added**: Added optional query parameter providerTrack to segment-email-sequences.preview. - [`segment-email-sequences.preview`](/docs/api/segment-email-sequences/preview.md)
- **Changed**: The LinkedIn account schema gains the optional safetyHolds field. This response leaves it out: read holds with GET /v1/linkedin-accounts. - [`campaigns.list-linkedin-accounts`](/docs/api/campaigns/list-linkedin-accounts.md)
- **Changed**: The LinkedIn account schema gains the optional safetyHolds field. This response leaves it out: read holds with GET /v1/linkedin-accounts. - [`campaigns.replace-linkedin-accounts`](/docs/api/campaigns/replace-linkedin-accounts.md)
- **Changed**: Each LinkedIn account now carries safetyHolds: the safety holds Kenso has on it right now, each with scope (all_writes, invites or invite_notes), until (UTC), reason and source. Empty when the account has none. - [`linkedin-accounts.get`](/docs/api/linkedin-accounts/get.md)
- **Changed**: Each LinkedIn account now carries safetyHolds: the safety holds Kenso has on it right now, each with scope (all_writes, invites or invite_notes), until (UTC), reason and source. Empty when the account has none. - [`linkedin-accounts.list`](/docs/api/linkedin-accounts/list.md)
- **Changed**: Each LinkedIn account now carries safetyHolds: the safety holds Kenso has on it right now, each with scope (all_writes, invites or invite_notes), until (UTC), reason and source. Empty when the account has none. - [`linkedin-accounts.reset-ramp`](/docs/api/linkedin-accounts/reset-ramp.md)
- **Changed**: Each LinkedIn account now carries safetyHolds: the safety holds Kenso has on it right now, each with scope (all_writes, invites or invite_notes), until (UTC), reason and source. Empty when the account has none. - [`linkedin-accounts.update`](/docs/api/linkedin-accounts/update.md)
- **Added**: Added optional query parameter includeTagIds to campaigns.list. Items carry tagIds only when it is true; without it they omit tagIds. - [`campaigns.list`](/docs/api/campaigns/list.md)
- **Changed**: Added optional field authorSource to the threads.replace-draft request: a person signed in to the app sends agent on an email thread when the draft is a reply Kenso's agent wrote. - [`threads.replace-draft`](/docs/api/threads/replace-draft.md)
- **Changed**: Each credit ledger line can now say what it was for: a plain title, the object it was for (subjectType, subjectId), the web page it read (webUrl, webSite, webPage), what started it (trigger, actorUserId), its workflow and list (workflowId, listId) and which credits paid it (paidFrom, creditGrantId). All but title are optional and omitted on lines written before they were recorded. - [`credit-ledger.list`](/docs/api/credit-ledger/list.md)
- **Changed**: Each credit ledger line now names what it was for, from the line's own workspace: subjectName, actorName, workflowName, listName and campaignName, the Ken chat (chatId, chatTitle, chatMessageCount), the run it belongs to with the run's total on every page (run), and whether its grant is paid or free credits (creditGrantKind). All are optional and omitted when there is nothing to name. - [`credit-ledger.list`](/docs/api/credit-ledger/list.md)
- **Changed**: The spend report now breaks the period down by kind of work (actions, largest first, each with a plain title, net millicredits, amount and lineCount; refunds and write-offs net into the action they corrected) and by campaign (campaigns, largest first, at most 50 plus one row with campaignId null for work tied to no campaign; campaignsTruncated says when more were left out). campaignName is null for a deleted campaign or no campaign. - [`credit-spend.get`](/docs/api/credit-spend/get.md)
- **Changed**: Each rate card row now says how it is priced: pricing is fixed or typical. Rows priced by the work they do (campaign_build, reply_assist, autonomous_reply, ken_chat, translation, podcast_search) are typical, use the units build, reply_draft, reply, chat_turn, translation and podcast_request (a podcast lookup makes one to a few requests), and carry typical: the median price of one unit across Kenso in the last 30 days (millicredits, windowDays, from, to). millicreditsPerUnit on those rows is that median, or 0 while fewer than 20 units were charged; the exact price is on each ledger line. - [`credit-rate-card.get`](/docs/api/credit-rate-card/get.md)
- **Changed**: Added socialPosts to each workspaces item of me.get: whether the caller's own social posts feed that workspace (mode auto, on or off; on; reason). Added the caller's instagramUrl, xUrl, youtubeUrl and githubUrl to me.get, omitted when unset. - [`me.get`](/docs/api/me/get.md)
- **Added**: Added segments.apply-provider-track-to-all: make one provider track's copy of a segment's email sequence the sequence every track sends. - [`segments.apply-provider-track-to-all`](/docs/api/segments/apply-provider-track-to-all.md)

Optional fields added on 13 operations:

- **Changed**: Added optional field `source` to the campaigns.create request. - [`campaigns.create`](/docs/api/campaigns/create.md)
- **Changed**: Added optional field `data[].renewalEndsWindowEarly` to the campaigns.list-inboxes response. - [`campaigns.list-inboxes`](/docs/api/campaigns/list-inboxes.md)
- **Changed**: Added optional field `data[].renewalEndsWindowEarly` to the campaigns.replace-inboxes response. - [`campaigns.replace-inboxes`](/docs/api/campaigns/replace-inboxes.md)
- **Changed**: Added optional field `data.renewalEndsWindowEarly` to the inboxes.create response. - [`inboxes.create`](/docs/api/inboxes/create.md)
- **Changed**: Added optional field `data.renewalEndsWindowEarly` to the inboxes.disconnect response. - [`inboxes.disconnect`](/docs/api/inboxes/disconnect.md)
- **Changed**: Added optional field `data.renewalEndsWindowEarly` to the inboxes.get response. - [`inboxes.get`](/docs/api/inboxes/get.md)
- **Changed**: Added optional field `data[].renewalEndsWindowEarly` to the inboxes.list response. - [`inboxes.list`](/docs/api/inboxes/list.md)
- **Changed**: Added optional field `data.inbox.renewalEndsWindowEarly` to the inboxes.rename response. - [`inboxes.rename`](/docs/api/inboxes/rename.md)
- **Changed**: Added optional field `data.renewalEndsWindowEarly` to the inboxes.update response. - [`inboxes.update`](/docs/api/inboxes/update.md)
- **Changed**: Added optional field `data.renewalEndsWindowEarly` to the inboxes.verify response. - [`inboxes.verify`](/docs/api/inboxes/verify.md)
- **Changed**: Added optional field `data.steps[].sendsPlainText` to the email-sequences.preview response. - [`email-sequences.preview`](/docs/api/email-sequences/preview.md)
- **Changed**: Added optional field `data.steps[].sendsPlainText` to the segment-email-sequences.preview response. - [`segment-email-sequences.preview`](/docs/api/segment-email-sequences/preview.md)
- **Changed**: Added optional field `providerTrack` to the segment-email-sequences.test-send request. - [`segment-email-sequences.test-send`](/docs/api/segment-email-sequences/test-send.md)

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