Skip to content
CleverEV Docs

Update tariff element

POST
/api/locations/{locationId}/tariff/elements/{elementId}

The provided price components and restrictions will be merged with the

  • existing ones, null values will be unset.

Parameters

Path Parameters

locationId
required
string
>= 21 characters <= 21 characters
elementId
required
string

Request Body required

object
element
required
object
name
string
<= 64 characters
backgroundColor
string
<= 12 characters
priceComponents
object
Flat
string
nullable
PerMinute
string
nullable
PerKilowattHour
string
nullable
restrictions
object
startTime
object
hour
required
integer
<= 23
minute
required
integer
<= 59
endTime
object
hour
required
integer
<= 23
minute
required
integer
<= 59
daysOfWeek
Array<string>
nullable
Allowed values: Mon Tue Wed Thu Fri Sat Sun
minEnergy
number
nullable <= 9007199254740991
maxEnergy
number
nullable <= 9007199254740991
minCurrent
number
nullable <= 9007199254740991
maxCurrent
number
nullable <= 9007199254740991
minPower
number
nullable <= 9007199254740991
maxPower
number
nullable <= 9007199254740991
minDuration
integer
nullable <= 9007199254740991
maxDuration
integer
nullable <= 9007199254740991
vehicleRequestingPower
boolean
nullable
minRestrictionsDuration
integer
nullable >= -9007199254740991 <= 9007199254740991

Responses

200

Response for status ok

object
success
required
boolean
element
required
object
id
required
string
>= 21 characters <= 21 characters
name
required
string
<= 64 characters
backgroundColor
required
string
<= 12 characters
priceComponents
required
object
Flat
string
PerMinute
string
PerKilowattHour
string
restrictions
object
startTime
object
hour
required
integer
<= 23
minute
required
integer
<= 59
endTime
object
hour
required
integer
<= 23
minute
required
integer
<= 59
daysOfWeek
Array<string>
Allowed values: Mon Tue Wed Thu Fri Sat Sun
minEnergy
number
<= 9007199254740991
maxEnergy
number
<= 9007199254740991
minCurrent
number
<= 9007199254740991
maxCurrent
number
<= 9007199254740991
minPower
number
<= 9007199254740991
maxPower
number
<= 9007199254740991
minDuration
integer
<= 9007199254740991
maxDuration
integer
<= 9007199254740991
vehicleRequestingPower
boolean
minRestrictionsDuration
integer
>= -9007199254740991 <= 9007199254740991

400

Response for status badRequest

object
success
required
boolean
message
required
string

403

Response for status forbidden

object
success
required
boolean
message
required
string

404

Response for status notFound

object
success
required
boolean
message
required
string

500

Response for status internalServerError

object
success
required
boolean
message
required
string