Storage Usage
See how much file storage a tenant uses, broken down by category
Storage Usage
Alpha tracks how much blob storage each tenant consumes and breaks it down by the
area of the app the files belong to. Storage is measured by summing the fileSize
of every stored asset that belongs to the tenant — no external storage-account query
is needed, and the figures are always tenant-scoped.
Where to find it
- Your own tenant — Settings → Usage. The page shows your plan limits, current users and storage, plus a Storage breakdown card.
- Any tenant (super-admin) — Admin → Tenants → <tenant> → Billing. The same Storage breakdown card appears alongside the tenant's usage and plan, so you can inspect a specific tenant's consumption.
What counts toward storage
The breakdown groups every asset-bearing collection into these categories:
| Category | What it includes |
|---|---|
| Documents | DMS documents, including every historical version |
| Products | Product assets (3D models, images, datasheets) |
| Projects | Project blobs (image, DXF, Revit template) and per-concept model overrides (GLB/RVT/PNG outputs) |
| Construction models | Generated type/variant coverage assets |
| Finance | PDFs, attachments and signatures on invoices, AP invoices, purchase orders and estimates |
| HR | Employee attachments and contract attachments |
| Asset management | Maintenance and certification documents on asset instances |
Categories with no stored files are omitted from the breakdown. The reported total is the sum of all categories and is the same figure used for usage and billing.
API
| Endpoint | Description |
|---|---|
GET /billing/usage/storage-breakdown | Per-category storage for the authenticated tenant |
GET /billing/admin/tenants/{tenantId}/storage-breakdown | Per-category storage for a specific tenant (super-admin only) |
Each returns a total (bytes and GB) and a list of { category, label, bytes, gb } entries.