Kenso API changes on 2026-11-14
Every change on this day, by version. The changelog lists the newest days and links the older ones.
Version 2026-11-02
2026-11-14 34 changes
- Added
agent-permission-settings.get
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. - Added
agent-permission-settings.update
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. - Added
campaigns.get-agent-work
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. - Added
campaigns.update-agent-work
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. - Changed
workspaces.get
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. - Changed
workspaces.update
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. - Added
segment-email-sequences.preview
Added optional query parameter providerTrack to segment-email-sequences.preview. - Changed
campaigns.list-linkedin-accounts
The LinkedIn account schema gains the optional safetyHolds field. This response leaves it out: read holds with GET /v1/linkedin-accounts. - Changed
campaigns.replace-linkedin-accounts
The LinkedIn account schema gains the optional safetyHolds field. This response leaves it out: read holds with GET /v1/linkedin-accounts. - Changed
linkedin-accounts.get
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. - Changed
linkedin-accounts.list
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. - Changed
linkedin-accounts.reset-ramp
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. - Changed
linkedin-accounts.update
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. - Added
campaigns.list
Added optional query parameter includeTagIds to campaigns.list. Items carry tagIds only when it is true; without it they omit tagIds. - Changed
threads.replace-draft
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. - Changed
credit-ledger.list
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. - Changed
credit-ledger.list
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. - Changed
credit-spend.get
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. - Changed
credit-rate-card.get
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. - Changed
me.get
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. - Added
segments.apply-provider-track-to-all
Added segments.apply-provider-track-to-all: make one provider track's copy of a segment's email sequence the sequence every track sends.
Optional fields added on 13 operations
- Changed
campaigns.create
Added optional fieldsourceto the campaigns.create request. - Changed
campaigns.list-inboxes
Added optional fielddata[].renewalEndsWindowEarlyto the campaigns.list-inboxes response. - Changed
campaigns.replace-inboxes
Added optional fielddata[].renewalEndsWindowEarlyto the campaigns.replace-inboxes response. - Changed
inboxes.create
Added optional fielddata.renewalEndsWindowEarlyto the inboxes.create response. - Changed
inboxes.disconnect
Added optional fielddata.renewalEndsWindowEarlyto the inboxes.disconnect response. - Changed
inboxes.get
Added optional fielddata.renewalEndsWindowEarlyto the inboxes.get response. - Changed
inboxes.list
Added optional fielddata[].renewalEndsWindowEarlyto the inboxes.list response. - Changed
inboxes.rename
Added optional fielddata.inbox.renewalEndsWindowEarlyto the inboxes.rename response. - Changed
inboxes.update
Added optional fielddata.renewalEndsWindowEarlyto the inboxes.update response. - Changed
inboxes.verify
Added optional fielddata.renewalEndsWindowEarlyto the inboxes.verify response. - Changed
email-sequences.preview
Added optional fielddata.steps[].sendsPlainTextto the email-sequences.preview response. - Changed
segment-email-sequences.preview
Added optional fielddata.steps[].sendsPlainTextto the segment-email-sequences.preview response. - Changed
segment-email-sequences.test-send
Added optional fieldproviderTrackto the segment-email-sequences.test-send request.