File Storage

Store and serve files with S3-compatible storage. Upload images, documents, videos, or any file type.

Upload Files

POST /api/v1/storage/projects/{project_slug}/upload

Headers:
  Authorization: Bearer YOUR_API_KEY
  Content-Type: multipart/form-data

Form Data:
  file: [binary file data]
  path: "images/profile.jpg"
  public: true

List Files

GET /api/v1/storage/projects/{project_slug}/files?path=images&limit=10

Headers:
  Authorization: Bearer YOUR_API_KEY

Download Files

GET /api/v1/storage/projects/{project_slug}/files/{file_key}/download

Headers:
  Authorization: Bearer YOUR_API_KEY

Get Public URL

GET /api/v1/storage/projects/{project_slug}/files/{file_key}/url

Headers:
  Authorization: Bearer YOUR_API_KEY

Presigned URLs

Generate temporary URLs for secure file access:

POST /api/v1/storage/projects/{project_slug}/presigned-url

Headers:
  Authorization: Bearer YOUR_API_KEY
  Content-Type: application/json

Body:
{
  "file_key": "images/profile.jpg",
  "expires_in": 3600
}

Response:
{
  "url": "https://storage.wowsql.com/...?signature=...",
  "expires_at": "2024-01-01T01:00:00Z"
}

Delete Files

DELETE /api/v1/storage/projects/{project_slug}/files/{file_key}

Headers:
  Authorization: Bearer YOUR_API_KEY

Check Storage Usage

GET /api/v1/storage/projects/{project_slug}/quota

Headers:
  Authorization: Bearer YOUR_API_KEY