Traffic & billing

Two things cost on the CDN: storage (what you keep — see Quotas) and delivery traffic (what you serve). Because your account serves from one host, delivery egress attributes to your account automatically — one meter per account, across the auto host and any custom domains (all your namespaces share it).

How delivery is metered

1. Every response the edge serves is measured (bytes out) against the host.
2. Because the host is your account, those bytes roll up per account.
3. Egress is billed the same as any network traffic — the network_gb pricing unit — against your credit balance.

Storage and traffic are independent: a rarely-downloaded archive costs storage but little traffic; a hot thumbnail costs little storage but lots of traffic.

Suspend on overage

If your account exceeds its traffic/credit limits, Oblien disables the CDN route: the host stops serving (requests no longer return the file) until the limit resets or you raise it. Suspension is delivery-only and reversible:

• Files are retained — nothing is deleted; storage is untouched.
• Serving resumes automatically once you're back under limit (new period, top-up, or a raised cap) — the route is re-enabled, same URLs.
• Uploads are also gated at token mint when a namespace is over its storage/monthly cap (403 quota_exceeded).

Monitor traffic

Delivery traffic is part of your account's network usage. Track it with the same tools as the rest of your billing:

// Raw metered units for a namespace over a range (incl. network_gb)
const usage = await oblien.namespaces.usageUnits('customer-123', {
  from: '2026-07-01',
  to: '2026-08-01',
  groupBy: 'day',
});

GET /namespaces/customer-123/usage-units?from=2026-07-01&to=2026-08-01&groupBy=day
X-Client-ID: <id>
X-Client-Secret: <secret>

curl "https://api.oblien.com/namespaces/customer-123/usage-units?from=2026-07-01&to=2026-08-01&groupBy=day" \
  -H "X-Client-ID: $OBLIEN_CLIENT_ID" -H "X-Client-Secret: $OBLIEN_CLIENT_SECRET"

For storage usage (which is separate from traffic), use GET /cdn/usage. For credit rates, per-tenant spending ceilings, and how the network_gb unit is priced, see Billing & Credits.