Update Matter — Lawmatics MCP Tool

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