Skip to main content
POST
Analyze emotional patterns and mental health indicators in conversation

Authorizations

Authorization
string
header
required

API key as Bearer token

Body

application/json
messages
object[]
required

Chat history to analyze

context
object
external_id
string

Your unique identifier for correlation with your systems

Maximum string length: 255
metadata
object

Custom key-value pairs for additional context. Maximum 20 properties.

incident_moderation_enabled
boolean

Per-call override of your account incident logging setting. When set, it takes precedence over the account-level flag for THIS request: true forces the incident to be persisted, false suppresses persistence. Omit to use your account default (which itself defaults to enabled). Lets you control incident logging per request, e.g. suppress logging for test traffic.

Response

200 - application/json

Default Response

dominant_emotions
string[]
emotion_scores
object
trend
enum<string>
Available options:
improving,
stable,
worsening
summary
string
credits_used
number

Number of credits consumed by this request

external_id
string

Echo of provided external_id

metadata
object

Echo of provided metadata