deleteTag
Permanently remove a tag from the directory by its ID. Irreversible action; use when you need to delete a tag entirely.
Instructions
Delete a tag - Permanently delete a tag record by ID. Destructive - cannot be undone via API.
Use when: removing a tag entirely. Tag-relationships (rel_tags) pointing at it may orphan.
Required: id.
See also: updateTag (modify without removing).
Destructive: confirm intent with the user before bulk use. No soft-delete via API - records removed are not recoverable.
Returns: { status: "success", message: "record was deleted" }. No body beyond the confirmation string.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "deleteTag"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes |