r301.dev

API-first URL shortener

Short links.
Clean code.

A lightweight URL shortening API with zero fluff. Drop it into your backend, authenticate, and start generating custom short links in under two minutes.

Create a short link

POST /v1/links

Request

Authorization: Bearer r301_live_…

{
  "destination": "https://clinic.example.com/appt/9182",
  "slug": "visit-9182",
  "expires_at": "2027-03-31T12:00:00Z",
  "tags": ["tenant:42", "kind:appointment"]
}

Response 201

{
  "slug": "visit-9182",
  "short_url": "https://r301.dev/visit-9182",
  "destination": "https://clinic.example.com/appt/9182",
  "redirect_type": 302,
  "is_active": true,
  "expires_at": "2027-03-31T12:00:00Z",
  "tags": ["tenant:42", "kind:appointment"],
  "external_id": null,
  "created_at": "2026-09-06T10:00:00Z",
  "updated_at": "2026-09-06T10:00:00Z"
}
  1. API-first

    No dashboard, no console to click through. Your code creates the links and retires them, over plain REST.

  2. Served at the edge

    Every redirect is answered by a Cloudflare Worker at the point of presence nearest the click, reading a KV-cached copy of the link.

  3. Safe by default

    Deleting a link tombstones it: the redirect 404s at once and the slug stays blocked, so nobody inherits a link you retired. Reserved words are blocked. Unknown fields are rejected, not quietly ignored.