Sign in
Image Updates

Set the detection schedule

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

put/api/image-updates/interval

Request body

minutesinteger 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.

cronstring

5-field cron expression (required when mode is 'cron'). Nicknames like @daily are accepted.

Response

Schedule updated.

checkingboolean

true if a scan is currently running.

intervalMinutesinteger

Configured fallback interval in minutes (15-1440).

lastCheckedAtinteger nullable

Unix epoch-ms of the last check start, or null if never checked.

nextCheckAtinteger nullable

Unix epoch-ms of the next scheduled check, or null when not scheduled.

manualCooldownMinutesinteger

Fixed cooldown ceiling in minutes for manual refresh.

manualCooldownRemainingMsinteger

Live remaining cooldown in milliseconds (0 when refresh is allowed).

mode'interval' | 'cron'

Active scheduling mode.

cronExpressionstring nullable

5-field cron expression when mode is 'cron', null otherwise.

sidebarIndicatorsboolean

Whether sidebar update-status indicators are enabled. Controlled by the image_update_sidebar_indicators global setting. Default is false.

Changes

Changed in 2 of the 36 revisions of this API.2