Skip to main content
PUT
/
v3
/
sites
/
{site}
Update Location
curl --request PUT \
  --url https://app.plugchoice.com/api/v3/sites/{site} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "street": "<string>",
  "house_number": 123,
  "house_number_addition": "<string>",
  "postal_code": "<string>",
  "city": "<string>",
  "country": "<string>"
}
'
{
  "uuid": "<string>",
  "id": 123,
  "name": "<string>",
  "address": "<string>",
  "street": "<string>",
  "postal_code": "<string>",
  "house_number": 123,
  "house_number_addition": "<string>",
  "city": "<string>",
  "country": "<string>",
  "smart_charging": true,
  "chargers_count": 123,
  "capabilities": {
    "smart_charging": true,
    "load_management": {
      "dynamic": true,
      "peak_shaving": true,
      "solar": true
    }
  },
  "created_at": "<string>",
  "updated_at": "<string>",
  "permissions": {
    "basic": true,
    "sensitive": true,
    "full": true
  }
}
Updates the details of a specific location. All fields are optional; only the fields provided will be updated.
site
string
required
The UUID of the location to update.
name
string
The name of the location. Maximum 255 characters.
street
string
The street name. Maximum 255 characters.
house_number
number
The house number. Must be 0 or greater.
house_number_addition
string
The house number addition (e.g., “A”, “B”). Maximum 255 characters.
postal_code
string
The postal code. Maximum 255 characters.
city
string
The city name. Maximum 255 characters.
country
string
The ISO 3166-1 alpha-2 country code (e.g., “NL”, “DE”). Maximum 2 characters.

Response

uuid
string
The unique UUID of the location.
id
integer
The numeric ID of the location.
name
string
The name of the location.
address
string
The full formatted address of the location.
street
string
The street name.
postal_code
string
The postal code.
house_number
integer
The house number.
house_number_addition
string
The house number addition. May be null.
city
string
The city name.
country
string
The ISO 3166-1 alpha-2 country code.
smart_charging
boolean
Whether smart charging is enabled for this location.
chargers_count
integer
The number of chargers assigned to this location.
capabilities
object
The location’s available capabilities based on licensing.
created_at
string
ISO 8601 timestamp of when the location was created.
updated_at
string
ISO 8601 timestamp of when the location was last updated.
permissions
object
The authenticated user’s permissions for this location.