GitHubHue Developer Portal
Edit

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
hue-application-keystringRequired
Responses
200

Light Level Success Response

application/json
Responseall of
get
/clip/v2/resource/light_level
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-12-03T06:26:41.610Z",
          "light_level": 1
        }
      }
    }
  ]
}

Get light

get

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

Authorizations
hue-application-keystringRequired
Path parameters
lightIdstringRequired

ID of the light

Responses
200

Light Level Success Response

application/json
Responseall of
get
/clip/v2/resource/light_level/{lightId}
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-12-03T06:26:41.610Z",
          "light_level": 1
        }
      }
    }
  ]
}

Update light

put

Update a single light from its given {lightId}.

Authorizations
hue-application-keystringRequired
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
/clip/v2/resource/light_level/{lightId}
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
hue-application-keystringRequired
Responses
200

Temperature Success Response

application/json
Responseall of
get
/clip/v2/resource/temperature
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-12-03T06:26:41.610Z",
          "temperature": 23
        }
      }
    }
  ]
}

Get temperature sensor information

get

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

Authorizations
hue-application-keystringRequired
Path parameters
temperatureIdstringRequired

ID of the temperature sensor

Responses
200

Temperature Success Response

application/json
Responseall of
get
/clip/v2/resource/temperature/{temperatureId}
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-12-03T06:26:41.610Z",
          "temperature": 23
        }
      }
    }
  ]
}

Update temperature sensor

put

Update a temperature sensor from its given {temperatureId}.

Authorizations
hue-application-keystringRequired
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
/clip/v2/resource/temperature/{temperatureId}
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?