> ## Documentation Index
> Fetch the complete documentation index at: https://developer.plugchoice.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Location

Updates the details of a specific location. All fields are optional; only the fields provided will be updated.

<ParamField path="site" type="string" required>
  The UUID of the location to update.
</ParamField>

<ParamField body="name" type="string">
  The name of the location. Maximum 255 characters.
</ParamField>

<ParamField body="street" type="string">
  The street name. Maximum 255 characters.
</ParamField>

<ParamField body="house_number" type="number">
  The house number. Must be 0 or greater.
</ParamField>

<ParamField body="house_number_addition" type="string">
  The house number addition (e.g., "A", "B"). Maximum 255 characters.
</ParamField>

<ParamField body="postal_code" type="string">
  The postal code. Maximum 255 characters.
</ParamField>

<ParamField body="city" type="string">
  The city name. Maximum 255 characters.
</ParamField>

<ParamField body="country" type="string">
  The ISO 3166-1 alpha-2 country code (e.g., "NL", "DE"). Maximum 2 characters.
</ParamField>

<ParamField body="access_level" type="string">
  The access level of the location. One of `closed`, `app_users`, or `roaming`. Setting `app_users` or `roaming` requires the current team to be an admin team.
</ParamField>

<ParamField body="manual_coordinates" type="boolean">
  Whether the location's coordinates are set manually. When `true`, `latitude` and `longitude` are required; otherwise the coordinates are geocoded from the address.
</ParamField>

<ParamField body="latitude" type="number">
  The latitude of the location. Must be between -90 and 90. Required when `manual_coordinates` is `true`.
</ParamField>

<ParamField body="longitude" type="number">
  The longitude of the location. Must be between -180 and 180. Required when `manual_coordinates` is `true`.
</ParamField>

## Response

<ResponseField name="uuid" type="string">
  The unique UUID of the location.
</ResponseField>

<ResponseField name="id" type="integer">
  The numeric ID of the location.
</ResponseField>

<ResponseField name="name" type="string">
  The name of the location.
</ResponseField>

<ResponseField name="address" type="string">
  The full formatted address of the location.
</ResponseField>

<ResponseField name="street" type="string">
  The street name.
</ResponseField>

<ResponseField name="postal_code" type="string">
  The postal code.
</ResponseField>

<ResponseField name="house_number" type="integer">
  The house number.
</ResponseField>

<ResponseField name="house_number_addition" type="string">
  The house number addition. May be `null`.
</ResponseField>

<ResponseField name="city" type="string">
  The city name.
</ResponseField>

<ResponseField name="country" type="string">
  The ISO 3166-1 alpha-2 country code.
</ResponseField>

<ResponseField name="tariff_zone" type="string">
  The tariff zone key used for day-ahead pricing lookups. May be `null`.
</ResponseField>

<ResponseField name="latitude" type="number">
  The latitude of the location. May be `null`.
</ResponseField>

<ResponseField name="longitude" type="number">
  The longitude of the location. May be `null`.
</ResponseField>

<ResponseField name="manual_coordinates" type="boolean">
  Whether the location's coordinates were set manually rather than geocoded automatically.
</ResponseField>

<ResponseField name="access_level" type="string">
  The access level of the location. One of `closed`, `app_users`, or `roaming`.
</ResponseField>

<ResponseField name="smart_charging" type="string">
  The smart charging mode of the location. One of `disabled`, `off_peak`, or `day_ahead_pricing`.
</ResponseField>

<ResponseField name="chargers_count" type="integer">
  The number of chargers assigned to this location.
</ResponseField>

<ResponseField name="capabilities" type="object">
  The location's available capabilities based on licensing.

  <Expandable title="capabilities">
    <ResponseField name="smart_charging" type="boolean">
      Whether smart charging is available.
    </ResponseField>

    <ResponseField name="load_management" type="object">
      Load management capabilities.

      <Expandable title="load_management">
        <ResponseField name="dynamic" type="boolean">
          Whether dynamic load management is available.
        </ResponseField>

        <ResponseField name="peak_shaving" type="boolean">
          Whether peak shaving is available.
        </ResponseField>

        <ResponseField name="solar" type="boolean">
          Whether solar integration is available.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp of when the location was created.
</ResponseField>

<ResponseField name="updated_at" type="string">
  ISO 8601 timestamp of when the location was last updated.
</ResponseField>

<ResponseField name="permissions" type="object">
  The authenticated user's permissions for this location.

  <Expandable title="permissions">
    <ResponseField name="basic" type="boolean">
      Whether the user has basic read access.
    </ResponseField>

    <ResponseField name="sensitive" type="boolean">
      Whether the user has access to sensitive data (e.g., cards, transactions).
    </ResponseField>

    <ResponseField name="full" type="boolean">
      Whether the user has full control (e.g., delete, transfer ownership).
    </ResponseField>
  </Expandable>
</ResponseField>
