Kenso API changes on 2026-11-12
Every change on this day, by version. The changelog lists the newest days and links the older ones.
Version 2026-11-02
2026-11-12 45 changes
- Added
tags.assign
Accepts an optional Idempotency-Key header (at most 200 characters, per workspace). A retry with the same key and the same request within 24 hours returns the first response, with Idempotent-Replayed: true, and does not run the write again. The same key with a different request is 422 idempotency_key_reused. - Added
tags.bulk-assign
Accepts an optional Idempotency-Key header (at most 200 characters, per workspace). A retry with the same key and the same request within 24 hours returns the first response, with Idempotent-Replayed: true, and does not run the write again. The same key with a different request is 422 idempotency_key_reused. - Added
tags.bulk-unassign
Accepts an optional Idempotency-Key header (at most 200 characters, per workspace). A retry with the same key and the same request within 24 hours returns the first response, with Idempotent-Replayed: true, and does not run the write again. The same key with a different request is 422 idempotency_key_reused. - Added
tags.unassign
Accepts an optional Idempotency-Key header (at most 200 characters, per workspace). A retry with the same key and the same request within 24 hours returns the first response, with Idempotent-Replayed: true, and does not run the write again. The same key with a different request is 422 idempotency_key_reused. - Changed
analytics.get-campaign-performance
Added optional field opensTracked to the metrics of the analytics.get-campaign-performance response (window metrics and rows). false means the campaign sends as plain text or has Track opens off, so its openRate is not a real rate: opens are partial, not none. Omitted when the call spans campaigns or the value is unknown; treat omitted like true. - Changed
campaigns.list-inboxes
Added optional fieldsdata[].health.notes,data[].health.notes[].kind,data[].health.notes[].reasonanddata[].health.notes[].untilto the campaigns.list-inboxes response. health.blocks no longer lists an automatic pause that holds no send (any pause Kenso opened itself, such as after a placement test, bounces, complaints or a domain breach, while capacity limits are not enforced); it shows as a health.notes item with kind sending_pause_observed. An operator's pause still shows as a sending_paused block. - Changed
campaigns.replace-inboxes
Added optional fieldsdata[].health.notes,data[].health.notes[].kind,data[].health.notes[].reasonanddata[].health.notes[].untilto the campaigns.replace-inboxes response. health.blocks no longer lists an automatic pause that holds no send (any pause Kenso opened itself, such as after a placement test, bounces, complaints or a domain breach, while capacity limits are not enforced); it shows as a health.notes item with kind sending_pause_observed. An operator's pause still shows as a sending_paused block. - Changed
inboxes.create
Added optional fieldsdata.health.notes,data.health.notes[].kind,data.health.notes[].reasonanddata.health.notes[].untilto the inboxes.create response. health.blocks no longer lists an automatic pause that holds no send (any pause Kenso opened itself, such as after a placement test, bounces, complaints or a domain breach, while capacity limits are not enforced); it shows as a health.notes item with kind sending_pause_observed. An operator's pause still shows as a sending_paused block. - Changed
inboxes.disconnect
Added optional fieldsdata.health.notes,data.health.notes[].kind,data.health.notes[].reasonanddata.health.notes[].untilto the inboxes.disconnect response. health.blocks no longer lists an automatic pause that holds no send (any pause Kenso opened itself, such as after a placement test, bounces, complaints or a domain breach, while capacity limits are not enforced); it shows as a health.notes item with kind sending_pause_observed. An operator's pause still shows as a sending_paused block. - Changed
inboxes.get
Added optional fieldsdata.health.notes,data.health.notes[].kind,data.health.notes[].reasonanddata.health.notes[].untilto the inboxes.get response. health.blocks no longer lists an automatic pause that holds no send (any pause Kenso opened itself, such as after a placement test, bounces, complaints or a domain breach, while capacity limits are not enforced); it shows as a health.notes item with kind sending_pause_observed. An operator's pause still shows as a sending_paused block. - Changed
inboxes.list
Added optional fieldsdata[].health.notes,data[].health.notes[].kind,data[].health.notes[].reasonanddata[].health.notes[].untilto the inboxes.list response. health.blocks no longer lists an automatic pause that holds no send (any pause Kenso opened itself, such as after a placement test, bounces, complaints or a domain breach, while capacity limits are not enforced); it shows as a health.notes item with kind sending_pause_observed. An operator's pause still shows as a sending_paused block. - Changed
inboxes.rename
Added optional fieldsdata.inbox.health.notes,data.inbox.health.notes[].kind,data.inbox.health.notes[].reasonanddata.inbox.health.notes[].untilto the inboxes.rename response. health.blocks no longer lists an automatic pause that holds no send (any pause Kenso opened itself, such as after a placement test, bounces, complaints or a domain breach, while capacity limits are not enforced); it shows as a health.notes item with kind sending_pause_observed. An operator's pause still shows as a sending_paused block. - Changed
inboxes.update
Added optional fieldsdata.health.notes,data.health.notes[].kind,data.health.notes[].reasonanddata.health.notes[].untilto the inboxes.update response. health.blocks no longer lists an automatic pause that holds no send (any pause Kenso opened itself, such as after a placement test, bounces, complaints or a domain breach, while capacity limits are not enforced); it shows as a health.notes item with kind sending_pause_observed. An operator's pause still shows as a sending_paused block. - Changed
inboxes.verify
Added optional fieldsdata.health.notes,data.health.notes[].kind,data.health.notes[].reasonanddata.health.notes[].untilto the inboxes.verify response. health.blocks no longer lists an automatic pause that holds no send (any pause Kenso opened itself, such as after a placement test, bounces, complaints or a domain breach, while capacity limits are not enforced); it shows as a health.notes item with kind sending_pause_observed. An operator's pause still shows as a sending_paused block. - Added
agent-sandbox-connections.list
Added agent-sandbox-connections.list (GET /v1/agent-sandbox/connections): the six agent CLIs in your own Kenso sandbox, each connected or not_connected, with connectedAt and lastRunAt. Behind the agent_work and agent_sandboxes features. - Added
agent-sandbox-connections.disconnect
Added agent-sandbox-connections.disconnect (DELETE /v1/agent-sandbox/connections/{agent}): logs an agent CLI out in your own Kenso sandbox; with no agent left connected the sandbox is deleted. 409 run_active while a sandbox run is live. Behind the agent_work and agent_sandboxes features. - Added
agent-sandbox-runs.create
Added agent-sandbox-runs.create: estimate a run of the caller's own Kenso sandbox, which works the agent work queue with the coding agent they connected (estimateOnly: true answers 200 with the estimate and creates nothing), or hold its ceiling in credits and queue the run (202 with the run). Available to workspaces with agent sandboxes turned on. - Added
agent-sandbox-runs.list
Added agent-sandbox-runs.list: the caller's own sandbox runs in the workspace, newest first, with cursor pagination (limit 1 to 50, default 20); active=true lists only live runs. Available to workspaces with agent sandboxes turned on. - Added
agent-sandbox-runs.get
Added agent-sandbox-runs.get: one of the caller's sandbox runs with its progress (accepted and rejected answers, waiting items, minutes and credits so far, the billed ones once it ended). Available to workspaces with agent sandboxes turned on. - Added
agent-sandbox-runs.cancel
Added agent-sandbox-runs.cancel: asks Kenso to stop one of the caller's sandbox runs and answers with the run; a queued run ends without starting and is not charged, a running one stops and is charged the minutes it ran. Available to workspaces with agent sandboxes turned on. - Changed
agent-sandbox-runs.create
Added optional field data.stopRequestedAt to the agent-sandbox-runs.create 202 response: when the person asked to stop the run, null until then. - Added
agent-sandbox-auto-run-settings.get
Added agent-sandbox-auto-run-settings.get: read whether Kenso may start the caller's own Kenso sandbox by itself in this workspace (enabled and agent), and the workspace's monthly credit cap on those automatic runs and how long work waits before one starts. Available to workspaces with agent sandboxes turned on. - Added
agent-sandbox-auto-run-settings.update
Added agent-sandbox-auto-run-settings.update: turn the caller's own automatic sandbox runs on or off in this workspace, or change the agent Kenso starts. Turning on needs that agent connected in the caller's Kenso sandbox. Available to workspaces with agent sandboxes turned on. - Added
agent-sandbox-auto-run-settings.update-workspace
Added agent-sandbox-auto-run-settings.update-workspace: set the workspace's monthly credit cap on automatic sandbox runs (0 to 100000; 0 starts none) and how long work waits before Kenso starts a sandbox (15 to 1440 minutes). Requires the workspace settings permission. Available to workspaces with agent sandboxes turned on.
Optional fields added on 21 operations
- Changed
triggers.create
Added optional fielddata.listeningIdleReasonto the triggers.create response. - Changed
triggers.get
Added optional fielddata.listeningIdleReasonto the triggers.get response. - Changed
triggers.list
Added optional fielddata[].listeningIdleReasonto the triggers.list response. - Changed
triggers.list-linkedin-engagements
Added optional fieldsdata[].sourceKindanddata[].topicto the triggers.list-linkedin-engagements response. - Changed
triggers.update
Added optional fielddata.listeningIdleReasonto the triggers.update response. - Changed
contacts.get
Added optional fielddata.linkedInSendBlockedReasonto the contacts.get response. - Changed
contacts.list
Added optional fielddata[].linkedInSendBlockedReasonto the contacts.list response. - Changed
contacts.search
Added optional fielddata[].linkedInSendBlockedReasonto the contacts.search response. - Changed
contacts.update
Added optional fielddata.linkedInSendBlockedReasonto the contacts.update response. - Changed
linkedin-sequences.get
Added optional fielddata.steps[].warningsto the linkedin-sequences.get response. - Changed
linkedin-sequences.replace
Added optional fielddata.steps[].warningsto the linkedin-sequences.replace response. - Changed
linkedin-sequences.save-version
Added optional fielddata.sequence.steps[].warningsto the linkedin-sequences.save-version response. - Changed
segment-linkedin-sequences.get
Added optional fielddata.steps[].warningsto the segment-linkedin-sequences.get response. - Changed
segment-linkedin-sequences.replace
Added optional fielddata.steps[].warningsto the segment-linkedin-sequences.replace response. - Changed
segment-linkedin-sequences.save-version
Added optional fielddata.sequence.steps[].warningsto the segment-linkedin-sequences.save-version response. - Changed
domains.get
Added optional fielddata.providerHostedto the domains.get response. - Changed
domains.list
Added optional fielddata[].providerHostedto the domains.list response. - Changed
domains.update
Added optional fielddata.providerHostedto the domains.update response. - Changed
custom-variables.create
Added optional fielddata.aiOnlyto the custom-variables.create response. - Changed
custom-variables.list
Added optional fielddata[].aiOnlyto the custom-variables.list response. - Changed
custom-variables.update
Added optional fielddata.aiOnlyto the custom-variables.update response.