Skip to main content
GET
/
alerts
GET /alerts
curl --request GET \
  --url https://api.example.com/alerts
{
  "alerts": [
    {
      "severity": "spike",
      "theme": "Burnout",
      "count": 12,
      "delta": 3.2,
      "recommended_action": "Schedule a wellbeing check-in with the engineering team lead"
    }
  ],
  "flagged_count": 8,
  "at_risk_pct": 4.2
}
Returns active Fast Brain flags and at-risk signals. Anonymised — no individual user data.

​
Query parameters

​
severity
string
default:"all"
Filter by severity: spike, crisis, or all.
​
limit
integer
default:"20"
Maximum alerts to return.

​
Response

​
alerts
array
Array of {severity, theme, count, delta, recommended_action} objects.
​
flagged_count
integer
Users with active Fast Brain flags (anonymised count).
​
at_risk_pct
float
Percentage of cohort currently above distress baseline.

​
Example

curl -X GET "https://api.togetherwithkai.com/v1/affective/alerts?severity=all&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "alerts": [
    {
      "severity": "spike",
      "theme": "Burnout",
      "count": 12,
      "delta": 3.2,
      "recommended_action": "Schedule a wellbeing check-in with the engineering team lead"
    }
  ],
  "flagged_count": 8,
  "at_risk_pct": 4.2
}
Crisis-level alerts trigger platform native notifications when received via webhook. See the pricing page for webhook handling pseudocode.