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

# PUT /lighting/updateLightingProgram

`PUT /lighting/updateLightingProgram`

## Request body

- UpdateLightingProgramRequest — All update properties aside from the id are optional. Only one of zones, groups, or scenes can be provided.
  - `id` string
  - `name` string
  - `enabled` boolean
  - `on_at` NullableLightingTime — Set "data" to a new lighting time to update, or "null" to null to remove
    - `null` string
    - `lighting_time` LightingTime
      - `fixed_time` FixedTime
        - `time` Time
          - `hour` integer
          - `minute` integer
          - `second` integer
      - `sun_position_based_time` SunPositionBasedTime
        - `sun_position` 'BEFORE_RISE' | 'AFTER_RISE' | 'BEFORE_SET' | 'AFTER_SET', enum
        - `offset_seconds` integer
  - `off_at` NullableLightingTime — Set "data" to a new lighting time to update, or "null" to null to remove
    - `null` string
    - `lighting_time` LightingTime
      - `fixed_time` FixedTime
        - `time` Time
          - `hour` integer
          - `minute` integer
          - `second` integer
      - `sun_position_based_time` SunPositionBasedTime
        - `sun_position` 'BEFORE_RISE' | 'AFTER_RISE' | 'BEFORE_SET' | 'AFTER_SET', enum
        - `offset_seconds` integer
  - `days_of_week` DaysOfWeek
    - `days_of_week` string[]
  - `lighting_zone_ids` LightingZoneIds
    - `ids` string[]
    - `dimming_settings` LightingZoneDimmingSetting[] — Custom program dimming levels to use. Default settings are created when a zone dimming setting is not provided.
      - `lighting_zone_id` string
      - `dimming_percent` integer
  - `lighting_zone_group_ids` LightingZoneGroupIds
    - `ids` string[]
    - `dimming_settings` LightingZoneDimmingSetting[] — Custom program dimming levels to use. Default settings are created when a zone dimming setting is not provided.
      - `lighting_zone_id` string
      - `dimming_percent` integer
  - `lighting_scene_ids` LightingSceneIds
    - `ids` string[]

## Response `200`

OK

- UpdateLightingProgramResponse
  - `lighting_program` LightingProgram
    - `id` string
    - `lighting_area_id` string
    - `name` string
    - `enabled` boolean
    - `on_at` LightingTime
      - `fixed_time` FixedTime
        - `time` Time
          - `hour` integer
          - `minute` integer
          - `second` integer
      - `sun_position_based_time` SunPositionBasedTime
        - `sun_position` 'BEFORE_RISE' | 'AFTER_RISE' | 'BEFORE_SET' | 'AFTER_SET', enum
        - `offset_seconds` integer
    - `off_at` LightingTime
      - `fixed_time` FixedTime
        - `time` Time
          - `hour` integer
          - `minute` integer
          - `second` integer
      - `sun_position_based_time` SunPositionBasedTime
        - `sun_position` 'BEFORE_RISE' | 'AFTER_RISE' | 'BEFORE_SET' | 'AFTER_SET', enum
        - `offset_seconds` integer
    - `days_of_week` string[]
    - `lighting_zone_ids` LightingZoneIds
      - `ids` string[]
      - `dimming_settings` LightingZoneDimmingSetting[] — Custom program dimming levels to use. Default settings are created when a zone dimming setting is not provided.
        - `lighting_zone_id` string
        - `dimming_percent` integer
    - `lighting_zone_group_ids` LightingZoneGroupIds
      - `ids` string[]
      - `dimming_settings` LightingZoneDimmingSetting[] — Custom program dimming levels to use. Default settings are created when a zone dimming setting is not provided.
        - `lighting_zone_id` string
        - `dimming_percent` integer
    - `lighting_scene_ids` LightingSceneIds
      - `ids` string[]

---

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