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

> **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-04 (20 changes)

- **Breaking**: Fix: data[].status on webhook-deliveries.list is now success, pending or fail, the same values as lastDelivery.status on webhook endpoints and attempt.status on webhook-endpoints.test. It returned capitalized names (Success, Pending, Sending, Fail); Sending is now pending. If you compare status to Success or Fail, compare to success or fail. - [`webhook-deliveries.list`](/docs/api/webhook-deliveries/list.md) Migration: Compare data[].status to the lowercase values success, pending and fail. A delivery that read Sending now reads pending. If your code matched Success, Pending, Sending or Fail exactly, lowercase the value before you compare it, or compare it to the new values; lastDelivery.status on webhook endpoints and attempt.status on webhook-endpoints.test use the same values. This fix shipped inside version 2026-11-02 on 2026-11-04, so every key on that version got it.
- **Added**: Added ai-feedback.create (POST /v1/ai-feedback), which saves or updates the caller's thumbs up or down, with optional reasons and a note, on one piece of Ken's output. It answers 201 for a new rating and 200 for an update, and takes Idempotency-Key. It answers 404 until AI feedback is turned on for the workspace. - [`ai-feedback.create`](/docs/api/ai-feedback/create.md)
- **Added**: Added ai-feedback.delete (DELETE /v1/ai-feedback/{feedbackId}), which clears the caller's rating. A reward already earned stays. It answers 404 until AI feedback is turned on for the workspace. - [`ai-feedback.delete`](/docs/api/ai-feedback/delete.md)
- **Added**: Added ai-feedback.get (GET /v1/ai-feedback/{feedbackId}), which returns the caller's own rating and any credit reward it earned. It answers 404 until AI feedback is turned on for the workspace. - [`ai-feedback.get`](/docs/api/ai-feedback/get.md)
- **Added**: Added ai-feedback.signal (POST /v1/ai-feedback/signals), which records that the caller regenerated a reply draft or suggestion. It answers 404 until AI feedback is turned on for the workspace. - [`ai-feedback.signal`](/docs/api/ai-feedback/signal.md)
- **Changed**: Documentation fix: the reference now names its schemas without their C# type parts (CampaignModel is Campaign, CanonicalPagination is Pagination, and the envelopes are CampaignResponse and CampaignListResponse) and groups its sections in the sidebar under readable names. Only the documentation changed: requests and responses on the wire did not change.

Optional fields added on 14 operations:

- **Changed**: Added optional fields `data.agentJobId` and `data.sentBy` to the threads.create response. - [`threads.create`](/docs/api/threads/create.md)
- **Changed**: Added optional fields `data.agentJobId` and `data.sentBy` to the threads.create-message 201 response. - [`threads.create-message`](/docs/api/threads/create-message.md)
- **Changed**: Added optional field `data.agentJobId` to the threads.get-draft response. - [`threads.get-draft`](/docs/api/threads/get-draft.md)
- **Changed**: Added optional fields `data[].agentJobId` and `data[].sentBy` to the threads.list-messages response. - [`threads.list-messages`](/docs/api/threads/list-messages.md)
- **Changed**: Added optional field `data.agentJobId` to the threads.replace-draft response. - [`threads.replace-draft`](/docs/api/threads/replace-draft.md)
- **Changed**: Added optional fields `data.leadQualityScoreId` and `data.qualificationResponseId` to the contacts.get response. - [`contacts.get`](/docs/api/contacts/get.md)
- **Changed**: Added optional fields `data[].leadQualityScoreId` and `data[].qualificationResponseId` to the contacts.list response. - [`contacts.list`](/docs/api/contacts/list.md)
- **Changed**: Added optional fields `data[].leadQualityScoreId` and `data[].qualificationResponseId` to the contacts.search response. - [`contacts.search`](/docs/api/contacts/search.md)
- **Changed**: Added optional fields `data.leadQualityScoreId` and `data.qualificationResponseId` to the contacts.update response. - [`contacts.update`](/docs/api/contacts/update.md)
- **Changed**: Added optional field `data.id` to the email-copy-grades.grade response. - [`email-copy-grades.grade`](/docs/api/email-copy-grades/grade.md)
- **Changed**: Added optional field `data.steps[].variables[].lineId` to the email-sequences.preview response. - [`email-sequences.preview`](/docs/api/email-sequences/preview.md)
- **Changed**: Added optional field `data.steps[].variables[].lineId` to the segment-email-sequences.preview response. - [`segment-email-sequences.preview`](/docs/api/segment-email-sequences/preview.md)
- **Changed**: Added optional fields `data.demoPersona`, `data.demoPersona.email` and `data.demoPersona.memberId` to the workspaces.get response. - [`workspaces.get`](/docs/api/workspaces/get.md)
- **Changed**: Added optional fields `data.demoPersona`, `data.demoPersona.email` and `data.demoPersona.memberId` to the workspaces.update response. - [`workspaces.update`](/docs/api/workspaces/update.md)

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