Skip to main content
PUT
Updates a plug

Authorizations

Authorization
string
header
required

OAuth2 Bearer Authorization

Path Parameters

uuid
string
required

UUID of the plug

Pattern: ^[a-f0-9]{8}\-[a-f0-9]{4}\-4[a-f0-9]{3}\-[89ab][a-f0-9]{3}\-[a-f0-9]{12}$

Body

application/json

Updates a plug. Required permission: asset:plugs:update

type_id
integer<int32>
required

The ID of the plug type assigned to this connector. Must reference a valid plug type from the system. Incorrect plug types may cause the connector to fail quality checks and be excluded from public outputs and roaming platforms.

Required range: x >= 0
phase
enum<string>
required

The electrical phase configuration of this plug. Must match the hardware specification and is used for power calculations and display in the app and roaming outputs.

Available options:
ac1,
ac3,
dc
Example:

"AC3"

ampere
integer<int32>
required

The current rating of this plug in amperes. Displayed in the app and transmitted to roaming partners. Typical values: 16A (Schuko), 32A (Type 2), 200A (CHAdeMO), 600A (CCS2).

Required range: x >= 0
voltage
integer<int32>
required

The voltage of this plug in volts. Displayed in the app and transmitted to roaming partners. Typical values: 230V (Type 1/Schuko), 400V (Type 2 AC), up to 1000V (DC fast charging).

Required range: x >= 0
max_power
integer<int32>
required

The maximum charging power of this plug in kilowatts. One of the most important fields for end users, as drivers filter charge points by this value when searching for a suitable location.

Required range: x >= 0
active
boolean
default:true
required

Indicates whether this plug is currently active and available for charging sessions. Inactive plugs are not shown in public-facing outputs or transmitted to roaming partners.

fixable
boolean
default:true
required

Indicates whether this plug can be physically locked to the vehicle during a charging session. When true, the connector supports a locking mechanism that prevents accidental disconnection.

with_cable
boolean
default:false
required

Indicates whether this plug has a permanently attached charging cable. When true, the driver does not need to bring their own cable to use this connector.

cable_length
integer<int32>
required

The length of the attached cable in centimeters. Only relevant when with_cable is true.

Required range: x >= 0
export
boolean
default:false
required

Controls whether this plug is included in external API outputs such as the Whitelabel app and POI data. Set to false to hide the plug from all public-facing outputs.

comment
string

An internal comment about this plug, visible only to backend users. Used for operational notes or installation remarks. Not displayed in the app or transmitted to roaming partners.

Maximum string length: 255
serial_number
string

The manufacturer-assigned serial number of the plug hardware.

Maximum string length: 25
article_number
string

The manufacturer's article or part number for this plug.

Maximum string length: 25

Response

Plug edited

plug
object
required

Plug