Notifications
zdr.sh tells you when something happens to your account: a payment, a low balance, a spend cap, a key, a new sign-in, a service incident, your agent. Every notice appears in the dashboard, in the bell at the top right, and most of them are also emailed to you. You choose which ones are emailed.
The bell#
The bell shows every notice for the account you are looking at, newest first, with a count of the ones you have not read. Opening a notice takes you to the page it belongs to and marks it read. Mark all read clears the count; a notice stays in the list for ninety days.
The kinds of notice are:
| Notice | What it means |
|---|---|
| Payment received | A top-up settled and the credit is in your balance. The email is the receipt. |
| Low balance | Your funded balance fell below the warning amount. It is sent once per fall, not every hour. |
| Daily spend cap reached | A key, or the account, reached its daily spend cap. Requests are refused until the cap resets at 00:00 UTC. |
| Monthly spend cap reached | The same for the monthly cap, until the first of the next month. |
| API key created | A key was added to the account. The notice names it and never shows its secret. |
| API key revoked | A key stopped working. |
| New sign-in | A session signed in to your account. |
| Security change | A password, authenticator app, passkey or recovery-codes change. |
| Service incident | The operators posted an incident about the service. |
| Agent unavailable | The platform stopped counting your agent as available. |
| Agent rebuilt | Your agent was replaced with a new machine generation. |
| Scheduled run | A scheduled or triggered run on your agent finished or failed. It is in the bell, and its email is off by default: the answer is in the conversation. |
Email preferences#
Open Settings, then Notifications. Each kind has one switch: on means an email is sent when that kind of notice happens, off means the notice stays in the bell and no email is sent. The switches are saved when you press Save notification settings.
Four kinds cannot be turned off: API key created, API key revoked, New sign-in and Security change. These are the messages that tell you someone is using or changing your account, so the switch is shown disabled with the sentence that says so. There is no marketing email: none of these kinds is one, and zdr.sh does not sell or share your address.
The bell is not affected by these switches. A notice is recorded for you whatever the email preference says, so turning an email off never hides what happened.
Delivery and failures#
An email is queued when the event happens and sent in the background, so an event is not lost if the mail server is briefly unavailable: the delivery is retried, and a message that keeps failing is kept as a failure rather than silently dropped. That is an operator-facing record, described in the runbook; you see the same event in the bell regardless.
The email carries only what the notice needs: the amount, the balance, the key's name, the window. It never carries your API key's secret, a password, a one-time code or a sign-in token. The links in it open the dashboard, not a page that spends an action by itself.
Notices are kept for ninety days in the bell. Email preferences apply from the moment they are saved; a notice already in the bell when you turn a kind off stays there.
Not one of these kinds#
A payment that failed, a balance that ran low and a security change are all their own notices, each with its own switch where the notification page names one. Nothing about a notice depends on another kind's switch.