Everything you need to integrate Yukisbox into your apps, scripts, and workflows.
https://yukiapi.site
Upload a file up to 2GB. Returns a permanent shareable URL. Supports password protection, custom slugs, and self-destruct.
| Parameter | Type | Description |
|---|---|---|
file required | File | The file to upload (max 2GB) |
password optional | string | Password to protect the file. Users must enter it to download. |
max_downloads optional | int | Auto-delete after N downloads. 0 = never delete (default). 1 = burn after reading. |
custom_slug optional | string | Custom URL slug. Only letters, numbers, dashes, underscores. Example: my-video → /file/my-video |
userhash optional | string | Your API hash to link upload to your account (appears in Dashboard). |
# Simple anonymous upload curl -X POST -F "file=@photo.jpg" https://yukiapi.site/upload # With password + self-destruct after 1 download curl -X POST \ -F "file=@secret.pdf" \ -F "password=mypass123" \ -F "max_downloads=1" \ https://yukiapi.site/upload # With custom slug + linked to account curl -X POST \ -F "file=@video.mp4" \ -F "custom_slug=my-cool-video" \ -F "userhash=YOUR_API_HASH" \ https://yukiapi.site/upload
# pip install requests import requests resp = requests.post("https://yukiapi.site/upload", files={ "file": open("photo.jpg", "rb") }, data={ "password": "optional_pass", "max_downloads": 5, "custom_slug": "my-photo" }) print(resp.json()["url"])
{
"success": true,
"uid": "my-cool-video",
"url": "https://yukiapi.site/file/my-cool-video",
"filename": "video.mp4"
}
Download a file from a remote URL and host it on Yukisbox. The server fetches the file — no need to download it yourself first.
| Parameter | Type | Description |
|---|---|---|
url required | string | Direct URL to the file to download and host. |
password optional | string | Password protect the file. |
max_downloads optional | int | Auto-delete after N downloads. |
custom_slug optional | string | Custom URL slug. |
userhash optional | string | Link to your account. |
curl -X POST \ -F "url=https://example.com/file.zip" \ -F "custom_slug=my-file" \ https://yukiapi.site/upload-url
Create and host code snippets, logs, configuration files, notes, or plain text without creating a local file. Returns shareable URL and direct raw URL (like Pastebin/Hastebin).
| Parameter | Type | Description |
|---|---|---|
text required | string | The raw text content or code to host (max 10MB). |
filename optional | string | Custom filename (e.g. server.py, log.txt). |
extension optional | string | File extension / syntax (e.g. .py, .json, .txt, .sh, .md). |
password optional | string | Password protect the paste. |
max_downloads optional | int | Auto-delete after N views/downloads (1 = burn after reading). |
custom_slug optional | string | Custom URL slug. Example: my-script → /file/my-script & /raw/my-script |
# Fast CLI pipe into Yukisbox Pastebin cat my_script.py | curl -X POST -F "text=<-" -F "filename=my_script.py" https://yukiapi.site/upload-text # With custom slug and password curl -X POST \ -F "text=SECRET_TOKEN=xyz12345" \ -F "filename=config.env" \ -F "custom_slug=my-config" \ -F "password=secret" \ https://yukiapi.site/upload-text
import requests
code = """print("Hello from Yukisbox!")"""
resp = requests.post("https://yukiapi.site/upload-text", data={
"text": code,
"filename": "hello.py",
"custom_slug": "hello-py"
})
data = resp.json()
print("Paste URL:", data["url"])
print("Raw URL:", data["raw_url"])
{
"success": true,
"uid": "hello-py",
"url": "https://yukiapi.site/file/hello-py",
"raw_url": "https://yukiapi.site/raw/hello-py",
"filename": "hello.py",
"size": 31
}
Get metadata about any file by its UID — size, filename, download count, and protection status.
{
"uid": "abc123xy",
"filename": "photo.jpg",
"size": 2048576,
"mimetype": "image/jpeg",
"upload_time": "2026-06-25T04:22:15.123Z",
"download_count": 5,
"max_downloads": 0,
"is_password_protected": false
}
Retrieve all files linked to your account, including sizes and upload times.
curl "https://yukiapi.site/api/user/data?userhash=YOUR_API_HASH"
{
"user_hash": "YOUR_API_HASH",
"files": [
{
"uid": "abc123xy",
"filename": "photo.jpg",
"size": 2048576,
"upload_time": "2026-06-25T04:22:15Z",
"download_count": 5
}
]
}
Get global server health, uptime, and total file count.
{
"status": "online",
"uptime": "99.99%",
"total_files": 12847
}
Update a file's password, filename, or download limit. Requires your API hash. Send empty password to remove protection.
| Parameter | Type | Description |
|---|---|---|
userhash required | string | Your API hash |
filename optional | string | New filename |
password optional | string | New password (empty = remove) |
max_downloads optional | int | New download limit (0 = unlimited) |
curl -X PUT \ -d "userhash=YOUR_API_HASH&password=newpass&max_downloads=10" \ https://yukiapi.site/api/file/abc123xy/edit
Permanently delete a file from your account.
curl -X DELETE "https://yukiapi.site/api/file/abc123xy?userhash=YOUR_API_HASH"
Clone any file to your account without re-uploading. Creates a new permanent URL instantly.
curl -X POST "https://yukiapi.site/api/file/abc123xy/clone?userhash=YOUR_API_HASH"
{
"success": true,
"new_uid": "xyz987ba",
"url": "https://yukiapi.site/file/xyz987ba"
}
⚠️ Permanently delete ALL files from your account. This action cannot be undone.
curl -X DELETE "https://yukiapi.site/api/user/files/all?userhash=YOUR_API_HASH"