Skip to main content

Documentation Index

Fetch the complete documentation index at: https://fileguard.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

Get time-series data for building charts and visualizations.

​
API Calls Chart

GET /api/v1/stats/charts/api-calls

​
Query Parameters

​
period
string
default:"daily"
Time period: hourly, daily, or weekly
​
days
integer
default:"30"
Number of days of data (1-365)

​
Response

{
  "status": "SUCCESS",
  "data": {
    "period": "daily",
    "data_points": [
      {
        "timestamp": "2026-01-15T00:00:00Z",
        "total": 12847,
        "success": 12500,
        "failure": 347,
        "by_operation": {
          "upload": 5200,
          "download": 6847,
          "metadata": 700,
          "delete": 100
        }
      }
    ]
  }
}

​
Storage Chart

GET /api/v1/stats/charts/storage

​
Query Parameters

​
period
string
default:"daily"
Time period: daily or weekly
​
days
integer
default:"30"
Number of days of data

​
Response

{
  "status": "SUCCESS",
  "data": {
    "period": "daily",
    "data_points": [
      {
        "timestamp": "2026-01-15T00:00:00Z",
        "total_bytes": 2638827520000,
        "files_count": 847000
      }
    ]
  }
}

​
Uploads Chart

GET /api/v1/stats/charts/uploads

​
Query Parameters

​
period
string
default:"daily"
Time period: hourly, daily, or weekly
​
days
integer
default:"30"
Number of days of data

​
Response

{
  "status": "SUCCESS",
  "data": {
    "period": "daily",
    "data_points": [
      {
        "timestamp": "2026-01-15T00:00:00Z",
        "count": 5200,
        "total_bytes": 15728640000
      }
    ]
  }
}

​
By-Context Statistics

​
API Calls by Context

GET /api/v1/stats/by-context/api-calls

{
  "status": "SUCCESS",
  "data": [
    {
      "context_key": "patient_reports",
      "context_name": "Patient Reports",
      "total": 8500,
      "success": 8200,
      "failure": 300,
      "by_operation": {
        "upload": 3500,
        "download": 4800,
        "metadata": 150,
        "delete": 50
      }
    }
  ]
}

​
Files by Context

GET /api/v1/stats/by-context/files

{
  "status": "SUCCESS",
  "data": [
    {
      "context_key": "patient_reports",
      "context_name": "Patient Reports",
      "file_count": 450000,
      "total_bytes": 1500000000000,
      "total_formatted": "1.4 TB"
    }
  ]
}