conversation
Log Conversation
Logs a new conversation or updates an existing one with new messages. Always include all messages.
POST
/
conversations
Authorizations
Authorization
string
headerrequiredBearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
application/json
id
string | null
externalId
string | null
externalUrl
string | null
type
enum<string>
requiredAvailable options:
openai
createdAt
string | null
updatedAt
string | null
projectId
string | null
integrationId
string | null
properties
object
A customizable collection of custom properties or attributes.
userProperties
object
A customizable collection of custom properties or attributes.
tags
string[] | null
messages
object[]
requiredThe messages in the conversation. Must be at least one message.
Response
200 - application/json
id
string
requiredexternalId
string | null
externalUrl
string | null
type
enum<string>
requiredAvailable options:
openai
createdAt
string
requiredupdatedAt
string
requiredprojectId
string | null
integrationId
string | null
properties
object
A customizable collection of custom properties or attributes.
userProperties
object
A customizable collection of custom properties or attributes.
tags
string[] | null
messages
object[]
requiredThe messages in the conversation. Must be at least one message.
messagesOpenAIFormat
object[]
required