SPECIFICATION // DUAL PROTOCOL ENGINE

PROTOCOL SPECIFICATIONS

Fuxico is 100% drop-in compatible with the two most popular self-hosted file vault specifications in the Unix world: The Null Pointer (0x0.st) and rustypaste.

🌐 cURL Native Compatibility 🔑 X-Token Management Header 🛡️ Strict MIME & Subpath Aliasing

0️⃣ 1. The Null Pointer Protocol (0x0.st)

Send standard multipart forms via POST /:

Field / Parameter	Type	Description
`file`	File Multipart	File content payload to upload.
`url`	String URL	Instructs the server to download and store content from a remote URL.
`shorten`	String URL	Shortens the provided target URL and generates a redirect link.
`secret`	Flag / Empty	Generates an unguessable 16-character high-entropy secret slug.
`expires`	Integer / String	Retention duration in hours (e.g. `24`) or ms epoch timestamp.
`oneshot`	Flag / Boolean	If set, file evaporates immediately after its first download.

cURL Examples

curl — 0x0.st examples

# Upload with 24 hours expiration:
curl -F 'file=@photo.png' -F 'expires=24' https://fuxico.2lp.in/

# Shorten a URL:
curl -F 'shorten=https://codeberg.org/lumenpink/fuxico' https://fuxico.2lp.in/

# Manage / Delete using X-Token:
curl -F 'token=<X-Token>' -F 'delete=' https://fuxico.2lp.in/abcde.png

🦀 2. Rustypaste Protocol

Send files using HTTP headers for configuration:

Header / Endpoint	Format	Description
`expire: <duration>`	Header	Duration string: `10m`, `2h`, `7d`, etc.
`oneshot: true`	Header	Enables single-download self-destruction.
`filename: <name>`	Header	Custom filename alias override.
`DELETE /<slug>`	HTTP Method	Deletes an upload using `Authorization: Bearer <token>`.
`GET /list`	JSON Endpoint	Returns active uploads list in structured JSON format.

cURL Examples

curl — rustypaste examples

# Upload with 10 minutes lifetime header:
curl -F 'file=@secret.txt' -H 'expire: 10m' https://fuxico.2lp.in/

# Delete via DELETE method:
curl -X DELETE -H 'Authorization: Bearer <token>' https://fuxico.2lp.in/abcde.png

# List active uploads:
curl -H 'Authorization: Bearer <token>' https://fuxico.2lp.in/list

📎 3. Friendly Subpath Aliasing

Need to share a file so it saves with a recognizable human name rather than a random slug? Fuxico natively supports subpath aliasing:

Subpath URL Structure

https://fuxico.2lp.in/<slug>.<ext>/<friendly_filename>

Example: https://fuxico.2lp.in/8x9yt.png/avatar-lumen-2026.png streams the exact same payload while setting Content-Disposition: inline; filename="avatar-lumen-2026.png".