> ## Documentation Index
> Fetch the complete documentation index at: https://docs.attaxr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Notifications

> Channels, per-event preferences, and the notification feed.

Aquila notifies you when the platform finds something worth your attention.
You control where notifications land and which events trigger them.

## The feed

* `GET /api/notifications` — your notification feed, paginated.
* `POST /api/notifications/{id}/read` — mark one as read.
* `POST /api/notifications/read-all` — mark all as read.

## Channels

A channel is a delivery target: a webhook or a chat bot.

* `GET /api/notification-channels` — list channels. Secrets come back
  masked.
* `POST /api/notification-channels` — create a channel.
* `PUT /api/notification-channels/{id}` — update.
* `DELETE /api/notification-channels/{id}` — delete.
* `POST /api/notification-channels/{id}/test` — send a test message.

## Event preferences

`PUT /api/notification-event-preferences` sets which events reach which
channel:

```json theme={"theme":{"light":"github-light","dark":"one-dark-pro"}}
{
  "preferences": [
    { "channelId": "chan_1", "eventType": "vulnerability.created", "enabled": true }
  ]
}
```

`GET /api/notification-event-preferences?channelId=chan_1` reads the current
preferences for one channel.

## Dashboards and events

* `GET /api/dashboard/counts` — the dashboard counters.
* `GET /api/dashboard/attack-surface` — the attack-surface radar data.
* `GET /api/events` — the raw event feed. `?subject=` filters by subject.