# Update Relationship

`lawmatics_update-relationship` · Lawmatics MCP tool · Relationships

Update an existing relationship in Lawmatics by ID — re-link it to a different matter or contact, or change its relationship type. All three IDs are required (the API replaces the full link); fetch the current values with get-relationship first when changing only one side.

## Input

- **relationshipId** `string` (required, pattern: ^\d+$) — ID of the relationship to update
- **matterId** `string` (required) — ID of the matter on one side of the relationship
- **contactId** `string` (required) — ID of the contact on the other side of the relationship
- **relationshipTypeId** `string` (required) — ID of the relationship type (e.g. Spouse, Child). Use list-relationship-types to find valid IDs.

## Output

- **id** `string` (required) — Unique ID of the relationship
- **name** `string` (required) — Relationship name derived from the relationship type (e.g. Spouse, Child); read-only
- **matterId** `string` (required) — ID of the matter on one side of the relationship
- **contactId** `string` (required) — ID of the contact on the other side of the relationship
- **relationshipTypeId** `string` (required) — ID of the relationship type that defines this relationship
- **createdAt** `string | null` (required) — When the relationship was created, as an ISO 8601 timestamp; null if unknown
- **updatedAt** `string | null` (required) — When the relationship was last updated, as an ISO 8601 timestamp; null if unknown