List storage variant families
GET /admin/storage/variants
Returns registered storage variants grouped by key family.
You need system.storage.read or system.admin for the whole install; a permission held only for a team doesn’t count. Without one you get 403, and signed-out callers get 401.
A family is the part of variant_key before its first /, or the whole key if there’s no slash. For example, turntable/0028.png belongs to turntable, while original and hires are each their own family. Originals are included, so this isn’t a derivatives-only list.
Results are ordered by total recorded bytes, largest first, and ties have no fixed order. variant_count counts rows, distinct_keys counts full keys in the family and object_count counts distinct parent hashes. One object can appear in several families, so adding up family object counts doesn’t give an install-wide distinct count.
Byte sizes come from storage_variants, not a fresh look at the backend. newest_at is the latest row creation time in the family, not the last time a variant was regenerated. The endpoint runs one uncached database query and returns every family with no pagination. With no registered variants, it returns items: [].
Authorizations
Section titled “Authorizations ”Responses
Section titled “ Responses ”All registered variant families ordered by recorded byte total, largest first.
All registered variant families, without pagination.
object
Family buckets ordered by recorded byte total, largest first. Ties have no fixed order; empty when no variant rows exist.
Database inventory for one variant-key family, including the original family. Recorded sizes do not prove that the bytes are present.
object
The key segment before the first /, or the whole key when there is no slash.
Example
turntableNumber of registered object-and-variant rows in this family.
Number of distinct full variant keys in this family, across all represented objects.
Distinct parent hashes with at least one registered variant in this family. The same hash can be counted in other families.
Sum of recorded variant sizes in this family.
Latest created_at among the family’s rows. Regenerating an existing variant changes updated_at, not this creation timestamp.
Authentication required, missing, or invalid
object
Human-readable error summary
Example
the request could not be completedExample
{ "error": "authentication required: sign in and retry with a valid session or API token"}Authenticated but missing required capabilities
object
Human-readable error summary
Example
the request could not be completed