Skip to navigation
CPOLocations

Update a location

Changes only the fields sent; send null to clear a field. Partner locations are read-only (409).

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

location_idstringRequired1-36 characters
OCPI location id.

Headers

If-Matchstring or nullOptional

Optional. The last_updated value you read; the write is refused with 412 if the object changed since.

Request

This endpoint expects an object.
expected_revisioninteger or nullOptional>=1
namestring or nullOptional<=255 characters
postal_codestring or nullOptional<=10 characters
statestring or nullOptional<=20 characters
parking_typeenum or nullOptional

Allowed parking_type values on ocpp.ocpp_locations.

facilitieslist of strings or nullOptional
opening_timesobject or nullOptional
charging_when_closedboolean or nullOptional
publishboolean or nullOptional
publish_allowed_tolist of objects or nullOptional
related_locationslist of objects or nullOptional
parking_placeslist of objects or nullOptional
directionslist of objects or nullOptional
operatorobject or nullOptional
suboperatorobject or nullOptional
ownerobject or nullOptional
imageslist of objects or nullOptional
energy_mixobject or nullOptional
help_phonestring or nullOptional<=25 characters
addressstring or nullOptional1-45 characters
citystring or nullOptional1-45 characters
countrystring or nullOptionalformat: "^[A-Z]{3}$"
coordinatesobject or nullOptional
time_zonestring or nullOptional1-255 characters

Response

The object after the update.
idinteger
location_idstring
publishboolean
addressstring
citystring
countrystring
coordinatesobject
time_zonestring
last_updateddatetime
revisioninteger
roleenum or any
originenum or any
country_codestring
party_idstring
ocpi_versionenum or any
organization_idstring
created_atdatetime
updated_atdatetime
publish_allowed_tolist of objects or nullOptional
namestring or nullOptional
postal_codestring or nullOptional
statestring or nullOptional
related_locationslist of objects or nullOptional
parking_typeenum or any or nullOptional
parking_placeslist of objects or nullOptional
directionslist of objects or nullOptional
operatorobject or nullOptional
suboperatorobject or nullOptional
ownerobject or nullOptional
facilitieslist of strings or nullOptional
opening_timesobject or nullOptional
charging_when_closedboolean or nullOptional
imageslist of objects or nullOptional
energy_mixobject or nullOptional
help_phonestring or nullOptional
ocpp_versionstring or nullOptional

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
409
Conflict Error
412
Precondition Failed Error
422
Unprocessable Entity Error
429
Too Many Requests Error
502
Bad Gateway Error
504
Gateway Timeout Error