# Update Sub Status

`lawmatics_update-sub-status` · Lawmatics MCP tool · Sub Statuses

Update an existing matter sub status in Lawmatics by ID. The response includes a `relationships` envelope of {id,type} pointers to the creating user and the matters (prospects) carrying this sub status.

## Input

- **subStatusId** `string` (required, pattern: ^\d+$) — ID of the sub status to update; a numeric string
- **name** `string` — New sub status name
- **status** `string` — Matter status this sub status maps to. Valid values: "hired", "pnc", "lost". Omit to leave the current status unchanged
- **createdById** `string` — ID of the user to record as the creator of this sub status. Write-only; not returned in the response

## Output

- **id** `string` (required) — Lawmatics sub status ID
- **name** `string` (required) — Sub status name
- **status** `string` (required) — Matter status this sub status maps to; one of "hired", "pnc", or "lost"
- **createdAt** `string` (required) — When the sub status was created, as an ISO 8601 timestamp
- **updatedAt** `string` (required) — When the sub status was last updated, as an ISO 8601 timestamp
- **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 (type 'user' -> get-user, type 'prospect' -> get-matter).
  - **createdBy** `object | null` (required) — Creating user pointer; 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
  - **prospects** `array` (required) — Pointers to matters (prospects) carrying this sub status; empty if none
    - **[]** `object`
      - **id** `string` (required) — ID of the referenced Lawmatics record
      - **type** `string` (required) — JSON:API record class of the reference; resolve it by calling that resource's own tool