alerts

Return a list of all current system alerts.

Example (GET): curl 'http://host-ip:8111/api/v1/alerts'

[{
    "id": 1472,
    "severity": 0,
    "message": "Unable to compile global expression \"long_text\"",
    "ts": 1636054374368,
    "options": {
        "detail": "Can't find \"leak_detectors\""
    },
    "level_name": "Error"
}]

alert/add

Add an alert to the system alert list.

Example: (GET): curl 'http://host-ip:8111/api/v1/alert/add?message=Howdy%21'

Example: (PUT): curl -X PUT -H 'content-type: application/json' -d '{"message": "Howdy!"}' 'http://host-ip:8111/api/v1/alert/add'

The following are the key/value pairs used in the JSON request body:

• message — The message text of the alert
• severity — May be error, warning or notice (default: notice)
• tag — An optional alphanumeric identifier for the alert. A tagged alert can be removed by requesting alert/:tag with the DELETE method.
• detail — Optional (text) detail to accompany the message. When provided, it is displayed in a smaller font size beneath the message.

alert/:tag

This endpoint, currently supporting only the HTTP DELETE method, will dismiss the alert with the given tag.

Example (DELETE): curl -X DELETE 'http://host-ip:8111/api/v1/alert/plugh'

This endpoint always returns JSON { "status": true } (unless something goes horribly wrong); it is not an error to delete/dismiss an alert that does not exist.

Updated 2025-09-17