Per-family variant inventory

GET

/admin/storage/variants

• Local development behind nginx (port 8088 by default)

Read-only inventory of derivative families (#402), largest first.

Rows are grouped by variant FAMILY — the segment of variant_key before the first / (turntable/0028.png → turntable), or the whole key when it has none (original, hires). variant_key itself is high-cardinality (one key per HLS segment and per turntable frame — 2090 distinct on a dev install), so a raw per-key listing would be thousands of unreadable rows; the family grain is roughly a dozen. distinct_keys reports how many raw keys each family covers.

Small result set, so no paging. Gated on system.storage.read (or system.admin). No write path.

Authorizations

• cookieAuth
• bearerAuth

Responses

200

Variant families, largest first.

object

items

required

Array<object>

object

family

required

Variant_key up to the first ’/’, or the whole key when it has none.

string

Example

turntable

variant_count

required

Variant rows in this family.

integer format: int64

distinct_keys

required

How many distinct raw variant_keys the family covers.

integer format: int64

object_count

required

Distinct objects that have at least one variant in this family.

integer format: int64

total_bytes

required

integer format: int64

newest_at

Created_at of the most recent variant in the family.

string format: date-time

nullable

401

Authentication required, missing, or invalid

object

error

required

Human-readable error summary

string

Example

the request could not be completed

Example

{
  "error": "authentication required: sign in and retry with a valid session or API token"
}

403

Authenticated but missing required capabilities

object

error

required

Human-readable error summary

string

Example

the request could not be completed