Files and links
Public and private files, expiry, names, file types and plan limits.
Public and private
Every file is either public or private. New files are public unless you say otherwise.
| public | A permanent CDN link, like https://cdn.drop.media/acme/q3-revenue.png. Anyone with the link can open it, and it never changes, so it's safe to put in a page, a README or an email. |
| private | Never on the CDN. It's only reachable through a signed link that stops working, by default after an hour and at most after 7 days. Make a new link whenever you need one. |
Choose with visibility on the API and MCP tools, --private on the CLI, +private on an email address, or a private/ folder over SFTP.
Expiry
Give a file an expiry and it's deleted automatically when it passes, link and all. It's the easy way to keep a library tidy: screenshots for a pull request rarely need to outlive it.
- Durations: a number and a unit,
m(minutes),h,dorw, e.g.30m,12h,7d,2w. An ISO 8601 date also works. - At least a minute, and at most 365 days away (7 days on the free plan, where every file expires).
- Set it with
expires_in,--expires,+7don an email address, or anexpires-7d/folder over SFTP.
A deleted or expired file sends a file.deleted or file.expired webhook.
Names and links
A file's id is a random UUID, and it's also the last part of its link. Pass name (letters, numbers, dashes and underscores, up to 100) to use a readable one instead: name=q3-revenue gives https://cdn.drop.media/acme/q3-revenue.png. Every account has its own folder, acme here, chosen when the account was made.
Responses include markdown, a ready-made snippet: an image for images, a link for anything else.
File types
- Images: PNG, JPG, GIF, WebP, SVG, AVIF, HEIC
- Documents: PDF, TXT, MD, CSV, JSON, LOG, DOCX, XLSX, PPTX
- Video: MP4, MOV, WebM
- Audio: MP3, WAV, M4A
The type is checked from the file's contents, not just its name. Anything else is refused with 422 and the reason. GET /me returns the exact list as limits.file_types.
Plan limits
| Free | Files up to 10 MB, 5 uploads in total, 50 MB of storage, every file deleted after at most 7 days. |
| Standard | Files up to 100 MB and 10 GB of storage. Links are permanent. |
| Pro | Files up to 500 MB (5 GB with direct uploads), 100 GB of storage included, then pay for what you use. |
GET /me returns the account's current limits and how much is used. See pricing for the plans.
Fetching from a URL
The API and MCP upload_file can fetch a file from a url instead of receiving it. Only public internet addresses are fetched: private, loopback and link-local addresses are refused, including after a redirect.