--- title: "Get south connector by ID" method: GET path: "/api/south/{southId}" tags: ["South Connectors"] --- # Get south connector by ID `GET /api/south/{southId}` Retrieves a specific south connector by its unique identifier ## Path parameters - `southId` string, required ## Response `200` The south connector object - 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 - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. 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. - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. If the resulting end time is not after the effective start time, the query is skipped. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. Negative values extend the window backwards (equivalent to the old overlap behaviour). - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields (maxReadInterval, readDelay, startTimeOffset, endTimeOffset) 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. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings. Negative values extend the window backwards (equivalent to the old overlap behaviour). - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings. If the resulting end time is not after the effective start time, the query is skipped. - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `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 - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. 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. - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. If the resulting end time is not after the effective start time, the query is skipped. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. Negative values extend the window backwards (equivalent to the old overlap behaviour). - 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 - `username` string, nullable - `password` string, nullable - `domain` string, nullable - `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 - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. 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. - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. If the resulting end time is not after the effective start time, the query is skipped. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. Negative values extend the window backwards (equivalent to the old overlap behaviour). - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields (maxReadInterval, readDelay, startTimeOffset, endTimeOffset) 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. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings. Negative values extend the window backwards (equivalent to the old overlap behaviour). - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings. If the resulting end time is not after the effective start time, the query is skipped. - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `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 - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. 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. - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. If the resulting end time is not after the effective start time, the query is skipped. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. Negative values extend the window backwards (equivalent to the old overlap behaviour). - 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 - `retryInterval` number, double, 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 - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. 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. - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. If the resulting end time is not after the effective start time, the query is skipped. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. Negative values extend the window backwards (equivalent to the old overlap behaviour). - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields (maxReadInterval, readDelay, startTimeOffset, endTimeOffset) 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. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings. Negative values extend the window backwards (equivalent to the old overlap behaviour). - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings. If the resulting end time is not after the effective start time, the query is skipped. - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `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 - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. 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. - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. If the resulting end time is not after the effective start time, the query is skipped. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. Negative values extend the window backwards (equivalent to the old overlap behaviour). - SouthConnectorInfluxDBDTO — South connector configuration for InfluxDB time series 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` 'influxdb', 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` SouthInfluxDBSettings, required - `version` '1' | '2' | '3', required - `host` string - `port` number, double - `protocol` 'http' | 'https' - `database` string - `username` string, nullable - `password` string, nullable - `url` string - `token` string, nullable - `organisation` string - `bucket` string - `items` SouthConnectorInfluxDBItemDTO[], 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` SouthInfluxDBItemSettings, required - `query` string, required - `requestTimeout` 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 - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. 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. - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. If the resulting end time is not after the effective start time, the query is skipped. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. Negative values extend the window backwards (equivalent to the old overlap behaviour). - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields (maxReadInterval, readDelay, startTimeOffset, endTimeOffset) 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. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings. Negative values extend the window backwards (equivalent to the old overlap behaviour). - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings. If the resulting end time is not after the effective start time, the query is skipped. - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `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 - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. 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. - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. If the resulting end time is not after the effective start time, the query is skipped. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. Negative values extend the window backwards (equivalent to the old overlap behaviour). - 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 - `networkTimeout` 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 - `batchQuery` boolean, required - `groupingGap` number, double - `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 - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. 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. - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. If the resulting end time is not after the effective start time, the query is skipped. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. Negative values extend the window backwards (equivalent to the old overlap behaviour). - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields (maxReadInterval, readDelay, startTimeOffset, endTimeOffset) 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. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings. Negative values extend the window backwards (equivalent to the old overlap behaviour). - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings. If the resulting end time is not after the effective start time, the query is skipped. - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `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 - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. 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. - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. If the resulting end time is not after the effective start time, the query is skipped. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. Negative values extend the window backwards (equivalent to the old overlap behaviour). - 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 - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. 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. - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. If the resulting end time is not after the effective start time, the query is skipped. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. Negative values extend the window backwards (equivalent to the old overlap behaviour). - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields (maxReadInterval, readDelay, startTimeOffset, endTimeOffset) 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. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings. Negative values extend the window backwards (equivalent to the old overlap behaviour). - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings. If the resulting end time is not after the effective start time, the query is skipped. - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `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 - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. 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. - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. If the resulting end time is not after the effective start time, the query is skipped. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. Negative values extend the window backwards (equivalent to the old overlap behaviour). - 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 - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. 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. - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. If the resulting end time is not after the effective start time, the query is skipped. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. Negative values extend the window backwards (equivalent to the old overlap behaviour). - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields (maxReadInterval, readDelay, startTimeOffset, endTimeOffset) 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. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings. Negative values extend the window backwards (equivalent to the old overlap behaviour). - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings. If the resulting end time is not after the effective start time, the query is skipped. - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `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 - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. 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. - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. If the resulting end time is not after the effective start time, the query is skipped. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. Negative values extend the window backwards (equivalent to the old overlap behaviour). - 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 - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. 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. - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. If the resulting end time is not after the effective start time, the query is skipped. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. Negative values extend the window backwards (equivalent to the old overlap behaviour). - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields (maxReadInterval, readDelay, startTimeOffset, endTimeOffset) 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. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings. Negative values extend the window backwards (equivalent to the old overlap behaviour). - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings. If the resulting end time is not after the effective start time, the query is skipped. - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `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 - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. 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. - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. If the resulting end time is not after the effective start time, the query is skipped. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. Negative values extend the window backwards (equivalent to the old overlap behaviour). - 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 - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. 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. - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. If the resulting end time is not after the effective start time, the query is skipped. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. Negative values extend the window backwards (equivalent to the old overlap behaviour). - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields (maxReadInterval, readDelay, startTimeOffset, endTimeOffset) 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. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings. Negative values extend the window backwards (equivalent to the old overlap behaviour). - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings. If the resulting end time is not after the effective start time, the query is skipped. - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `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 - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. 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. - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. If the resulting end time is not after the effective start time, the query is skipped. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. Negative values extend the window backwards (equivalent to the old overlap behaviour). - 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 - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. 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. - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. If the resulting end time is not after the effective start time, the query is skipped. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. Negative values extend the window backwards (equivalent to the old overlap behaviour). - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields (maxReadInterval, readDelay, startTimeOffset, endTimeOffset) 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. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings. Negative values extend the window backwards (equivalent to the old overlap behaviour). - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings. If the resulting end time is not after the effective start time, the query is skipped. - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `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 - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. 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. - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. If the resulting end time is not after the effective start time, the query is skipped. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. Negative values extend the window backwards (equivalent to the old overlap behaviour). - 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 - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. 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. - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. If the resulting end time is not after the effective start time, the query is skipped. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. Negative values extend the window backwards (equivalent to the old overlap behaviour). - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields (maxReadInterval, readDelay, startTimeOffset, endTimeOffset) 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. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings. Negative values extend the window backwards (equivalent to the old overlap behaviour). - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings. If the resulting end time is not after the effective start time, the query is skipped. - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `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 - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. 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. - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. If the resulting end time is not after the effective start time, the query is skipped. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. Negative values extend the window backwards (equivalent to the old overlap behaviour). - 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 - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. 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. - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. If the resulting end time is not after the effective start time, the query is skipped. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. Negative values extend the window backwards (equivalent to the old overlap behaviour). - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields (maxReadInterval, readDelay, startTimeOffset, endTimeOffset) 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. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings. Negative values extend the window backwards (equivalent to the old overlap behaviour). - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings. If the resulting end time is not after the effective start time, the query is skipped. - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `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 - `recoveryStrategy` 'oldest' | 'newest', required — Recovery strategy used when a south connector reconnects after a long disconnection. - 'oldest': fill the gap from oldest to newest (default behaviour). - 'newest': fill the gap from newest to oldest so that recent data arrives first. - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. 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. - `endTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the end of the history query interval. Only applicable for connectors with historian capabilities. If the resulting end time is not after the effective start time, the query is skipped. - `startTimeOffset` number, double, nullable, required — Offset in milliseconds applied to the start of the history query interval. Only applicable for connectors with historian capabilities. Negative values extend the window backwards (equivalent to the old overlap behaviour). - 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 - … truncated; see the full OpenAPI document linked below --- [API](https://skmtc.net/optimistiksas/apis/oibus-api.md) · [All operations](https://skmtc.net/optimistiksas/apis/oibus-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/optimistiksas/oibus-api/revisions/fe8fd32c9fdc/schema)