Lawmatics MCP Tool - Update Matter

Q: What does the Update Matter tool do?

This page documents the Update Matter tool (lawmatics_update-matter). Update an existing matter (legal case) in Lawmatics by ID: case title, contact fields, practice area, sub-status, staff assignment, tags, notes, and custom field values. It is one of the Lawmatics Matters tools, invoked through your firm's Weave MCP connection and available to members whose access level permits it.

Update Matter (lawmatics_update-matter)

Update an existing matter (legal case) in Lawmatics by ID: case title, contact fields, practice area, sub-status, staff assignment, tags, notes, and custom field values.

Tool Input

matterIdstring— ID of the matter to update; a numeric string (e.g. '25')(pattern: ^\d+$)

caseTitlestring— Title of the matter/case

firstNamestring— First name to set on the matter's contact

lastNamestring— Last name to set on the matter's contact

emailstring(email)— Email address to set on the matter's contact(pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$)

phonestring— Phone number to set on the matter's contact

practiceAreaIdstring— ID of the practice area to assign; a numeric string (e.g. '986')(pattern: ^\d+$)

subStatusIdstring— ID of the sub-status to assign; a numeric string (e.g. '6')(pattern: ^\d+$)

assignedStaffIdsarray— User IDs of staff to assign to the matter; numeric strings. Replaces the current assignment; pass an empty array to unassign all staff

[]string(pattern: ^\d+$)

notesarray— Notes to create inline on update (write-only; not returned)

[]object

namestring— Note title

bodystring— Note content

tagsarray— Tag names to attach to the matter; missing tags are created

[]string

customFieldsarray— Custom field values to set; pass null as a value to clear that field

[]object

idstringnumber— Custom field ID (the API returns it as a number; either a string or number is accepted)

valuestringnumberbooleannull— Value to set (matches the field's type); pass null to clear the field

Tool Output

idstring— Lawmatics matter ID of the updated matter

firstNamestringnull— First name of the matter's primary contact; null if unset

lastNamestringnull— Last name of the matter's primary contact; null if unset

emailstringnull— Primary email address of the matter's contact; null if unset

phonestringnull— Primary phone number of the matter's contact; null if unset or not reported

caseTitlestringnull— Title of the matter/case; null if unset or not reported

caseBlurbstringnull— Short description of the matter; null if unset or not reported

statusstringnull— Matter status (e.g. "pnc", "hired", "lost"); null if not reported

subStatusstringnull— Sub-status label within the status; null if unset or not reported

customFieldsarray— Account-defined custom fields on the matter; empty array if none

[]object

idstring— Custom field definition ID, as a numeric string

namestringnull— Custom field display name; null if unset

fieldTypestringnull— Custom field data type (e.g. text, date, select); null if unset

valueany— Raw custom field value; type varies by `fieldType`

formattedValueany— Display-formatted custom field value; type varies by `fieldType`

createdAtstringnull— When the matter was created, as an ISO 8601 timestamp; null if not reported

updatedAtstringnull— When the matter was last updated, as an ISO 8601 timestamp; null if not reported

relationshipsobject— JSON:API relationship pointers to related records as {id,type} stubs. Not materialized — follow a pointer by calling that resource's own get/find tool (e.g. type 'contact' -> get-contact, type 'company' -> get-company, type 'user' -> get-user). All keys coalesce to null / [] when the echo omits the relationships envelope.

sourceobjectnull— Lead source pointer; null when unset