Skip to main content
POST
Mark a thread read

Authorizations

Authorization
string
header
required

An API key from Settings → API keys, sent as Authorization: Bearer kb_live_…. A workspace key starts kb_; a personal key starts kbp_ and acts as its owner.

Headers

Idempotency-Key
string
required

A unique key (a UUID works) for this request. Retrying with the same key returns the first answer instead of running twice.

Maximum string length: 255
Kallabot-Version
enum<string>

The API version to answer as, a date (YYYY-MM-DD). Leave it out for the current version (2026-11-07). An unknown version is refused with 400 unsupported_api_version.

Available options:
2026-11-07
Example:

"2026-11-07"

Path Parameters

channel
string
required
thread_id
string
required

Response

Successful Response

channel
enum<string>
required

The chat channel.

Available options:
whatsapp,
messenger,
instagram,
web
id
string
required

The thread id (unique within its channel).

connection
NamedRef · object
required

The channel connection it came in on.

contact
ThreadContact · object
required
state
ThreadState · object
required
unread_count
integer
required

Customer messages not read yet.

window
ThreadWindow · object
required
agent
NamedRef · object | null

The agent answering it.

handled_by
string | null

agent or human: who replies now.

handler
PersonRef · object | null

The teammate who took it over.

handover_reason
string | null

Why it was handed to a person.

handover_at
string | null

When.

summary
ThreadSummary · object | null
closed_at
string | null

When the chat session ended.

last_message
ThreadLastMessage · object | null
last_activity_at
string | null

The latest message or change.

created_at
string | null

ISO 8601.