---
title: "Create south connector"
method: POST
path: "/api/south"
tags: ["South Connectors"]
---

# Create south connector

`POST /api/south`

Creates a new south connector with the provided configuration

## Query parameters

- `duplicate` string, required

## Request body

- union — Command Data Transfer Object for creating or updating a South connector. Used as the request body for South connector creation/update endpoints.
  - SouthConnectorADSCommandDTO — South connector command for Beckhoff ADS.
    - `name` string, required — The name of the South connector.
    - `type` 'ads', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector should be enabled.
    - `settings` SouthADSSettings, required
      - `netId` string, required
      - `port` number, double, required
      - `routerAddress` string, nullable, required
      - `routerTcpPort` number, double, nullable, required
      - `clientAmsNetId` string, nullable, required
      - `clientAdsPort` number, double, nullable, required
      - `retryInterval` number, double, required
      - `plcName` string, nullable, required
      - `enumAsText` 'text' | 'integer', required
      - `boolAsText` 'text' | 'integer', required
      - `structureFiltering` SouthADSSettingsStructureFiltering[], nullable, required
        - `name` string, required
        - `fields` string, required
    - `items` SouthConnectorADSItemCommandDTO[], required — List of items (data points) to configure for this connector.
      - `id` string, nullable, required — The ID of the item (null when creating a new item).
      - `enabled` boolean, required — Whether this item should be enabled.
      - `name` string, required — The name of the item.
      - `settings` SouthADSItemSettings, required
        - `address` string, required
      - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
      - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
      - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
      - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupCommandDTO[], required — List of groups used to gather items
      - `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
        - `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.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries.
  - SouthConnectorFolderScannerCommandDTO — South connector command for the Folder Scanner.
    - `name` string, required — The name of the South connector.
    - `type` 'folder-scanner', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector should be enabled.
    - `settings` SouthFolderScannerSettings, required
      - `inputFolder` string, required
      - `compression` boolean, required
    - `items` SouthConnectorFolderScannerItemCommandDTO[], required — List of items (data points) to configure for this connector.
      - `id` string, nullable, required — The ID of the item (null when creating a new item).
      - `enabled` boolean, required — Whether this item should be enabled.
      - `name` string, required — The name of the item.
      - `settings` SouthFolderScannerItemSettings, required
        - `regex` string, required
        - `minAge` number, double, required
        - `preserveFiles` boolean, required
        - `ignoreModifiedDate` boolean
        - `maxFiles` number, double, required
        - `maxSize` number, double, required
        - `recursive` boolean, required
      - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
      - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
      - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
      - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupCommandDTO[], required — List of groups used to gather items
      - `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
        - `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.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries.
  - SouthConnectorFTPCommandDTO — South connector command for FTP file transfer.
    - `name` string, required — The name of the South connector.
    - `type` 'ftp', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector should be enabled.
    - `settings` SouthFTPSettings, required
      - `host` string, required
      - `port` number, double, required
      - `authentication` 'none' | 'password', required
      - `username` string, nullable
      - `password` string, nullable
      - `compression` boolean, required
    - `items` SouthConnectorFTPItemCommandDTO[], required — List of items (data points) to configure for this connector.
      - `id` string, nullable, required — The ID of the item (null when creating a new item).
      - `enabled` boolean, required — Whether this item should be enabled.
      - `name` string, required — The name of the item.
      - `settings` SouthFTPItemSettings, required
        - `remoteFolder` string, required
        - `regex` string, required
        - `minAge` number, double, required
        - `preserveFiles` boolean, required
        - `ignoreModifiedDate` boolean
        - `maxFiles` number, double, required
        - `maxSize` number, double, required
        - `recursive` boolean, required
      - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
      - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
      - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
      - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupCommandDTO[], required — List of groups used to gather items
      - `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
        - `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.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries.
  - SouthConnectorModbusCommandDTO — South connector command for Modbus.
    - `name` string, required — The name of the South connector.
    - `type` 'modbus', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector should be enabled.
    - `settings` SouthModbusSettings, required
      - `host` string, required
      - `port` number, double, required
      - `connectTimeout` number, double, required
      - `retryInterval` number, double, required
      - `slaveId` number, double, required
      - `addressOffset` 'modbus' | 'jbus', required
      - `endianness` 'big-endian' | 'little-endian', required
      - `swapBytesInWords` boolean, required
      - `swapWordsInDWords` boolean, required
      - `groupingGap` number, double, required
    - `items` SouthConnectorModbusItemCommandDTO[], required — List of items (data points) to configure for this connector.
      - `id` string, nullable, required — The ID of the item (null when creating a new item).
      - `enabled` boolean, required — Whether this item should be enabled.
      - `name` string, required — The name of the item.
      - `settings` SouthModbusItemSettings, required
        - `address` string, required
        - `modbusType` 'coil' | 'discrete-input' | 'input-register' | 'holding-register', required
        - `data` SouthModbusItemSettingsData
          - `dataType` 'uint16' | 'int16' | 'uint32' | 'int32' | 'big-uint64' | 'big-int64' | 'float' | 'double' | 'bit', required
          - `bitIndex` number, double
          - `multiplierCoefficient` number, double, required
      - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
      - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
      - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
      - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupCommandDTO[], required — List of groups used to gather items
      - `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
        - `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.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries.
  - SouthConnectorMQTTCommandDTO — South connector command for MQTT.
    - `name` string, required — The name of the South connector.
    - `type` 'mqtt', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector should be enabled.
    - `settings` SouthMQTTSettings, required
      - `url` string, required
      - `qos` '0' | '1' | '2', required
      - `persistent` boolean
      - `authentication` SouthMQTTSettingsAuthentication, required
        - `type` 'none' | 'basic' | 'cert', required
        - `username` string
        - `password` string, nullable
        - `certFilePath` string
        - `keyFilePath` string
        - `caFilePath` string
      - `rejectUnauthorized` boolean, required
      - `reconnectPeriod` number, double, required
      - `connectTimeout` number, double, required
      - `maxNumberOfMessages` number, double, required
      - `flushMessageTimeout` number, double, required
    - `items` SouthConnectorMQTTItemCommandDTO[], required — List of items (data points) to configure for this connector.
      - `id` string, nullable, required — The ID of the item (null when creating a new item).
      - `enabled` boolean, required — Whether this item should be enabled.
      - `name` string, required — The name of the item.
      - `settings` SouthMQTTItemSettings, required
        - `topic` string, required
      - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
      - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
      - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
      - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupCommandDTO[], required — List of groups used to gather items
      - `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
        - `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.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries.
  - SouthConnectorMSSQLCommandDTO — South connector command for Microsoft SQL Server.
    - `name` string, required — The name of the South connector.
    - `type` 'mssql', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector should be enabled.
    - `settings` SouthMSSQLSettings, required
      - `host` string, required
      - `port` number, double, required
      - `connectionTimeout` number, double, required
      - `database` string, required
      - `encryption` boolean, required
      - `trustServerCertificate` boolean, required
      - `username` string, nullable, required
      - `password` string, nullable, required
      - `domain` string, nullable, required
      - `requestTimeout` number, double, required
    - `items` SouthConnectorMSSQLItemCommandDTO[], required — List of items (data points) to configure for this connector.
      - `id` string, nullable, required — The ID of the item (null when creating a new item).
      - `enabled` boolean, required — Whether this item should be enabled.
      - `name` string, required — The name of the item.
      - `settings` SouthMSSQLItemSettings, required
        - `query` string, required
        - `dateTimeFields` SouthMSSQLItemSettingsDateTimeFields[], nullable, required
          - `fieldName` string, required
          - `useAsReference` boolean, required
          - `type` 'string' | 'date' | 'date-time' | 'date-time-2' | 'date-time-offset' | 'small-date-time' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string
          - `locale` string
        - `serialization` SouthMSSQLItemSettingsSerialization, required
          - `type` 'csv', required
          - `filename` string, required
          - `delimiter` 'DOT' | 'SEMI_COLON' | 'COLON' | 'COMMA' | 'NON_BREAKING_SPACE' | 'SLASH' | 'TAB' | 'PIPE', required
          - `compression` boolean, required
          - `outputTimestampFormat` string, required
          - `outputTimezone` string, required — Represents a timezone as an IANA timezone string.
      - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
      - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
      - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
      - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupCommandDTO[], required — List of groups used to gather items
      - `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
        - `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.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries.
  - SouthConnectorMySQLCommandDTO — South connector command for MySQL.
    - `name` string, required — The name of the South connector.
    - `type` 'mysql', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector should be enabled.
    - `settings` SouthMySQLSettings, required
      - `host` string, required
      - `port` number, double, required
      - `connectionTimeout` number, double, required
      - `database` string, required
      - `username` string, nullable, required
      - `password` string, nullable, required
    - `items` SouthConnectorMySQLItemCommandDTO[], required — List of items (data points) to configure for this connector.
      - `id` string, nullable, required — The ID of the item (null when creating a new item).
      - `enabled` boolean, required — Whether this item should be enabled.
      - `name` string, required — The name of the item.
      - `settings` SouthMySQLItemSettings, required
        - `query` string, required
        - `requestTimeout` number, double, required
        - `dateTimeFields` SouthMySQLItemSettingsDateTimeFields[], nullable, required
          - `fieldName` string, required
          - `useAsReference` boolean, required
          - `type` 'string' | 'date-time' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string
          - `locale` string
        - `serialization` SouthMySQLItemSettingsSerialization, required
          - `type` 'csv', required
          - `filename` string, required
          - `delimiter` 'DOT' | 'SEMI_COLON' | 'COLON' | 'COMMA' | 'NON_BREAKING_SPACE' | 'SLASH' | 'TAB' | 'PIPE', required
          - `compression` boolean, required
          - `outputTimestampFormat` string, required
          - `outputTimezone` string, required — Represents a timezone as an IANA timezone string.
      - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
      - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
      - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
      - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupCommandDTO[], required — List of groups used to gather items
      - `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
        - `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.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries.
  - SouthConnectorODBCCommandDTO — South connector command for ODBC.
    - `name` string, required — The name of the South connector.
    - `type` 'odbc', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector should be enabled.
    - `settings` SouthODBCSettings, required
      - `remoteAgent` boolean, required
      - `agentUrl` string
      - `connectionTimeout` number, double, required
      - `retryInterval` number, double, required
      - `requestTimeout` number, double
      - `connectionString` string, required
      - `password` string, nullable, required
    - `items` SouthConnectorODBCItemCommandDTO[], required — List of items (data points) to configure for this connector.
      - `id` string, nullable, required — The ID of the item (null when creating a new item).
      - `enabled` boolean, required — Whether this item should be enabled.
      - `name` string, required — The name of the item.
      - `settings` SouthODBCItemSettings, required
        - `query` string, required
        - `dateTimeFields` SouthODBCItemSettingsDateTimeFields[], nullable, required
          - `fieldName` string, required
          - `useAsReference` boolean, required
          - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string
          - `locale` string
        - `serialization` SouthODBCItemSettingsSerialization, required
          - `type` 'csv', required
          - `filename` string, required
          - `delimiter` 'DOT' | 'SEMI_COLON' | 'COLON' | 'COMMA' | 'NON_BREAKING_SPACE' | 'SLASH' | 'TAB' | 'PIPE', required
          - `compression` boolean, required
          - `outputTimestampFormat` string, required
          - `outputTimezone` string, required — Represents a timezone as an IANA timezone string.
      - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
      - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
      - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
      - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupCommandDTO[], required — List of groups used to gather items
      - `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
        - `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.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries.
  - SouthConnectorOIAnalyticsCommandDTO — South connector command for OIAnalytics.
    - `name` string, required — The name of the South connector.
    - `type` 'oianalytics', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector should be enabled.
    - `settings` SouthOIAnalyticsSettings, required
      - `useOiaModule` boolean, required
      - `timeout` number, double, required
      - `specificSettings` SouthOIAnalyticsSettingsSpecificSettings
        - `host` string, required
        - `acceptUnauthorized` boolean, required
        - `authentication` 'basic' | 'aad-client-secret' | 'aad-certificate', required
        - `accessKey` string
        - `secretKey` string, nullable
        - `tenantId` string
        - `clientId` string
        - `clientSecret` string, nullable
        - `certificateId` string
        - `scope` string
        - `useProxy` boolean, required
        - `proxyUrl` string
        - `proxyUsername` string
        - `proxyPassword` string, nullable
    - `items` SouthConnectorOIAnalyticsItemCommandDTO[], required — List of items (data points) to configure for this connector.
      - `id` string, nullable, required — The ID of the item (null when creating a new item).
      - `enabled` boolean, required — Whether this item should be enabled.
      - `name` string, required — The name of the item.
      - `settings` SouthOIAnalyticsItemSettings, required
        - `endpoint` string, required
        - `queryParams` SouthOIAnalyticsItemSettingsQueryParams[], required
          - `key` string, required
          - `value` string, required
        - `serialization` SouthOIAnalyticsItemSettingsSerialization, required
          - `type` 'csv', required
          - `filename` string, required
          - `delimiter` 'DOT' | 'SEMI_COLON' | 'COLON' | 'COMMA' | 'NON_BREAKING_SPACE' | 'SLASH' | 'TAB' | 'PIPE', required
          - `compression` boolean, required
          - `outputTimestampFormat` string, required
          - `outputTimezone` string, required — Represents a timezone as an IANA timezone string.
      - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
      - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
      - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
      - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupCommandDTO[], required — List of groups used to gather items
      - `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
        - `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.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries.
  - SouthConnectorOLEDBCommandDTO — South connector command for OLE DB.
    - `name` string, required — The name of the South connector.
    - `type` 'oledb', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector should be enabled.
    - `settings` SouthOLEDBSettings, required
      - `agentUrl` string, required
      - `connectionTimeout` number, double, required
      - `retryInterval` number, double, required
      - `requestTimeout` number, double, required
      - `connectionString` string, required
      - `password` string, nullable, required
    - `items` SouthConnectorOLEDBItemCommandDTO[], required — List of items (data points) to configure for this connector.
      - `id` string, nullable, required — The ID of the item (null when creating a new item).
      - `enabled` boolean, required — Whether this item should be enabled.
      - `name` string, required — The name of the item.
      - `settings` SouthOLEDBItemSettings, required
        - `query` string, required
        - `dateTimeFields` SouthOLEDBItemSettingsDateTimeFields[], nullable, required
          - `fieldName` string, required
          - `useAsReference` boolean, required
          - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string
          - `locale` string
        - `serialization` SouthOLEDBItemSettingsSerialization, required
          - `type` 'csv', required
          - `filename` string, required
          - `delimiter` 'DOT' | 'SEMI_COLON' | 'COLON' | 'COMMA' | 'NON_BREAKING_SPACE' | 'SLASH' | 'TAB' | 'PIPE', required
          - `compression` boolean, required
          - `outputTimestampFormat` string, required
          - `outputTimezone` string, required — Represents a timezone as an IANA timezone string.
      - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
      - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
      - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
      - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupCommandDTO[], required — List of groups used to gather items
      - `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
        - `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.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries.
  - SouthConnectorOPCCommandDTO — South connector command for classic OPC (OLE for Process Control).
    - `name` string, required — The name of the South connector.
    - `type` 'opc', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector should be enabled.
    - `settings` SouthOPCSettings, required
      - `agentUrl` string, required
      - `retryInterval` number, double, required
      - `host` string, required
      - `serverName` string, required
      - `mode` 'hda' | 'da', required
    - `items` SouthConnectorOPCItemCommandDTO[], required — List of items (data points) to configure for this connector.
      - `id` string, nullable, required — The ID of the item (null when creating a new item).
      - `enabled` boolean, required — Whether this item should be enabled.
      - `name` string, required — The name of the item.
      - `settings` SouthOPCItemSettings, required
        - `nodeId` string, required
        - `aggregate` 'raw' | 'interpolative' | 'total' | 'average' | 'time-average' | 'count' | 'stdev' | 'minimum-actual-time' | 'minimum' | 'maximum-actual-time' | 'maximum' | 'start' | 'end' | 'delta' | 'reg-slope' | 'reg-const' | 'reg-dev' | 'variance' | 'range' | 'duration-good' | 'duration-bad' | 'percent-good' | 'percent-bad' | 'worst-quality' | 'annotations', required
        - `resampling` 'none' | '1s' | '10s' | '30s' | '1min' | '1h' | '1d'
      - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
      - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
      - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
      - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupCommandDTO[], required — List of groups used to gather items
      - `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
        - `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.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries.
  - SouthConnectorOPCUACommandDTO — South connector command for OPC UA.
    - `name` string, required — The name of the South connector.
    - `type` 'opcua', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector should be enabled.
    - `settings` SouthOPCUASettings, required
      - `url` string, required
      - `keepSessionAlive` boolean, required
      - `readTimeout` number, double, required
      - `retryInterval` number, double, required
      - `maxNumberOfMessages` number, double, required
      - `flushMessageTimeout` number, double, required
      - `securityMode` 'none' | 'sign' | 'sign-and-encrypt', required
      - `securityPolicy` 'none' | 'basic128' | 'basic192' | 'basic256' | 'basic128-rsa15' | 'basic192-rsa15' | 'basic256-rsa15' | 'basic256-sha256' | 'aes128-sha256-rsa-oaep' | 'pub-sub-aes-128-ctr' | 'pub-sub-aes-256-ctr'
      - `authentication` SouthOPCUASettingsAuthentication, required
        - `type` 'none' | 'basic' | 'cert', required
        - `username` string
        - `password` string, nullable
        - `certFilePath` string
        - `keyFilePath` string
    - `items` SouthConnectorOPCUAItemCommandDTO[], required — List of items (data points) to configure for this connector.
      - `id` string, nullable, required — The ID of the item (null when creating a new item).
      - `enabled` boolean, required — Whether this item should be enabled.
      - `name` string, required — The name of the item.
      - `settings` SouthOPCUAItemSettings, required
        - `nodeId` string, required
        - `mode` 'da' | 'ha', required
        - `haMode` SouthOPCUAItemSettingsHaMode
          - `aggregate` 'raw' | 'average' | 'count' | 'minimum' | 'maximum', required
          - `resampling` 'none' | '1s' | '10s' | '30s' | '1min' | '1h' | '1d'
        - `timestampOrigin` 'oibus' | 'point' | 'server'
      - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
      - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
      - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
      - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupCommandDTO[], required — List of groups used to gather items
      - `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
        - `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.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries.
  - SouthConnectorOracleCommandDTO — South connector command for Oracle Database.
    - `name` string, required — The name of the South connector.
    - `type` 'oracle', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector should be enabled.
    - `settings` SouthOracleSettings, required
      - `thickMode` boolean, required
      - `oracleClient` string
      - `host` string, required
      - `port` number, double, required
      - `connectionTimeout` number, double, required
      - `database` string, required
      - `username` string, nullable, required
      - `password` string, nullable, required
    - `items` SouthConnectorOracleItemCommandDTO[], required — List of items (data points) to configure for this connector.
      - `id` string, nullable, required — The ID of the item (null when creating a new item).
      - `enabled` boolean, required — Whether this item should be enabled.
      - `name` string, required — The name of the item.
      - `settings` SouthOracleItemSettings, required
        - `query` string, required
        - `requestTimeout` number, double, required
        - `dateTimeFields` SouthOracleItemSettingsDateTimeFields[], nullable, required
          - `fieldName` string, required
          - `useAsReference` boolean, required
          - `type` 'string' | 'date-time' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string
          - `locale` string
        - `serialization` SouthOracleItemSettingsSerialization, required
          - `type` 'csv', required
          - `filename` string, required
          - `delimiter` 'DOT' | 'SEMI_COLON' | 'COLON' | 'COMMA' | 'NON_BREAKING_SPACE' | 'SLASH' | 'TAB' | 'PIPE', required
          - `compression` boolean, required
          - `outputTimestampFormat` string, required
          - `outputTimezone` string, required — Represents a timezone as an IANA timezone string.
      - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
      - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
      - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
      - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupCommandDTO[], required — List of groups used to gather items
      - `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
        - `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.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries.
  - SouthConnectorOsisoftPICommandDTO — South connector command for OSIsoft PI System.
    - `name` string, required — The name of the South connector.
    - `type` 'osisoft-pi', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector should be enabled.
    - `settings` SouthPISettings, required
      - `agentUrl` string, required
      - `retryInterval` number, double, required
    - `items` SouthConnectorOsisoftPIItemCommandDTO[], required — List of items (data points) to configure for this connector.
      - `id` string, nullable, required — The ID of the item (null when creating a new item).
      - `enabled` boolean, required — Whether this item should be enabled.
      - `name` string, required — The name of the item.
      - `settings` SouthPIItemSettings, required
        - `type` 'point-id' | 'point-query', required
        - `piPoint` string
        - `piQuery` string
      - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
      - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
      - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
      - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupCommandDTO[], required — List of groups used to gather items
      - `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
        - `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.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries.
  - SouthConnectorPostgreSQLCommandDTO — South connector command for PostgreSQL.
    - `name` string, required — The name of the South connector.
    - `type` 'postgresql', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector should be enabled.
    - `settings` SouthPostgreSQLSettings, required
      - `host` string, required
      - `port` number, double, required
      - `sslMode` boolean, required
      - `database` string, required
      - `connectionTimeout` number, double, required
      - `requestTimeout` number, double, required
      - `username` string, nullable, required
      - `password` string, nullable, required
    - `items` SouthConnectorPostgreSQLItemCommandDTO[], required — List of items (data points) to configure for this connector.
      - `id` string, nullable, required — The ID of the item (null when creating a new item).
      - `enabled` boolean, required — Whether this item should be enabled.
      - `name` string, required — The name of the item.
      - `settings` SouthPostgreSQLItemSettings, required
        - `query` string, required
        - `dateTimeFields` SouthPostgreSQLItemSettingsDateTimeFields[], nullable, required
          - `fieldName` string, required
          - `useAsReference` boolean, required
          - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms' | 'timestamp' | 'timestamptz', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string
          - `locale` string
        - `serialization` SouthPostgreSQLItemSettingsSerialization, required
          - `type` 'csv', required
          - `filename` string, required
          - `delimiter` 'DOT' | 'SEMI_COLON' | 'COLON' | 'COMMA' | 'NON_BREAKING_SPACE' | 'SLASH' | 'TAB' | 'PIPE', required
          - `compression` boolean, required
          - `outputTimestampFormat` string, required
          - `outputTimezone` string, required — Represents a timezone as an IANA timezone string.
      - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
      - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
      - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
      - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupCommandDTO[], required — List of groups used to gather items
      - `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
        - `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.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries.
  - SouthConnectorRESTCommandDTO — South connector command for the REST API.
    - `name` string, required — The name of the South connector.
    - `type` 'rest', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector should be enabled.
    - `settings` SouthRestSettings, required
      - `host` string, required
      - `acceptUnauthorized` boolean, required
      - `timeout` number, double, required
      - `authentication` SouthRestSettingsAuthentication, required
        - `type` 'none' | 'basic' | 'bearer' | 'api-key', required
        - `username` string
        - `password` string, nullable
        - `token` string, nullable
        - `apiKey` string
        - `apiValue` string, nullable
        - `addTo` 'header' | 'query-params'
      - `proxy` SouthRestSettingsProxy, required
        - `useProxy` boolean, required
        - `proxyUrl` string
        - `proxyUsername` string, nullable
        - `proxyPassword` string, nullable
      - `test` SouthRestSettingsTest, required
        - `method` 'GET' | 'POST' | 'PUT', required
        - `endpoint` string, required
        - `body` string, nullable
        - `successCode` number, double, required
    - `items` SouthConnectorRESTItemCommandDTO[], required — List of items (data points) to configure for this connector.
      - `id` string, nullable, required — The ID of the item (null when creating a new item).
      - `enabled` boolean, required — Whether this item should be enabled.
      - `name` string, required — The name of the item.
      - `settings` SouthRestItemSettings, required
        - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', required
        - `endpoint` string, required
        - `returnType` 'file' | 'body', required
        - `queryParams` SouthRestItemSettingsQueryParams[], required
          - `key` string, required
          - `value` string, required
          - `dateTimeInput` SouthRestItemSettingsQueryParamsDateTimeInput
            - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
            - `timezone` string — Represents a timezone as an IANA timezone string.
            - `format` string, nullable
        - `headers` SouthRestItemSettingsHeaders[], required
          - `key` string, required
          - `value` string, required
          - `dateTimeInput` SouthRestItemSettingsHeadersDateTimeInput
            - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
            - `timezone` string — Represents a timezone as an IANA timezone string.
            - `format` string, nullable
        - `body` SouthRestItemSettingsBody
          - `content` string, nullable, required
          - `dateTimeInput` SouthRestItemSettingsBodyDateTimeInput
            - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
            - `timezone` string — Represents a timezone as an IANA timezone string.
            - `format` string, nullable
        - `trackingInstant` SouthRestItemSettingsTrackingInstant
          - `trackInstant` boolean, required
          - `jsonPath` string
          - `dateTimeInput` SouthRestItemSettingsTrackingInstantDateTimeInput
            - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
            - `timezone` string — Represents a timezone as an IANA timezone string.
            - `format` string
            - `locale` string
      - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
      - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
      - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
      - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupCommandDTO[], required — List of groups used to gather items
      - `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
        - `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.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries.
  - SouthConnectorSFTPCommandDTO — South connector command for SFTP file transfer.
    - `name` string, required — The name of the South connector.
    - `type` 'sftp', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector should be enabled.
    - `settings` SouthSFTPSettings, required
      - `host` string, required
      - `port` number, double, required
      - `authentication` 'password' | 'private-key', required
      - `username` string, required
      - `password` string, nullable
      - `privateKey` string
      - `passphrase` string, nullable
      - `compression` boolean, required
    - `items` SouthConnectorSFTPItemCommandDTO[], required — List of items (data points) to configure for this connector.
      - `id` string, nullable, required — The ID of the item (null when creating a new item).
      - `enabled` boolean, required — Whether this item should be enabled.
      - `name` string, required — The name of the item.
      - `settings` SouthSFTPItemSettings, required
        - `remoteFolder` string, required
        - `regex` string, required
        - `minAge` number, double, required
        - `preserveFiles` boolean, required
        - `ignoreModifiedDate` boolean
        - `maxFiles` number, double, required
        - `maxSize` number, double, required
        - `recursive` boolean, required
      - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
      - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
      - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
      - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupCommandDTO[], required — List of groups used to gather items
      - `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
        - `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.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries.
  - SouthConnectorSQLiteCommandDTO — South connector command for SQLite.
    - `name` string, required — The name of the South connector.
    - `type` 'sqlite', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector should be enabled.
    - `settings` SouthSQLiteSettings, required
      - `databasePath` string, required
    - `items` SouthConnectorSQLiteItemCommandDTO[], required — List of items (data points) to configure for this connector.
      - `id` string, nullable, required — The ID of the item (null when creating a new item).
      - `enabled` boolean, required — Whether this item should be enabled.
      - `name` string, required — The name of the item.
      - `settings` SouthSQLiteItemSettings, required
        - `query` string, required
        - `dateTimeFields` SouthSQLiteItemSettingsDateTimeFields[], nullable, required
          - `fieldName` string, required
          - `useAsReference` boolean, required
          - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string
          - `locale` string
        - `serialization` SouthSQLiteItemSettingsSerialization, required
          - `type` 'csv', required
          - `filename` string, required
          - `delimiter` 'DOT' | 'SEMI_COLON' | 'COLON' | 'COMMA' | 'NON_BREAKING_SPACE' | 'SLASH' | 'TAB' | 'PIPE', required
          - `compression` boolean, required
          - `outputTimestampFormat` string, required
          - `outputTimezone` string, required — Represents a timezone as an IANA timezone string.
      - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
      - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
      - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
      - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupCommandDTO[], required — List of groups used to gather items
      - `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
        - `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.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries.

## Response `201`

Created

- union — Data Transfer Object for a South connector. Contains all configuration details and current state of a South connector.
  - SouthConnectorADSDTO — South connector configuration for Beckhoff ADS.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required — The name of the South connector.
    - `type` 'ads', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector is enabled and active.
    - `settings` SouthADSSettings, required
      - `netId` string, required
      - `port` number, double, required
      - `routerAddress` string, nullable, required
      - `routerTcpPort` number, double, nullable, required
      - `clientAmsNetId` string, nullable, required
      - `clientAdsPort` number, double, nullable, required
      - `retryInterval` number, double, required
      - `plcName` string, nullable, required
      - `enumAsText` 'text' | 'integer', required
      - `boolAsText` 'text' | 'integer', required
      - `structureFiltering` SouthADSSettingsStructureFiltering[], nullable, required
        - `name` string, required
        - `fields` string, required
    - `items` SouthConnectorADSItemDTO[], required — List of items (data points) configured for this connector.
      - `id` string, required — The unique identifier of the entity.
      - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `name` string, required — The name of the item.
      - `enabled` boolean, required — Whether this item is enabled and should be collected.
      - `settings` SouthADSItemSettings, required
        - `address` string, required
      - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `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.
      - `group` SouthItemGroupDTO, required — Data Transfer Object for a South item group. Represents a group of items that can share common settings.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `standardSettings` object, required
          - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
            - `id` string, required — The unique identifier of the entity.
            - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `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.
          - `name` string, required — The name of the group.
        - `historySettings` object, required
          - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities.
          - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities.
          - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields (maxReadInterval, readDelay, overlap) are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupDTO[], required — List of groups attached to this connector
      - `id` string, required — The unique identifier of the entity.
      - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `standardSettings` object, required
        - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
          - `id` string, required — The unique identifier of the entity.
          - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
            - `id` string, required — The unique identifier of the user.
            - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
          - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
            - `id` string, required — The unique identifier of the user.
            - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
          - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
          - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
          - `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.
        - `name` string, required — The name of the group.
      - `historySettings` object, required
        - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities.
        - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities.
  - SouthConnectorFolderScannerDTO — South connector configuration for the Folder Scanner.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required — The name of the South connector.
    - `type` 'folder-scanner', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector is enabled and active.
    - `settings` SouthFolderScannerSettings, required
      - `inputFolder` string, required
      - `compression` boolean, required
    - `items` SouthConnectorFolderScannerItemDTO[], required — List of items (data points) configured for this connector.
      - `id` string, required — The unique identifier of the entity.
      - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `name` string, required — The name of the item.
      - `enabled` boolean, required — Whether this item is enabled and should be collected.
      - `settings` SouthFolderScannerItemSettings, required
        - `regex` string, required
        - `minAge` number, double, required
        - `preserveFiles` boolean, required
        - `ignoreModifiedDate` boolean
        - `maxFiles` number, double, required
        - `maxSize` number, double, required
        - `recursive` boolean, required
      - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `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.
      - `group` SouthItemGroupDTO, required — Data Transfer Object for a South item group. Represents a group of items that can share common settings.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `standardSettings` object, required
          - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
            - `id` string, required — The unique identifier of the entity.
            - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `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.
          - `name` string, required — The name of the group.
        - `historySettings` object, required
          - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities.
          - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities.
          - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields (maxReadInterval, readDelay, overlap) are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupDTO[], required — List of groups attached to this connector
      - `id` string, required — The unique identifier of the entity.
      - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `standardSettings` object, required
        - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
          - `id` string, required — The unique identifier of the entity.
          - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
            - `id` string, required — The unique identifier of the user.
            - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
          - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
            - `id` string, required — The unique identifier of the user.
            - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
          - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
          - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
          - `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.
        - `name` string, required — The name of the group.
      - `historySettings` object, required
        - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities.
        - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities.
  - SouthConnectorFTPDTO — South connector configuration for FTP file transfer.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required — The name of the South connector.
    - `type` 'ftp', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector is enabled and active.
    - `settings` SouthFTPSettings, required
      - `host` string, required
      - `port` number, double, required
      - `authentication` 'none' | 'password', required
      - `username` string, nullable
      - `password` string, nullable
      - `compression` boolean, required
    - `items` SouthConnectorFTPItemDTO[], required — List of items (data points) configured for this connector.
      - `id` string, required — The unique identifier of the entity.
      - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `name` string, required — The name of the item.
      - `enabled` boolean, required — Whether this item is enabled and should be collected.
      - `settings` SouthFTPItemSettings, required
        - `remoteFolder` string, required
        - `regex` string, required
        - `minAge` number, double, required
        - `preserveFiles` boolean, required
        - `ignoreModifiedDate` boolean
        - `maxFiles` number, double, required
        - `maxSize` number, double, required
        - `recursive` boolean, required
      - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `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.
      - `group` SouthItemGroupDTO, required — Data Transfer Object for a South item group. Represents a group of items that can share common settings.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `standardSettings` object, required
          - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
            - `id` string, required — The unique identifier of the entity.
            - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `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.
          - `name` string, required — The name of the group.
        - `historySettings` object, required
          - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities.
          - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities.
          - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields (maxReadInterval, readDelay, overlap) are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupDTO[], required — List of groups attached to this connector
      - `id` string, required — The unique identifier of the entity.
      - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `standardSettings` object, required
        - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
          - `id` string, required — The unique identifier of the entity.
          - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
            - `id` string, required — The unique identifier of the user.
            - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
          - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
            - `id` string, required — The unique identifier of the user.
            - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
          - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
          - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
          - `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.
        - `name` string, required — The name of the group.
      - `historySettings` object, required
        - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities.
        - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities.
  - SouthConnectorModbusDTO — South connector configuration for Modbus.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required — The name of the South connector.
    - `type` 'modbus', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector is enabled and active.
    - `settings` SouthModbusSettings, required
      - `host` string, required
      - `port` number, double, required
      - `connectTimeout` number, double, required
      - `retryInterval` number, double, required
      - `slaveId` number, double, required
      - `addressOffset` 'modbus' | 'jbus', required
      - `endianness` 'big-endian' | 'little-endian', required
      - `swapBytesInWords` boolean, required
      - `swapWordsInDWords` boolean, required
      - `groupingGap` number, double, required
    - `items` SouthConnectorModbusItemDTO[], required — List of items (data points) configured for this connector.
      - `id` string, required — The unique identifier of the entity.
      - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `name` string, required — The name of the item.
      - `enabled` boolean, required — Whether this item is enabled and should be collected.
      - `settings` SouthModbusItemSettings, required
        - `address` string, required
        - `modbusType` 'coil' | 'discrete-input' | 'input-register' | 'holding-register', required
        - `data` SouthModbusItemSettingsData
          - `dataType` 'uint16' | 'int16' | 'uint32' | 'int32' | 'big-uint64' | 'big-int64' | 'float' | 'double' | 'bit', required
          - `bitIndex` number, double
          - `multiplierCoefficient` number, double, required
      - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `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.
      - `group` SouthItemGroupDTO, required — Data Transfer Object for a South item group. Represents a group of items that can share common settings.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `standardSettings` object, required
          - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
            - `id` string, required — The unique identifier of the entity.
            - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `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.
          - `name` string, required — The name of the group.
        - `historySettings` object, required
          - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities.
          - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities.
          - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields (maxReadInterval, readDelay, overlap) are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupDTO[], required — List of groups attached to this connector
      - `id` string, required — The unique identifier of the entity.
      - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `standardSettings` object, required
        - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
          - `id` string, required — The unique identifier of the entity.
          - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
            - `id` string, required — The unique identifier of the user.
            - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
          - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
            - `id` string, required — The unique identifier of the user.
            - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
          - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
          - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
          - `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.
        - `name` string, required — The name of the group.
      - `historySettings` object, required
        - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities.
        - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities.
  - SouthConnectorMQTTDTO — South connector configuration for MQTT.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required — The name of the South connector.
    - `type` 'mqtt', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector is enabled and active.
    - `settings` SouthMQTTSettings, required
      - `url` string, required
      - `qos` '0' | '1' | '2', required
      - `persistent` boolean
      - `authentication` SouthMQTTSettingsAuthentication, required
        - `type` 'none' | 'basic' | 'cert', required
        - `username` string
        - `password` string, nullable
        - `certFilePath` string
        - `keyFilePath` string
        - `caFilePath` string
      - `rejectUnauthorized` boolean, required
      - `reconnectPeriod` number, double, required
      - `connectTimeout` number, double, required
      - `maxNumberOfMessages` number, double, required
      - `flushMessageTimeout` number, double, required
    - `items` SouthConnectorMQTTItemDTO[], required — List of items (data points) configured for this connector.
      - `id` string, required — The unique identifier of the entity.
      - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `name` string, required — The name of the item.
      - `enabled` boolean, required — Whether this item is enabled and should be collected.
      - `settings` SouthMQTTItemSettings, required
        - `topic` string, required
      - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `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.
      - `group` SouthItemGroupDTO, required — Data Transfer Object for a South item group. Represents a group of items that can share common settings.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `standardSettings` object, required
          - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
            - `id` string, required — The unique identifier of the entity.
            - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `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.
          - `name` string, required — The name of the group.
        - `historySettings` object, required
          - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities.
          - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities.
          - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields (maxReadInterval, readDelay, overlap) are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupDTO[], required — List of groups attached to this connector
      - `id` string, required — The unique identifier of the entity.
      - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `standardSettings` object, required
        - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
          - `id` string, required — The unique identifier of the entity.
          - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
            - `id` string, required — The unique identifier of the user.
            - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
          - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
            - `id` string, required — The unique identifier of the user.
            - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
          - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
          - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
          - `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.
        - `name` string, required — The name of the group.
      - `historySettings` object, required
        - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities.
        - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities.
  - SouthConnectorMSSQLDTO — South connector configuration for Microsoft SQL Server.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required — The name of the South connector.
    - `type` 'mssql', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector is enabled and active.
    - `settings` SouthMSSQLSettings, required
      - `host` string, required
      - `port` number, double, required
      - `connectionTimeout` number, double, required
      - `database` string, required
      - `encryption` boolean, required
      - `trustServerCertificate` boolean, required
      - `username` string, nullable, required
      - `password` string, nullable, required
      - `domain` string, nullable, required
      - `requestTimeout` number, double, required
    - `items` SouthConnectorMSSQLItemDTO[], required — List of items (data points) configured for this connector.
      - `id` string, required — The unique identifier of the entity.
      - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `name` string, required — The name of the item.
      - `enabled` boolean, required — Whether this item is enabled and should be collected.
      - `settings` SouthMSSQLItemSettings, required
        - `query` string, required
        - `dateTimeFields` SouthMSSQLItemSettingsDateTimeFields[], nullable, required
          - `fieldName` string, required
          - `useAsReference` boolean, required
          - `type` 'string' | 'date' | 'date-time' | 'date-time-2' | 'date-time-offset' | 'small-date-time' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string
          - `locale` string
        - `serialization` SouthMSSQLItemSettingsSerialization, required
          - `type` 'csv', required
          - `filename` string, required
          - `delimiter` 'DOT' | 'SEMI_COLON' | 'COLON' | 'COMMA' | 'NON_BREAKING_SPACE' | 'SLASH' | 'TAB' | 'PIPE', required
          - `compression` boolean, required
          - `outputTimestampFormat` string, required
          - `outputTimezone` string, required — Represents a timezone as an IANA timezone string.
      - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `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.
      - `group` SouthItemGroupDTO, required — Data Transfer Object for a South item group. Represents a group of items that can share common settings.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `standardSettings` object, required
          - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
            - `id` string, required — The unique identifier of the entity.
            - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `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.
          - `name` string, required — The name of the group.
        - `historySettings` object, required
          - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities.
          - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities.
          - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields (maxReadInterval, readDelay, overlap) are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupDTO[], required — List of groups attached to this connector
      - `id` string, required — The unique identifier of the entity.
      - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `standardSettings` object, required
        - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
          - `id` string, required — The unique identifier of the entity.
          - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
            - `id` string, required — The unique identifier of the user.
            - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
          - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
            - `id` string, required — The unique identifier of the user.
            - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
          - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
          - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
          - `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.
        - `name` string, required — The name of the group.
      - `historySettings` object, required
        - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities.
        - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities.
  - SouthConnectorMySQLDTO — South connector configuration for MySQL.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required — The name of the South connector.
    - `type` 'mysql', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector is enabled and active.
    - `settings` SouthMySQLSettings, required
      - `host` string, required
      - `port` number, double, required
      - `connectionTimeout` number, double, required
      - `database` string, required
      - `username` string, nullable, required
      - `password` string, nullable, required
    - `items` SouthConnectorMySQLItemDTO[], required — List of items (data points) configured for this connector.
      - `id` string, required — The unique identifier of the entity.
      - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `name` string, required — The name of the item.
      - `enabled` boolean, required — Whether this item is enabled and should be collected.
      - `settings` SouthMySQLItemSettings, required
        - `query` string, required
        - `requestTimeout` number, double, required
        - `dateTimeFields` SouthMySQLItemSettingsDateTimeFields[], nullable, required
          - `fieldName` string, required
          - `useAsReference` boolean, required
          - `type` 'string' | 'date-time' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string
          - `locale` string
        - `serialization` SouthMySQLItemSettingsSerialization, required
          - `type` 'csv', required
          - `filename` string, required
          - `delimiter` 'DOT' | 'SEMI_COLON' | 'COLON' | 'COMMA' | 'NON_BREAKING_SPACE' | 'SLASH' | 'TAB' | 'PIPE', required
          - `compression` boolean, required
          - `outputTimestampFormat` string, required
          - `outputTimezone` string, required — Represents a timezone as an IANA timezone string.
      - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `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.
      - `group` SouthItemGroupDTO, required — Data Transfer Object for a South item group. Represents a group of items that can share common settings.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `standardSettings` object, required
          - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
            - `id` string, required — The unique identifier of the entity.
            - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `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.
          - `name` string, required — The name of the group.
        - `historySettings` object, required
          - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities.
          - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities.
          - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields (maxReadInterval, readDelay, overlap) are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupDTO[], required — List of groups attached to this connector
      - `id` string, required — The unique identifier of the entity.
      - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `standardSettings` object, required
        - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
          - `id` string, required — The unique identifier of the entity.
          - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
            - `id` string, required — The unique identifier of the user.
            - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
          - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
            - `id` string, required — The unique identifier of the user.
            - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
          - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
          - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
          - `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.
        - `name` string, required — The name of the group.
      - `historySettings` object, required
        - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities.
        - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities.
  - SouthConnectorODBCDTO — South connector configuration for ODBC.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required — The name of the South connector.
    - `type` 'odbc', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector is enabled and active.
    - `settings` SouthODBCSettings, required
      - `remoteAgent` boolean, required
      - `agentUrl` string
      - `connectionTimeout` number, double, required
      - `retryInterval` number, double, required
      - `requestTimeout` number, double
      - `connectionString` string, required
      - `password` string, nullable, required
    - `items` SouthConnectorODBCItemDTO[], required — List of items (data points) configured for this connector.
      - `id` string, required — The unique identifier of the entity.
      - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `name` string, required — The name of the item.
      - `enabled` boolean, required — Whether this item is enabled and should be collected.
      - `settings` SouthODBCItemSettings, required
        - `query` string, required
        - `dateTimeFields` SouthODBCItemSettingsDateTimeFields[], nullable, required
          - `fieldName` string, required
          - `useAsReference` boolean, required
          - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string
          - `locale` string
        - `serialization` SouthODBCItemSettingsSerialization, required
          - `type` 'csv', required
          - `filename` string, required
          - `delimiter` 'DOT' | 'SEMI_COLON' | 'COLON' | 'COMMA' | 'NON_BREAKING_SPACE' | 'SLASH' | 'TAB' | 'PIPE', required
          - `compression` boolean, required
          - `outputTimestampFormat` string, required
          - `outputTimezone` string, required — Represents a timezone as an IANA timezone string.
      - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `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.
      - `group` SouthItemGroupDTO, required — Data Transfer Object for a South item group. Represents a group of items that can share common settings.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `standardSettings` object, required
          - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
            - `id` string, required — The unique identifier of the entity.
            - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `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.
          - `name` string, required — The name of the group.
        - `historySettings` object, required
          - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities.
          - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities.
          - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields (maxReadInterval, readDelay, overlap) are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupDTO[], required — List of groups attached to this connector
      - `id` string, required — The unique identifier of the entity.
      - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `standardSettings` object, required
        - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
          - `id` string, required — The unique identifier of the entity.
          - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
            - `id` string, required — The unique identifier of the user.
            - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
          - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
            - `id` string, required — The unique identifier of the user.
            - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
          - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
          - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
          - `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.
        - `name` string, required — The name of the group.
      - `historySettings` object, required
        - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities.
        - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities.
  - SouthConnectorOIAnalyticsDTO — South connector configuration for OIAnalytics.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required — The name of the South connector.
    - `type` 'oianalytics', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector is enabled and active.
    - `settings` SouthOIAnalyticsSettings, required
      - `useOiaModule` boolean, required
      - `timeout` number, double, required
      - `specificSettings` SouthOIAnalyticsSettingsSpecificSettings
        - `host` string, required
        - `acceptUnauthorized` boolean, required
        - `authentication` 'basic' | 'aad-client-secret' | 'aad-certificate', required
        - `accessKey` string
        - `secretKey` string, nullable
        - `tenantId` string
        - `clientId` string
        - `clientSecret` string, nullable
        - `certificateId` string
        - `scope` string
        - `useProxy` boolean, required
        - `proxyUrl` string
        - `proxyUsername` string
        - `proxyPassword` string, nullable
    - `items` SouthConnectorOIAnalyticsItemDTO[], required — List of items (data points) configured for this connector.
      - `id` string, required — The unique identifier of the entity.
      - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `name` string, required — The name of the item.
      - `enabled` boolean, required — Whether this item is enabled and should be collected.
      - `settings` SouthOIAnalyticsItemSettings, required
        - `endpoint` string, required
        - `queryParams` SouthOIAnalyticsItemSettingsQueryParams[], required
          - `key` string, required
          - `value` string, required
        - `serialization` SouthOIAnalyticsItemSettingsSerialization, required
          - `type` 'csv', required
          - `filename` string, required
          - `delimiter` 'DOT' | 'SEMI_COLON' | 'COLON' | 'COMMA' | 'NON_BREAKING_SPACE' | 'SLASH' | 'TAB' | 'PIPE', required
          - `compression` boolean, required
          - `outputTimestampFormat` string, required
          - `outputTimezone` string, required — Represents a timezone as an IANA timezone string.
      - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `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.
      - `group` SouthItemGroupDTO, required — Data Transfer Object for a South item group. Represents a group of items that can share common settings.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `standardSettings` object, required
          - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
            - `id` string, required — The unique identifier of the entity.
            - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `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.
          - `name` string, required — The name of the group.
        - `historySettings` object, required
          - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities.
          - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities.
          - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields (maxReadInterval, readDelay, overlap) are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupDTO[], required — List of groups attached to this connector
      - `id` string, required — The unique identifier of the entity.
      - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `standardSettings` object, required
        - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
          - `id` string, required — The unique identifier of the entity.
          - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
            - `id` string, required — The unique identifier of the user.
            - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
          - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
            - `id` string, required — The unique identifier of the user.
            - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
          - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
          - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
          - `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.
        - `name` string, required — The name of the group.
      - `historySettings` object, required
        - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities.
        - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities.
  - SouthConnectorOLEDBDTO — South connector configuration for OLE DB.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required — The name of the South connector.
    - `type` 'oledb', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector is enabled and active.
    - `settings` SouthOLEDBSettings, required
      - `agentUrl` string, required
      - `connectionTimeout` number, double, required
      - `retryInterval` number, double, required
      - `requestTimeout` number, double, required
      - `connectionString` string, required
      - `password` string, nullable, required
    - `items` SouthConnectorOLEDBItemDTO[], required — List of items (data points) configured for this connector.
      - `id` string, required — The unique identifier of the entity.
      - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `name` string, required — The name of the item.
      - `enabled` boolean, required — Whether this item is enabled and should be collected.
      - `settings` SouthOLEDBItemSettings, required
        - `query` string, required
        - `dateTimeFields` SouthOLEDBItemSettingsDateTimeFields[], nullable, required
          - `fieldName` string, required
          - `useAsReference` boolean, required
          - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string
          - `locale` string
        - `serialization` SouthOLEDBItemSettingsSerialization, required
          - `type` 'csv', required
          - `filename` string, required
          - `delimiter` 'DOT' | 'SEMI_COLON' | 'COLON' | 'COMMA' | 'NON_BREAKING_SPACE' | 'SLASH' | 'TAB' | 'PIPE', required
          - `compression` boolean, required
          - `outputTimestampFormat` string, required
          - `outputTimezone` string, required — Represents a timezone as an IANA timezone string.
      - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `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.
      - `group` SouthItemGroupDTO, required — Data Transfer Object for a South item group. Represents a group of items that can share common settings.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `standardSettings` object, required
          - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
            - `id` string, required — The unique identifier of the entity.
            - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `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.
          - `name` string, required — The name of the group.
        - `historySettings` object, required
          - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities.
          - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities.
          - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields (maxReadInterval, readDelay, overlap) are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupDTO[], required — List of groups attached to this connector
      - `id` string, required — The unique identifier of the entity.
      - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `standardSettings` object, required
        - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
          - `id` string, required — The unique identifier of the entity.
          - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
            - `id` string, required — The unique identifier of the user.
            - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
          - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
            - `id` string, required — The unique identifier of the user.
            - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
          - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
          - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
          - `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.
        - `name` string, required — The name of the group.
      - `historySettings` object, required
        - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities.
        - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities.
  - SouthConnectorOPCDTO — South connector configuration for classic OPC (OLE for Process Control).
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required — The name of the South connector.
    - `type` 'opc', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector is enabled and active.
    - `settings` SouthOPCSettings, required
      - `agentUrl` string, required
      - `retryInterval` number, double, required
      - `host` string, required
      - `serverName` string, required
      - `mode` 'hda' | 'da', required
    - `items` SouthConnectorOPCItemDTO[], required — List of items (data points) configured for this connector.
      - `id` string, required — The unique identifier of the entity.
      - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `name` string, required — The name of the item.
      - `enabled` boolean, required — Whether this item is enabled and should be collected.
      - `settings` SouthOPCItemSettings, required
        - `nodeId` string, required
        - `aggregate` 'raw' | 'interpolative' | 'total' | 'average' | 'time-average' | 'count' | 'stdev' | 'minimum-actual-time' | 'minimum' | 'maximum-actual-time' | 'maximum' | 'start' | 'end' | 'delta' | 'reg-slope' | 'reg-const' | 'reg-dev' | 'variance' | 'range' | 'duration-good' | 'duration-bad' | 'percent-good' | 'percent-bad' | 'worst-quality' | 'annotations', required
        - `resampling` 'none' | '1s' | '10s' | '30s' | '1min' | '1h' | '1d'
      - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `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.
      - `group` SouthItemGroupDTO, required — Data Transfer Object for a South item group. Represents a group of items that can share common settings.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `standardSettings` object, required
          - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
            - `id` string, required — The unique identifier of the entity.
            - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `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.
          - `name` string, required — The name of the group.
        - `historySettings` object, required
          - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities.
          - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities.
          - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields (maxReadInterval, readDelay, overlap) are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupDTO[], required — List of groups attached to this connector
      - `id` string, required — The unique identifier of the entity.
      - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `standardSettings` object, required
        - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
          - `id` string, required — The unique identifier of the entity.
          - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
            - `id` string, required — The unique identifier of the user.
            - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
          - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
            - `id` string, required — The unique identifier of the user.
            - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
          - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
          - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
          - `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.
        - `name` string, required — The name of the group.
      - `historySettings` object, required
        - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities.
        - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities.
  - SouthConnectorOPCUADTO — South connector configuration for OPC UA.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required — The name of the South connector.
    - `type` 'opcua', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector is enabled and active.
    - `settings` SouthOPCUASettings, required
      - `url` string, required
      - `keepSessionAlive` boolean, required
      - `readTimeout` number, double, required
      - `retryInterval` number, double, required
      - `maxNumberOfMessages` number, double, required
      - `flushMessageTimeout` number, double, required
      - `securityMode` 'none' | 'sign' | 'sign-and-encrypt', required
      - `securityPolicy` 'none' | 'basic128' | 'basic192' | 'basic256' | 'basic128-rsa15' | 'basic192-rsa15' | 'basic256-rsa15' | 'basic256-sha256' | 'aes128-sha256-rsa-oaep' | 'pub-sub-aes-128-ctr' | 'pub-sub-aes-256-ctr'
      - `authentication` SouthOPCUASettingsAuthentication, required
        - `type` 'none' | 'basic' | 'cert', required
        - `username` string
        - `password` string, nullable
        - `certFilePath` string
        - `keyFilePath` string
    - `items` SouthConnectorOPCUAItemDTO[], required — List of items (data points) configured for this connector.
      - `id` string, required — The unique identifier of the entity.
      - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `name` string, required — The name of the item.
      - `enabled` boolean, required — Whether this item is enabled and should be collected.
      - `settings` SouthOPCUAItemSettings, required
        - `nodeId` string, required
        - `mode` 'da' | 'ha', required
        - `haMode` SouthOPCUAItemSettingsHaMode
          - `aggregate` 'raw' | 'average' | 'count' | 'minimum' | 'maximum', required
          - `resampling` 'none' | '1s' | '10s' | '30s' | '1min' | '1h' | '1d'
        - `timestampOrigin` 'oibus' | 'point' | 'server'
      - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `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.
      - `group` SouthItemGroupDTO, required — Data Transfer Object for a South item group. Represents a group of items that can share common settings.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `standardSettings` object, required
          - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
            - `id` string, required — The unique identifier of the entity.
            - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `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.
          - `name` string, required — The name of the group.
        - `historySettings` object, required
          - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities.
          - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities.
          - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities.
      - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields (maxReadInterval, readDelay, overlap) are inherited from the group.
      - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
      - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `groups` SouthItemGroupDTO[], required — List of groups attached to this connector
      - `id` string, required — The unique identifier of the entity.
      - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `standardSettings` object, required
        - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
          - `id` string, required — The unique identifier of the entity.
          - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
            - `id` string, required — The unique identifier of the user.
            - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
          - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
            - `id` string, required — The unique identifier of the user.
            - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
          - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
          - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
          - `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.
        - `name` string, required — The name of the group.
      - `historySettings` object, required
        - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities.
        - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities.
        - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities.
  - SouthConnectorOracleDTO — South connector configuration for Oracle Database.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required — The name of the South connector.
    - `type` 'oracle', required — The type of the South connector.
    - `description` string, required — Description of the South connector's purpose.
    - `enabled` boolean, required — Whether the South connector is enabled and active.
    - `settings` SouthOracleSettings, required
      - `thickMode` boolean, required
      - `oracleClient` string
      - `host` string, required
      - `port` number, double, required
      - `connectionTimeout` number, double, required
      - `database` string, required
      - `username` string, nullable, required
      - `password` string, nullable, required
    - `items` SouthConnectorOracleItemDTO[], required — List of items (data points) configured for this connector.
      - `id` string, required — The unique identifier of the entity.
      - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
        - `id` string, required — The unique identifier of the user.
        - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
      - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - `name` string, required — The name of the item.
      - `enabled` boolean, required — Whether this item is enabled and should be collected.
      - `settings` SouthOracleItemSettings, required
        - `query` string, required
        - `requestTimeout` number, double, required
        - `dateTimeFields` SouthOracleItemSettingsDateTimeFields[], nullable, required
          - `fieldName` string, required
          - `useAsReference` boolean, required
          - `type` 'string' | 'date-time' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string
          - `locale` string
        - `serialization` SouthOracleItemSettingsSerialization, required
          - `type` 'csv', required
          - `filename` string, required
          - `delimiter` 'DOT' | 'SEMI_COLON' | 'COLON' | 'COMMA' | 'NON_BREAKING_SPACE' | 'SLASH' | 'TAB' | 'PIPE', required
          - `compression` boolean, required
          - `outputTimestampFormat` string, required
          - `outputTimezone` string, required — Represents a timezone as an IANA timezone string.
      - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `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.
      - `group` SouthItemGroupDTO, required — Data Transfer Object for a South item group. Represents a group of items that can share common settings.
        - `id` string, required — The unique identifier of the entity.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `standardSettings` object, required
          - `scanMode` ScanModeDTO, required — Data Transfer Object for a scan mode. Represents a configured scan mode with its metadata and schedule.
            - `id` string, required — The unique identifier of the entity.
            - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
              - …
            - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
            - `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.
          - `name` string, required — The name of the group.
        - `historySettings` object, required
          - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities.
          - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities.
          - `overlap` number, double, nullable, required — Default overlap in milliseconds for historical queries. Only applicable for connectors with historian capabilities.
- … truncated; see the full OpenAPI document linked below

## Changes

- **2026-05-12** `bf3cc429dbcb` — 1 breaking, 1 info
  - added the new required request property `anyOf[#/components/schemas/SouthConnectorModbusCommandDTO]/settings/groupingGap`
  - added the required property `anyOf[#/components/schemas/SouthConnectorModbusDTO]/settings/groupingGap` to the response with the `201` status
- …earlier changes not shown

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