Scenarios
Private links for clients
Send a contract, a draft design or an invoice to a client with a link that stops working, while the file stays safely in your library.
-
Upload the file as private
$ curl https://drop.media/api/v1/files \ -H "Authorization: Bearer YOUR_API_KEY" \ -F file=@contract-draft.pdf -F visibility=private$ drop contract-draft.pdf --private> Upload contract-draft.pdf to drop as private.Private files are never on the CDN. The response's
urlis already a signed link that works for an hour. -
Make a link that lasts as long as you need
Ask for a link with a
ttl, up to 7 days:$ curl -X POST https://drop.media/api/v1/files/FILE_ID/link \ -H "Authorization: Bearer YOUR_API_KEY" -d ttl=3d$ drop link FILE_ID --ttl 3d> Give me a link to the contract draft that works for 3 days.Response{ "data": { "id": "7c1e4b2a-5d3f-4a8e-b6c9-0f2d8e4a1b37", "url": "https://drop.media/p/7c1e4b2a-5d3f-4a8e-b6c9-0f2d8e4a1b37?ref=4821&expires=1795521600&signature=8f3c\u2026", "url_expires_at": "2026-11-19T10:30:00+00:00", "thumbnail_url": "https://drop.media/p/7c1e4b2a-5d3f-4a8e-b6c9-0f2d8e4a1b37?ref=4821&expires=1795521600&signature=8f3c\u2026&thumbnail=1", "markdown": "[contract-draft.pdf](https://drop.media/p/7c1e4b2a-5d3f-4a8e-b6c9-0f2d8e4a1b37?ref=4821&expires=1795521600&signature=8f3c\u2026)", "name": "contract-draft.pdf", "mime_type": "application/pdf", "size": 284113, "width": null, "height": null, "visibility": "private", "expires_at": null, "source": "api", "prompt": null, "model": null, "created_at": "2026-11-18T09:30:00+00:00" } } -
Send it
After
url_expires_atthe link stops working. The file doesn't: make a new link whenever the client needs it again.
Notes
- Anyone with an unexpired link can open the file, so keep the time short for anything sensitive.
- To get rid of the file itself later, give it an expiry when you upload it (
expires_in=30d) or delete it. - Each link made is a
file.sharedevent, so you can see when links were handed out.