MZ.DROP

Temporary file hoster, inspired by 0x0.st .

A personal service for quick file sharing.

min_age = 1 days
max_age = 30 days
max_size = 512.0 MiB
retention = min_age + (min_age - max_age) * pow((file_size / max_size - 1), 3)
   days
   30  |  \
       |   \
       |    \
       |     \
       |      \
       |       \
       |        ..
       |          \
   15  | ----------..-------------------------------------------
       |             ..
       |               \
       |                ..
       |                  ...
       |                     ..
       |                       ...
       |                          ....
       |                              ......
    1  |                                    ....................
         0                      256.0                      512.0
                                                             MiB
    
Uploading files
Send HTTP POST requests to https://dump.mz.uy/ with data encoded as multipart/form-data

Valid fields are:
  ┌─────────┬────────────┬──────────────────────────────────────────────────┐
  │ field   │ content    │ remarks                                          │
  ╞═════════╪════════════╪══════════════════════════════════════════════════╡
  │ file    │ data       │                                                  │
  ├─────────┼────────────┼──────────────────────────────────────────────────┤
  │ url     │ remote URL │ Mutually exclusive with "file".                  │
  │         │            │ Remote site must return Content-Length header.   │
  ├─────────┼────────────┼──────────────────────────────────────────────────┤
  │ secret  │ (ignored)  │ If present, a longer, hard-to-guess URL          │
  │         │            │ will be generated.                               │
  ├─────────┼────────────┼──────────────────────────────────────────────────┤
  │ one_time│ (ignored)  │ If present, file will be deleted after first     │
  │         │            │ download or view.                                │
  │         │            │                                                  │
  │         │            │ When sharing one time links some bots may        │
  │         │            │ consume the link immediately.                    │
  ├─────────┼────────────┼──────────────────────────────────────────────────┤
  │ expires │ time       │ Sets file expiration time. Accepts:              │
  │         │ format     │ - Hours as integer (e.g., 24)                    │
  │         │            │ - Milliseconds since epoch (e.g., 1681996320000) │
  │         │            │ - RFC3339 (e.g., 2006-01-02T15:04:05Z07:00)      │
  │         │            │ - ISO date (e.g., 2006-01-02)                    │
  │         │            │ - ISO datetime (e.g., 2006-01-02T15:04:05)       │
  │         │            │ - SQL datetime (e.g., 2006-01-02 15:04:05)       │
  └─────────┴────────────┴──────────────────────────────────────────────────┘

cURL examples
    Uploading a file:
        curl -F'file=@yourfile.png' https://dump.mz.uy/

    Copy a file from a remote URL:
        curl -F'url=http://example.com/image.jpg' https://dump.mz.uy/

    Same, but with hard-to-guess URLs:
        curl -F'file=@yourfile.png' -Fsecret= https://dump.mz.uy/
        curl -F'url=http://example.com/image.jpg' -Fsecret= https://dump.mz.uy/

    Create a one-time download link (file is deleted after first download):
        curl -F'file=@yourfile.png' -Fone_time= https://dump.mz.uy/

    Setting retention time in hours:
        curl -F'file=@yourfile.png' -Fexpires=24 https://dump.mz.uy/

    Setting expiration date with milliseconds since UNIX epoch:
        curl -F'file=@yourfile.png' -Fexpires=1681996320000 https://dump.mz.uy/

    Setting expiration date with RFC3339 format:
        curl -F'file=@yourfile.png' -Fexpires=2023-04-20T10:15:30Z https://dump.mz.uy/

    Setting expiration date with ISO date format:
        curl -F'file=@yourfile.png' -Fexpires=2023-04-20 https://dump.mz.uy/

    Setting expiration date with ISO datetime format:
        curl -F'file=@yourfile.png' -Fexpires=2023-04-20T10:15:30 https://dump.mz.uy/

    Setting expiration date with SQL datetime format:
        curl -F'file=@yourfile.png' -Fexpires="2023-04-20 10:15:30" https://dump.mz.uy/

    Combining options (one-time view with expiration and secret URL):
        curl -F'file=@yourfile.png' -Fone_time= -Fsecret= -Fexpires=24 https://dump.mz.uy/
	

It is possible to append a custom file name to any URL:
https://dump.mz.uy/aaa.jpg/image.jpeg

File URLs are valid for at least 1 days and up to 30 days (see above).

Expired files won't be removed immediately but within the next 60 minutes.

Maximum file size: 512.0 MiB (see above).

Managing your files
	Whenever a file that does not already exist or has expired is uploaded,
	the HTTP response header includes an X-Token field. You can use this
	to perform management operations on the file by sending POST requests
	to the file URL.
	When using cURL, you can add the -i option to view the response header.
	Valid fields are:
	┌─────────┬────────────┬──────────────────────────────────────────────────┐
	│ field   │ content    │ remarks                                          │
	╞═════════╪════════════╪══════════════════════════════════════════════════╡
	│ token   │ management │ Returned after upload in X-Token HTTP header     │
	│         │ token      │ field. Required.                                 │
	├─────────┼────────────┼──────────────────────────────────────────────────┤
	│ delete  │ (ignored)  │ Removes the file.                                │
	├─────────┼────────────┼──────────────────────────────────────────────────┤
	│ expires │ time       │ Sets file expiration time. Accepts:              │
	│         │ format     │ - Hours as integer (e.g., 24)                    │
	│         │            │ - Milliseconds since epoch (e.g., 1681996320000) │
	│         │            │ - RFC3339 (e.g., 2006-01-02T15:04:05Z07:00)      │
	│         │            │ - ISO date (e.g., 2006-01-02)                    │
	│         │            │ - ISO datetime (e.g., 2006-01-02T15:04:05)       │
	│         │            │ - SQL datetime (e.g., 2006-01-02 15:04:05)       │
	└─────────┴────────────┴──────────────────────────────────────────────────┘
cURL examples

Delete a file immediately:

curl -X POST -F'token=token_here' -F'delete=' https://dump.mz.uy/abc.txt

Change the expiration date (see above):

curl -X POST -F'token=token_here' -F'expires=3' https://dump.mz.uy/abc.txt
Terms of Service

This service is NOT a platform for:

Uploads found to be in violation of these rules will be removed, and the originating IP address may be blocked from further uploads.

Privacy Policy

For the purpose of moderation, the following is stored with each uploaded file:

This site generally does not log requests, but may enable logging if necessary for purposes such as threat mitigation.

No data is shared with third parties.


Personal instance inspired by 0x0.st.

Hosted on mz.uy for personal use.