---
title: "Patch an existing charge point"
method: PATCH
path: "/api/v1/charge-points/{chargePointId}"
tags: ["Charge Points"]
---

# Patch an existing charge point

`PATCH /api/v1/charge-points/{chargePointId}`

Required scope: `charge-points:write` </br>Organization authorization: `supported`

## Path parameters

- `chargePointId` integer, required

## Request body

- PatchChargePoint
  - `siteId` integer, nullable — Id of the site the charge point belongs to.
  - `name` string, nullable — Name of the charge point.
  - `maxKw` number, double, nullable — Max Kw (Max Power) the charge point can output.
  - `visibility` 'private' | 'public' — definitions: * `private` - Indicates the charge point access is private, only available to users from operator umbrella. * `public` - Indicates the charge point access is public.
  - `type` 'ac' | 'dc' | 'other' — definitions: * `ac` - Indicates the charge point use `ac` (alternating current) as electric current. * `dc` - Indicates the charge point use `ac` (direct current) as electric current. * `other` - Indicates the team member has only access to the selected charge points.
  - `active` boolean, nullable — Indicates the charge point is active.
  - `showOnMap` boolean, nullable — Indicates the charge point should be displayed on map. By setting this to false, the charge point will not be shown on the app's map, but will still be fully functional for users of the charge point.
  - `connectorIds` JsonNullableSetLong
    - `present` boolean
  - `note` string, nullable — A note (instructions, warning, information) you have entered for this charge point
  - `latitude` number, nullable — Latitude coordinate for the charge point location. When provided along with longitude, overrides the site's location.
  - `longitude` number, nullable — Longitude coordinate for the charge point location. When provided along with latitude, overrides the site's location.
  - `partnerExternalId` string, nullable — External Id of this entity, managed by you.
  - `partnerCustomPayload` JsonNullableJsonNode
    - `present` boolean
  - `meterId` string, nullable — Meter id of the charge point.
  - `roaming` boolean, nullable — Indicates if the charge point is roaming enabled.
  - `roamingPriceGroupId` integer, nullable — The id of the roaming price group for this charge point.</br>*Note*: This field is required if the `roaming` field is set to true and the charge point doesn't have an associated roaming price group id.
  - `smartChargeSetting` 'off' | 'optional' | 'forced' | 'forced-setting', nullable — Smart charging setting for this charge point. - `off`: Smart charging is disabled, rules cannot be created - `optional`: Smart charging is optional, rules can be created and applied - `forced`: Smart charging is forced, rules will always be applied - `forced-setting`: Smart charging setting is forced
  - `userId` integer, nullable — Id of the user that owns this charge point. Can only be set or updated, not removed.
  - `autoRegisterRfid` boolean, nullable — Whether RFID tags are auto-registered when scanned at this charge point.

## Response `200`

Charge point updated

- ChargePoint
  - `id` integer, required — Id of this charge point.
  - `teamId` integer, required — Id of the team.
  - `partnerExternalId` string, nullable — External Id of this entity, managed by you.
  - `partnerCustomPayload` object[], nullable — Custom JSON payload for this entity, managed by you.
  - `siteId` integer, nullable — Id of the site.
  - `operator` Operator
    - `id` integer — ID of the operator
    - `name` string, required — Name of operator
    - `identifier` string, required — Identifier of operator
    - `partnerId` integer, nullable — Id of the partner
    - `vatNumber` string, nullable — VAT number
  - `createdAt` string, date-time, required — Creation date of this charge point.
  - `updatedAt` string, date-time, required — Date this charge point was last updated.
  - `deletedAt` string, date-time, nullable — Date this charge point was deleted.
  - `activeAt` string, date-time, nullable — Last date when charge point was activated.
  - `serialNumber` string, nullable — Serial number of this charge point.
  - `name` string, nullable — Name of the charge point.
  - `visibility` 'private' | 'public', required — Indicates if this charge point is `public` or `private`.
  - `maxKW` number, double, nullable — Deprecated (will be removed by 01.04.24), use `maxKw` field instead.
  - `maxKw` number, double, nullable — Max KW available at this charge point.
  - `type` 'ac' | 'dc', nullable — Type of charge point (`AC` / `DC`).
  - `note` string, nullable — A note you have entered for this charge point, e.g. via our Portal.
  - `operatorNote` string, nullable — An operator note you have entered for this charge point, e.g. via our Portal.
  - `state` 'available' | 'busy' | 'busy-blocked' | 'busy-charging' | 'busy-non-charging' | 'busy-non-released' | 'busy-reserved' | 'busy-scheduled' | 'error' | 'disconnected' | 'passive' | 'maintenance' | 'other', nullable — Various types of Charge Point states. Definitions: * `available` - The charge point is available for charging. * `busy` - The charge point is currently in use. * `busy-blocked` - The charge point is currently in use and blocked. * `busy-charging` - The charge point is currently in use and charging. * `busy-non-charging` - The charge point is currently in use and not charging. * `busy-non-released` - The charge point is currently in use and not released. * `busy-reserved` - The charge point is currently in use and reserved. * `busy-scheduled` - The charge point is currently in use and scheduled. * `error` - The charge point is in an error state. * `disconnected` - The charge point is disconnected from Monta. * `passive` - The charge point is in a passive state, charging can only be controlled locally. * `maintenance` - The charge point is in maintenance mode. * `exempt` - The charge point is exempt from downtime reporting due to external factors.
  - `location` Location, required
    - `coordinates` Coordinates
      - `latitude` number, double — Latitude value of coordinate
      - `longitude` number, double — Longitude value of coordinate
    - `addressLabel` string, nullable — The full address.
    - `address` PartialAddress
      - `address1` string, nullable — First line of address
      - `address2` string, nullable — Second line of address
      - `address3` string, nullable — Third line of address
      - `zip` string, nullable — Zip-code
      - `city` string, nullable — City (readable)
      - `province` string, nullable — Province
      - `country` string, nullable — Country (readable)
      - `countryAreaId` integer, nullable — Country area id
  - `connectors` ChargePointConnector[], required — List of supported connector types at this charge point (e.g. type-2, ccs, ...).
    - `id` integer — Id of this connector
    - `identifier` string, required — Identifier of connector
    - `name` string, required — Readable name of connector
  - `deeplinks` ChargePointDeeplinks, required
    - `app` string, uri, required — Follow this link to open the Monta App with this charge point
    - `web` string, uri, required — Follow this link to open the Monta Web App with this charge point
  - `lastMeterReadingKwh` number, double, nullable — Last meter reading (KWH) for this charge point.
  - `meterId` string, nullable — Meter Id of this charge point.
  - `cablePluggedIn` boolean, required — Indicates if a cable is plugged in (true).
  - `chargePointModelId` integer, nullable — The ID of the charge point model for this charge point.
  - `brandName` string, nullable — Brand name for this charge point.
  - `modelName` string, nullable — Model name for this charge point.
  - `firmwareVersion` string, nullable — Current firmware version for this charge point.
  - `integrationType` 'oicp' | 'ocpi' | 'ocpp' | 'other' — definitions: * `oicp` - Indicates the current integration is OICP. * `ocpi` - Indicates the current integration is OCPI. * `ocpp` - Indicates the current integration is OCPP. * `other` - Fallback value, Indicates a new type was added but is not mapped/unknown on this API yet.
  - `evseId` string, required — The EVSE id for this charge point.
  - `priceGroupId` integer, nullable — The id of the public price group for this charge point.
  - `costGroupId` integer, nullable — The id of the cost price group for this charge point.
  - `roamingPriceGroupId` integer, nullable — The id of the roaming price group for this charge point.
  - `sponsoredPriceGroupId` integer, nullable — The id of the sponsored price group for this charge point.
  - `scheduleId` integer, nullable — The id of the schedule assigned to this charge point.
  - `isActive` boolean, required — Indicates if this charge point is active (true) or not (false). Active = fully onboarded to Monta.
  - `reservable` boolean, required — Indicates if the charge point can be reserved.
  - `reservationTime` integer, nullable — The max duration(in minutes) that this Charge Point can be reserved for</br>`null` indicates that reservation is not supported.
  - `simCard` SimCard
    - `imsi` string, nullable — imsi (International Mobile Subscriber Identity) for the SIM card
    - `iccid` string, nullable — iccid (Integrated Circuit Card Identifier) for the SIM card
  - `roaming` boolean, required — Indicates whether roaming is enabled for this charge point.
  - `lastConnectedAt` string, date-time, nullable — The last date/time this charge point was reported as connected.
  - `disconnectedAt` string, date-time, nullable — The date/time this charge point was reported as disconnected.
  - `occupied` boolean, nullable — Indicates if the Charge Point is currently occupied. **Note:** At the moment this is only determined by a charge point sensor attached to it.
  - `protocolData` ChargePointProtocolData, required
    - `ocpp` ChargePointOcpp
      - `status` 'available' | 'online' | 'not-connected' | 'error' | 'offline' | 'occupied' | 'preparing' | 'paused-ev' | 'paused-evse' | 'charging' | 'suspended-evse' | 'suspended-ev' | 'finishing' | 'reserved' | 'unavailable' | 'faulted' | 'idle' | 'ev-connected' | 'unknown' — Various types of Charge Point OCPP protocol statuses
      - `updatedAt` string, date-time, nullable — Indicates when the status was last updated.
  - `metadata` ChargePointMetadata
    - `busCompatible` boolean, nullable — Bus-compatible charge point
    - `motorcycleCompatible` boolean, nullable — Motorcycle-compatible charge point
    - `lorryCompatible` boolean, nullable — Lorry-compatible charge point
    - `lorryWithDangerousGoodsCompatible` boolean, nullable — Lorry with dangerous goods allowed
    - `lorryWithTrailerCompatible` boolean, nullable — Lorry with trailer compatible
    - `personalVehicleCompatible` boolean, nullable — Personal vehicle-compatible charge point
    - `personalVehicleWithTrailerCompatible` boolean, nullable — Personal vehicle with trailer compatible
    - `rigidLoryCompatible` boolean, nullable — Rigid lorry compatible
    - `vanCompatible` boolean, nullable — Van-compatible charge point
    - `vehicleWithDisabilityPermitCompatible` boolean, nullable — Vehicles with disability permit compatible
    - `additionalParkingFeesPolicy` boolean, nullable — Additional parking fees policy
    - `buildingTenantsOnlyPolicy` boolean, nullable — Building tenants only parking policy
    - `customersOnlyPolicy` boolean, nullable — Customers only parking policy
    - `disabilityPermitPolicy` boolean, nullable — Disability permit parking policy
    - `evOnlyPolicy` boolean, nullable — Electric vehicle only parking policy
    - `employeesOnlyPolicy` boolean, nullable — Employees only parking policy
    - `overnightParkingPolicy` boolean, nullable — Overnight parking policy
    - `parkingOnlyWhileChargingPolicy` boolean, nullable — Parking only while charging policy
    - `reservationPolicy` boolean, nullable — Reservation required parking policy
    - `taxisOnlyPolicy` boolean, nullable — Taxis only parking policy
    - `floorLevel` string, nullable — Floor level of the charge point
    - `cableLength` number, double, nullable — Cable length in centimeters
    - `behindBarrierPolicy` boolean, nullable — Behind barrier parking policy
    - `hdvParkingSpot` HdvParkingSpot
      - `height` integer, nullable — Height in centimeters
      - `width` integer, nullable — Width in centimeters
      - `length` integer, nullable — Length in centimeters
      - `weight` integer, nullable — Weight in kilograms
      - `angledOrientation` boolean, nullable — Angled orientation
      - `driveThroughOrientation` boolean, nullable — Drive-through orientation
      - `parallelOrientation` boolean, nullable — Parallel orientation
      - `perpendicularOrientation` boolean, nullable — Perpendicular orientation
      - `turningRadius` number, double, nullable — Turning radius in meters
      - `cpPosition` string, nullable — cpPosition, if any
    - `dangerousGoodsAllowed` boolean, nullable — Dangerous goods are allowed
    - `rigidVehiclesAllowed` boolean, nullable — Rigid vehicles are allowed
    - `twoWheeledStation` boolean, nullable — Two wheeled station available
    - `vehicleAccessibility` string, nullable — Vehicle accessibility description
    - `heightRestriction` boolean, nullable — Height restriction in place
    - `reservationRequired` boolean, nullable — Reservation is required
    - `overnightParkingAllowed` boolean, nullable — Overnight parking is allowed
    - `accessConditions` string, nullable — Access conditions description
    - `barrier` boolean, nullable — Barrier present at the charge point
    - `chargingWhenClosed` boolean, nullable — Charging allowed when site is closed
    - `trailerPullThrough` boolean, nullable — Trailer pull-through available
  - `showOnMap` boolean, required — Indicates if this charge point should be displayed on the map.
  - `smartChargeSetting` 'off' | 'optional' | 'forced' | 'forced-setting', nullable — Smart charging setting for this charge point. - `off`: Smart charging is disabled, rules cannot be created - `optional`: Smart charging is optional, rules can be created and applied - `forced`: Smart charging is forced, rules will always be applied - `forced-setting`: Smart charging setting is forced
  - `autoStart` 'on' | 'off' | 'not-available' — Auto-start status values
  - `userId` integer, nullable — Id of the user that owns this charge point.
  - `autoRegisterRfid` boolean, nullable — Whether RFID tags are auto-registered when scanned at this charge point.

## Other responses

- `400` — The request is invalid
- `401` — Consumer with provided credentials was not found
- `403` — Operator doesn't have access to resource
- `404` — Entity with the provided id was not found

---

[API](https://skmtc.net/monta/apis/monta-partner-api.md) · [All operations](https://skmtc.net/monta/apis/monta-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monta/monta-partner-api/versions/517e18f11015/schema)