(DELETE) Delete tags

Permanently delete one or more tags (hard delete).

Endpoint

DELETE /api/tags

Delete one or more tags (hard delete). This permanently removes tags from your workspace.

Accepts an array of tag IDs to delete. All specified tags must belong to your workspace.

Endpoint text 
DELETE /api/tags

Authentication

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

Request Body

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

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

ParameterTypeRequiredDescription
body (body)array<string>YesArray of tag IDs (UUIDs) to delete. All IDs must be valid and belong to your workspace.

Request Size

Ensure the request body contains at least one valid tag ID.

Examples

Request cURL 
curl -X DELETE "https://hoko.to/api/tags" \
  -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/tags", {
  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 tags cannot be restored. This is a hard delete operation that permanently removes tags from your workspace. Links that had these tags will no longer have those tag associations.