---
title: "PUT /timings/{timingId}"
method: PUT
path: "/timings/{timingId}"
tags: ["Timings"]
---

# PUT /timings/{timingId}

`PUT /timings/{timingId}`

Update timing properties.

## Path parameters

- `timingId` string, required

## Request body

- Timing — Represents a timing in the system.
  - `timingId` string, required — Timing unique id.
  - `timingName` string — Timing display name.
  - `triggerOperationId` string — Operation id to invoke (optional).
  - `triggerDirectAction` OperationActivity — Represents activity.
    - `minionId` string, required — Minion id to set
    - `minionStatus` MinionStatus, required — Minion status, the available values depend on the minion type.
      - `toggle` Toggle — A toggle value, the toggle is on way communicated device, For example wall light switches with 433 RF that can turn on or off but there is no way to know the real light status if someone changes the light status using physical switch.
        - `status` 'on' | 'off', required — Switches option
      - `switch` Switch — A switch status. Used for simple devices that can be turned on or off. *and minion status is readable* The properties same as a toggle, and the difference is logic only (if that status is readable or not).
        - `status` 'on' | 'off', required — Switches option
      - `roller` Roller — A roller switch status. A roller is a switch for curtains or blinds (or for any other needs) that can drag up/down or stop.
        - `status` 'on' | 'off', required — Switches option
        - `direction` 'up' | 'down', required — Roller direction
      - `cleaner` Cleaner — A Cleaner (robot) status. Cleaner is a smart robot for cleaning home.
        - `status` 'on' | 'off', required — Switches option
        - `mode` 'dock' | 'clean', required — Cleaner mode
        - `fanSpeed` 'low' | 'med' | 'high' | 'auto', required — Valid fan strength.
      - `airConditioning` AirConditioning — An AC status.
        - `status` 'on' | 'off', required — Switches option
        - `temperature` integer, required — Valid AC temperature. (minimum 16° maximum 30°).
        - `mode` 'hot' | 'cold' | 'dry' | 'auto', required — Valid AC mode.
        - `fanStrength` 'low' | 'med' | 'high' | 'auto', required — Valid fan strength.
      - `light` Light — A simple light status. Used to devices that can chang it's brightness.
        - `status` 'on' | 'off', required — Switches option
        - `brightness` integer, required — Minimum 1% maximum 100% of light brightness.
      - `temperatureLight` TemperatureLight — A light simple light status. Used to devices that can chang also light temperature (warm or cold light).
        - `status` 'on' | 'off', required — Switches option
        - `brightness` integer, required — Minimum 1% maximum 100% of light brightness.
        - `temperature` integer, required — Spectrum is 1% to warm light and 100% to cold light.
      - `colorLight` ColorLight — A light simple light status. Used to devices that can change also light color (RGB).
        - `status` 'on' | 'off', required — Switches option
        - `brightness` integer, required — Minimum 1% maximum 100% of light brightness.
        - `temperature` integer, required — Spectrum is 1% to warm light and 100% to cold light.
        - `red` integer, required — Minimum 0 maximum 255 from red color. Valid color value. (8 bits number, minimum 0 maximum 255).
        - `green` integer, required — Minimum 0 maximum 255 from green color. Valid color value. (8 bits number, minimum 0 maximum 255).
        - `blue` integer, required — Minimum 0 maximum 255 from blue color. Valid color value. (8 bits number, minimum 0 maximum 255).
      - `temperatureSensor` TemperatureSensor
        - `status` 'on' | 'off', required — Switches option
        - `temperature` number, double, required — Temperature in celsius (X°)
  - `isActive` boolean, required — Is timing active or not.
  - `timingType` 'dailySunTrigger' | 'dailyTimeTrigger' | 'once' | 'timeout', required — Supported timings types.
  - `timingProperties` TimingProperties, required — Timing properties, values depend on timing type.
    - `dailySunTrigger` DailySunTrigger — Daily timing based on sun triggers.
      - `days` DaysOptions[], required — Selected days in a week.
      - `durationMinutes` number, double, required — Minutes from the sun trigger. can be before or after the sun triggers. For example, to invoke 40 minutes before sunset set -40 and to invoke 40 minutes after sunset set 40. NOTE! if the duration is more then minutes available in the day from the sun trigger time, the timing will not activate. for example if the sunset is in 18:00 and the duration set to 7*60 minutes, the activate time is not on the same day, so it will not activate at all.
      - `sunTrigger` 'sunrise' | 'sunset', required — Sun triggers.
    - `dailyTimeTrigger` DailyTimeTrigger — Daily timing based on time in a day.
      - `days` DaysOptions[], required — Selected days in a week.
      - `hour` integer, required — The hour in a day.
      - `minutes` integer, required — Minutes in an hour.
    - `once` OnceTiming — Once timing structure.
      - `date` number, double, required — UTC time.
    - `timeout` TimeoutTiming — Timeout timing structure.
      - `startDate` number, double, required — UTC time.
      - `durationInMinutes` number, double, required — Duration to activate timing from the start timeout time in minutes.
  - `setLock` 'LOCK_ON' | 'LOCK_OFF' | 'SHABBAT' | 'AUTO' | 'LOCK_DASHBOARD'
  - `overrideLock` boolean — Override lock, if exists (default false)

## Response `204`

No content

## Other responses

- `501` — Server error

---

[API](https://skmtc.net/casanet/apis/casanet-local-server.md) · [All operations](https://skmtc.net/casanet/apis/casanet-local-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/casanet/casanet-local-server/versions/0f9f76cd80d5/schema)