Detect KOSA-aligned harm signals in text
Comprehensive safety analysis covering all KOSA harm categories: self-harm and suicidal ideation, eating disorders, substance use, depression/anxiety indicators, compulsive usage patterns, sexual content, violence, and hate speech. Returns categorized findings with age-calibrated severity scoring. This is the recommended default endpoint for broad content moderation.
Authorizations
API key as Bearer token
Body
The content to analyze
10000Top-level alias for options.support_threshold. Minimum severity to show crisis support resources (default: high). Critical always shows.
low, medium, high, critical Your unique identifier (e.g. message ID, content ID) for correlating Tuteliq results with your own system. Echoed back in the response and included in webhook payloads so you can match alerts to the original content.
255Your end-customer identifier for multi-tenant / B2B2C scenarios. If you serve multiple customers (schools, apps, brands) from a single API key, set this to route webhook alerts to the correct customer. Echoed back in the response and included in webhook payloads as "customerId".
255Arbitrary key-value pairs for additional context (e.g. { "channel": "discord", "region": "eu" }). Stored with the detection result, echoed in the response, and included in webhook payloads. Maximum 20 properties.
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
Unsafe-content signal observed at ANY severity (including low / monitor cases). For production branching prefer recommended_action (flag_for_review / block / immediate_intervention), which is a stable enum, over the bare presence of a signal.
low, medium, high, critical Routing key, weakest to strongest: none, monitor, flag_for_review, block, immediate_intervention. Safe to switch on.
none, monitor, flag_for_review, block, immediate_intervention Optional human-readable expansion of recommended_action for a moderator UI. Free text: do not branch on it.
Language code used for analysis (auto-detected or provided)
Language support maturity: "stable" (en) or "beta" (all others)
stable, beta Number of credits consumed by this request
Echo of the external_id you provided in the request
Echo of the customer_id you provided in the request
Echo of the metadata you provided in the request
Country-specific crisis helplines and response guidance (only included for high/critical severity)