Explore documentation
  1. Welcome to Telemetry 👋
  2. Quick start guide
  3. Wide events vs. metrics
  4. Ingesting data
    1. Better Stack collector
    2. Vector
    3. OpenTelemetry
    4. Ingesting via HTTP API
    5. Ingesting metrics
    6. Ingesting logs
    7. Migrating to Better Stack
  5. Using the product
    1. AI SRE ↗
    2. MCP server ↗
    3. Transforming ingested data
    4. Querying data
    5. Tracing
    6. Alerts
  6. Telemetry API
    1. Getting an API token
    2. Sources API
    3. Source groups API
    4. Metrics API
    5. Dashboards API
    6. Explorations API
    7. Exploration groups API
    8. Alerts API
      1. List alerts in exploration GET
      2. Get a single alert GET
      3. Create an alert POST
      4. Update an alert PATCH
      5. Remove an alert DELETE
    9. Connections API
    10. Collectors API
    11. Query API ↗
  7. Alternative to
    1. Lightstep

Update an alert

Updates an existing alert by its ID. You only need to provide the fields you want to change.

PATCH https://telemetry.betterstack.com/api/v2/explorations/{exploration_id}/alerts/{id}

URL parameters

exploration_id
required integer

The unique identifier of the exploration.

id
required integer

The unique identifier of the alert to update.

Headers

Authorization
required string

Bearer $TOKEN

Body parameters

name
string

A new name for the alert.

value
number

A new threshold or percentage value. Only for threshold and relative alerts.

string_value
string

A new string value for equality matching. Only for threshold alerts.

anomaly_sensitivity
number

A new sensitivity level (0-100). Only for anomaly_rrcf alerts.

confirmation_period
integer

A new confirmation delay in seconds. Use 0 for immediate triggering.

paused
boolean

Set to true to pause the alert or false to resume it.

escalation_target
object

A new escalation target configuration. See the create alert endpoint for formats.

metadata
object

A new set of key-value metadata. This will replace all existing metadata.

200

The alert was updated successfully.

Response body

{
  "data": {
    "id": 789,
    "type": "alert",
    "attributes": {
      "name": "High Error Rate Alert",
      "alert_type": "threshold",
      "operator": "higher_than",
      "value": 150.0,
      "query_period": 300,
      "confirmation_period": 60,
      "recovery_period": 300,
      "escalation_target": {
        "policy_id": 123,
        "policy_name": "Critical Alerts Policy"
      },
      "paused": false,
      "paused_reason": null,
      "created_at": "2026-02-20T10:00:00Z",
      "updated_at": "2026-02-24T15:00:00Z"
    }
  }
}
404

The specified exploration or alert was not found.

Example request

cURL
curl --request PATCH \
  --url https://telemetry.betterstack.com/api/v2/explorations/123/alerts/789 \
  --header "Authorization: Bearer $TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "value": 150.0,
    "confirmation_period": 60
  }'


Previous article

Create an alert

Next article

Remove an alert