---
title: "Update south connector item"
method: PUT
path: "/api/south/{southId}/items/{itemId}"
tags: ["South Connectors"]
---

# Update south connector item

`PUT /api/south/{southId}/items/{itemId}`

Updates an existing item in a south connector

## Path parameters

- `southId` string, required
- `itemId` string, required

## Request body

- union — Command Data Transfer Object for creating or updating a South connector item. Used as the request body for South connector item creation/update endpoints.
  - SouthConnectorADSItemCommandDTO — South connector item command for Beckhoff ADS.
    - `id` string, nullable, required — The ID of the item (null when creating a new item).
    - `enabled` boolean, required — Whether this item should be enabled.
    - `name` string, required — The name of the item.
    - `settings` SouthADSItemSettings, required
      - `address` string, required
    - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
    - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
    - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
    - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
    - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
    - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `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.
  - SouthConnectorFolderScannerItemCommandDTO — South connector item command for the Folder Scanner.
    - `id` string, nullable, required — The ID of the item (null when creating a new item).
    - `enabled` boolean, required — Whether this item should be enabled.
    - `name` string, required — The name of the item.
    - `settings` SouthFolderScannerItemSettings, required
      - `regex` string, required
      - `minAge` number, double, required
      - `preserveFiles` boolean, required
      - `ignoreModifiedDate` boolean
      - `maxFiles` number, double, required
      - `maxSize` number, double, required
      - `recursive` boolean, required
    - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
    - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
    - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
    - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
    - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
    - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `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.
  - SouthConnectorFTPItemCommandDTO — South connector item command for FTP file transfer.
    - `id` string, nullable, required — The ID of the item (null when creating a new item).
    - `enabled` boolean, required — Whether this item should be enabled.
    - `name` string, required — The name of the item.
    - `settings` SouthFTPItemSettings, required
      - `remoteFolder` string, required
      - `regex` string, required
      - `minAge` number, double, required
      - `preserveFiles` boolean, required
      - `ignoreModifiedDate` boolean
      - `maxFiles` number, double, required
      - `maxSize` number, double, required
      - `recursive` boolean, required
    - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
    - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
    - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
    - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
    - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
    - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `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.
  - SouthConnectorInfluxDBItemCommandDTO — South connector item command for InfluxDB time series database.
    - `id` string, nullable, required — The ID of the item (null when creating a new item).
    - `enabled` boolean, required — Whether this item should be enabled.
    - `name` string, required — The name of the item.
    - `settings` SouthInfluxDBItemSettings, required
      - `query` string, required
      - `requestTimeout` number, double, required
    - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
    - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
    - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
    - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
    - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
    - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `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.
  - SouthConnectorModbusItemCommandDTO — South connector item command for Modbus.
    - `id` string, nullable, required — The ID of the item (null when creating a new item).
    - `enabled` boolean, required — Whether this item should be enabled.
    - `name` string, required — The name of the item.
    - `settings` SouthModbusItemSettings, required
      - `address` string, required
      - `modbusType` 'coil' | 'discrete-input' | 'input-register' | 'holding-register', required
      - `data` SouthModbusItemSettingsData
        - `dataType` 'uint16' | 'int16' | 'uint32' | 'int32' | 'big-uint64' | 'big-int64' | 'float' | 'double' | 'bit', required
        - `bitIndex` number, double
        - `multiplierCoefficient` number, double, required
    - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
    - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
    - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
    - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
    - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
    - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `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.
  - SouthConnectorMQTTItemCommandDTO — South connector item command for MQTT.
    - `id` string, nullable, required — The ID of the item (null when creating a new item).
    - `enabled` boolean, required — Whether this item should be enabled.
    - `name` string, required — The name of the item.
    - `settings` SouthMQTTItemSettings, required
      - `topic` string, required
    - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
    - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
    - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
    - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
    - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
    - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `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.
  - SouthConnectorMSSQLItemCommandDTO — South connector item command for Microsoft SQL Server.
    - `id` string, nullable, required — The ID of the item (null when creating a new item).
    - `enabled` boolean, required — Whether this item should be enabled.
    - `name` string, required — The name of the item.
    - `settings` SouthMSSQLItemSettings, required
      - `query` string, required
      - `dateTimeFields` SouthMSSQLItemSettingsDateTimeFields[], nullable, required
        - `fieldName` string, required
        - `useAsReference` boolean, required
        - `type` 'string' | 'date' | 'date-time' | 'date-time-2' | 'date-time-offset' | 'small-date-time' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
        - `timezone` string — Represents a timezone as an IANA timezone string.
        - `format` string
        - `locale` string
      - `serialization` SouthMSSQLItemSettingsSerialization, required
        - `type` 'csv', required
        - `filename` string, required
        - `delimiter` 'DOT' | 'SEMI_COLON' | 'COLON' | 'COMMA' | 'NON_BREAKING_SPACE' | 'SLASH' | 'TAB' | 'PIPE', required
        - `compression` boolean, required
        - `outputTimestampFormat` string, required
        - `outputTimezone` string, required — Represents a timezone as an IANA timezone string.
    - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
    - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
    - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
    - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
    - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
    - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `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.
  - SouthConnectorMySQLItemCommandDTO — South connector item command for MySQL.
    - `id` string, nullable, required — The ID of the item (null when creating a new item).
    - `enabled` boolean, required — Whether this item should be enabled.
    - `name` string, required — The name of the item.
    - `settings` SouthMySQLItemSettings, required
      - `query` string, required
      - `requestTimeout` number, double, required
      - `dateTimeFields` SouthMySQLItemSettingsDateTimeFields[], nullable, required
        - `fieldName` string, required
        - `useAsReference` boolean, required
        - `type` 'string' | 'date-time' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
        - `timezone` string — Represents a timezone as an IANA timezone string.
        - `format` string
        - `locale` string
      - `serialization` SouthMySQLItemSettingsSerialization, required
        - `type` 'csv', required
        - `filename` string, required
        - `delimiter` 'DOT' | 'SEMI_COLON' | 'COLON' | 'COMMA' | 'NON_BREAKING_SPACE' | 'SLASH' | 'TAB' | 'PIPE', required
        - `compression` boolean, required
        - `outputTimestampFormat` string, required
        - `outputTimezone` string, required — Represents a timezone as an IANA timezone string.
    - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
    - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
    - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
    - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
    - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
    - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `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.
  - SouthConnectorODBCItemCommandDTO — South connector item command for ODBC.
    - `id` string, nullable, required — The ID of the item (null when creating a new item).
    - `enabled` boolean, required — Whether this item should be enabled.
    - `name` string, required — The name of the item.
    - `settings` SouthODBCItemSettings, required
      - `query` string, required
      - `dateTimeFields` SouthODBCItemSettingsDateTimeFields[], nullable, required
        - `fieldName` string, required
        - `useAsReference` boolean, required
        - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
        - `timezone` string — Represents a timezone as an IANA timezone string.
        - `format` string
        - `locale` string
      - `serialization` SouthODBCItemSettingsSerialization, required
        - `type` 'csv', required
        - `filename` string, required
        - `delimiter` 'DOT' | 'SEMI_COLON' | 'COLON' | 'COMMA' | 'NON_BREAKING_SPACE' | 'SLASH' | 'TAB' | 'PIPE', required
        - `compression` boolean, required
        - `outputTimestampFormat` string, required
        - `outputTimezone` string, required — Represents a timezone as an IANA timezone string.
    - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
    - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
    - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
    - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
    - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
    - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `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.
  - SouthConnectorOIAnalyticsItemCommandDTO — South connector item command for OIAnalytics.
    - `id` string, nullable, required — The ID of the item (null when creating a new item).
    - `enabled` boolean, required — Whether this item should be enabled.
    - `name` string, required — The name of the item.
    - `settings` SouthOIAnalyticsItemSettings, required
      - `endpoint` string, required
      - `queryParams` SouthOIAnalyticsItemSettingsQueryParams[], required
        - `key` string, required
        - `value` string, required
      - `serialization` SouthOIAnalyticsItemSettingsSerialization, required
        - `type` 'csv', required
        - `filename` string, required
        - `delimiter` 'DOT' | 'SEMI_COLON' | 'COLON' | 'COMMA' | 'NON_BREAKING_SPACE' | 'SLASH' | 'TAB' | 'PIPE', required
        - `compression` boolean, required
        - `outputTimestampFormat` string, required
        - `outputTimezone` string, required — Represents a timezone as an IANA timezone string.
    - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
    - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
    - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
    - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
    - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
    - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `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.
  - SouthConnectorOLEDBItemCommandDTO — South connector item command for OLE DB.
    - `id` string, nullable, required — The ID of the item (null when creating a new item).
    - `enabled` boolean, required — Whether this item should be enabled.
    - `name` string, required — The name of the item.
    - `settings` SouthOLEDBItemSettings, required
      - `query` string, required
      - `dateTimeFields` SouthOLEDBItemSettingsDateTimeFields[], nullable, required
        - `fieldName` string, required
        - `useAsReference` boolean, required
        - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
        - `timezone` string — Represents a timezone as an IANA timezone string.
        - `format` string
        - `locale` string
      - `serialization` SouthOLEDBItemSettingsSerialization, required
        - `type` 'csv', required
        - `filename` string, required
        - `delimiter` 'DOT' | 'SEMI_COLON' | 'COLON' | 'COMMA' | 'NON_BREAKING_SPACE' | 'SLASH' | 'TAB' | 'PIPE', required
        - `compression` boolean, required
        - `outputTimestampFormat` string, required
        - `outputTimezone` string, required — Represents a timezone as an IANA timezone string.
    - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
    - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
    - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
    - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
    - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
    - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `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.
  - SouthConnectorOPCItemCommandDTO — South connector item command for classic OPC (OLE for Process Control).
    - `id` string, nullable, required — The ID of the item (null when creating a new item).
    - `enabled` boolean, required — Whether this item should be enabled.
    - `name` string, required — The name of the item.
    - `settings` SouthOPCItemSettings, required
      - `nodeId` string, required
      - `aggregate` 'raw' | 'interpolative' | 'total' | 'average' | 'time-average' | 'count' | 'stdev' | 'minimum-actual-time' | 'minimum' | 'maximum-actual-time' | 'maximum' | 'start' | 'end' | 'delta' | 'reg-slope' | 'reg-const' | 'reg-dev' | 'variance' | 'range' | 'duration-good' | 'duration-bad' | 'percent-good' | 'percent-bad' | 'worst-quality' | 'annotations', required
      - `resampling` 'none' | '1s' | '10s' | '30s' | '1min' | '1h' | '1d'
    - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
    - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
    - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
    - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
    - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
    - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `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.
  - SouthConnectorOPCUAItemCommandDTO — South connector item command for OPC UA.
    - `id` string, nullable, required — The ID of the item (null when creating a new item).
    - `enabled` boolean, required — Whether this item should be enabled.
    - `name` string, required — The name of the item.
    - `settings` SouthOPCUAItemSettings, required
      - `nodeId` string, required
      - `mode` 'da' | 'ha', required
      - `haMode` SouthOPCUAItemSettingsHaMode
        - `aggregate` 'raw' | 'average' | 'count' | 'minimum' | 'maximum', required
        - `resampling` 'none' | '1s' | '10s' | '30s' | '1min' | '1h' | '1d'
      - `timestampOrigin` 'oibus' | 'point' | 'server'
    - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
    - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
    - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
    - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
    - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
    - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `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.
  - SouthConnectorOracleItemCommandDTO — South connector item command for Oracle Database.
    - `id` string, nullable, required — The ID of the item (null when creating a new item).
    - `enabled` boolean, required — Whether this item should be enabled.
    - `name` string, required — The name of the item.
    - `settings` SouthOracleItemSettings, required
      - `query` string, required
      - `requestTimeout` number, double, required
      - `dateTimeFields` SouthOracleItemSettingsDateTimeFields[], nullable, required
        - `fieldName` string, required
        - `useAsReference` boolean, required
        - `type` 'string' | 'date-time' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
        - `timezone` string — Represents a timezone as an IANA timezone string.
        - `format` string
        - `locale` string
      - `serialization` SouthOracleItemSettingsSerialization, required
        - `type` 'csv', required
        - `filename` string, required
        - `delimiter` 'DOT' | 'SEMI_COLON' | 'COLON' | 'COMMA' | 'NON_BREAKING_SPACE' | 'SLASH' | 'TAB' | 'PIPE', required
        - `compression` boolean, required
        - `outputTimestampFormat` string, required
        - `outputTimezone` string, required — Represents a timezone as an IANA timezone string.
    - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
    - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
    - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
    - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
    - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
    - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `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.
  - SouthConnectorOsisoftPIItemCommandDTO — South connector item command for OSIsoft PI System.
    - `id` string, nullable, required — The ID of the item (null when creating a new item).
    - `enabled` boolean, required — Whether this item should be enabled.
    - `name` string, required — The name of the item.
    - `settings` SouthPIItemSettings, required
      - `type` 'point-id' | 'point-query', required
      - `piPoint` string
      - `piQuery` string
    - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
    - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
    - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
    - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
    - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
    - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `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.
  - SouthConnectorPostgreSQLItemCommandDTO — South connector item command for PostgreSQL.
    - `id` string, nullable, required — The ID of the item (null when creating a new item).
    - `enabled` boolean, required — Whether this item should be enabled.
    - `name` string, required — The name of the item.
    - `settings` SouthPostgreSQLItemSettings, required
      - `query` string, required
      - `dateTimeFields` SouthPostgreSQLItemSettingsDateTimeFields[], nullable, required
        - `fieldName` string, required
        - `useAsReference` boolean, required
        - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms' | 'timestamp' | 'timestamptz', required
        - `timezone` string — Represents a timezone as an IANA timezone string.
        - `format` string
        - `locale` string
      - `serialization` SouthPostgreSQLItemSettingsSerialization, required
        - `type` 'csv', required
        - `filename` string, required
        - `delimiter` 'DOT' | 'SEMI_COLON' | 'COLON' | 'COMMA' | 'NON_BREAKING_SPACE' | 'SLASH' | 'TAB' | 'PIPE', required
        - `compression` boolean, required
        - `outputTimestampFormat` string, required
        - `outputTimezone` string, required — Represents a timezone as an IANA timezone string.
    - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
    - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
    - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
    - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
    - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
    - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `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.
  - SouthConnectorRESTItemCommandDTO — South connector item command for the REST API.
    - `id` string, nullable, required — The ID of the item (null when creating a new item).
    - `enabled` boolean, required — Whether this item should be enabled.
    - `name` string, required — The name of the item.
    - `settings` SouthRestItemSettings, required
      - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', required
      - `endpoint` string, required
      - `returnType` 'file' | 'body', required
      - `queryParams` SouthRestItemSettingsQueryParams[], required
        - `key` string, required
        - `value` string, required
        - `dateTimeInput` SouthRestItemSettingsQueryParamsDateTimeInput
          - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string, nullable
      - `headers` SouthRestItemSettingsHeaders[], required
        - `key` string, required
        - `value` string, required
        - `dateTimeInput` SouthRestItemSettingsHeadersDateTimeInput
          - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string, nullable
      - `body` SouthRestItemSettingsBody
        - `content` string, nullable, required
        - `dateTimeInput` SouthRestItemSettingsBodyDateTimeInput
          - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string, nullable
      - `trackingInstant` SouthRestItemSettingsTrackingInstant
        - `trackInstant` boolean, required
        - `jsonPath` string
        - `dateTimeInput` SouthRestItemSettingsTrackingInstantDateTimeInput
          - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string
          - `locale` string
    - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
    - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
    - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
    - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
    - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
    - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `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.
  - SouthConnectorSFTPItemCommandDTO — South connector item command for SFTP file transfer.
    - `id` string, nullable, required — The ID of the item (null when creating a new item).
    - `enabled` boolean, required — Whether this item should be enabled.
    - `name` string, required — The name of the item.
    - `settings` SouthSFTPItemSettings, required
      - `remoteFolder` string, required
      - `regex` string, required
      - `minAge` number, double, required
      - `preserveFiles` boolean, required
      - `ignoreModifiedDate` boolean
      - `maxFiles` number, double, required
      - `maxSize` number, double, required
      - `recursive` boolean, required
    - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
    - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
    - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
    - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
    - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
    - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `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.
  - SouthConnectorSQLiteItemCommandDTO — South connector item command for SQLite.
    - `id` string, nullable, required — The ID of the item (null when creating a new item).
    - `enabled` boolean, required — Whether this item should be enabled.
    - `name` string, required — The name of the item.
    - `settings` SouthSQLiteItemSettings, required
      - `query` string, required
      - `dateTimeFields` SouthSQLiteItemSettingsDateTimeFields[], nullable, required
        - `fieldName` string, required
        - `useAsReference` boolean, required
        - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
        - `timezone` string — Represents a timezone as an IANA timezone string.
        - `format` string
        - `locale` string
      - `serialization` SouthSQLiteItemSettingsSerialization, required
        - `type` 'csv', required
        - `filename` string, required
        - `delimiter` 'DOT' | 'SEMI_COLON' | 'COLON' | 'COMMA' | 'NON_BREAKING_SPACE' | 'SLASH' | 'TAB' | 'PIPE', required
        - `compression` boolean, required
        - `outputTimestampFormat` string, required
        - `outputTimezone` string, required — Represents a timezone as an IANA timezone string.
    - `scanModeId` string, nullable, required — The ID of the scan mode to use for this item. Null when the scan mode should be determined by the system.
    - `scanModeName` string, nullable, required — The name of the scan mode to use when ID is not available. Null when not specifying by name.
    - `groupId` string, nullable, required — The ID of the group this item belongs to. Null when the item is not in any group.
    - `groupName` string, nullable, required — The name of the group this item belongs to. Used when importing from CSV where group IDs are not available. Null when the item is not in any group.
    - `syncWithGroup` boolean, required — Whether this item syncs its historian settings with its group. When true, historian fields are inherited from the group.
    - `maxReadInterval` number, double, nullable, required — Maximum read interval in seconds for historical queries. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `readDelay` number, double, nullable, required — Read delay in milliseconds before querying historical data. Only applicable for connectors with historian capabilities. When null and item is in a group, inherits from group settings.
    - `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.

## Response `204`

No Content

---

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