Update token
update-tokenUpdate map token properties (position, size, rotation, hidden, disposition, name, elevation, lock rotation) and verify changes via read-back.
Instructions
Change properties of a token on the map (not of its actor): position, size in grid spaces, rotation, hidden, disposition (-2 secret, -1 hostile, 0 neutral, 1 friendly), displayed name, elevation, rotation lock. Other fields are refused with their names. Every change is read back; values Foundry stored differently come as warnings.
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": {
"tokenId": "<tokenId>",
"updates": "<updates>"
},
"name": "update-token"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tokenId | Yes | Id of the token on that scene, as get-current-scene lists it. Not a name, not an actor id. | |
| updates | Yes | The properties to change | |
| sceneIdentifier | No | Scene of the token, by id or name. Without it the scene that is active for everyone is used; every answer names the scene. |