---
title: "Update vehicle"
method: PATCH
path: "/cases/{case_id}/vehicles/{vehicle_id}"
tags: ["Vehicles"]
---

# Update vehicle

`PATCH /cases/{case_id}/vehicles/{vehicle_id}`

## Request

- Base URL: `https://api.example.com/v1`
- URL: `https://api.example.com/v1/cases/{case_id}/vehicles/{vehicle_id}`
- Auth: none declared

## Request body

- VehicleWrite
  - `vehicle_type` 'automobile' | 'motorcycle' | 'recreational_vehicle' | 'boat' | 'commercial_vehicle' | 'classic_car' | 'trailer' | 'off_highway_vehicle' | 'farm_equipment' | 'aircraft' | 'other', required
  - `year` integer
  - `make` string
  - `model` string
  - `vin` string: Full VIN.
  - `license_plate` string
  - `registration_state` string
  - `title_status` 'clean' | 'salvage' | 'rebuilt' | 'lien_present' | 'missing' | 'unknown'
  - `ownership_type` 'sole_owner' | 'joint_owner' | 'transfer_on_death' | 'leased' | 'other'
  - `co_owner_name` string
  - `estimated_value` number, double
  - `valuation_source` 'kelley_blue_book' | 'nada' | 'edmunds' | 'appraisal' | 'owner_estimate'
  - `lien_holder` string
  - `lien_payoff_amount` number, double
  - `mileage` integer
  - `condition` 'excellent' | 'good' | 'fair' | 'poor'
  - `location` string
  - `disposition` 'keep' | 'transfer_to_heir' | 'sell' | 'donate' | 'junk' | 'pending_decision'
  - `institution_contact_id` string
  - `notes` string

## Response `200`

Vehicle updated.

- object
  - `data` Vehicle
    - `id` string
    - `case_id` string
    - `vehicle_type` 'automobile' | 'motorcycle' | 'recreational_vehicle' | 'boat' | 'commercial_vehicle' | 'classic_car' | 'trailer' | 'off_highway_vehicle' | 'farm_equipment' | 'aircraft' | 'other'
    - `year` integer, nullable
    - `make` string, nullable
    - `model` string, nullable
    - `vin` string, nullable: Vehicle Identification Number. Masked in responses (last 6 digits only).
    - `license_plate` string, nullable
    - `registration_state` string, nullable
    - `title_status` 'clean' | 'salvage' | 'rebuilt' | 'lien_present' | 'missing' | 'unknown'
    - `ownership_type` 'sole_owner' | 'joint_owner' | 'transfer_on_death' | 'leased' | 'other'
    - `co_owner_name` string, nullable
    - `estimated_value` number, double, nullable
    - `valuation_source` 'kelley_blue_book' | 'nada' | 'edmunds' | 'appraisal' | 'owner_estimate' | 'null', nullable
    - `lien_holder` string, nullable: Bank or finance company holding the lien.
    - `lien_payoff_amount` number, double, nullable
    - `equity_estimate` number, double, nullable
    - `mileage` integer, nullable
    - `condition` 'excellent' | 'good' | 'fair' | 'poor' | 'null', nullable
    - `location` string, nullable: Where the vehicle is currently located.
    - `disposition` 'keep' | 'transfer_to_heir' | 'sell' | 'donate' | 'junk' | 'pending_decision'
    - `disposition_details` object, nullable
      - `transferred_to` string
      - `sale_price` number, double
      - `sale_date` string, date
      - `buyer_name` string
    - `title_transfer_status` 'not_started' | 'dmv_paperwork_filed' | 'title_transferred' | 'completed'
    - `institution_contact_id` string, nullable
    - `notes` string, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `404`: Resource not found.
- `422`: Request validation failed.

---

[API](https://skmtc.dev/hellosunset/apis/sunset-api.md) - [All operations](https://skmtc.dev/hellosunset/apis/sunset-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hellosunset/apis/sunset-api/revisions/f128e5526efe?raw)