---
title: "Merge-patch the coach's alert-delivery settings"
method: PUT
path: "/api/insights/settings"
tags: ["Insights"]
---

# Merge-patch the coach's alert-delivery settings

`PUT /api/insights/settings`

## Request

- Base URL: `https://api.setluca.com`
- URL: `https://api.setluca.com/api/insights/settings`
- Auth: one of:
  - API key in cookie `luca.session_token`
  - API key in header `x-api-key`
  - HTTP bearer

A merge patch. Send only what you're changing. Anything you leave out keeps its current value.

**API key scopes:** `insights:write`. You also need an `Idempotency-Key` header.

## Headers

- `Luca-API-Version` '1'

## Request body

- AlertSettingsPatch
  - `feedEnabled` boolean
  - `digestEnabled` boolean
  - `pushEnabled` boolean
  - `toggles` object
    - `metric_drop` boolean
    - `metric_spike` boolean
    - `opportunity` boolean
    - `milestone` boolean
    - `risk` boolean
  - `thresholds` object
    - `show_rate_drop` number
    - `revenue_drop` number
    - `reply_speed_regression` number
    - `ghost_rate_spike` number
    - `hot_leads_silent` integer
    - `bookings_spike` number
    - `trust_graduation` number

## Response `200`

ok

- AlertSettingsResponse
  - `feedEnabled` boolean, required
  - `digestEnabled` boolean, required
  - `pushEnabled` boolean, required
  - `toggles` object, required
  - `thresholds` object, required
  - `updatedAt` string, required

## Other responses

- `400`: validation failed
- `401`: unauthorized
- `429`: rate limited
- `503`: service unavailable

---

[API](https://skmtc.dev/setluca/apis/luca-api.md) · [All operations](https://skmtc.dev/setluca/apis/luca-api/llms.txt) · [OpenAPI document](https://skmtc.dev/setluca/apis/luca-api/revisions/90a200e4100b?raw)