---
title: "Analyze emotional patterns and mental health indicators in conversation"
method: POST
path: "/api/v1/analysis/emotions"
tags: ["Analysis"]
---

# Analyze emotional patterns and mental health indicators in conversation

`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`

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.

## Request body

- object
  - `messages` object[], required: Chat history to analyze
    - `sender` string, required: Sender identifier
    - `text` string, required: Message text
  - `context` object
    - `age_group` string: Age group (e.g., "11-13")
  - `external_id` string: Your unique identifier for correlation with your systems
  - `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`

Default Response

- object
  - `dominant_emotions` string[]
  - `emotion_scores` object
  - `trend` 'improving' | 'stable' | 'worsening'
  - `summary` string
  - `recommended_followup` 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

## Changes

- **2026-10-19** `8490332e0031`: 1 info
  - added the new optional request property `incident_moderation_enabled`

[Operation history](https://skmtc.dev/tuteliq/apis/tuteliq-api/changes/api/v1/analysis/emotions/post.md)

---

[API](https://skmtc.dev/tuteliq/apis/tuteliq-api.md) · [All operations](https://skmtc.dev/tuteliq/apis/tuteliq-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tuteliq/apis/tuteliq-api/revisions/8490332e0031?raw)