action files_get_usage_snapshots {
  label: "List Usage Snapshots"
  description: "List Usage Snapshots"
  provider: files
  method: GET
  path: "/usage_snapshots"
  encoding: json
  input: {
    type: "object"
    properties: {
      cursor: {
        type: "string"
      }
      per_page: {
        type: "integer"
        format: "int32"
      }
    }
    additionalProperties: false
  }
  output: {
    type: "array"
    items: {
      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)"
        }
      }
    }
  }
}