Usage

Get workspace usage snapshot

Return aggregated bytes scanned and current storage size for a billing period. Pass since as the start of your billing period so the totals line up with your invoice rather than the calendar month.

Query parameters

• since string — Billing period start (ISO-8601). Defaults to the start of the current UTC calendar month when omitted.

Response 200 — Workspace usage snapshot

• bytes_scanned integer — required. Sum of bytes_scanned across all completed/failed query runs since since. Null bytes (queries that touched no row data) contribute 0.
• query_count integer — required. Number of query runs (succeeded + failed) since since.
• since string — required. The period start used for this response (echoed back for the caller to verify).
• storage_bytes integer — required. The workspace's current stored-data footprint in bytes, measured at request time: instant-database data, plus un-consumed uploads, connection caches, and search-index artifacts.
• storage_captured_at string,null — When storage_bytes was measured (the time this response was produced).

{
  "bytes_scanned": 0,
  "query_count": 0,
  "since": "2026-01-01T00:00:00Z",
  "storage_bytes": 0,
  "storage_captured_at": "2026-01-01T00:00:00Z"
}