Skip to Content

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.

45 changesRSS feed
Markdown

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 fields data[].health.notes, data[].health.notes[].kind, data[].health.notes[].reason and data[].health.notes[].until to 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 fields data[].health.notes, data[].health.notes[].kind, data[].health.notes[].reason and data[].health.notes[].until to 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 fields data.health.notes, data.health.notes[].kind, data.health.notes[].reason and data.health.notes[].until to 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 fields data.health.notes, data.health.notes[].kind, data.health.notes[].reason and data.health.notes[].until to 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 fields data.health.notes, data.health.notes[].kind, data.health.notes[].reason and data.health.notes[].until to 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 fields data[].health.notes, data[].health.notes[].kind, data[].health.notes[].reason and data[].health.notes[].until to 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 fields data.inbox.health.notes, data.inbox.health.notes[].kind, data.inbox.health.notes[].reason and data.inbox.health.notes[].until to 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 fields data.health.notes, data.health.notes[].kind, data.health.notes[].reason and data.health.notes[].until to 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 fields data.health.notes, data.health.notes[].kind, data.health.notes[].reason and data.health.notes[].until to 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 field data.listeningIdleReason to the triggers.create response.
  • Changed triggers.get
    Added optional field data.listeningIdleReason to the triggers.get response.
  • Changed triggers.list
    Added optional field data[].listeningIdleReason to the triggers.list response.
  • Changed triggers.list-linkedin-engagements
    Added optional fields data[].sourceKind and data[].topic to the triggers.list-linkedin-engagements response.
  • Changed triggers.update
    Added optional field data.listeningIdleReason to the triggers.update response.
  • Changed contacts.get
    Added optional field data.linkedInSendBlockedReason to the contacts.get response.
  • Changed contacts.list
    Added optional field data[].linkedInSendBlockedReason to the contacts.list response.
  • Changed contacts.search
    Added optional field data[].linkedInSendBlockedReason to the contacts.search response.
  • Changed contacts.update
    Added optional field data.linkedInSendBlockedReason to the contacts.update response.
  • Changed linkedin-sequences.get
    Added optional field data.steps[].warnings to the linkedin-sequences.get response.
  • Changed linkedin-sequences.replace
    Added optional field data.steps[].warnings to the linkedin-sequences.replace response.
  • Changed linkedin-sequences.save-version
    Added optional field data.sequence.steps[].warnings to the linkedin-sequences.save-version response.
  • Changed segment-linkedin-sequences.get
    Added optional field data.steps[].warnings to the segment-linkedin-sequences.get response.
  • Changed segment-linkedin-sequences.replace
    Added optional field data.steps[].warnings to the segment-linkedin-sequences.replace response.
  • Changed segment-linkedin-sequences.save-version
    Added optional field data.sequence.steps[].warnings to the segment-linkedin-sequences.save-version response.
  • Changed domains.get
    Added optional field data.providerHosted to the domains.get response.
  • Changed domains.list
    Added optional field data[].providerHosted to the domains.list response.
  • Changed domains.update
    Added optional field data.providerHosted to the domains.update response.
  • Changed custom-variables.create
    Added optional field data.aiOnly to the custom-variables.create response.
  • Changed custom-variables.list
    Added optional field data[].aiOnly to the custom-variables.list response.
  • Changed custom-variables.update
    Added optional field data.aiOnly to the custom-variables.update response.

More