Sharey

FAQ

Support Sharey

Contribute to infrastructure →

How do I share a file?

Drop files onto the upload area, click to browse, or press Ctrl+V / long-press on mobile to paste from clipboard. You'll get a shareable link straight away.

How do I share text?

Switch to Pastebin mode, type or paste your content, then click Submit Paste. Works for code snippets, notes, or any plain text.

Do files expire?

Yes. Use the Expiry selector before uploading — options range from 1 hour to 90 days (default 7 days). Expired content is deleted automatically.

What is Burn after view?

Tick Burn after view before uploading. The file or paste is permanently deleted the moment someone opens the link — ideal for sensitive one-time shares.

What is Password protection?

Enter a password in the Password field before uploading. Anyone opening the link will be asked for the password before the content is shown.

What are the URL formats?

All uploads get a short link: sharey.org/ABC123.
Older direct paths like sharey.org/files/ABC123.png still work too.

API Reference

POST /api/upload

multipart/form-data

FieldDescription
file *File to upload. Also: files, files[].
expiry1h 24h 7d 30d 90d or ISO-8601. Default 7d.
burn_after_viewtrue — delete on first view.
passwordRequire a password to view.
 
# basic
curl -F "[email protected]" https://sharey.org/api/upload

# expiry + burn
curl -F "[email protected]" \
  -F "expiry=24h" \
  -F "burn_after_view=true" \
  https://sharey.org/api/upload

# password protected
curl -F "[email protected]" \
  -F "password=hunter2" \
  https://sharey.org/api/upload
# python
import requests
url = requests.post(
    "https://sharey.org/api/upload",
    files={"file": open("photo.jpg","rb")},
    data={"expiry":"7d"}
).json()["urls"][0]

POST /api/paste

application/json

FieldDescription
content *Text content of the paste.
expirySame shorthand options as upload.
burn_after_viewtrue — delete on first view.
passwordRequire a password to view.
 
# basic
curl -X POST https://sharey.org/api/paste \
  -H "Content-Type: application/json" \
  -d '{"content":"Hello, world!"}'

# burn + expiry
curl -X POST https://sharey.org/api/paste \
  -H "Content-Type: application/json" \
  -d '{"content":"secret","expiry":"1h","burn_after_view":true}'

# password protected
curl -X POST https://sharey.org/api/paste \
  -H "Content-Type: application/json" \
  -d '{"content":"private text","password":"hunter2"}'
# python
import requests
url = requests.post(
    "https://sharey.org/api/paste",
    json={"content":"Hello","expiry":"24h"}
).json()["url"]

Notes