# Delete a tag

`DELETE https://api.cademi.com.br/api/v3/tags/{tag_id}`

Operation ID: `tags.delete` · API v3

Moves the tag to the trash and removes it from every user it is assigned to.

A tag used by an access rule cannot be deleted; the API returns `409 Conflict` with the `tag_in_use` error code.

Replicated tags are read-only and cannot be deleted. Attempts to delete them return `403 Forbidden` with the `replica_readonly` error code.

Required permissions: `tags.delete`.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `tag_id` | path | string | yes |  |

## Responses

### 204

The tag was deleted successfully.

### 401

The credential is missing, malformed, expired, or revoked.

Body: Error.

### 403

The current credentials do not have the permission required by this operation.

Body: Error.

### 404

The tag was not found or is not accessible with the current credentials.

Body: Error.

### 409

The tag is used by an access rule and cannot be deleted.

Body: Error.

Full schema: https://cademi.dev/openapi/v3.json