---
title: "Set the detection schedule"
method: PUT
path: "/api/image-updates/interval"
tags: ["Image Updates"]
---

# Set the detection schedule

`PUT /api/image-updates/interval`

Configure the image-update check cadence. In interval mode only `minutes` is required. In cron mode also send `mode` and `cron`.

## Request body

- object
  - `minutes` integer, required — Fallback interval in minutes (used in interval mode, or as fallback when cron is unset).
  - `mode` 'interval' | 'cron' — Scheduling mode. Omit to leave unchanged.
  - `cron` string — 5-field cron expression (required when mode is 'cron'). Nicknames like @daily are accepted.

## Response `200`

Schedule updated.

- ImageUpdateCheckStatus
  - `checking` boolean — `true` if a scan is currently running.
  - `intervalMinutes` integer — Configured fallback interval in minutes (15-1440).
  - `lastCheckedAt` integer, nullable — Unix epoch-ms of the last check start, or null if never checked.
  - `nextCheckAt` integer, nullable — Unix epoch-ms of the next scheduled check, or null when not scheduled.
  - `manualCooldownMinutes` integer — Fixed cooldown ceiling in minutes for manual refresh.
  - `manualCooldownRemainingMs` integer — Live remaining cooldown in milliseconds (0 when refresh is allowed).
  - `mode` 'interval' | 'cron' — Active scheduling mode.
  - `cronExpression` string, nullable — 5-field cron expression when mode is 'cron', null otherwise.
  - `sidebarIndicators` boolean — Whether sidebar update-status indicators are enabled. Controlled by the `image_update_sidebar_indicators` global setting. Default is `false`.

## Other responses

- `400` — Insufficient permissions or license tier.
- `401` — Authentication required. Provide a valid Bearer token.
- `403` — Non-admin users cannot change the schedule.

---

[API](https://skmtc.net/studio-saelix/apis/sencho-api.md) · [All operations](https://skmtc.net/studio-saelix/apis/sencho-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/studio-saelix/sencho-api/versions/f36f82acae1d/schema)