Update an EVSE

PATCH

https://api.ocpplab.io/cpo/evses/:id

PATCH

/cpo/evses/:id

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.cpo.evses.update({
        id: 101,
        ifMatch: "2026-09-30T10:00:00Z",
        expected_revision: 1,
        floor_level: "-1",
    });
}
main();

{
  "id": 101,
  "organization_id": "550e8400-e29b-41d4-a716-446655440000",
  "charge_point_id": "CP-AMS-001",
  "removed": false,
  "origin": "LOCAL",
  "last_updated": "2026-09-30T10:00:00Z",
  "revision": 2,
  "created_at": "2026-09-01T09:00:00Z",
  "updated_at": "2026-09-30T10:00:00Z",
  "evse_type_id": 1,
  "evse_id": "NL*OCP*E1001*1",
  "evse_uid": "NL*OCP*E1001*1",
  "location_id": "LOC-AMS-01",
  "location_db_id": 12,
  "status": "AVAILABLE",
  "capabilities": [
    "RFID_READER",
    "REMOTE_START_STOP_CAPABLE"
  ],
  "floor_level": "-1",
  "role": "CPO",
  "country_code": "NL",
  "party_id": "OCP",
  "ocpi_version": "2.2.1",
  "ocpp_version": "ocpp2.0.1"
}

Changes only the fields sent; send null to clear a field. Guard it with If-Match or expected_revision to avoid overwriting someone else’s change.

Authentication

AuthorizationBearer

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

Path parameters

idintegerRequired>=1

The EVSE’s id.

Request

This endpoint expects an object.

expected_revisioninteger or nullOptional>=1

evse_uidstring or nullOptional1-36 characters

evse_idstring or nullOptional<=48 characters

physical_referencestring or nullOptional<=16 characters

location_idstring or nullOptional1-36 characters

capabilitieslist of strings or nullOptional

floor_levelstring or nullOptional<=4 characters

coordinatesobject or nullOptional

directionslist of objects or nullOptional

parking_restrictionslist of strings or nullOptional

accepted_service_providerslist of strings or nullOptional

imageslist of objects or nullOptional

Response

The object after the update.

idinteger

organization_idstring

charge_point_idstring

removedboolean

originenum or any

last_updateddatetime

revisioninteger

created_atdatetime

updated_atdatetime

evse_type_idinteger or nullOptional

evse_idstring or nullOptional

evse_uidstring or nullOptional

physical_referencestring or nullOptional

location_idstring or nullOptional

location_db_idinteger or nullOptional

statusenum or any or nullOptional

status_schedulelist of objects or nullOptional

capabilitieslist of strings or nullOptional

floor_levelstring or nullOptional

coordinatesobject or nullOptional

directionslist of objects or nullOptional

parking_restrictionslist of strings or nullOptional

parkinglist of objects or nullOptional

accepted_service_providerslist of strings or nullOptional

imageslist of objects or nullOptional

rolestring or nullOptional

country_codestring or nullOptional

party_idstring or nullOptional

ocpi_versionstring or nullOptional

ocpp_versionstring or nullOptional

responded_atdatetime 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

Authentication

Path parameters

Headers

Request

Response

Errors