Skip to main content
Permanently delete a short link and its associated analytics data.

​
Endpoint

DELETE /api/links/{linkId}

​
Headers

​
Authorization
string
required
Bearer token for authentication

​
Path Parameters

​
linkId
string
required
Link UUID

​
Response

​
success
boolean
Returns true if deletion was successful

​
Example Request

curl -X DELETE "https://your-umami-instance.com/api/links/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Example Response

{
  "success": true
}

​
Error Responses

​
401
error
Unauthorized - You don’t have permission to delete this link
​
404
error
Not Found - Link does not exist
This action is permanent and cannot be undone. The short URL will stop working immediately, and all associated analytics data will be deleted.
You must have delete permissions for the link to remove it.

Build docs developers (and LLMs) love

Get started for freeTalk to us