API Documentation
Complete REST API reference for uploading files, streaming media, password authorization, and managing file deletions.
https://pyon.eu.org/upload.php
Uploads single or multiple files using standard multipart/form-data. Files > 20MB are automatically chunked into 20MB encrypted release assets. Executable & script files (.exe, .js, .html, .php) are rejected for security.
| Form Field | Type | Description |
|---|---|---|
| files[] / file | Binary File | The binary file payload to upload. |
| note | String (Optional) | Optional caption/description displayed on file page (Markdown supported). |
| download_password | String (Optional) | Optional password required to view/download the file. |
| delete_password | String (Optional) | Custom password required to authorize file deletion. |
| expiration | String (Optional) | Self-destruct timer: 5m, 1h, 1d, 7d, 30d, or never. |
cURL Upload Example:
curl -F "files[]=@photo.jpg" -F "note=# My Photo" -F "download_password=123" https://pyon.eu.org/upload.php
Python Requests Example:
import requests
r = requests.post('https://pyon.eu.org/upload.php',
files={'files[]': open('photo.jpg','rb')},
data={'note': 'My Photo'})
print(r.json())
JSON Success Response Schema:
{
"success": true,
"files": [
{
"hash": "a8f9k2",
"name": "photo.jpg",
"url": "/u/a8f9k2.jpg/x9m2b7",
"page_url": "/f/a8f9k2.jpg",
"delete_url": "/u/a8f9k2.jpg?key=del_x9m2b7",
"deletion_key": "del_x9m2b7",
"size": 123456
}
]
}
https://pyon.eu.org/f/:shortFilename
Renders the dedicated Catppuccin HTML preview page with media player, Markdown note, and download actions. Pass ?pwd=PASSWORD if protected.
https://pyon.eu.org/u/:shortFilename/:token
Streams the decrypted binary file payload directly. If password protected, provide ?pwd=PASSWORD or header x-file-password: PASSWORD.
curl -H "x-file-password: 123" "https://pyon.eu.org/u/a8f9k2.jpg/x9m2b7" --output photo.jpg
https://pyon.eu.org/u/:shortFilename?key=KEY
Permanently purges file assets from storage and deletes metadata using the deletion key or deletion password.
curl -X DELETE "https://pyon.eu.org/u/a8f9k2.jpg?key=del_x9m2b7"