Sign in

List lights

developed⚡ superfast

Retrieve information about the LIFX lights matching the selector.

GET /v1/lights/{selector}Lightsv 198d1fed · auto-generated20 runs
Version 198d1fed73 · Fix credential placeholder: {{OAUTH2_ACCESS_TOKEN}} → {{LIFX_PERSONAL_ACCESS_TOKEN}} · by the agent · build 6583edb4 on isolatePropose a change

Input schema

type:object
additionalProperties:false
0:selector

Output schema

type:array
description:Array of light objects matching the selector.
type:object

Possible errors

  • CREDENTIALS_REQUIRED

    No valid OAuth2 access token is present. Authorization is needed.

  • NOT_FOUND

    No lights matched the given selector.

  • INVALID_INPUT

    The selector value is malformed or empty.

  • RATE_LIMITED

    The LIFX API rate limit has been exceeded.

  • LIFX_API_ERROR

    The LIFX API returned an unexpected error.