# Update Task Status

`lawmatics_update-task-status` · Lawmatics MCP tool · Task Statuses

Update an existing task status in Lawmatics by ID. The response includes a `relationships` envelope of {id,type} pointers to the tasks assigned this status.

## Input

- **taskStatusId** `string` (required, pattern: ^\d+$) — ID of the task status to update; a numeric string
- **name** `string` — New task status name
- **color** `string` — New hex color code for the status, e.g. #A7783B

## Output

- **id** `string` (required) — Lawmatics task status ID
- **name** `string` (required) — Task status name (e.g. Waiting for Client, In Progress)
- **color** `string` (required) — Hex color code for the status, e.g. #A7783B
- **createdAt** `string` (required) — When the task status was created, as an ISO 8601 timestamp
- **updatedAt** `string` (required) — When the task 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 tool (e.g. type 'task' -> get-task).
  - **tasks** `array` (required) — Task pointers (type 'task') assigned this 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