JouloDocs

Restart a charger

Sends an OCPP Reset to one of your own OCPP-connected chargers (including Joulo Proxy connections) • a remote reboot for when the charge point hangs.

type "Soft" (default) lets the charger end an active session gracefully before restarting; "Hard" reboots immediately. Delivery is live-only: if the charger is offline this returns 409 and nothing is queued. Reboots are rate-limited per charger (a burst of 2, then one per 5 minutes).

A charger that honours the reset often reboots without ever answering, so no reply is not the same as no reboot. Joulo then confirms the restart out-of-band via the charger's BootNotification and still returns 200, with confirmed_by_boot: true. If neither an answer nor a restart arrives within the confirmation window you get 202: the command went out over a live socket but could not be verified.

POST
/chargers/reboot
AuthorizationBearer <token>

API token from the Joulo dashboard, or an OAuth2 access token.

In: header

charger_idstring

The charger id from GET /chargers.

Formatuuid
type?string

OCPP reset type. Soft ends an active session gracefully; Hard reboots immediately.

Default"Soft"
Value in"Soft" | "Hard"

Response Body

curl -X POST "https://api.joulo.nl/functions/v1/api/chargers/reboot" \
  -H "Content-Type: application/json" \
  -d '{
    "charger_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "type": "Soft"
  }'
{
  "charger_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "type": "Soft",
  "delivered": true,
  "status": "Accepted"
}
{
  "charger_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "type": "Soft",
  "delivered": true,
  "status": "unconfirmed",
  "error": "Reset was delivered but the charger has not confirmed a restart yet"
}
{
  "error": "connection_type is required and must be \"ocpp\""
}
{
  "error": "Missing or invalid API token"
}
{
  "error": "Insufficient scope",
  "required_scope": "chargers:read"
}
{
  "error": "Charger not found or not connected via OCPP"
}
{
  "charger_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "type": "Soft",
  "delivered": false,
  "status": "offline",
  "error": "Charger is not connected to Joulo right now"
}
Empty