Update a vehicle's charging connectors

Request

Update the vehicle's connectors. The body is a partial map: only the keys you include are changed. Set native_connector to override the model default for this vehicle, or null to inherit it. adaptors replaces the adapter list (send [] to clear); adaptors must be distinct and must not include the native connector. PATCH {} is a valid no-op.

Security

oauth2(Required scopes: vehicle:write)

Path

vehicle_idstringvhcl[A-Z\d]{26}required

The ID of the specific vehicle to retrieve.

Example:vhcl01HRFF3SEVSCRAV9B3CHVDFN0H

EvEnergy-Versionnumber

Specify the version of this endpoint to use.

Value:2

Bodyapplication/json

native_connectorstring or null

Enum:"CCS""NACS""CHADEMO"null

adaptorsArray of strings

Items Enum:"CCS""NACS""CHADEMO"

curl -i -X PATCH \
  https://developers.ev.energy/_mock/ev.energy-api-v2/vehicles/vhcl01HRFF3SEVSCRAV9B3CHVDFN0H/connectors \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'EvEnergy-Version: 2' \
  -d '{
    "native_connector": "CCS",
    "adaptors": [
      "CCS"
    ]
  }'

Responses

Connectors updated successfully.

Headers

EvEnergy-Versionnumber

Indicates the version of the API that generated this response. If EvEnergy-Version was not specified in the request, this will be your OAuth application's default version.

Value:2

X-RateLimit-Limitnumber

The maximum number of requests that can be made to this endpoint per hour. Defaults to 1000 but may vary per client.

Default:1000

X-RateLimit-Remainingnumber

The number of requests remaining until this client's rate limit is reached.

Default:999

Bodyapplication/json

urlstring, (uri)read-onlyrequired

Example:"https://api.ev.energy/v2/vehicles/vhcl01HRFF3SEVSCRAV9B3CHVDFN0H/connectors"

vehiclestring, (uri)read-onlyrequired

Example:"https://api.ev.energy/v2/vehicles/vhcl01HRFF3SEVSCRAV9B3CHVDFN0H"

native_connectorstring or nullrequired

The vehicle's built-in DC-fast plug. A per-vehicle override, falling back to the model's default connector when unset; null when not yet known.

Enum:"CCS""NACS""CHADEMO"null

adaptorsArray of stringsrequired

Additional connectors usable via an adapter. Empty when none.

Items Enum:"CCS""NACS""CHADEMO"

updated_atstring or null, (date-time)read-onlyrequired

Response

{
  "url": "https://api.ev.energy/v2/vehicles/vhcl01HRFF3SEVSCRAV9B3CHVDFN0H/connectors",
  "vehicle": "https://api.ev.energy/v2/vehicles/vhcl01HRFF3SEVSCRAV9B3CHVDFN0H",
  "native_connector": "CCS",
  "adaptors": [
    "CCS"
  ],
  "updated_at": "2019-08-24T14:15:22Z"
}