Share a file

Send the file as the request body and get a short link to it. snip.link/<code> shows the file with a download button and its QR code, snip.link/<code>.<its extension> is the file itself, and any other ending converts it (.pdf, .png, .md ...). Send Content-Length; name the file with ?name= or an X-File-Name header. Free shares files up to 100 MB and keeps 5 GB of them; Pro shares files up to 5 GB and keeps 100 GB. Programs and installers are never accepted. The same works without an API: curl -T photo.jpg https://snip.link. Also available as the MCP tool drop_file.

Parameters

Example request

curl -s -X POST "https://snip.link/v1/drops?name=spring-menu.pdf&ending=menu" \
  -H "Authorization: Bearer $SNIP_KEY"

Example response

{
  "link": {
    "id": "lnk_7f0c2a2b4bb04a8b",
    "code": "spring-menu",
    "domain": "snip.link",
    "short_url": "https://snip.link/spring-menu",
    "url": "https://example.com/menus/spring-2026",
    "title": "Spring menu",
    "redirect": 302,
    "disabled": false,
    "held": false,
    "expires_at": null,
    "expired_url": null,
    "expired": false,
    "starts_at": null,
    "scheduled": false,
    "max_clicks": null,
    "limit_reached": false,
    "track": true,
    "password_protected": false,
    "routes": [
      {
        "when": "all",
        "conditions": [
          {
            "kind": "os",
            "values": [
              "ios"
            ]
          }
        ],
        "url": "https://apps.apple.com/app/id1234567890",
        "match": "ios"
      },
      {
        "name": "Lunch menu",
        "when": "all",
        "conditions": [
          {
            "kind": "time",
            "from": "11:00",
            "to": "15:00",
            "tz": "America/New_York"
          },
          {
            "kind": "weekday",
            "values": [
              1,
              2,
              3,
              4,
              5
            ],
            "tz": "America/New_York"
          }
        ],
        "url": "https://example.com/menus/lunch"
      }
    ],
    "forward_query": false,
    "preview": {
      "title": "Spring menu",
      "description": "Twelve new dishes, out now.",
      "image": "screenshot"
    },
    "health": {
      "status": "ok",
      "code": 200,
      "checked_at": "2026-10-20T08:00:00.000Z"
    },
    "clicks": 1284,
    "qr_style": {
      "style": "rounded",
      "fg": "#111111",
      "bg": "#ffffff",
      "ecc": "M"
    },
    "qr_png_url": "https://snip.link/qr.png?data=https%3A%2F%2Fsnip.link%2Fspring-menu%3Fqr%3D1",
    "qr_svg_url": "https://snip.link/qr.svg?data=https%3A%2F%2Fsnip.link%2Fspring-menu%3Fqr%3D1",
    "snapshots": "public",
    "watch": null,
    "file": null,
    "stats_url": null,
    "created_at": "2026-10-01T09:12:40.000Z",
    "updated_at": "2026-10-18T16:03:11.000Z"
  }
}

Response fields

Errors