set_tag
Update an existing animation tag in an Aseprite sprite by changing its name, color, direction, frame range, or repeat count. Use it to fix or adjust tag metadata without recreating the tag manually.
Instructions
Update an existing tag. Only the arguments you pass are changed.
Note: changing from_frame/to_frame recreates the tag in place to update its
range reliably across Aseprite versions. A frame that does not exist is rejected
with the sprite's valid range rather than clamped into it.
`repeats` is how many times the tag plays, with 0 meaning forever. It survives the
recreate above along with the name, direction and colour.
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": {
"filename": "<filename>",
"name": "<name>"
},
"name": "set_tag"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| color | No | ||
| repeats | No | ||
| filename | Yes | ||
| new_name | No | ||
| to_frame | No | ||
| direction | No | ||
| from_frame | No |