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

---

[API](https://skmtc.net/optimistiksas/apis/oibus-api.md) · [All operations](https://skmtc.net/optimistiksas/apis/oibus-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/optimistiksas/oibus-api/versions/743d1b62f042/schema)