> Kenso API docs in Markdown. Index of every page: [/docs/llms.txt](/docs/llms.txt). Search: `/docs/search.md?q=<words>`. OpenAPI: [/docs/api/threads/openapi.json](/docs/api/threads/openapi.json). CLI docs offline: `kenso docs <topic>`.
> Last updated: 2026-11-22.

# Threads

> **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.

Inbox threads across email and LinkedIn: count and list them, read messages, reply, forward, update in bulk and keep drafts.

Inbox. 17 endpoints under `https://api.ken.so`. Every request sends `Authorization: Bearer <your API key>` and `Ken-Version: 2026-11-02`: see [Authentication](/docs/authentication.md), [Workspaces](/docs/workspaces.md) and [Errors](/docs/errors.md). OpenAPI for this resource only: [/docs/api/threads/openapi.json](/docs/api/threads/openapi.json).

- `GET /v1/threads` - List threads (`threads.list`): [/docs/api/threads/list.md](/docs/api/threads/list.md)
- `POST /v1/threads` - Start an email thread (`threads.create`): [/docs/api/threads/create.md](/docs/api/threads/create.md)
- `GET /v1/threads/{threadId}` - Get a thread (`threads.get`): [/docs/api/threads/get.md](/docs/api/threads/get.md)
- `PATCH /v1/threads/{threadId}` - Update a thread (`threads.update`): [/docs/api/threads/update.md](/docs/api/threads/update.md)
- `GET /v1/threads/counts` - Count threads by tab (`threads.counts`): [/docs/api/threads/counts.md](/docs/api/threads/counts.md)
- `POST /v1/threads/mark-all-read` - Mark all threads read (`threads.mark-all-read`): [/docs/api/threads/mark-all-read.md](/docs/api/threads/mark-all-read.md)
- `POST /v1/threads/bulk-update` - Update many threads (`threads.bulk-update`): [/docs/api/threads/bulk-update.md](/docs/api/threads/bulk-update.md)
- `GET /v1/threads/{threadId}/messages` - List a thread's messages (`threads.list-messages`): [/docs/api/threads/list-messages.md](/docs/api/threads/list-messages.md)
- `POST /v1/threads/{threadId}/messages` - Send a reply in a thread (`threads.create-message`): [/docs/api/threads/create-message.md](/docs/api/threads/create-message.md)
- `GET /v1/threads/{threadId}/draft` - Get a thread's draft (`threads.get-draft`): [/docs/api/threads/get-draft.md](/docs/api/threads/get-draft.md)
- `PUT /v1/threads/{threadId}/draft` - Replace a thread's draft (`threads.replace-draft`): [/docs/api/threads/replace-draft.md](/docs/api/threads/replace-draft.md)
- `DELETE /v1/threads/{threadId}/draft` - Delete a thread's draft (`threads.delete-draft`): [/docs/api/threads/delete-draft.md](/docs/api/threads/delete-draft.md)
- `POST /v1/threads/{threadId}/images` - Upload an image for a Facebook reply (`threads.create-image`): [/docs/api/threads/create-image.md](/docs/api/threads/create-image.md)
- `POST /v1/threads/{threadId}/forward` - Forward an email thread (`threads.forward`): [/docs/api/threads/forward.md](/docs/api/threads/forward.md)
- `PUT /v1/threads/{threadId}/messages/{messageId}/reaction` - React to a received iMessage text (`threads.react-message`): [/docs/api/threads/react-message.md](/docs/api/threads/react-message.md)
- `GET /v1/threads/{threadId}/messages/{messageId}/attachments/{index}` - Download a received iMessage attachment (`threads.get-message-attachment`): [/docs/api/threads/get-message-attachment.md](/docs/api/threads/get-message-attachment.md)
- `GET /v1/threads/messages` - List the messages of several threads (`threads.batch-messages`): [/docs/api/threads/batch-messages.md](/docs/api/threads/batch-messages.md)

This resource is too large for one page. Each endpoint above links to its own page with its parameters, fields, nested types, a curl request and an example response.

All resources: [/docs.md](/docs.md).
