---
title: "Update scan mode"
method: PUT
path: "/api/scan-modes/{scanModeId}"
tags: ["Scan Modes"]
---

# Update scan mode

`PUT /api/scan-modes/{scanModeId}`

Updates an existing scan mode with new configuration

## Path parameters

- `scanModeId` string, required

## Request body

- ScanModeCommandDTO — Command DTO for creating or updating a scan mode. Used as the request body for scan mode creation/update endpoints.
  - `name` string, required — The name of the scan mode.
  - `description` string, required — A description of the scan mode's purpose or behavior.
  - `cron` string, required — A cron expression defining the scan schedule.

## Response `204`

Scan mode updated successfully

## Changes

- **2026-08-18** `87fa588c6b1b` — 3 warning
  - removed the request property `activationWindow`
  - removed the request property `interval`
  - removed the request property `type`
- **2026-08-03** `8ee92ea35845` — 3 breaking
  - added the new required request property `activationWindow`
  - added the new required request property `interval`
  - added the new required request property `type`
- **2026-07-28** `9a6250881fa7` — 3 warning
  - removed the request property `activationWindow`
  - removed the request property `interval`
  - removed the request property `type`
- **2026-07-28** `6c9a9144ca23` — 3 breaking
  - added the new required request property `activationWindow`
  - added the new required request property `interval`
  - added the new required request property `type`
- **2026-07-15** `57cbe043ec5a` — 3 warning
  - removed the request property `activationWindow`
  - removed the request property `interval`
  - removed the request property `type`

[Full history](https://skmtc.dev/optimistiksas/apis/oibus-api/changes/api/scan-modes/:scanModeId/put.md)

---

[API](https://skmtc.dev/optimistiksas/apis/oibus-api.md) · [All operations](https://skmtc.dev/optimistiksas/apis/oibus-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/optimistiksas/oibus-api/revisions/fe8fd32c9fdc/schema)