Skip to main content
POST
Create a conversation

Authorizations

Authorization
string
header
required

Personal Access Token. Send as Authorization: Bearer hq_pat_....

Body

application/json
agent_id
string<uuid>
required

The agent the user picked in the modal. Tenant-scoped: we refuse to create against an agent_id that doesn't live in the caller's workspace.

Response

New web conversation created

adapter_conv_id
string
required
agent_id
string<uuid>
required
channel_kind
string
required
channel_thread
string
required
id
string<uuid>
required