Analysis

Analyze emotional patterns and mental health indicators in conversation

Analyze a conversation for dominant emotions, sentiment trajectory (improving/stable/worsening), and early mental health risk indicators. Surfaces persistent patterns of sadness, anxiety, anger, or withdrawal that may indicate depression or declining wellbeing. Returns emotion scores, trend analysis, a human-readable summary, and recommended follow-up actions.

post/api/v1/analysis/emotions

Request

  • Base URL: https://api.tuteliq.ai
  • URL: https://api.tuteliq.ai/api/v1/analysis/emotions
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Request body

external_idstring

Your unique identifier for correlation with your systems

metadataobject

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

incident_moderation_enabledboolean

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

Default Response

dominant_emotionsstring[]
emotion_scoresobject
trend'improving' | 'stable' | 'worsening'
summarystring
recommended_followupstring
credits_usednumber

Number of credits consumed by this request

external_idstring

Echo of provided external_id

metadataobject

Echo of provided metadata

Changes

No recorded changes to this operation across all 1 revision of this API.