Mark a thread read
Marks the thread’s messages as read and returns the thread.
Scopes: inbox:read
Authorizations
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
A unique key (a UUID works) for this request. Retrying with the same key returns the first answer instead of running twice.
255The 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.
2026-11-07 "2026-11-07"
Response
Successful Response
The chat channel.
whatsapp, messenger, instagram, web The thread id (unique within its channel).
The channel connection it came in on.
Customer messages not read yet.
The agent answering it.
agent or human: who replies now.
The teammate who took it over.
Why it was handed to a person.
When.
When the chat session ended.
The latest message or change.
ISO 8601.