Coolify logoCoolify
Cloud

Update Sentinel settings

API server

https://app.coolify.io/api/v1

Choose where to send API requests

This changes the request URL and code examples on every endpoint page.

API server type

Requests will use

https://app.coolify.io/api/v1

Use only a Coolify URL you trust. Sending a test request also sends the API token you enter.

PATCH
/servers/{uuid}/sentinel

Update Sentinel settings for a server owned by the authenticated team. Changing token/metrics timing fields may restart Sentinel. Needs a token with the write and deploy permissions.

Authorization

bearerAuth
AuthorizationBearer <token>

Go to Keys & Tokens / API tokens and create a new token. Use the token as the bearer token.

In: header

Path Parameters

uuid*string

Server UUID

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

is_metrics_enabled?boolean
is_sentinel_debug_enabled?boolean
sentinel_token?string
sentinel_metrics_refresh_rate_seconds?integer
Range1 <= value
sentinel_metrics_history_days?integer
Range1 <= value
sentinel_push_interval_seconds?integer
Range10 <= value
sentinel_custom_url?string|null
traffic_topn?integer
Range1 <= value <= 1000
traffic_sample_threshold?integer
Range0 <= value
traffic_retention_1h_days?integer
Range1 <= value <= 365
traffic_retention_1d_days?integer
Range1 <= value <= 3650
is_geoip_enabled?boolean
geoip_refresh_days?integer
Range1 <= value
geoip_maxmind_license_key?string|null
traffic_ip_mode?string

How Sentinel stores client IPs: full, anonymized (IPv4 /24, IPv6 /48), or off.

Value in"full" | "anonymized" | "off"

Response Body

application/json

application/json

application/json

application/json

curl -X PATCH "https://app.coolify.io/api/v1/servers/string/sentinel" \  -H "Content-Type: application/json" \  -d '{}'
Empty
{  "message": "Invalid token."}
{  "message": "Unauthenticated."}
Empty
{  "message": "Resource not found."}
{  "message": "Validation error.",  "errors": {    "name": [      "The name field is required."    ],    "api_url": [      "The api url field is required.",      "The api url format is invalid."    ]  }}

Update server proxy PATCH

Update proxy redirect settings, exact labels generation, the Traefik certificate resolver, and optionally the proxy type for a team-owned server. Changing proxy_type needs a token with the `write` and `deploy` permissions.

Validate POST

Validate server by UUID. With install=true, needs a token with the write and deploy permissions.