Skip to main content
POST
Enter the connected car's state of charge and schedule for the current charging session

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

org_id
string<uuid>
required

The organization ID

user_id
string<uuid>
required

The user ID whom the wallbox belongs to

wallbox_id
string<uuid>
required

The EV charger (wallbox) UUID

Body

application/json

What the user knows about the car plugged in right now.

The state of charge is always required — every submit asserts "the car is at X% now", which is what anchors the session's synthetic charge progress. The rest is optional: the battery capacity is durable car configuration (it becomes the wallbox's default), while the deadline and target are override-and-forget for this session alone.

soc_pct
number
required

The car's state of charge right now, in percent.

Required range: 0 <= x <= 100
battery_capacity_kwh
number | null

Usable battery capacity of the connected car (kWh). Stored as the wallbox's default for subsequent sessions. Required while the wallbox has none configured.

Required range: 0 < x <= 300
charge_deadline
string<date-time> | null

Charge by this instant, for this session only — an ISO-8601 datetime carrying a UTC offset. Must be in the future and within the session's remaining life; the wallbox's configured schedule is untouched.

charge_target_pct
integer | null

Charge to this state of charge, for this session only. The wallbox's configured charge limit is untouched.

Required range: 1 <= x <= 100

Response

No Content