(DELETE) Delete links

Delete one or more links using soft delete. Historical analytics data is preserved.

Endpoint

DELETE /api/links

Delete one or more links using soft delete. Soft delete marks links as deleted without permanently removing them from the database, allowing for potential recovery and maintaining referential integrity.

Accepts an array of link IDs to delete. All specified links must belong to your workspace. The endpoint returns the IDs of successfully deleted links.

Deleted links are no longer accessible via the API and will not appear in GET requests, but historical analytics data associated with these links is preserved.

Endpoint text

DELETE /api/links

Authentication

Requires authentication with an API key that has the linksWrite scope.

Request Body

The request body must be an array of link IDs (UUIDs) to delete.

You can delete up to 10,000 links in a single request. However, the actual maximum may be lower based on your subscription plan limits and available resources.

Parameter	Type	Required	Description
`body` (body)	array<string>	Yes	Array of link IDs (UUIDs) to delete. All IDs must be valid and belong to your workspace.

Request Size

You can delete up to 10,000 links in a single request. Requests above 10,000 IDs are rejected.

Examples

Request cURL

curl -X DELETE "https://hoko.to/api/links" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '[
    "550e8400-e29b-41d4-a716-446655440000"
  ]'

Request JavaScript

const response = await fetch("https://hoko.to/api/links", {
  method: "DELETE",
  headers: {
    "Authorization": "Bearer <API_KEY>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify([
    "550e8400-e29b-41d4-a716-446655440000"
  ])
});
const result = await response.json();

Response json

{
  "deletedIds": [
    "550e8400-e29b-41d4-a716-446655440000"
  ]
}

Permanent Action

Deleted links cannot be restored through the API. While the data is preserved for analytics purposes, the links themselves are no longer accessible. Ensure you have backups or exports before performing bulk deletions.