Create Short URL

Shorten a URL

post

This endpoint shortens a long URL, optionally with a custom alias.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

longUrlstringRequired

The long URL to shorten.

Example: https://www.example.com

customAliasstringOptional

A custom alias for the shortened URL (optional).

Example: customalias

topicstringOptional

A topic or category for the URL (optional).

Example: test

Responses

200

URL successfully shortened.

application/json

401

Unauthorized, invalid or expired token.

application/json

419

Missing required field longUrl.

application/json

post

/shorten

HTTPcURLJavaScriptPython

POST /api/shorten HTTP/1.1
Host: minifyurl.choreoapps.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 80

{
  "longUrl": "https://www.example.com",
  "customAlias": "customalias",
  "topic": "test"
}

{
  "shortUrl": "https://minifyurl.choreoapps.dev/api/shorten/eOE4a_w0",
  "createdAt": "2025-01-19T12:38:04.242Z"
}