Retrieve recorded additions and successful removals by storage and UTC date. Historical coverage depends on event retention.
GET
/metrics/storage
Authorization
Authorization
header
string
required
Enter the project access token with the Bearer prefix, e.g. "Bearer project_access_token"
Query Parameters
format
string
Response format. Defaults to JSON unless Accept requests CSV. Overrides Accept when supplied; errors remain JSON.
Available options:
jsoncsv
from
string
Inclusive UTC start date, YYYY-MM-DD. Supply both dates for a custom range of at most 366 days. Omit both for the past 7 UTC calendar days including today.
Pattern:
^\d{4}-\d{2}-\d{2}$
to
string
Exclusive UTC end date, YYYY-MM-DD. Must be after from and at most 366 days later.
Pattern:
^\d{4}-\d{2}-\d{2}$
storage_id
string
Filter to one persistent storage configuration in the authenticated project.
Responses
application/json
data
object
required
Data contains the requested report.
from
string
required
From specifies the inclusive UTC start date.
Examples:
2026-10-01
storages
object[]
required
Storages specifies persistent project storage configurations, including those without recorded activity. Chunkify temporary storage is excluded.
daily
object[]
required
Daily specifies one record for each selected event day, oldest first.
asset_bytes_added
integer
int64
required
AssetBytesAdded specifies recorded Asset package additions.
Required range: x >= 0
bytes_removed
integer
int64
required
BytesRemoved specifies recorded successful file removals as a positive amount.
Required range: x >= 0
date
string
required
Date specifies the UTC event day.
Examples:
2026-10-01
net_bytes_change
integer
int64
required
NetBytesChange specifies additions minus successful removals. This may be negative and is not bucket occupancy.
source_bytes_added
integer
int64
required
SourceBytesAdded specifies recorded Source additions.
Required range: x >= 0
static_rendition_bytes_added
integer
int64
required
StaticRenditionBytesAdded specifies recorded static rendition additions.
Required range: x >= 0
storage_id
string
required
StorageId identifies the persistent storage configuration.
Examples:
stor_aws_example
summary
object
required
Summary specifies recorded activity in the selected period.
asset_bytes_added
integer
int64
required
AssetBytesAdded specifies recorded Asset package additions.
Required range: x >= 0
bytes_removed
integer
int64
required
BytesRemoved specifies recorded successful file removals as a positive amount.
Required range: x >= 0
net_bytes_change
integer
int64
required
NetBytesChange specifies additions minus successful removals. This may be negative and is not bucket occupancy.
source_bytes_added
integer
int64
required
SourceBytesAdded specifies recorded Source additions.
Required range: x >= 0
static_rendition_bytes_added
integer
int64
required
StaticRenditionBytesAdded specifies recorded static rendition additions.
Required range: x >= 0
to
string
required
To specifies the exclusive UTC end date.
Examples:
2026-10-02
text/csv
The project report.
application/json
error
object
required
code
400
integer
required
Code is the HTTP status code
Examples:
400
message
string
required
Message is a human-readable error description
Examples:
Invalid request parameters
type
"ValidationError"
string
required
Type indicates the error category
Available options:
ValidationError
status
"error"
string
required
Status indicates the response status "error"
Invalid dates, incomplete range or a range longer than 366 days.
application/json
error
object
required
Error response details
code
401
integer
required
Code is the HTTP status code
Examples:
401
message
string
required
Message is a human-readable error description
Examples:
Authentication error: invalid token or subscription inactive
type
"AuthenticationError"
string
required
Type indicates the error category
Available options:
AuthenticationError
status
"error"
string
required
Status indicates the response status "error"
A valid Project token is required.
application/json
error
object
required
Error response details
code
403
integer
required
Code is the HTTP status code
Examples:
403
message
string
required
Message is a human-readable error description
Examples:
Unauthorized to perform this action
type
"ForbiddenError"
string
required
Type indicates the error category
Available options:
ForbiddenError
status
"error"
string
required
Status indicates the response status "error"
The operation is not permitted.
application/json
error
object
required
Error response details
code
404
integer
required
Code is the HTTP status code
Examples:
404
message
string
required
Message is a human-readable error description
Examples:
Ressource not found
type
"NotFoundError"
string
required
Type indicates the error category
Available options:
NotFoundError
status
"error"
string
required
Status indicates the response status "error"
The persistent storage configuration was not found in this project.