Skip to main content
POST
/
ev-charger
/
{deviceId}
/
settings
curl
curl --request POST \
  --url 'https://api.amps.ai/ev-charger/device_abc123/settings' \
  --header 'x-api-key: amps_sk_test_xxxxxxxxxxxxxxxxxxxxxxxx' \
  --header 'content-type: application/json' \
  --data '{
    "max_charge_rate": {
      "value": 11,
      "unit": "kw"
    }
  }'
{
  "success": true,
  "data": {
    "deviceId": "device_ev_001",
    "updated": [
      "max_charge_rate"
    ]
  },
  "meta": {
    "requestId": "req_8a2Bf3kP",
    "environment": "sandbox",
    "timestamp": "2026-06-02T12:00:00.000Z",
    "latencyMs": 12
  }
}

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

Sparse map of writable settings. At least one field is required. Each value uses the canonical { value, unit } shape; unit must match the canonical setting.

Sparse map of writable settings. At least one field is required. Unknown or read-only keys are rejected with UNSUPPORTED_SETTING.

​
max_charge_rate
Quantity · object

Maximum charging power the charger will draw. (unit: kw, min: 0, max: 50)

Response

Settings written. Response lists the canonical setting keys that changed.

​
success
boolean
required

Always true for success responses.

​
data
Ev Charger Settings Update · object
required

Acknowledgement of a settings write. updated lists the canonical setting keys that changed; OEMs that fire-and-forget will still echo the keys.

​
meta
Response Meta · object
required

Metadata attached to every response: the request identifier, the serving environment, the build timestamp, and the server-side latency.