Upload Files

POST /upload

Basic Upload

curl -F '[email protected]' https://clipbin.net/upload

Complete Example with All Options

curl -F '[email protected]' \ -F 'password=mysecretpassword123' \ -F 'expires_in=1440' \ -F 'max_views=10' \ -F 'custom_url=my-secret-file' \ -F 'one_time_view=true' \ https://clipbin.net/upload

Parameters

file (required): The file to upload. Use @filename to upload from filesystem.

password (optional): Password to protect the clip.

expires_in (optional): Expiration time in minutes. Default: 60 minutes.
Options: 5, 15, 60, 360, 1440, 10080, 43200

max_views (optional): Maximum number of views. Default: 1.
Options: 1, 5, 10, 25, 100, 0 (unlimited)

custom_url (optional): Custom URL for the clip.
Only letters, numbers, hyphens and underscores allowed.

one_time_view (optional): Set to 'true' for burn-after-reading.

Supported File Types

Text and code files are supported. Categories include:

Text & Config: .txt, .md, .json, .xml, .csv, .log, .yaml, .yml, .ini, .conf, .toml, .properties, .env, .cfg, .config, .settings, .plist, .reg

Programming: .go, .py, .js, .ts, .java, .c, .cpp, .h, .hpp, .cs, .php, .rb, .rs, .kt, .swift, .dart, .scala, .clj, .hs, .ml, .fs, .vb, .pas, .pl, .r, .m, .lua, .nim, .zig, .jl, .elm, .ex, .exs, .erl, .hrl, .cr, .d, .f90, .f95, .f03, .f08, .for, .ftn, .f, .cob, .cbl, .ada, .adb, .ads

Web: .html, .htm, .css, .scss, .sass, .less, .jsx, .tsx, .vue, .svelte, .astro

Scripts: .sh, .bash, .zsh, .fish, .csh, .tcsh, .ksh, .bat, .cmd, .ps1, .psm1, .psd1

Database: .sql, .mysql, .pgsql, .sqlite, .nosql, .cql, .cypher, .sparql

Documentation: .rst, .tex, .latex, .adoc, .asciidoc, .org, .wiki, .textile

Build & Deploy: .dockerfile, .makefile, .cmake, .gradle, .maven, .ant, .sbt, .cabal, .stack, .cargo, .mix, .rebar, .dub, .nimble, .shards

Version Control: .gitignore, .gitattributes, .gitmodules, .hgignore, .bzrignore, .svnignore

Package Managers: .lock, .sum, .resolved, .frozen

Other: .proto, .graphql, .gql, .thrift, .avro, .schema, .xsd, .dtd, .rng, .rnc

File Size Limit

Maximum file size: 10 MB

Response

Successful upload returns JSON with clip information:

{
  "url": "clipbin.net/abc123",
  "file_name": "README.md",
  "expires_at": "2024-01-01T12:00:00Z"
}

Tips

Use @ before filename to upload from your local filesystem
Combine multiple parameters with -F flags
Use \ for line continuation in long commands
Files are automatically deleted after expiration or max views
Password-protected clips can be accessed through the web interface