Convert a character to its ruleset's successor
vault_convert_characterMake the version of a character in the ruleset that succeeds its own (the preview's ruleset.to), as its linked sheet there, owned by the original's owner (it counts against the owner's character limit unless a blank linked sheet is being filled in). The original is not changed. Call vault_preview_character_conversion first, show the user its report, and convert only when they agree: pass updatedAt from the preview's character.updatedAt. Vault makes the plan again from the stored character, so the result is what the preview forecast. The new character arrives fully rested, keeps the original's gear, numbers, settings, and notes, and carries the conversion's report as a note. Returns the new character document with _conversionReport, the same shape as the preview's report: what was converted, the choices vault made, what is not in the newer ruleset and was kept, what was carried as is, what was left behind, what was not added, the totals that come out different, and anything that failed (a campaign seat that could not be made; the character still exists). Show the user that report as vault gives it, each row as its name, then its text, then its note; do not compose one. Vault answers 409 when the character changed since the preview (preview again) or already has a used linked sheet in that ruleset, 403 for the character limit or the ruleset, and 404 for an unknown character or one the user may not edit. A conversion that fails leaves nothing behind. A 500 here is a fault in vault's own content that this character's conversion ran into; trying again will not fix it, so tell the user it needs reporting.
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>",
"updatedAt": "<updatedAt>"
},
"name": "vault_convert_character"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Mongo `_id` of the character to convert (owned by the calling user, or any character for an admin with Admin Mode on). | |
| updatedAt | Yes | `character.updatedAt` exactly as the preview returned it. Vault answers 409 when the character has changed since; preview again. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||