DELETE /api/tags/{tag_id}
Permanently deletes a tag. This endpoint is restricted to administrators.
Because tasks and tags share a many-to-many relationship, deleting a tag only removes the tag record and its associations — the tasks themselves are not affected.
Authentication
Requires a valid Bearer access token. The authenticated user must have the admin role.Path Parameters
The ID of the tag to delete.
Response
true when the deletion succeeds.Human-readable confirmation that the tag was deleted.
Errors
| Status | Description |
|---|---|
401 | Missing or invalid access token. |
403 | The authenticated user does not have the admin role. |
404 | No tag exists with the given tag_id. |