---
title: "Change the overdue check-in alert"
method: PATCH
path: "/api/apps/fleet/{installation_id}/alerts"
tags: ["Apps - Fleet"]
---

# Change the overdue check-in alert

`PATCH /api/apps/fleet/{installation_id}/alerts`

## Request

- Base URL: `https://trmnl.com`
- URL: `https://trmnl.com/api/apps/fleet/{installation_id}/alerts`
- Auth: HTTP bearer

One email digest when a member is overdue by the threshold. Keys left out keep their value; a null email sends the digest to the account owner.

## Request body

- object
  - `overdue_alert_enabled` boolean
  - `overdue_alert_threshold_minutes` 30 | 60 | 240
  - `overdue_alert_email` string, nullable

## Response `200`

Updated

- object
  - `data` Fleet
    - `id` string, uuid
    - `name` string
    - `master` FleetMember
      - `device_id` integer
      - `name` string, nullable
      - `role` 'master' | 'mirror'
      - `check_in_state` 'overdue' | 'on_time' | 'asleep' | 'never_seen', nullable: Whether the device checked in when it said it would; null for a device that was reset
      - `expected_check_in_at` string, date_time, nullable
      - `last_pushed_at` string, date_time, nullable
      - `in_sync` boolean: Pushed since the master playlist last changed
    - `mirror_count` integer
    - `needs_push_count` integer: Mirrors not pushed since the master playlist last changed
    - `overdue_count` integer
    - `last_pushed_at` string, date_time, nullable
    - `inherited_settings` string[]: Master settings each push copies to the mirrors
    - `alerts` object
      - `enabled` boolean
      - `threshold_minutes` integer
      - `email` string, nullable

## Other responses

- `401`: Unauthorized
- `404`: Installation belongs to another user
- `422`: A threshold the alert does not offer

---

[API](https://skmtc.dev/trmnl/apis/trmnl-api.md) · [All operations](https://skmtc.dev/trmnl/apis/trmnl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trmnl/apis/trmnl-api/revisions/66179e6d663b?raw)