action files_get_site_usage {
  label: "Get the most recent usage snapshot (usage data for billing purposes) for a Site."
  description: "Get the most recent usage snapshot (usage data for billing purposes) for a Site."
  provider: files
  method: GET
  path: "/site/usage"
  encoding: json
  output: {
    type: "object"
    description: "List Usage Snapshots"
    properties: {
      bytes_sent: {
        type: "number"
        format: "double"
        description: "Transfer Usage for period - Outbound GB from Files Native Storage"
      }
      current_storage: {
        type: "number"
        format: "double"
        description: "Current total Storage Usage GB as of end date (not necessarily high water mark, which is used for billing)"
      }
      deleted_files_counted_in_minimum: {
        type: "number"
        format: "double"
        description: "Storage Usage for files that are deleted but uploaded within last 30 days as of end date (not necessarily high water mark, which is used for billing)"
      }
      deleted_files_storage: {
        type: "number"
        format: "double"
        description: "Storage Usage for files that are deleted but retained as backups as of end date (not necessarily high water mark, which is used for billing)"
      }
      end_at: {
        type: "string"
        format: "date-time"
        description: "Usage snapshot end date/time"
      }
      high_water_storage: {
        type: "number"
        format: "double"
        description: "Highest Storage Usage GB recorded in time period (used for billing)"
      }
      high_water_user_count: {
        type: "number"
        format: "double"
        description: "Highest user count number in time period"
      }
      id: {
        type: "integer"
        format: "int32"
        description: "Usage snapshot ID"
      }
      root_storage: {
        type: "number"
        format: "double"
        description: "Storage Usage for root folder as of end date (not necessarily high water mark, which is used for billing)"
      }
      start_at: {
        type: "string"
        format: "date-time"
        description: "Usage snapshot start date/time"
      }
      sync_bytes_received: {
        type: "number"
        format: "double"
        description: "Transfer Usage for period - Inbound GB to Remote Servers (Sync/Mount)"
      }
      sync_bytes_sent: {
        type: "number"
        format: "double"
        description: "Transfer Usage for period - Outbound GB from Remote Servers (Sync/Mount)"
      }
      total_billable_transfer_usage: {
        type: "number"
        format: "double"
        description: "Transfer usage for period - Total Billable amount"
      }
      total_billable_usage: {
        type: "number"
        format: "double"
        description: "Storage + Transfer Usage - Total Billable amount"
      }
      usage_by_top_level_dir: {
        type: "object"
        description: "Storage Usage - map of root folders to their usage as of end date (not necessarily high water mark, which is used for billing)"
      }
    }
  }
}