update_heir
Destructive
Update an existing heir's details. Use when the user wants to correct or add information to a recorded heir. Get the heir_id from the pre-loaded Heirs context block.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Updated full legal name | |
| No | Updated email address (empty string clears it) | ||
| notes | No | Updated free-text notes about this heir (empty string clears). Use for context like whereabouts unknown, predeceased details, per-stirpes notes, disputes, or anything the user wants remembered. | |
| phone | No | Updated phone number (empty string clears it) | |
| address | No | Updated mailing address (empty string clears it) | |
| heir_id | Yes | ID of the heir to update | |
| is_minor | No | Whether the heir is under 18 | |
| estate_id | Yes | The estate to act on. Call list_my_estates first to get this id. | |
| is_deceased | No | Whether the heir is deceased | |
| is_divorced | No | For a spouse only: whether they are a divorced/former spouse (not a surviving spouse). | |
| relationship | No | Updated relationship to the deceased. Canonical values: spouse, child, stepchild, grandchild, parent, sibling, other. Free-text wording (e.g. 'half-brother') is accepted and normalized automatically. | |
| relationship_detail | No | The relationship exactly as the user described it, when it carries more than the canonical value (empty string clears it). Shown on probate forms. |