Light

These are offered by devices with lighting capabilities.

List lights.

get

List all available lights.

Authorizations
hue-application-keystringRequired
Responses
200

Light Success Response

application/json
get
/clip/v2/resource/light

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 Success Response

application/json
get
/clip/v2/resource/light/{lightId}

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 here)

modestring · enumOptionalPossible values:
Responses
200

Success

application/json
put
/clip/v2/resource/light/{lightId}

Grouped Light

These are offered by rooms, zones, and homes.

List grouped lights

get

List all grouped lights

Authorizations
hue-application-keystringRequired
Responses
200

Grouped Light Success Response

application/json
get
/clip/v2/resource/grouped_light

Get grouped light

get

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

Authorizations
hue-application-keystringRequired
Path parameters
groupedLightIdstringRequired

ID of the grouped light

Responses
200

Grouped Light Success Response

application/json
get
/clip/v2/resource/grouped_light/{groupedLightId}

Update grouped light

put

Update a single grouped light from its given {groupedLightId}.

Authorizations
hue-application-keystringRequired
Path parameters
groupedLightIdstringRequired

ID of the light

Body
typestring · enumOptional

Type of the supported resources (always grouped_light here)

Possible values:
Responses
200

Success

application/json
put
/clip/v2/resource/grouped_light/{groupedLightId}

Last updated

Was this helpful?