# Delete a tag

`DELETE /api/tag/{tagId}`

URL: https://repsona.com/api/delete-tag-tagid

Removes the tag together with its task/note/project/user assignments. Admin only.

## Parameters

| name | in | type | required | description |
| --- | --- | --- | --- | --- |
| `tagId` | path | integer | required | The ID of the tag. |

## Request

```sh
curl -X DELETE "https://<space>.repsona.com/api/tag/{tagId}" \
  -H "Authorization: Bearer $REPSONA_API_KEY"
```

## Responses

- 200: Deleted
- 401: Authentication is required
- 403: Admin only
- 404: Tag not found

## Example response

```json
{
  "ok": true
}
```