Build with FlingDrop

Quick start

1. 1

   Create a free account

   Sign up at app.flingdrop.com — it takes 30 seconds.

2. 2

   Get your API Key

   Your API Key is emailed upon registration. You can also generate new keys from your dashboard under Settings > API Keys.

3. 3

   Upload your first file

   Use the cURL command below to upload a file and get a shareable link.

   curl -X POST https://app.flingdrop.com/api/upload \
     -H "X-API-Key: YOUR_API_KEY" \
     -F "file=@document.pdf"

Base URL & Authentication

All API requests go to:

https://app.flingdrop.com

Authenticate every request by including your API Key in the X-API-Key header:

X-API-Key: your_api_key_here

Your API Key is sent by email when you register. You can also create new keys from your dashboard.

Response format

All endpoints return JSON with a consistent shape:

{
  "success": true,
  "data": { ... }
}

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "..."
  }
}

Upload a file

POST /api/upload

Upload a single file using multipart form data. The server automatically detects duplicates by file hash — if the same file was already uploaded and has not expired, the existing URL is returned without storing a second copy.

Headers

Body

multipart/form-data with a field named file.

Response

{
  "success": true,
  "data": {
    "url": "https://app.flingdrop.com/f/abc123xyz",
    "shortCode": "abc123xyz",
    "fileName": "document.pdf",
    "fileSize": 2048576,
    "expiresAt": "2026-04-01T00:00:00Z",
    "isDuplicate": false
  }
}

When isDuplicate is true, no new file was stored — the existing download link is returned.

Chunked upload

For large files, use chunked upload to split the transfer into multiple requests. This avoids timeouts and allows progress tracking.

{
  "fileName": "large-video.mp4",
  "totalSize": 524288000,
  "fileHash": "A1B2C3...",
  "isCompressed": false,
  "originalSize": 524288000
}

{
  "success": true,
  "data": {
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "isDuplicate": false
  }
}

{
  "success": true,
  "data": {
    "bytesReceived": 10485760,
    "chunksReceived": 1
  }
}

Check duplicate

GET /api/check/{hash}

Check if a file with the given SHA-256 hash already exists in your tenant. Useful to avoid uploading a file that is already available.

Response

{
  "success": true,
  "data": {
    "exists": true,
    "url": "https://app.flingdrop.com/f/abc123xyz",
    "expiresAt": "2026-04-01T00:00:00Z"
  }
}

When exists is false, url and expiresAt are null.

Download URLs

Every uploaded file gets a short URL in the format:

https://app.flingdrop.com/f/{shortCode}

These URLs are public — no authentication is needed to download. Anyone with the link can download the file until it expires.

Expiration depends on the tenant plan: 7 days (Free), 30 days (Pro), or 90 days (Business). After expiration, the file is permanently deleted.

Health check

GET /api/status

Verify that the API is operational. No authentication required.

{
  "success": true,
  "data": {
    "status": "OK",
    "serverTime": "2026-03-23T12:00:00Z"
  }
}

Team invitations

Business plan tenants can invite team members via the API. Invitations are sent by email and expire after 7 days.

{
  "email": "colleague@company.com",
  "role": "Member",
  "tenantId": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "success": true,
  "token": "...",
  "invitationUrl": "https://app.flingdrop.com/invitation/...",
  "message": "Invitation created successfully"
}

{
  "success": true,
  "tenantName": "Acme Corp",
  "email": "colleague@company.com",
  "role": "Member",
  "expiresAt": "2026-03-30T00:00:00Z"
}

{
  "password": "securepassword123",
  "name": "Jane Doe"
}

Error codes

All error responses include a machine-readable code field:

Rate limits

Upload endpoints are rate-limited. When you exceed the limit, you receive an HTTP 429 Too Many Requests response with a Retry-After header indicating how many seconds to wait.

Implement exponential backoff in your client to handle rate limits gracefully.

Plan limits

Each plan has specific limits that the API enforces automatically:

Code examples

# Upload a file
curl -X POST https://app.flingdrop.com/api/upload \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@/path/to/document.pdf"

# pip install requests
import requests

response = requests.post(
    "https://app.flingdrop.com/api/upload",
    headers={"X-API-Key": "YOUR_API_KEY"},
    files={"file": open("document.pdf", "rb")},
)

data = response.json()
if data["success"]:
    print(f"Download URL: {data['data']['url']}")
    print(f"Expires at:   {data['data']['expiresAt']}")
else:
    print(f"Error: {data['error']['code']} — {data['error']['message']}")

// Node.js (v18+) or browser
const form = new FormData();
form.append("file", fileInput.files[0]); // browser
// form.append("file", fs.createReadStream("document.pdf")); // Node.js

const res = await fetch("https://app.flingdrop.com/api/upload", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_API_KEY" },
  body: form,
});

const { success, data, error } = await res.json();
if (success) {
  console.log("Download URL:", data.url);
  console.log("Expires at:", data.expiresAt);
} else {
  console.error(error.code, error.message);
}

#!/bin/bash
# Upload all .log files from /var/log/myapp/
API_KEY="YOUR_API_KEY"
DIR="/var/log/myapp/"

for file in "$DIR"*.log; do
  [ -f "$file" ] || continue
  echo "Uploading $file..."
  response=$(curl -s -X POST https://app.flingdrop.com/api/upload \
    -H "X-API-Key: $API_KEY" \
    -F "file=@$file")
  url=$(echo "$response" | grep -o '"url":"[^"]*"' | cut -d'"' -f4)
  echo "  → $url"
done