(DELETE) Delete tags
Permanently delete one or more tags (hard delete).
Endpoint
DELETE /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.
DELETE /tagsAuthentication
Requires an authorized credential with permission for tagsWrite. API keys are one supported credential; eligible OAuth or authenticated sessions may also authorize this operation.
Request Body
The request body must be an array of tag IDs (ULIDs) to delete.
You can delete up to 10,000 tags in a single request. Requests above 10,000 IDs are rejected.
Request Size
Ensure the request body contains at least one valid tag ID.
Examples
curl -X DELETE "https://api.hoko.to/tags" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json" \
-d '[
"<tag_id>"
]'const response = await fetch('https://api.hoko.to/tags', {
method: 'DELETE',
headers: {
Authorization: 'Bearer <API_KEY>',
'Content-Type': 'application/json'
},
body: JSON.stringify(['<tag_id>'])
});
const result = await response.json();{
"deletedIds": ["<tag_id>"]
}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.