Skip to main content
POST
/
configure
POST /configure
curl --request POST \
  --url https://api.example.com/configure \
  --header 'Content-Type: application/json' \
  --data '
{
  "cohort_filters": {},
  "anon_floor": 123,
  "active_layers": [
    {}
  ],
  "alert_threshold": 123,
  "kai_tone": "<string>"
}
'
{
  "config_id": "cfg_8f3a2b1c",
  "applied_at": "2026-06-15T10:00:00Z",
  "cohort_size": 142
}
Updates the organisation’s Affective Intelligence configuration. Admin role required.

Request body

cohort_filters
object
default:"{}"
Demographic or tag-based cohort definition. Filter by team, department, age range, tenure, or custom tag.
anon_floor
integer
default:"10"
Minimum group size floor. Must be at least 10.
active_layers
array
default:"all"
Signal layers to include: moods, states, topics, actions.
alert_threshold
float
default:"2.0"
Distress delta multiplier to trigger alert.
kai_tone
string
default:"community"
Kai’s language tone: community, corporate, or clinical.

Response

config_id
string
Confirmed configuration ID.
applied_at
string
ISO 8601 timestamp when config takes effect.
cohort_size
integer
Number of users matching filters.

Example

curl -X POST "https://api.togetherwithkai.com/v1/affective/configure" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "cohort_filters": {
      "department": "engineering"
    },
    "anon_floor": 10,
    "active_layers": ["moods", "states", "topics", "actions"],
    "alert_threshold": 2.0,
    "kai_tone": "corporate"
  }'
{
  "config_id": "cfg_8f3a2b1c",
  "applied_at": "2026-06-15T10:00:00Z",
  "cohort_size": 142
}
If cohort_size is below your anon_floor, signals will not be surfaced on the dashboard. Expand your cohort filters or increase the monitored user base.