Token Delete
token_deleteRemove a placed map token from a CozyVTT campaign map as a DM; this deletes the map token and linked combatants, not the character sheet or HP.
Instructions
Delete one token from a campaign map (DM only). Use token_move to reposition a token instead. Use token_hp_update for a signed sheet HP adjustment through WS: that tool takes a character ID, whereas this tool takes a map token ID. Deletion removes the placed token, not its linked character sheet or HP. v1.5.0 also removes its combatants and repairs initiative order; do not send a second initiative write. It is destructive and has no undo tool. Repeating leaves the token absent but may return a not-found error. Returns upstream {message} in data without a broadcast receipt; REST permission and resource errors retain upstream diagnostics. Returns {ok:true,data} on success; tool-body failures return {ok:false,error} with optional diagnostic data. Argument-schema errors are MCP errors.
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": {
"map_id": "<map_id>",
"token_id": "<token_id>"
},
"name": "token_delete"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| map_id | Yes | Map ID containing the token in the configured campaign. | |
| token_id | Yes | Map token ID to remove, not a character sheet ID. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||