cutline
PricingSign in
Developer API

Programmatic link creation.

Generate short links from your backend, CI/CD pipeline, or client dashboards. Authenticate with a workspace API key and receive an instant 301-ready short URL.

Endpoint

POST /api/public/v1/links
POST /api/public/v1/links
Content-Type: application/json
Authorization: Bearer <API_KEY>

Request body

application/json
{
  "original_url": "https://example.com/a/very/long/path"
}

Response

200 OK
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "short_code": "a3k9xZ",
  "short_url": "https://cutline.example.com/r/a3k9xZ",
  "original_url": "https://example.com/a/very/long/path",
  "created_at": "2026-08-07T14:53:00.000Z"
}

Example curl

curl
curl -X POST https://cutline.example.com/api/public/v1/links \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"original_url": "https://example.com/a/very/long/path"}'

Errors

  • 401 Unauthorized — Missing or invalid API key.
  • 422 Unprocessable Entity — Invalid or missing original_url.

Ready to integrate?

Create a workspace, generate an API key, and start shortening programmatically.

Get API access