---
title: "PUT /lighting/updateLightingZone"
method: PUT
path: "/lighting/updateLightingZone"
tags: ["LightingService"]
---

# PUT /lighting/updateLightingZone

`PUT /lighting/updateLightingZone`

## Request body

- UpdateLightingZoneRequest — All update properties aside from the id are optional. Adjusting dimmable and max_output will automatically adjust calibration.
  - `id` string
  - `name` string
  - `enabled` boolean
  - `dimmable` boolean
  - `max_output` 'TWELVE_VOLTS' | 'FIFTEEN_VOLTS', enum

## Response `200`

OK

- UpdateLightingZoneResponse
  - `lighting_zone` LightingZone
    - `id` string
    - `lighting_controller_id` string
    - `zone_number` integer
    - `name` string
    - `reported_state` LightingZoneReportedState — The last reported state of the zone
      - `state` 'ERROR' | 'ON' | 'OFF', enum
      - `dimming_settings` LightingZoneReportedDimmingSettings — Reported dimming configuration including calibration and current dim level. Percentage fields are integers [0,100]. Note that the firmware handles scaling based on min and max. The default and current dim levels are always [0,100]
        - `min_dimming_percent` integer
        - `max_dimming_percent` integer
        - `default_dimming_percent` integer
        - `current_dimming_percent` integer
      - `current_wattage` integer
      - `max_wattage_reported` WattageMeasurement — Wattage measurement with timestamp
        - `wattage` integer
        - `timestamp` string, date-time
    - `order` integer
    - `enabled` boolean
    - `dimmable` boolean
    - `lighting_controller_serial_number` string
    - `lighting_controller_name` string
    - `max_output` 'TWELVE_VOLTS' | 'FIFTEEN_VOLTS', enum

---

[API](https://skmtc.net/rach/apis/readme.md) · [All operations](https://skmtc.net/rach/apis/readme/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rach/readme/versions/7cb72b0455d5/schema)