TOtower

Describe catalog usage

Changed on

Returns physical bytes stored by one Tower-managed catalog, including Iceberg metadata and not-yet-compacted snapshot history. Measurements are cached and may be temporarily unavailable; measured_at is null when no measurement exists. BYO and S3 Tables catalogs are not metered.

get/catalogs/{name}/usage

Request

Path parameters

namestring required

The name of the catalog.

Query parameters

environmentstring

Environment whose catalog usage to return. When it has no same-named catalog, usage for the catalog from default is returned instead.

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

environmentstring required

Environment containing the catalog definition.

Example response

{
  "$schema": "https://api.tower.dev/v1/schemas/DescribeCatalogUsageResponse.json"
}

Changes