Skip to main content
POST
Assign a conversation

Authorizations

Authorization
string
header
required

An org API key: Authorization: Bearer oak_….

Path Parameters

conversation_id
string
required

Body

application/json
email
string | null
required

The member to assign, by the email they sign in with. null unassigns.

keep_ai
boolean
default:false

Keep the AI answering. Without it, the member takes the chat over and the AI stops, as when assigning from the inbox.

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,
email
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. resolved is terminal: the contact's next message opens a fresh 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. (closed was dropped by migration 0200: nothing distinguished it from resolved.)

Available options:
open,
resolved
assignee_id
string | null
required

Member id (mbr_…) of the member the conversation is assigned to: id in GET /v1/members.

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