{
  "id": "alerts",
  "title": "Cluster alerts requests",
  "url": "https://redis.io/docs/latest/operate/rs/7.8/references/rest-api/requests/cluster/alerts/",
  "summary": "Cluster alert requests",
  "content": "\n| Method | Path | Description |\n|--------|------|-------------|\n| [GET](#get-all-alerts) | `/v1/cluster/alerts` | Get all cluster alerts |\n| [GET](#get-alert) | `/v1/cluster/alerts/{alert}` | Get a specific cluster alert |\n\n## Get all cluster alerts {#get-all-alerts}\n\n\tGET /v1/cluster/alerts\n\nGet all alert states for the cluster object.\n\n#### Required permissions\n\n| Permission name |\n|-----------------|\n| [view_cluster_alerts]() |\n\n### Request {#get-all-request} \n\n#### Example HTTP request\n\n\tGET /v1/cluster/alerts \n\n#### Request headers\n\n| Key | Value | Description |\n|-----|-------|-------------|\n| Host | cnm.cluster.fqdn | Domain name |\n| Accept | application/json | Accepted media type |\n\n#### Query parameters\n\n| Field | Type | Description |\n|-------|------|-------------|\n| ignore_settings | boolean | Retrieve updated alert state regardless of the cluster’s alert_settings. When not present, a disabled alert will always be retrieved as disabled with a false state. (optional) |\n\n### Response {#get-all-response} \n\nReturns a hash of [alert objects]() and their states.\n\n#### Example JSON body\n\n```json\n{\n    \"cluster_too_few_nodes_for_replication\": {\n        \"change_time\": \"2014-12-22T11:48:00Z\",\n        \"change_value\": {\n            \"state\": false\n        },\n       \"enabled\": true,\n       \"state\": \"off\",\n       \"severity\": \"WARNING\",\n    },\n    \"...\"\n}\n```\n\n### Status codes {#get-all-status-codes} \n\n| Code | Description |\n|------|-------------|\n| [200 OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1) | No error |\n\n## Get cluster alert {#get-alert}\n\n\tGET /v1/cluster/alerts/{alert}\n\nGet a cluster alert state.\n\n#### Required permissions\n\n| Permission name |\n|-----------------|\n| [view_cluster_alerts]() |\n\n### Request {#get-request} \n\n#### Example HTTP request\n\n\tGET /v1/cluster/alerts/cluster_too_few_nodes_for_replication \n\n#### Request headers\n\n| Key | Value | Description |\n|-----|-------|-------------|\n| Host | cnm.cluster.fqdn | Domain name |\n| Accept | application/json | Accepted media type |\n\n#### Query parameters\n\n| Field | Type | Description |\n|-------|------|-------------|\n| ignore_settings | boolean | Retrieve updated alert state regardless of the cluster’s alert_settings. When not present, a disabled alert will always be retrieved as disabled with a false state. (optional) |\n\n### Response {#get-response} \n\nReturns an [alert object]().\n\n#### Example JSON body\n\n```json\n{\n    \"change_time\": \"2014-12-22T11:48:00Z\",\n    \"change_value\": {\n        \"state\": false\n    },\n   \"enabled\": true,\n   \"state\": \"off\",\n   \"severity\": \"WARNING\",\n}\n```\n\n### Status codes {#get-status-codes} \n\n| Code | Description |\n|------|-------------|\n| [200 OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1) | No error |\n| [404 Not Found](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5) | Specified alert does not exist |\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-04-01T08:10:08-05:00"
}