Location / Update

patch

https://{tenantUrl}/public-api/resources/locations/v2.0/{location}

Update a location

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

location

integer

required

Query Params

include

array of strings

include

Allowed:

Body Params

externalId

string | null

name

array of objects

name

status

string

enum

Deprecated.

Allowed:

description

array of objects

description

shortDescription

array of objects

shortDescription

additionalDescription

array of objects

additionalDescription

geoposition

object

address

array of objects

The full address of the location

address

streetAddress

array of objects

The street address of the location

streetAddress

city

string | null

region

string | null

When country is not in US, AU, CA, UM or RO, you can provide the region

state

enum

When the selected country is one of US, AU, CA, UM or RO

When the country is US.

country

string

enum

postCode

string | null

Postal code of the location. Required for most countries — omitting it for those will result in a validation error.

timezone

string | null

A valid timezone in the form of Area/Location, required when Allow Multiple Time Zones option is turned on in the Timezone Setting.

parkingType

string | null

enum

Indicates the type of parking available at the charging location. This field helps EV drivers understand the physical parking environment before arrival.

Valid values:

ALONG_MOTORWAY - Located along a motorway/highway, typically at rest areas or service stations
PARKING_GARAGE - Multi-level parking garage structure, either above-ground or mixed-use
PARKING_LOT - Surface parking lot, open-air parking area
ON_DRIVEWAY - Located on a private driveway, typically residential or small business
ON_STREET - Street-side parking, curbside charging locations
UNDERGROUND_GARAGE - Underground parking structure, subterranean parking facility
IS_TENT - Site located on the Trans-European Transport Network (Lithuania NAP / Via Lietuva extension; may not be interpreted by all roaming partners)
SECURE - Restricted-access parking such as gated lots, key-card access, or staffed parking (Lithuania NAP / Via Lietuva extension; may not be interpreted by all roaming partners)

Request behavior (POST/PATCH):

Optional field when creating or updating locations
Send null to clear the parking type
Omit the field in PATCH requests to leave the existing value unchanged

Response behavior (GET):

Field is omitted from the response when no parking type is configured (null in database)
When present, returns one of the valid enum values listed above

accessMethods

array of strings | null

Physical access methods available at this location. Multiple methods can be selected if the site supports different access types.

Request behavior (POST/PATCH):

Optional field when creating or updating locations
Send null to clear all access methods
Send [] to store an empty access methods list
Duplicate values are automatically de-duplicated before storage
Omit the field in PATCH requests to leave the existing value unchanged

Response behavior (GET):

Field is omitted from the response when no access methods are configured (null in database)
When access methods are configured but the array is empty, returns an empty array []
When present, returns an array of valid enum values listed above

Available methods:

OPEN - Publicly accessible without restrictions
TOKEN - Access via RFID token or card
LICENSE_PLATE - Access via license plate recognition
ACCESS_CODE - Access via PIN/access code entry
INTERCOM - Access via intercom system
PARKING_TICKET - Access via parking ticket validation

accessMethods

Allowed:

facilities

array of strings | null

Describes amenities and facilities available at or near the charging location. Most values are self-explanatory. Special categories include:

RECREATION_AREA - Parks, playgrounds, or leisure facilities
CARPOOL_PARKING - Dedicated parking for carpooling/ridesharing
NATURE - Natural attractions or green spaces
STAFFED - Location has staff present
BATHROOM - Bathroom facilities available

Request behavior (POST/PATCH):

Optional field when creating or updating locations
Send null to clear all facilities
Send [] to store an empty facilities list
Duplicate values are automatically de-duplicated before storage
Omit the field in PATCH requests to leave the existing value unchanged

Response behavior (GET):

Field is omitted from the response when no facilities are configured (null in database)
When facilities are configured but the array is empty, returns an empty array []
When present, returns an array of valid enum values listed above

facilities

workingHours

object

200Location updated successfully

401Access token is missing or invalid

403You do not have permission to perform the action

404The record is not found

422The payload you provided is invalid

429Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*