Get started
Quickstart
Upload a file and get a link back in two minutes.
-
Create an account and an API key
Sign up, verify your email address, then Open API in the app and create a key with
files:readandfiles:write. Copy it: it's only shown once. -
Upload a file
Send it as multipart form data. The response is the stored file, with its link.
$ curl https://drop.media/api/v1/files \ -H "Authorization: Bearer YOUR_API_KEY" \ -F file=@chart.png$ npm install -g drop-media $ drop login YOUR_API_KEY $ drop chart.pngimport fs from 'node:fs/promises'; const form = new FormData(); form.append('file', new Blob([await fs.readFile('chart.png')]), 'chart.png'); const res = await fetch('https://drop.media/api/v1/files', { method: 'POST', headers: { Authorization: `Bearer ${process.env.DROP_API_KEY}` }, body: form, }); const { data } = await res.json(); console.log(data.url);import os, requests res = requests.post( 'https://drop.media/api/v1/files', headers={'Authorization': f"Bearer {os.environ['DROP_API_KEY']}"}, files={'file': open('chart.png', 'rb')}, ) print(res.json()['data']['url']) -
Use the link
urlis a permanent CDN link, andmarkdownis ready to paste into a pull request, an issue or a doc.Response{ "data": { "id": "q3-revenue", "url": "https://cdn.drop.media/acme/q3-revenue.png", "url_expires_at": null, "thumbnail_url": "https://cdn.drop.media/acme/thumbnail/q3-revenue.png", "markdown": "", "name": "q3-revenue.png", "mime_type": "image/png", "size": 48213, "width": 1600, "height": 900, "visibility": "public", "expires_at": "2026-12-18T09:30:00+00:00", "source": "api", "prompt": null, "model": null, "created_at": "2026-11-18T09:30:00+00:00" } } -
Make it private, or make it expire
Add
visibility=privatefor a signed link that expires, andexpires_into delete the file automatically:$ curl https://drop.media/api/v1/files \ -H "Authorization: Bearer YOUR_API_KEY" \ -F file=@report.pdf -F visibility=private -F expires_in=7d
Next
- Connect an AI agent so it can upload and find files itself.
- Read the Files API for search, share links and deleting.
- See what you can build in the scenarios.