Device Power

API to manage device power services. These are offered by battery powered devices. The update endpoint (e.g. PUT) was intentionally not implemented.

List device powers

get

List all available device powers

Authorizations

HueApplicationKey

hue-application-keystringRequired

Responses

200

Device Power Success Response

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

405

Method Not Allowed

application/json

406

Not Acceptable

application/json

409

Conflict

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

503

Service Unavailable

application/json

507

Insufficient Storage

application/json

get

/clip/v2/resource/device_power

HTTPcURLJavaScriptPython

GET /clip/v2/resource/device_power HTTP/1.1
Host: 192.168.1.0
hue-application-key: YOUR_API_KEY
Accept: */*

{
  "errors": [
    {
      "description": "text"
    }
  ],
  "data": [
    {
      "type": "light",
      "id": "3883f8bf-30a3-445b-ac06-b047d50599df",
      "id_v1": "/lights/8",
      "owner": {
        "rid": "42edd1f5-9538-4180-9ced-2d9e07f26d0f",
        "rtype": "device"
      },
      "power_state": {
        "battery_state": "normal",
        "battery_level": 1
      }
    }
  ]
}

Get device power

get

Get power details of a single device from its given {deviceId}.

Authorizations

HueApplicationKey

hue-application-keystringRequired

Path parameters

deviceIdstringRequired

ID of the device

Responses

200

Device Success Response

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

405

Method Not Allowed

application/json

406

Not Acceptable

application/json

409

Conflict

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

503

Service Unavailable

application/json

507

Insufficient Storage

application/json

get

/clip/v2/resource/device_power/{deviceId}

HTTPcURLJavaScriptPython

GET /clip/v2/resource/device_power/{deviceId} HTTP/1.1
Host: 192.168.1.0
hue-application-key: YOUR_API_KEY
Accept: */*

{
  "errors": [
    {
      "description": "text"
    }
  ],
  "data": [
    {
      "type": "light",
      "id": "3883f8bf-30a3-445b-ac06-b047d50599df",
      "id_v1": "/lights/8",
      "owner": {
        "rid": "42edd1f5-9538-4180-9ced-2d9e07f26d0f",
        "rtype": "device"
      },
      "power_state": {
        "battery_state": "normal",
        "battery_level": 1
      }
    }
  ]
}