Enter the connected car's state of charge and schedule for the current charging session
Provide what is known about the car plugged into the wallbox right now.
Wallbox-only spot optimization has no BMS visibility: with soc_pct and a battery
capacity the optimizer sizes the charging window from the real energy need instead
of a fallback estimate. soc_pct is always required — it describes the car now
and re-anchors the session’s charge progress on every accepted request.
battery_capacity_kwh is the connected car’s usable capacity. It is stored as the
wallbox’s durable default, so later sessions need only the state of charge.
It is saved even when the rest of the request is rejected — losing a
first-session capture to an unplug race would send the user through the same dead
end again.
charge_deadline and charge_target_pct override the wallbox’s configured
schedule for this session only (“this once, 90% by 05:00”). They expire with the
session — the persistent configuration is never written — and bind from the next
recalculation onwards.
Returns 204 on success (persisted; a running spot session recalculates
immediately). Returns 409 with reason when the inputs can’t be used:
no_open_session (no charging session is currently open), no_battery_capacity
(none supplied here and none configured on the wallbox), or
invalid_charge_deadline (in the past, or past the point this session stops being
steered — spot steering ends 48 hours after the session opened, so a later deadline
is unenforceable). Out-of-range values, and a charge_deadline without a UTC
offset, are rejected as 422 rather than silently clamped or guessed.
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Path Parameters
The organization ID
The user ID whom the wallbox belongs to
The EV charger (wallbox) UUID
Body
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.
The car's state of charge right now, in percent.
0 <= x <= 100Usable battery capacity of the connected car (kWh). Stored as the wallbox's default for subsequent sessions. Required while the wallbox has none configured.
0 < x <= 300Charge 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 to this state of charge, for this session only. The wallbox's configured charge limit is untouched.
1 <= x <= 100Response
No Content
