Billing and usage

Metering

The unit of billing is the agent run. Each run emits a metered event the moment it terminates (success or failure), and that event carries the workspace, the agent, the run id, the duration, and the model and tool costs that AgentHub absorbed on your behalf. Metered events are immutable; corrections show up as offsetting events with a link to the original.

Replay runs are tagged with a replay flag and excluded from billable totals, so debugging an incident does not double-charge you. See /docs/run-replay.

Monthly invoice cycle

Invoices generate on the first day of every month for the calendar month that just closed. A scheduled billing-monthly cron walks every workspace, sums its metered events, applies plan quotas and overage rates, computes per-line tax, and finalizes the invoice. The cron is idempotent: re-running it for the same period does not produce duplicate invoices.

The pipeline runs in this order:

1. Aggregate metered events for the closed period.
2. Apply plan quota and overage rates.
3. Compute US sales tax, UK VAT, EU VAT, or EU reverse-charge per the workspace billing address.
4. Finalize the invoice, write a hash to the audit chain, and emit billing.invoice.finalized via webhooks.
5. Charge the workspace’s payment method.
6. On failure, retry per the published dunning schedule before suspension.

Plan tiers

Tiers and the trade-offs that distinguish them:

• Free — small monthly run quota, single seat, sandbox-only data sources. Designed to evaluate the platform end-to-end.
• Entry — modest monthly quota, multi-seat workspace, all marketplace packs available. Per-run overage at the published list rate.
• Professional — higher monthly quota, volume discount on overage, access to premium packs and dual-approval workflows.
• Enterprise — negotiated quota and overage, SSO/SCIM, BAA on request, and a custom revenue-share for marketplace publishers.

Overage

When you exceed your plan’s monthly quota, every additional run is billed at the published per-run overage rate for your tier. Overage is shown live in the dashboard’s usage chart, so you can see the burn before the invoice cuts. Volume discounts kick in on professional and enterprise commitments.

Where to find your invoice

1. Open /dashboard/billing.
2. The current cycle’s accrued usage is shown at the top.
3. Scroll to Invoice history for finalized invoices.
4. Click any invoice to download the PDF or the underlying CSV of metered events.
5. Use Update payment method, Change plan, or Request refund from the same page; each action is mirrored to the workspace audit log.