---
search:
  tags:
    - alerts
    - PUT
seo:
  description: >-
    Partial: only the listed rules and the fields present change. Null…
    Reference for the PUT /api/v1/alert-rules endpoint in the TimescaleDB
    Enterprise API.
sidebar:
  label: Change global alert rules
  badge: PUT
title: Change global alert rules
type: openapi-operation
---
Partial: only the listed rules and the fields present change. Null resets a severity or a threshold to its default. The values that result for each service must be valid, else 400 names the service. Regenerates and reloads the rule file, so a change takes effect immediately.

`PUT /api/v1/alert-rules`

**Request body** (`application/json`, required)

- `rules` (AlertRuleUpdate[], required)

Request body example:

```json
{
  "rules": [
    {
      "enabled": true,
      "name": "string",
      "severity": "warning",
      "threshold": 0
    }
  ]
}
```

**Responses**

- `200` — OK
- `default` — Error

Response example, 200:

```json
{
  "rules": [
    {
      "configurable": true,
      "defaultSeverity": "string",
      "enabled": true,
      "group": "infrastructure",
      "name": "string",
      "scope": "service",
      "severity": "string",
      "summary": "string",
      "threshold": {
        "default": 0,
        "label": "string",
        "max": 0,
        "min": 0,
        "unit": "percent",
        "value": 0
      }
    }
  ]
}
```
