# Vehicle

Schema: #/components/schemas/VehicleWrite

Method: SCHEMA
Version: 2.0
Security: oauth2

## Schema fields:

  - `model` (string, required)
    UID-based URL of an existing CarModel. The backend resolves or creates a hidden trim for the given model and (optional) battery size.
    Example: https://api.ev.energy/v2/vehicle_models/vmod01HN2P436099PEQ20B7TKPGTEJ

  - `battery_size_watt_hours` (integer)
    Battery size in watt-hours.
    Example: 60000

  - `description` (string)
    Optional human-readable label for the vehicle. Defaults to a string built from the user's email and the resolved make/model when omitted.
    Example: My Volvo C40

  - `vehicle_class` (string | null)
    Class of vehicle, passenger or commercial.
    Enum: "PASSENGER", "COMMERCIAL", "null"

  - `user` (string)
    Required if using Client Credentials authentication.
    Example: https://api.ev.energy/v2/users/user01HN2NJ9NMRZBXT1H6FT9N7735