Get Storage Usage

Sprint 3

Get storage usage and quota for current user's organization.

Endpoint

GET /api/v1/storage/usage

Headers

Header	Required	Description
Authorization	Yes	Bearer <access_token>

Query Parameters

Parameter	Type	Required	Description
recalculate	boolean	No	Recalculate usage from files (default: false)

Response

Success (200)

{
  "success": true,
  "data": {
    "used_bytes": 1073741824,
    "used_mb": 1024.0,
    "used_gb": 1.0,
    "file_count": 150,
    "quota": {
      "limit_bytes": 10737418240,
      "limit_mb": 10240.0,
      "limit_gb": 10.0,
      "percentage_used": 10.0
    }
  },
  "message": "Storage usage retrieved successfully"
}

Error Codes

Status	Code	Description
401	UNAUTHORIZED	Invalid or missing authentication token
500	INTERNAL_SERVER_ERROR	Failed to get storage usage

Features

• Returns storage usage in bytes, MB, and GB
• File count
• Quota limits and percentage used
• Optional recalculation from actual files
• Organization-scoped

Recalculation

• recalculate=true: Recalculates usage by scanning all files in storage
• recalculate=false: Uses cached usage from storage_files table (faster)

Example

curl -X GET "https://api.rivergen.com/api/v1/storage/usage?recalculate=false" \
  -H "Authorization: Bearer <access_token>"

Related Endpoints

• Get Quota - Get quota limits only
• Upload File - Upload files (checks quota)