## `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