Upload Files

POST /upload

Basic Upload

curl -F '[email protected]' https://clipbin.net/upload

Complete Example with All Options

curl -F '[email protected]' \ -F 'password=mysecretpassword123' \ -F 'expires_in=1440' \ -F 'max_views=10' \ -F 'custom_url=my-secret-file' \ -F 'one_time_view=true' \ https://clipbin.net/upload

Parameters

file (required): The file to upload. Use @filename to upload from filesystem.

password (optional): Password to protect the clip.

expires_in (optional): Expiration time in minutes. Default: 60 minutes.
Options: 5, 15, 60, 360, 1440, 10080, 43200

max_views (optional): Maximum number of views. Default: 1.
Options: 1, 5, 10, 25, 100, 0 (unlimited)

custom_url (optional): Custom URL for the clip.
Only letters, numbers, hyphens and underscores allowed.

one_time_view (optional): Set to 'true' for burn-after-reading.

Supported File Types

✅ ALL FILE TYPES ARE SUPPORTED!

You can now upload any file regardless of its extension or type:

📄 Documents (.pdf, .doc, .docx, .txt, .md, etc.)
🖼️ Images (.jpg, .png, .gif, .svg, .webp, etc.)
🎵 Audio (.mp3, .wav, .flac, .ogg, etc.)
🎬 Video (.mp4, .avi, .mkv, .webm, etc.)
💻 Code files (.js, .py, .go, .java, .cpp, etc.)
📦 Archives (.zip, .tar, .gz, .rar, etc.)
🔧 Executables (.exe, .app, .deb, .rpm, etc.)
📊 Data files (.json, .xml, .csv, .sql, etc.)
⚙️ And literally any other file type!

No restrictions on file extensions - upload whatever you need!

File Size Limit

Maximum file size: 10 MB

Response

Successful upload returns JSON with clip information:

{
  "url": "clipbin.net/abc123",
  "file_name": "README.md",
  "expires_at": "2024-01-01T12:00:00Z"
}

Tips

Use @ before filename to upload from your local filesystem
Combine multiple parameters with -F flags
Use \ for line continuation in long commands
Files are automatically deleted after expiration or max views
Password-protected clips can be accessed through the web interface