blob.cx

Upload. Share. Done.

Docs

Getting Started

Upload files with a simple API call. Get instant shareable links.

Upload a File

curl -F "file=@document.pdf" https://blob.cx/api/upload
# Response:
# {
#   "id": "abc123de",
#   "url": "/abc123de",
#   "name": "document.pdf",
#   "size": 1024000,
#   "expiresAt": "2026-08-19T..."
# }

Password Protection

Optionally protect files with a password:

Upload with password

curl -F "file=@secret.zip" \
  -F "password=secure123" \
  https://blob.cx/api/upload

Download password-protected file

# Via query parameter
curl https://blob.cx/abc123de?password=secure123 -o secret.zip

# Via header
curl -H "X-Blob-Password: secure123" \
  https://blob.cx/abc123de -o secret.zip

File Expiration

Files are automatically deleted:

Plan your sharing accordingly.

Delete a File

DELETE /api/files/:id
# If password protected:
# curl -X DELETE https://blob.cx/api/files/abc123de \
#   -H "Content-Type: application/json" \
#   -d '{"password": "secure123"}'

Best Practices