nexalwarenexalwaredocs
API ReferenceDevice control

Get a device's command catalog

GET
/api/v1/devices/{deviceId}/commands

The commands this specific device supports right now what a control UI or an AI agent should present as its available actions. Devices with no custom DeviceType return the legacy ON/OFF/TOGGLE/STATUS set.

Authorization

X-Api-Key<token>

A secret API key created on the dashboard (Settings → API Keys). By itself it grants nothing - it must also have a DeviceGrant scoping it to the specific device(s) and command(s) it may call.

In: header

Path Parameters

deviceId*string

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/devices/string/commands"
[  {    "name": "string",    "label": "string",    "kind": "ACTION",    "paramsSchema": {      "property1": null,      "property2": null    }  }]