Get started

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.

publicA 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.
privateNever 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, d or w, 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, +7d on an email address, or an expires-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

FreeFiles up to 10 MB, 5 uploads in total, 50 MB of storage, every file deleted after at most 7 days.
StandardFiles up to 100 MB and 10 GB of storage. Links are permanent.
ProFiles 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.