Get started

Quickstart

Upload a file and get a link back in two minutes.

  1. 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:read and files:write. Copy it: it's only shown once.

  2. 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
  3. Use the link

    url is a permanent CDN link, and markdown is 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": "![q3-revenue](https://cdn.drop.media/acme/q3-revenue.png)",
            "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"
        }
    }
  4. Make it private, or make it expire

    Add visibility=private for a signed link that expires, and expires_in to 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