> ## Documentation Index
> Fetch the complete documentation index at: https://akua-1dce587a.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Notifications

> Stay informed about important events in your Akua account

![Workspace events routed by severity and channel into actionable notifications without noise.](https://mintcdn.com/akua-1dce587a/3H5lVc027NQakOso/images/heros/platform-notifications-light.svg?fit=max\&auto=format\&n=3H5lVc027NQakOso\&q=85\&s=bef69c0b72ef0ff727441d8f292b167b)

Akua sends notifications for important events like machine expiry reminders, cluster status changes, and quota warnings. Notifications are delivered through two channels: email and the in-dashboard notification center.

## Notification center

The notification center is the bell icon in the top-right corner of your dashboard. It shows a count of unread notifications and opens a panel with your recent activity.

Each notification includes:

* A **severity indicator** (blue for info, amber for warnings, red for critical).
* A **title** and short description.
* A **timestamp** showing when the event occurred.
* A **link** to the relevant resource (click to navigate directly).

### Managing notifications

* **Mark as read**: click any notification to mark it as read and navigate to the resource.
* **Mark all as read**: use the button at the top of the panel to clear all unread indicators.

## Email notifications

Akua sends email notifications to the workspace owner's email address. Emails include a summary of the event and a link to the dashboard.

## Notification types

| Event | Severity | Description |
| - | - | - |
| Machine expiry (5 days) | Warning | Akua-managed trial machine will expire in 5 days |
| Machine expiry (2 days) | Warning | Akua-managed trial machine will expire in 2 days |
| Machine expiry (24 hours) | Warning | Akua-managed trial machine will expire in 24 hours |

Akua also sends a warning when a BYOM cloud provider API token fails hourly validation.

> [!NOTE]
>
> These expiry reminders count down the free machine's one-time trial, not a recurring benefit. See the [machine lifecycle](https://akua-1dce587a.mintlify.site/compute/machines.md#free-tier-machine-lifetime) for what happens at expiry. Deleting it manually does not issue another free Akua-managed machine; see [the one-time managed-VM trial](https://akua-1dce587a.mintlify.site/platform/quotas.md#the-one-time-managed-vm-trial).

## API

Manage notifications programmatically.

> **[Notifications API](https://akua-1dce587a.mintlify.site/api-reference/notifications/list-recent-notifications.md)**
>
> List, count, and mark notifications as read.

> **[Authentication](https://akua-1dce587a.mintlify.site/apis/authentication.md)**
>
> Mint API tokens for programmatic access.

## Related topics

> **[Machines](https://akua-1dce587a.mintlify.site/compute/machines.md)**
>
> Akua-managed compute machine lifecycle and expiry.

> **[Quotas and limits](https://akua-1dce587a.mintlify.site/platform/quotas.md)**
>
> Understand resource limits and how to increase them.

> **[Plans and pricing](https://akua-1dce587a.mintlify.site/pricing.md)**
>
> Compare plans and understand free tier limits.

> **[Compute overview](https://akua-1dce587a.mintlify.site/compute/overview.md)**
>
> How Akua provisions and manages cloud servers.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.