Skip to main content
POST
/
ev-charger
/
{deviceId}
curl --request POST \
  --url https://api.example.com/ev-charger/{deviceId} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "action": "start_charging"
}
'
{
  "actionId": "act_abc123xyz",
  "state": "acknowledged",
  "type": "ev-charger:start_charging",
  "createdAt": "2025-01-23T10:30:00.000Z",
  "deferredUntil": "2025-06-01T18:00:00Z"
}
The deferUntil parameter is not yet operational and will be available in a future release.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
deviceId
string
required

The unique identifier for the EV Charger device

Example:

"device_abc123"

Body

application/json

The action to perform on the EV Charger device

​
action
enum<string>
required

Action type - start charging the vehicle

Available options:
start_charging
Example:

"start_charging"

​
deferUntil
string

Defer execution until a specific time. Accepts either an ISO 8601 UTC timestamp (e.g. '2025-06-01T18:00:00Z') or a relative duration: '{x}m' for minutes or '{x}h' for hours, where x is a number with up to 2 decimal places (e.g. '30m', '1.5h', '0.25h').

Example:

"30m"

​
sandbox
object

Optional sandbox configuration for testing

Response

Action acknowledged and queued for processing

​
actionId
string
required

Unique identifier for the action

Example:

"act_abc123xyz"

​
state
enum<string>
required

Current state of the action

Available options:
acknowledged,
deferred,
completed,
failed
Example:

"acknowledged"

​
type
enum<string>
required

Type of action being performed

Available options:
ev-charger:start_charging,
ev-charger:stop_charging,
ev-charger:set_max_power
Example:

"ev-charger:start_charging"

​
createdAt
string
required

Timestamp when the action was created

Example:

"2025-01-23T10:30:00.000Z"

​
deferredUntil
string | null

Resolved ISO 8601 UTC timestamp the action is deferred until. Null if the action was not deferred.

Example:

"2025-06-01T18:00:00Z"