Model XJA2VP (Renault Clio V e-tech) new endpoints not documented

[leonardpitzu]

Renault Clio V e-Tech, variant XJA2VP is already supported yet there are still following errors come up:

Source: components/renault/button.py:93
Endpoint actions/lights-start for model XJA2VP is not documented, using default endpoints. Please help to document it at https://github.com/hacf-fr/renault-api

Source: components/renault/button.py:85
Endpoint actions/horn-start for model XJA2VP is not documented, using default endpoints. Please help to document it at https://github.com/hacf-fr/renault-api

Source: components/renault/button.py:77
Endpoint actions/charge-stop for model XJA2VP is not documented, using default endpoints. Please help to document it at https://github.com/hacf-fr/renault-api

Source: components/renault/button.py:68
Endpoint actions/charge-start for model XJA2VP is not documented, using default endpoints. Please help to document it at https://github.com/hacf-fr/renault-api

Source: components/renault/button.py:59
Endpoint actions/hvac-start for model XJA2VP is not documented, using default endpoints. Please help to document it at https://github.com/hacf-fr/renault-api

XJA2VP — CLIO V (Full Hybrid HEV) endpoint test results

Vehicle: Renault Clio V (XJA2VP), Full-Hybrid HEV, Petrol (ESS), TCU: AIVCT
VIN prefix: VF1RJA003...
renault-api version: 0.5.6
Date tested: 2026-03-20

Read endpoints

Endpoint	Result	Suggested mapping
vehicles/{vin}/alerts	err.func.wired.not-found	None
kca/car-adapter/v2/cars/{vin}/battery-status	err.func.wired.notFound (404)	None
kca/car-adapter/v1/cars/{vin}/charge-history	err.func.wired.not-found	None
kca/car-adapter/v1/cars/{vin}/charge-mode	err.func.wired.forbidden	None
kca/car-adapter/v1/cars/{vin}/charge-schedule	err.func.wired.forbidden	None
kca/car-adapter/v1/cars/{vin}/charging-settings	err.func.wired.forbidden	None
kca/car-adapter/v1/cars/{vin}/cockpit	✅ OK — fuelAutonomy, fuelQuantity, totalMileage	_DEFAULT_ENDPOINTS["cockpit"]
kca/car-adapter/v1/cars/{vin}/hvac-history	err.func.wired.not-found	None
kca/car-adapter/v1/cars/{vin}/hvac-sessions	err.func.wired.not-found	None
kca/car-adapter/v1/cars/{vin}/hvac-settings	err.func.wired.forbidden	None
kca/car-adapter/v1/cars/{vin}/hvac-status	err.func.wired.notFound (404)	None
kca/car-adapter/v1/cars/{vin}/location	✅ OK — gpsLatitude, gpsLongitude, lastUpdateTime	_DEFAULT_ENDPOINTS["location"]
kca/car-adapter/v1/cars/{vin}/lock-status	err.func.wired.notFound (404)	None
kca/car-adapter/v1/cars/{vin}/notification-settings	err.func.vcps.users-helper.get-notification-settings.error (400001: no GDC gateway)	None
kca/car-adapter/v1/cars/{vin}/pressure	err.func.wired.notFound (404)	None
kca/car-adapter/v1/cars/{vin}/res-state	err.func.wired.notFound (404)	None

All KCM endpoints (kcm/v1/vehicles/{vin}/...) return err.func.wired.not-found.

Action endpoints (currently undocumented for XJA2VP)

Endpoint	Payload	Result	Suggested mapping
actions/horn-lights (horn)	{"data":{"type":"HornLights","attributes":{"action":"start","target":"horn"}}}	err.func.wired.forbidden	None
actions/horn-lights (lights)	{"data":{"type":"HornLights","attributes":{"action":"start","target":"lights"}}}	err.func.wired.forbidden	None
actions/charging-start (start)	{"data":{"type":"ChargingStart","attributes":{"action":"start"}}}	err.func.wired.forbidden	None
actions/charging-start (stop)	{"data":{"type":"ChargingStart","attributes":{"action":"stop"}}}	err.func.wired.invalid-body-format	None
actions/hvac-start	{"data":{"type":"HvacStart","attributes":{"action":"start","targetTemperature":21}}}	err.func.wired.forbidden	None

Action endpoints (currently undocumented for XJA2VP)

Library endpoint key	API path tested	Payload	Result	Suggested mapping
actions/horn-start	actions/horn-lights	{"data":{"type":"HornLights","attributes":{"action":"start","target":"horn"}}}	err.func.wired.forbidden	None
actions/lights-start	actions/horn-lights	{"data":{"type":"HornLights","attributes":{"action":"start","target":"lights"}}}	err.func.wired.forbidden	None
actions/charge-start	actions/charging-start	{"data":{"type":"ChargingStart","attributes":{"action":"start"}}}	err.func.wired.forbidden	None
actions/charge-stop	actions/charging-start	{"data":{"type":"ChargingStart","attributes":{"action":"stop"}}}	err.func.wired.invalid-body-format	None
actions/hvac-start	actions/hvac-start	{"data":{"type":"HvacStart","attributes":{"action":"start","targetTemperature":21}}}	err.func.wired.forbidden	None

"XJA2VP": {  # CLIO V
    "actions/charge-start": None,  # err.func.wired.forbidden
    "actions/charge-stop": None,  # err.func.wired.invalid-body-format
    "actions/horn-start": None,  # err.func.wired.forbidden
    "actions/hvac-start": None,  # err.func.wired.forbidden
    "actions/lights-start": None,  # err.func.wired.forbidden
    "alerts": None,  # err.func.wired.not-found
    "battery-status": None,  # err.func.wired.notFound
    "charge-mode": None,  # err.func.wired.forbidden
    "charge-history": None,  # err.func.wired.not-found
    "charge-schedule": None,  # err.func.wired.forbidden
    "charges": None,  # err.func.wired.notFound: Not Found
    "charging-settings": None,  # err.func.wired.forbidden
    "charging-start": None,  # err.func.wired.forbidden
    "cockpit": _DEFAULT_ENDPOINTS["cockpit"],
    "horn-lights": None,  # err.func.wired.forbidden
    "hvac-history": None,  # err.func.wired.not-found
    "hvac-schedule": None,  # err.func.wired.not-found
    "hvac-sessions": None,  # err.func.wired.not-found
    "hvac-settings": None,  # err.func.wired.forbidden
    "hvac-start": None,  # err.func.wired.forbidden
    "hvac-status": None,  # err.func.wired.notFound
    "location": _DEFAULT_ENDPOINTS["location"],
    "lock-status": None,  # err.func.wired.notFound
    "notification-settings": None,  # err.func.vcps.users-helper.get-notification-settings.error  # noqa: E501
    "pause-resume": None,  # err.func.wired.not-found
    "pressure": None,  # err.func.wired.notFound
    "res-state": None,  # err.func.wired.notFound
    "soc-levels": None,  # err.func.wired.forbidden
},

[epenet]

@leonardpitzu
Please see #1747 for how to properly document or update a vehicle definition