Skip to main content
POST
Persist an agent conversation turn

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Path Parameters

id
string
required

Identifier of the agent that handled the conversation.

Body

application/json
conversation_id
string
required

Stable identifier for the conversation being persisted.

messages
object[]
required

Ordered message log for the conversation.

tokens_used
integer
default:0
Required range: x >= 0
channel
string
default:api

Channel the conversation ran on (defaults to "api").

escalated
boolean

Set true when the turn tripped an escalation trigger.

escalation_reason
string | null
escalation_category
string | null

Response

200 - application/json

The conversation was persisted.

data
object
meta
object