# Update Phone Number

`lawmatics_update-phone-number` · Lawmatics MCP tool · Phone Numbers

Update an existing phone number in Lawmatics by ID. Optionally re-attach it to a different contact, matter, or company. Returns the updated record with a `relationships` envelope carrying an {id,type} pointer to the owning record (contact, company, or firm).

## Input

- **phoneNumberId** `string` (required, pattern: ^\d+$) — ID of the phone number to update; a numeric string
- **phoneNumber** `string` — The phone number string
- **phoneType** `string` — Phone number label (e.g. Primary, Mobile, Work, Home)
- **matterId** `string` — ID of the matter to re-attach this phone number to
- **contactId** `string` — ID of the contact to re-attach this phone number to
- **companyId** `string` — ID of the company to re-attach this phone number to

## Output

- **id** `string` (required) — Unique ID of the phone number record
- **phoneType** `string` (required) — Phone number label (e.g. Primary, Mobile, Work, Home)
- **phoneNumber** `string` (required) — The phone number string, formatted as stored
- **relationships** `object` (required) — 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).
  - **informationable** `object | null` (required) — Owning record pointer (contact, company, or firm); null when unset
    - **id** `string` (required) — ID of the referenced Lawmatics record
    - **type** `string` (required) — JSON:API record class of the reference (e.g. "user", "contact", "prospect", "firm"); resolve it by calling that resource's own get/find tool — this pointer is not materialized