// public api
Free developer API.
Shorten URLs, share text, and upload files programmatically. No API key, no signup.
Base URL: https://warp.link
POST
/api/public/shortenCreate a short link. Optional 'slug'; if omitted a random one is generated.
// request body
{
"url": "https://example.com/long/path",
"slug": "mylink" // optional
}// example (curl)
curl -X POST https://warp.link/api/public/shorten \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com"}'// response
{
"slug": "mylink",
"url": "https://warp.link/mylink",
"target": "https://example.com/long/path"
}POST
/api/public/textCreate a text share. Max 100,000 characters.
// request body
{
"content": "hello world",
"slug": "note" // optional
}// example (curl)
curl -X POST https://warp.link/api/public/text \
-H "Content-Type: application/json" \
-d '{"content":"hello world"}'// response
{
"slug": "note",
"url": "https://warp.link/t/note"
}POST
/api/public/uploadUpload a file (multipart/form-data). Max 1 GB.
// request body
file: <binary> (required)
slug: "payload" (optional form field)// example (curl)
curl -X POST https://warp.link/api/public/upload \
-F "file=@./photo.png" \
-F "slug=photo"// response
{
"slug": "photo",
"url": "https://warp.link/f/photo",
"original_name": "photo.png",
"size_bytes": 12345,
"mime_type": "image/png"
}// errors return { "error": "..." } with appropriate HTTP status