Usage and billing in the Aetherfy dashboard
Where Aetherfy usage and billing live in the dashboard
Aetherfy billing is split across two pages of the dashboard:
| Address | What it is |
|---|---|
/dashboard/billing | Usage in the sidebar: your plan, agent quota, this period’s usage and your vector storage |
/dashboard/settings/billing | Settings → BILLING, titled Plan & Payment: plan changes, payment method, spend limit, cancellation and invoices |
How Aetherfy prices and charges is explained at Billing and spend caps; this page describes what the two screens show. Billing has no CLI or REST equivalent: plans, payment and the spend limit are set here, and payment details in the Stripe portal these pages open.
Aetherfy subscription status labels
Both pages show the plan with its subscription status, in capitals.
| Label | Meaning |
|---|---|
active | Paid up |
past_due | A payment failed. Shown as PAST DUE, through the grace period and, if it ends unpaid, through the suspension after it |
canceled | The paid subscription ended; the account is on Free. Not a failure |
UNKNOWN | No status could be read |
Your agents and collections were deleted. | The suspension ran its 30 days unpaid: the agents and vector collections were permanently deleted, with the stored secrets and the API keys. The account, the login and the billing history remain; resubscribing starts from scratch. Shown on every dashboard page with a link to Plan & Payment, which offers Manage Billing |
Account suspended: a payment did not go through. | The grace period ended unpaid and the account is suspended: agents are stopped and API requests are refused. It names the day the account’s data is kept until, 44 days after the payment that failed. Shown on every dashboard page with a link to Plan & Payment, which offers Update Payment Method |
The failed-payment timeline — the grace period, suspension and when data is deleted — is at failed payments.
The Aetherfy usage meter
| Label | Meaning |
|---|---|
CURRENT PLAN | Your plan and its subscription status |
AGENT QUOTA | Deployed agents against your plan’s limit. Archiving an agent frees its slot; pausing one does not |
PLAN LIMIT REACHED | You are at the agent limit; the link offers the next plan, or Contact Sales when that plan has no self-serve price |
% of plan | Usage so far this period, as a share of what your plan includes. Usage inside the plan is never shown in dollars |
Usage-based | Your plan’s allowance is unlimited, so there is no share of it to show |
Usage is metered daily. | Usage is booked by a daily update, so today’s usage appears once that update has run |
Projected month-end: | Where this period is heading, with a warning when it is on track to reach your spend limit |
Spend limit: | The period’s total against your spend limit, with — reached once it is hit |
Agents — plan usage | Each agent’s share of the period’s usage |
PAUSED | Beside an agent: paused because the plan’s usage limit was reached |
VECTOR DB USAGE | Vector storage used and the number of collections |
Live usage meter is temporarily unavailable. Your plan and quota below are unaffected. | The meter could not be read; nothing about your account changed |
Past your plan’s allowance the figures switch to dollars: the overage so far, and
the period’s total split into plan and usage. STRIPE PORTAL opens your Stripe
billing portal; it is shown once the account has been billed through Stripe, and
if the portal cannot be opened the page says why. The meter shows the current period only; past periods are the
invoices on Plan & Payment. Per-agent usage events are also on the API, at
GET /api/v1/usage/agent/{agent_id}/events.
Aetherfy Plan & Payment labels
| Label | Meaning |
|---|---|
Account Status | Your plan, its status, and the next date that matters |
Renews on | The paid plan renews on that date |
Cancels on | A cancellation is scheduled for that date |
Downgrades to | A move to a lower plan is scheduled for that date |
Payment past due — update your payment method. | A payment failed. The line under it says when service may be suspended, or that the grace period has ended |
Spend Limit | Your own cap on the month’s total bill. Paid plans below Enterprise only |
Pause my account at a spend limit | Turns the cap on. At the cap Aetherfy blocks new deploys, configuration changes and background jobs; agents keep running until the plan’s usage is used up |
Invoice History | Your invoices, with links to view each one and its PDF |
Preparing invoice | A period has ended and its invoice is not issued yet |
Current Plan | The plan you are on, among the plan cards |
DOWNGRADE_BLOCKED — | Followed by the plan: a downgrade was checked and something on the account exceeds the lower plan. Each item is listed with a link; fix them and re-check |
Aetherfy Plan & Payment actions
| Action | What happens |
|---|---|
| Manage Billing, Update Payment Method | Opens the Stripe portal: card, billing address, tax id, receipts |
| Upgrade | From Free, through Stripe Checkout. Between paid plans, at once, with the prorated charge shown on the card first |
| Downgrade — type the plan’s name to confirm | Scheduled for the end of the period, after an eligibility check. Keep Current Plan withdraws it |
| Cancel Subscription | Scheduled for the end of the period. Resume Subscription withdraws it until then |
| Save Spend Limit | Saves the cap and its amount, within the range your plan allows |
After a Stripe Checkout, /dashboard/settings/billing/result says whether the
payment was confirmed or cancelled.
What the Aetherfy dashboard does not do for billing
| Not in the dashboard | Where instead |
|---|---|
| Store or show card details | The Stripe portal, opened from Manage Billing |
| Self-serve Enterprise | Contact Sales on the Enterprise plan card |
| Usage history for past periods | The invoices in Invoice History |
| Read usage from a script | GET /api/v1/usage/agent/{agent_id}/events (account API) |
Last updated on