myenergi Device settings API
The Device settings API from myenergi — 1 operation(s) for device settings.
The Device settings API from myenergi — 1 operation(s) for device settings.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/myenergi:myenergi-device-settings-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: myenergi public Device settings API
version: 1.0.0
servers:
- url: api.myenergi.com
tags:
- name: Device settings
paths:
/devices/user-settings/{deviceSerialNo}:
get:
operationId: device-userDeviceSettings-getSettings
description: Returns the user-configurable settings currently reported by a device. Includes `isEditable` (whether this device class supports user-editable settings at all) and `isController` (whether this device is acting as the hub controller — some fields, such as exportMargin, can only be written on the controller). `configStatus` indicates whether the device has reported a current configuration (`ready`) or not yet (`pending`).
tags:
- Device settings
security:
- bearerAuth: []
parameters:
- name: deviceSerialNo
in: path
required: true
schema:
type: number
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
serialNo:
type: number
deviceClass:
type: string
deviceSubclass:
type: string
isController:
type: boolean
isEditable:
type: boolean
config:
type:
- object
- 'null'
properties:
exportMargin:
type: number
minGreenLevel:
type: number
additionalProperties: false
configStatus:
type: string
enum:
- ready
- pending
required:
- serialNo
- deviceClass
- deviceSubclass
- isController
- isEditable
- config
- configStatus
additionalProperties: false
default:
$ref: '#/components/responses/error'
summary: Device user device settings get settings
x-summary-source: derived
post:
operationId: device-userDeviceSettings-setSettings
description: 'Dispatches a settings change to a device. Only fields valid for the device class are accepted. On successful dispatch returns `{ success: true, commandId }` — poll the command status endpoint to confirm delivery. When per-field rules reject the write (e.g. controller-only fields on a non-controller device), returns `{ success: false, fieldErrors }` with a structured error code per offending field.'
tags:
- Device settings
security:
- bearerAuth: []
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
config:
type: object
properties:
exportMargin:
type: number
minGreenLevel:
type: number
additionalProperties: false
required:
- config
additionalProperties: false
parameters:
- name: deviceSerialNo
in: path
required: true
schema:
type: number
responses:
'200':
description: Successful response
content:
application/json:
schema:
anyOf:
- type: object
properties:
success:
type: boolean
enum:
- true
commandId:
type: string
format: uuid
required:
- success
- commandId
additionalProperties: false
- type: object
properties:
success:
type: boolean
enum:
- false
fieldErrors:
type: object
required:
- exportMargin
- minGreenLevel
properties:
exportMargin:
type: string
enum:
- REQUIRES_CONTROLLER
- NOT_WRITABLE_FOR_DEVICE_CLASS
minGreenLevel:
type: string
enum:
- REQUIRES_CONTROLLER
- NOT_WRITABLE_FOR_DEVICE_CLASS
additionalProperties: false
required:
- success
- fieldErrors
additionalProperties: false
default:
$ref: '#/components/responses/error'
summary: Device user device settings set settings
x-summary-source: derived
components:
responses:
error:
description: Error response
content:
application/json:
schema:
type: object
properties:
message:
type: string
code:
type: string
issues:
type: array
items:
type: object
properties:
message:
type: string
required:
- message
additionalProperties: false
required:
- message
- code
additionalProperties: false
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: API Key
description: API key generated on the myaccount website