Overage behavior

Default: hard stop

When your credit balance reaches zero, the API returns HTTP 402:

{
  "error": {
    "code": "QUOTA_EXCEEDED",
    "message": "Credit balance exhausted. Add credits at app2.mworks.com.",
    "status": 402,
    "request_id": "...",
    "product": "platform",
    "docs_url": "https://docs.mworks.com/reference/billing"
  }
}

No partial requests are billed. The request that would have exceeded the balance is rejected in full.

Auto-reload

You can configure auto-reload to avoid downtime:

• Threshold — the credit balance that triggers a reload (e.g., 500 credits remaining)
• Top-up amount — the credit balance restored when the threshold trips
• Frequency cap — minimum hours between auto-reloads (prevents runaway loops)

Configure auto-reload at app2.mworks.com/billing.

Enterprise soft cap

High-volume customers on committed monthly plans can opt into a monthly soft cap instead of a hard stop. Usage continues beyond the allocated balance; the overage is invoiced at month-end at the standard $0.05/credit rate. This is distinct from Strategic Partnership ($250k/yr+), which uses custom contract terms outside the credit model.

Soft cap is a contract term. Contact sales@mworks.com to configure.

Notification thresholds

You will receive email notifications when your balance reaches:

Threshold	Notification
25% remaining	Low balance warning
10% remaining	Critical balance warning
0% remaining	Balance exhausted
Auto-reload triggered	Reload confirmation

Configure notification preferences at app2.mworks.com/billing.