Update a thread's state
Sets a thread’s status (open, done or snoozed with snoozed_until, up to 90 days ahead), assignee, priority or tags. Send only what changes. A customer writing again reopens a done or snoozed thread.
Scopes: inbox:write
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"
Body
open | done | snoozed
When a snooze ends (with status: snoozed).
Assign to this teammate; null unassigns.
64urgent | high | normal | low
Replaces the thread's tags.
20Response
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.