Update connector​

PATCH
/chargers/{chargerId}/connectors/{connectorId}

Updates connector metadata such as its name, sticker, type, and electrical limits. This does not change the connector availability.

Use cases

  • Correct connector details after a hardware or labeling change.
  • Keep the advertised power, current, and voltage limits accurate.

Related endpoints

  • GET /chargers/{chargerId} — read the charger and its connectors.
  • PUT /chargers/{chargerId}/connectors/{connectorId}/availability — change connector availability.

Authorizations​

bearerAuth

Generate an API token here

Type
HTTP (bearer)

Parameters​

Header Parameters

compatibility-date*

API compatibility date in YYYY-MM-DD format. Must be a date after 2025-11-01.

Type
string
Required
Example"2025-11-02"
Pattern
^\d{4}-\d{2}-\d{2}$
organization-id*

Routes the request to the organization named by this ID. The bearer token must be authorized for that organization.

Type
string
Required
Example"3b241101-e2bb-4255-8caf-4136c566a962"
Min Length
1
Max Length
40

Path Parameters

chargerId*

UUID returned by POST /chargers or GET /chargers. Use it to target that charger for configuration, connector, or status operations.

Type
string
Required
Example"550e8400-e29b-41d4-a716-446655440000"
Min Length
1
Max Length
40
connectorId*

Connector number from chargers[].connectors[].id. OCPP connector numbers range from 1 to 255.

Type
string
Required
Example"1"
Max Length
3
Pattern
^(?:[1-9]|[1-9]\d|1\d{2}|2[0-4]\d|25[0-5])$

Request Body​

application/json

Sticker ID to assign, or null to remove the current sticker.

Connector standard: type1/type2 are AC, ccs1/ccs2 are CCS, and gbt_ac/gbt_dc are GB/T.

Valid values"type1""type2""ccs1""ccs2""tesla""chademo""gbt_ac""gbt_dc""other"

Maximum connector power in watts (W).

Exclusive Minimum0
Maximum9007199254740991

Maximum connector current in amperes (A).

Exclusive Minimum0
Maximum9007199254740991

Maximum connector voltage in volts (V).

Exclusive Minimum0
Maximum9007199254740991

Responses​

Returns the updated information of the charger

application/json

Playground​

Authorization
Headers
Variables
Key
Value
Body

Samples​