---
title: "Update Sentinel settings"
method: PATCH
path: "/servers/{uuid}/sentinel"
tags: ["Servers"]
---

# Update Sentinel settings

`PATCH /servers/{uuid}/sentinel`

Update Sentinel settings for a server owned by the authenticated team. Changing token/metrics timing fields may restart Sentinel.

## Path parameters

- `uuid` string, required

## Request body

- object
  - `is_metrics_enabled` boolean
  - `is_sentinel_debug_enabled` boolean
  - `sentinel_token` string
  - `sentinel_metrics_refresh_rate_seconds` integer
  - `sentinel_metrics_history_days` integer
  - `sentinel_push_interval_seconds` integer
  - `sentinel_custom_url` string, nullable
  - `traffic_topn` integer
  - `traffic_sample_threshold` integer
  - `traffic_retention_1h_days` integer
  - `traffic_retention_1d_days` integer
  - `is_geoip_enabled` boolean
  - `geoip_refresh_days` integer
  - `geoip_maxmind_license_key` string, nullable

## Response `200`

Updated Sentinel settings.

## Other responses

- `400` — Invalid token.
- `401` — Unauthenticated.
- `404` — Resource not found.
- `422` — Validation error.

## Changes

- **2026-09-26** `f8b16020e5dd` — 1 warning
  - removed the request property `is_sentinel_enabled`
- **2026-09-19** `b5f81ea5b5b5` — 7 info
  - added the new optional request property `geoip_maxmind_license_key`
  - added the new optional request property `geoip_refresh_days`
  - added the new optional request property `is_geoip_enabled`
  - added the new optional request property `traffic_retention_1d_days`
  - …3 more
- **2026-07-22** `71a39cd460a7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/coollabsio/apis/coolify/changes/servers/:uuid/sentinel/patch.md)

---

[API](https://skmtc.dev/coollabsio/apis/coolify.md) · [All operations](https://skmtc.dev/coollabsio/apis/coolify/llms.txt) · [OpenAPI document](https://skmtc.dev/coollabsio/apis/coolify/revisions/f8b16020e5dd?raw)