Notifications
The bell in the header shows what needs your attention. Use it to find a low balance, a key near its limit or a payment problem before a request fails.
A notice belongs to you, not to a workspace. It stays in the bell when you change workspace. The bell shows the number of unread notices.
What the bell shows
| Notice | When it appears | Who gets it |
|---|---|---|
| Welcome | You open your account for the first time. It links to API keys. | The new person |
| Balance is low | The balance falls below your balance alert. | Owners and admins of the workspace |
| Key near its limit | A key has spent 80% of its spend limit. | Owners and admins of the workspace |
| Key limit reached | A key has spent all of its spend limit. The key refuses requests until the window moves or you raise the limit. | Owners and admins of the workspace |
| Funds added | A payment is credited to the balance. | Owners and admins of the workspace |
| Payment did not go through | A payment expired or failed. No money was taken. | Owners and admins of the workspace |
| Payment reversed | The payment rail took back a payment, for example after a chargeback. The workspace is suspended until support clears it. | Owners and admins of the workspace |
The bell also lists invitations to an organization and the workspaces that someone added you to.
Set a balance alert
- Open Settings for the workspace that holds the balance.
- Under Notifications, turn on Low balance. The alert starts at $10.
- Choose the arrow at the right of the row, type an amount in dollars, and choose Save. The amount must be more than $0 and at most $1,000,000.
The alert is off until you set it. To turn it off, turn off the switch. Only an owner or an admin can set it. A workspace under an organization spends the balance of the organization, so set the alert on the organization.
You get one notice each time the balance falls below the amount. When a top-up lifts the balance to the amount or above, the alert arms again and the old notice goes away. If you change the amount, the next check can send a new notice.
Read and dismiss
Choose a notice to mark it read and open the page that it is about. Choose Mark all read to clear the count. Choose the close button on a notice to remove it. A removed notice does not come back.
The exchange checks balances and key limits every five minutes, so a notice can be up to five minutes late. The exchange keeps a read or removed notice for 90 days.
Limits
- The bell is the only channel. The exchange sends no email for these notices.
- The 80% notice and the 100% notice for a key use the same window as the key's spend limit. The window moves with time, so a key that falls below 80% can send the notice again when it climbs.