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.

  1. 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

    Private files are never on the CDN. The response's url is already a signed link that works for an hour.

  2. 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
    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"
        }
    }
  3. Send it

    After url_expires_at the 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.shared event, so you can see when links were handed out.