REST API v1

Flovix API Documentation

Integrate cloud file storage into your app, bot or website. Upload, download and manage files with simple HTTP requests.

Get API Key → My Keys

Base URL

https://goodclud.com/api/v1

🔐 Authentication

All API requests require a Bearer token in the Authorization header. Get your key at /api-keys.

Authorization: Bearer fvx_your_api_key_here

Endpoints

GET /api/v1/files

List files and folders. Supports navigation and recursive listing.

Parameters:

folder	Folder path to list (optional). Example: `folder=Photos` or `folder=Photos/2026`
recursive	Set to `true` to get all files from all folders at once (no folders in response)

Examples:

# Root level (files + folders)
curl https://goodclud.com/api/v1/files \
  -H "Authorization: Bearer YOUR_KEY"

# Files inside a folder
curl "https://goodclud.com/api/v1/files?folder=Photos" \
  -H "Authorization: Bearer YOUR_KEY"

# All files recursively (no folders)
curl "https://goodclud.com/api/v1/files?recursive=true" \
  -H "Authorization: Bearer YOUR_KEY"

{
  "ok": true,
  "count": 2,
  "files": [
    {
      "id": 123,
      "name": "photo.jpg",
      "path": "Photos/photo.jpg",
      "folder": "Photos/",
      "size": 204800,
      "is_folder": false,
      "created_at": "2026-03-10T12:00:00"
    },
    {
      "id": 124,
      "name": "Videos/",
      "path": "Videos/",
      "folder": "",
      "size": 0,
      "is_folder": true,
      "created_at": "2026-03-10T12:00:00"
    }
  ]
}

POST /api/v1/upload

Upload a file. Request must be multipart/form-data.

file	File to upload (required)
folder	Target folder path (optional). Example: `Photos/2026`

# Upload to root
curl -X POST https://goodclud.com/api/v1/upload \
  -H "Authorization: Bearer YOUR_KEY" \
  -F "[email protected]"

# Upload to a folder
curl -X POST https://goodclud.com/api/v1/upload \
  -H "Authorization: Bearer YOUR_KEY" \
  -F "[email protected]" \
  -F "folder=Photos/2026"

{
  "ok": true,
  "file_id": 123,
  "name": "photo.jpg",
  "size": 204800
}

GET /api/v1/download/<file_id>

Get a temporary download URL valid for 1 hour.

curl https://goodclud.com/api/v1/download/123 \
  -H "Authorization: Bearer YOUR_KEY"

{
  "ok": true,
  "url": "https://...r2.cloudflarestorage.com/...",
  "name": "photo.jpg"
}

DELETE /api/v1/files/<file_id>

Delete a file. File is moved to trash (recoverable for 30 days).

curl -X DELETE https://goodclud.com/api/v1/files/123 \
  -H "Authorization: Bearer YOUR_KEY"

{"ok": true, "deleted": 123}

🔑 Managing API Keys

GET /api/v1/keys — list your keys

POST /api/v1/keys — create new key

DELETE /api/v1/keys/<key_id> — delete key

curl -X POST https://goodclud.com/api/v1/keys \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "My App"}'

Ready to integrate?

Create a free account and get your API key in seconds. Available on all plans.

Get Started Free →