GitHubHue Developer Portal

Sensors

This page regroups the sensors-related APIs.

Light Level

These are offered by devices with light level sensing capabilities.

List light levels.

get

List all available light levels.

Authorizations
Responses
200
Light Level Success Response
application/json
Responseall of
get
GET /clip/v2/resource/light_level 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"
      },
      "enabled": true,
      "light": {
        "light_level": 1,
        "light_level_valid": true,
        "light_level_report": {
          "changed": "2025-07-09T06:17:03.458Z",
          "light_level": 1
        }
      }
    }
  ]
}

Get light

get

Get details of a single light from its given {lightId}.

Authorizations
Path parameters
lightIdstringRequired

ID of the light

Responses
200
Light Level Success Response
application/json
Responseall of
get
GET /clip/v2/resource/light_level/{lightId} 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"
      },
      "enabled": true,
      "light": {
        "light_level": 1,
        "light_level_valid": true,
        "light_level_report": {
          "changed": "2025-07-09T06:17:03.458Z",
          "light_level": 1
        }
      }
    }
  ]
}

Update light

put

Update a single light from its given {lightId}.

Authorizations
Path parameters
lightIdstringRequired

ID of the light

Body
typestringOptional

Type of the supported resources (always light_level here)

enabledbooleanOptional

true when sensor is activated, false when deactivated

Responses
200
Success
application/json
Responseall of
put
PUT /clip/v2/resource/light_level/{lightId} HTTP/1.1
Host: 192.168.1.0
hue-application-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "enabled": true
}
{
  "errors": [
    {
      "description": "text"
    }
  ],
  "data": [
    {
      "rid": "42edd1f5-9538-4180-9ced-2d9e07f26d0f",
      "rtype": "device"
    }
  ]
}

Temperature

These are offered by devices with temperature sensing capabilities.

List temperatures

get

List all temperatures

Authorizations
Responses
200
Temperature Success Response
application/json
Responseall of
get
GET /clip/v2/resource/temperature 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"
      },
      "enabled": true,
      "temperature": {
        "temperature": 23,
        "temperature_valid": true,
        "temperature_report": {
          "changed": "2025-07-09T06:17:03.458Z",
          "temperature": 23
        }
      }
    }
  ]
}

Get temperature sensor information

get

Get details of a single temperature sensor from its given {temperatureId}.

Authorizations
Path parameters
temperatureIdstringRequired

ID of the temperature sensor

Responses
200
Temperature Success Response
application/json
Responseall of
get
GET /clip/v2/resource/temperature/{temperatureId} 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"
      },
      "enabled": true,
      "temperature": {
        "temperature": 23,
        "temperature_valid": true,
        "temperature_report": {
          "changed": "2025-07-09T06:17:03.458Z",
          "temperature": 23
        }
      }
    }
  ]
}

Update temperature sensor

put

Update a temperature sensor from its given {temperatureId}.

Authorizations
Path parameters
temperatureIdstringRequired

ID of the temperature sensor

Body
typestring · enumOptional

Type of the supported resources (always temperature here)

Possible values:
enabledbooleanOptional

true when sensor is activated, false when deactivated

Responses
200
Success
application/json
Responseall of
put
PUT /clip/v2/resource/temperature/{temperatureId} HTTP/1.1
Host: 192.168.1.0
hue-application-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "enabled": true
}
{
  "errors": [
    {
      "description": "text"
    }
  ],
  "data": [
    {
      "rid": "42edd1f5-9538-4180-9ced-2d9e07f26d0f",
      "rtype": "device"
    }
  ]
}
PreviousZoneNextOpenHue CLI

Last updated

Was this helpful?