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

# Notifications

> Stay informed about important events in your Akua account

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/akua-0b861dc6/7KPav8EV2jXc1gHe/images/heros/platform-notifications-light.svg?fit=max&auto=format&n=7KPav8EV2jXc1gHe&q=85&s=4bd234dd21b7e043cbf54beaa226efd9" alt="Workspace events routed by severity and channel into actionable notifications without noise." width="1536" height="864" data-path="images/heros/platform-notifications-light.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/akua-0b861dc6/7KPav8EV2jXc1gHe/images/heros/platform-notifications-dark.svg?fit=max&auto=format&n=7KPav8EV2jXc1gHe&q=85&s=8dbbf4be531eb7d55f7c1e361ff9287b" alt="Workspace events routed by severity and channel into actionable notifications without noise." width="1536" height="864" data-path="images/heros/platform-notifications-dark.svg" />
</Frame>

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.

<Info>
  These expiry reminders count down the free machine's one-time trial, not a recurring benefit. See the [machine lifecycle](/compute/machines#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](/platform/quotas#the-one-time-managed-vm-trial).
</Info>

## API

Manage notifications programmatically.

<CardGroup cols={2}>
  <Card title="Notifications API" icon="bell" href="/api-reference/notifications/list-recent-notifications">
    List, count, and mark notifications as read.
  </Card>

  <Card title="Authentication" icon="key" href="/apis/authentication">
    Mint API tokens for programmatic access.
  </Card>
</CardGroup>

## Related topics

<CardGroup cols={2}>
  <Card title="Machines" icon="server" href="/compute/machines">
    Akua-managed compute machine lifecycle and expiry.
  </Card>

  <Card title="Quotas and limits" icon="gauge" href="/platform/quotas">
    Understand resource limits and how to increase them.
  </Card>

  <Card title="Plans and pricing" icon="credit-card" href="/pricing">
    Compare plans and understand free tier limits.
  </Card>

  <Card title="Compute overview" icon="microchip" href="/compute/overview">
    How Akua provisions and manages cloud servers.
  </Card>
</CardGroup>


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