Saved Roll Update
saved_roll_updateUpdate a saved roll's name or expression in your CozyVTT campaign. Provide the roll's ID and at least one new value; validation and ownership checks are handled automatically.
Instructions
Change the name or expression of your Saved Roll in this campaign. Use saved_roll_list to find its ID; use dice_roll to execute it. Supply at least one field; null leaves that field unchanged. Upstream validates expressions and enforces per-user/per-campaign ownership. Replacing values does not roll dice; repeated writes may change update metadata, so full-operation idempotency is not guaranteed. 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": {
"macro_id": "<macro_id>"
},
"name": "saved_roll_update"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Replacement display label, trimmed to 1..60 characters; null preserves it. At least one of name/expression is required. | |
| macro_id | Yes | Existing Saved Roll ID owned by the current user in this campaign. | |
| expression | No | Replacement expression, trimmed to 1..200 characters and parsed upstream; null preserves it. At least one field is required. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||