Get an inbox thread
Returns one thread with its state, assignee and who is handling it. channel is whatsapp, messenger, instagram or web.
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
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.
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.