Skip to Content
API referenceCatalog snapshots

Catalog snapshots

Daily catalog rollups — point-in-time totals for scenes, size, duration, and cost. Reads need scenes:read; the manual trigger needs scenes:write.

List daily catalog snapshots (optional date range).

scenes:read
GET/v1/catalog-snapshots
Parameters
from
string
Start date, YYYY-MM-DD.
to
string
End date, YYYY-MM-DD.
Response fields
id
string
Snapshot ID.
takenOn
string
Snapshot date (YYYY-MM-DD).
totalScenes
integer
Total scenes at snapshot time.
readyScenes
integer
Ready scenes.
failedScenes
integer
Failed scenes.
totalSizeBytes
integer
Total catalog size in bytes.
totalDurationS
integer
Total catalog duration in seconds.
totalCostCents
integer
Total spend in cents.
createdAt
string (ISO)
Row creation timestamp.

Manually trigger a snapshot for all workspaces (idempotent per day).

scenes:write
POST/v1/catalog-snapshots/run
Console roles: OWNER, DIRECTOR
Response fields
rowsAffected
integer
Snapshot rows written/updated.
Last updated on
PipelinePricing & metering