Skip to main content
POST
/
bc
/
v1
/
events
/
event
/
conversation-turn
Conversation turn
curl --request POST \
  --url https://app.mindlytics.ai/bc/v1/events/event/conversation-turn \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'X-App-ID: <api-key>' \
  --data '
{
  "session_id": "<string>",
  "type": "track",
  "event": "Conversation Turn",
  "conversation_id": "<string>",
  "properties": {
    "user": "<string>",
    "assistant": "<string>",
    "assistant_id": "<string>",
    "model": "<string>",
    "prompt_tokens": 123,
    "completion_tokens": 123,
    "cost": 123
  },
  "timestamp": "<string>",
  "user_id": "<string>",
  "device_id": "<string>"
}
'
[
  {
    "type": "start_session"
  }
]

Authorizations

​
Authorization
string
header
required

API Key for your organization

​
X-App-ID
string
header
required

Project ID

Body

application/json
​
session_id
string
required

A unique session ID generated by caller

​
type
enum<string>
required

The event that tracks an arbitray event

Available options:
track
​
event
enum<string>
required

The event that represents a turn in a conversation

Available options:
Conversation Turn
​
conversation_id
string
required

The ID of the conversation

​
properties
object
required

Properties of a turn event

​
timestamp
string

The timestamp of the event, defaults to "now" if not specified.

​
user_id
string

The unique ID of the user

​
device_id
string

The ID of the device, if applicable

Response

200 - application/json

Success

​
type
enum<string>
required

The type of event being sent.

Available options:
start_session,
end_session,
identify,
alias,
track
​
{key}