---
title: "Update south item group"
method: PUT
path: "/api/south/{southId}/groups/{groupId}"
tags: ["South Connectors"]
---

# Update south item group

`PUT /api/south/{southId}/groups/{groupId}`

Updates an existing group

## Path parameters

- `southId` string, required
- `groupId` string, required

## Request body

- SouthItemGroupCommandDTO — Command Data Transfer Object for creating or updating a South item group.
  - `id` string, nullable, required — The ID of the group (null when creating a new group).
  - `standardSettings` object, required
    - `scanModeId` string, required — The ID of the scan mode to use for this group.
    - `name` string, required — The name of the group.
  - `historySettings` object, required
    - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first.
    - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data.
    - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries.
    - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. If the resulting end time is not after the effective start time, the query is skipped.
    - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Negative values extend the window backwards (equivalent to the old overlap behaviour).

## Response `204`

No Content

## Changes

- **2026-07-28** `9a6250881fa7` — 3 breaking, 1 warning
  - added the new required request property `historySettings/endTimeOffset`
  - added the new required request property `historySettings/recoveryStrategy`
  - added the new required request property `historySettings/startTimeOffset`
  - removed the request property `historySettings/overlap`
- **2026-07-26** `ea1c80cb9c69` — 1 breaking, 3 warning
  - added the new required request property `historySettings/overlap`
  - removed the request property `historySettings/endTimeOffset`
  - removed the request property `historySettings/recoveryStrategy`
  - removed the request property `historySettings/startTimeOffset`
- **2026-07-20** `6a232346b158` — 3 breaking, 1 warning
  - added the new required request property `historySettings/endTimeOffset`
  - added the new required request property `historySettings/recoveryStrategy`
  - added the new required request property `historySettings/startTimeOffset`
  - removed the request property `historySettings/overlap`
- **2026-07-15** `57cbe043ec5a` — 1 breaking, 3 warning
  - added the new required request property `historySettings/overlap`
  - removed the request property `historySettings/endTimeOffset`
  - removed the request property `historySettings/recoveryStrategy`
  - removed the request property `historySettings/startTimeOffset`
- …earlier changes not shown

[Full history](https://skmtc.dev/optimistiksas/apis/oibus-api/changes/api/south/:southId/groups/:groupId/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/a7264da113f9/schema)