---
title: "Update detection settings"
method: PUT
path: "/api/v1/settings/detection"
tags: ["Settings"]
---

# Update detection settings

`PUT /api/v1/settings/detection`

## Request

- Base URL: `https://api.tuteliq.ai`
- URL: `https://api.tuteliq.ai/api/v1/settings/detection`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Configure which detection endpoints are active for your account. Use `enabled_endpoints` (whitelist — only these run) OR `disabled_endpoints` (blacklist — these are skipped). Cannot use both.

Example for an adult platform that only needs self-harm detection:
```json
{"enabled_endpoints": ["distress-signals", "unsafe"]}
```

Example to disable grooming and bullying but keep everything else:
```json
{"disabled_endpoints": ["grooming", "bullying"]}
```

## Request body

- object
  - `enabled_endpoints` string[]: Only these endpoints will run. Mutually exclusive with disabled_endpoints.
  - `disabled_endpoints` string[]: These endpoints are skipped. Mutually exclusive with enabled_endpoints.
  - `default_context` object
    - `age_group` string: Default age group (e.g. "adult", "13-17")
    - `platform` string: Default platform name
    - `country` string: Default ISO country code
  - `default_conversation_type` 'fraud_report' | 'abuse_report' | 'support_disclosure' | 'helpline' | 'clinical' | 'investigative' | 'legal' | 'advisory' | 'training' | 'journalism' | 'research' | 'moderation_review' | 'healthcare' | 'law_enforcement' | 'education' | 'family' | 'workplace' | 'dating' | 'adult_community' | 'direct_message' | 'group_chat' | 'public_post' | 'customer_service' | 'gaming_chat': Account-level default for `context.conversation_type`. A request that sets `context.conversation_type` explicitly always overrides this. No default value: leave unset for unchanged behaviour. Set from your own platform configuration, never from end-user input.
  - `default_flag_profanity` boolean: Account-level default for options.flag_profanity on /bullying and /unsafe. A request that sets options.flag_profanity explicitly always overrides this.
  - `default_flag_risk_terms` boolean: Account-level default for options.flag_risk_terms on /bullying and /unsafe. A request that sets options.flag_risk_terms explicitly always overrides this.

## Response `200`

Default Response

- object
  - `success` boolean
  - `settings` object
  - `message` string

## Changes

- **2026-10-19** `8490332e0031`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tuteliq/apis/tuteliq-api/changes/api/v1/settings/detection/put.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)