Skip to main content
GET
Get a conversation

Authorizations

Authorization
string
header
required

An org API key: Authorization: Bearer oak_….

Path Parameters

conversation_id
string
required

Response

Successful Response

id
string
required
channel_kind
enum<string>
required

Connected messaging channel kinds. Stored in channels.kind.

Available options:
whatsapp,
instagram,
messenger,
webchat
channel_id
string
required
external_id
string
required
display_name
string
required
handled_by
enum<string>
required

Who is currently handling a conversation. The AI runs only while ai; while human or whatsapp_app inbound messages bypass the AI and surface in the inbox.

Available options:
ai,
human,
whatsapp_app
status
enum<string>
required

Lifecycle of a conversation. There is no expired value: WhatsApp 24h "expiry" is a derived window state (now - last_inbound_at >= 24h), not a lifecycle status — an expired thread is still open.

Available options:
open,
resolved,
closed
assignee_id
string | null
required
team_id
string | null
required
contact_id
string | null
required
last_inbound_at
string<date-time> | null
required
last_message_at
string<date-time> | null
required
resolved_at
string<date-time> | null
required
created_at
string<date-time>
required
summary
string | null
required
updated_at
string<date-time>
required