Local API

Basics

http://iconet.local/api/…
Authorization: Bearer ico_…

Create the token in Settings › Access (An integration or app) with the permissions you need. All calls are JSON, on the local network only, and logged under Activity.

Devices

GET  /api/areas                 rooms                          Read devices
GET  /api/entities              every device with its state    Read devices
GET  /api/entities/{id}         one device                     Read devices
POST /api/command               act on a device                Control devices

A device carries id, entityId (a readable alias like light.kitchen), name, domain (light, cover, climate, lock, sensor, switch…), area, capabilities and state. To act, send the device id and one of its capabilities:

POST /api/command
{ "id": "…", "capability": "on_off", "value": true }

Capabilities follow what the device reports: on_off (true/false), brightness (0–100), position and tilt (0–100 for blinds), setpoint (target temperature), hvac_mode, lock (lock/unlock), activate (scenes and buttons).

Live events

GET /api/events                 server‑sent events             Live events

A stream of state changes as they happen. Point an EventSource at it and keep the header.

Workflows

GET    /api/workflows           list                           Read workflows
GET    /api/workflows/{id}      one workflow                   Read workflows
PUT    /api/workflows/{id}      create or edit (enable, disable) Change workflows
DELETE /api/workflows/{id}      delete                         Change workflows
POST   /api/workflows/{id}/run  run it now                     Change workflows
GET    /api/workflows/log       recent runs                    Read workflows

A workflow is a JSON document with name, enabled and its flow (nodes and edges). The easiest way to get the shape right is to build one in the app and read it back with GET.

History and weather

GET /api/series?ids=…&keys=…&since=…&until=…&res=…     Read trends
GET /api/insights                                       Read trends
GET /api/weather                                        Read trends

series returns time series for the devices and keys you ask for; insights the energy totals of the current ranges; weather the forecast for the gateway's location.

Try it

curl -H "Authorization: Bearer ico_…" http://iconet.local/api/entities

Home Assistant

A rest_command with the same header gives you any device from an HA automation; Settings › MQTT is the richer path (all devices discovered automatically).