Skip to Content

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.

34 changesRSS feed
Markdown

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 field source to the campaigns.create request.
  • Changed campaigns.list-inboxes
    Added optional field data[].renewalEndsWindowEarly to the campaigns.list-inboxes response.
  • Changed campaigns.replace-inboxes
    Added optional field data[].renewalEndsWindowEarly to the campaigns.replace-inboxes response.
  • Changed inboxes.create
    Added optional field data.renewalEndsWindowEarly to the inboxes.create response.
  • Changed inboxes.disconnect
    Added optional field data.renewalEndsWindowEarly to the inboxes.disconnect response.
  • Changed inboxes.get
    Added optional field data.renewalEndsWindowEarly to the inboxes.get response.
  • Changed inboxes.list
    Added optional field data[].renewalEndsWindowEarly to the inboxes.list response.
  • Changed inboxes.rename
    Added optional field data.inbox.renewalEndsWindowEarly to the inboxes.rename response.
  • Changed inboxes.update
    Added optional field data.renewalEndsWindowEarly to the inboxes.update response.
  • Changed inboxes.verify
    Added optional field data.renewalEndsWindowEarly to the inboxes.verify response.
  • Changed email-sequences.preview
    Added optional field data.steps[].sendsPlainText to the email-sequences.preview response.
  • Changed segment-email-sequences.preview
    Added optional field data.steps[].sendsPlainText to the segment-email-sequences.preview response.
  • Changed segment-email-sequences.test-send
    Added optional field providerTrack to the segment-email-sequences.test-send request.

More