History Queries

List all history queries

Retrieves a list of all configured history queries

get/api/history

Response

Array of history query objects

idstring required

The unique identifier of the entity.

createdAtstring required

Represents an instant in time as an ISO 8601 string.

updatedAtstring required

Represents an instant in time as an ISO 8601 string.

namestring required

The name of the history query.

descriptionstring required

Description of the history query's purpose.

status'PENDING' | 'RUNNING' | 'ERRORED' | 'PAUSED' | 'FINISHED' required

Type representing the possible statuses for a history query.

startTimestring required

Start time for the data to be queried (ISO 8601 format).

endTimestring required

End time for the data to be queried (ISO 8601 format).

southType'opcua' | 'mqtt' | 'modbus' | 'oianalytics' | 'ads' | 'folder-scanner' | 'ftp' | 'influxdb' | 'mssql' | 'mysql' | 'odbc' | 'oledb' | 'opc' | 'oracle' | 'osisoft-pi' | 'postgresql' | 'rest' | 'sftp' | 'sqlite' required

Type representing the possible types for a South connector.

northType'opcua' | 'mqtt' | 'modbus' | 'oianalytics' | 'rest' | 'sftp' | 'aws-s3' | 'azure-blob' | 'console' | 'file-writer' required

Type representing the possible types for a North connector.

Example response

[
  {
    "id": "entity123",
    "createdBy": {
      "id": "abc123",
      "friendlyName": "John Doe (john.doe)"
    },
    "updatedBy": {
      "id": "abc123",
      "friendlyName": "John Doe (john.doe)"
    },
    "createdAt": "2023-10-31T12:34:56.789Z",
    "updatedAt": "2023-10-31T12:34:56.789Z",
    "name": "Production Data Migration",
    "description": "Migrate production data from old to new system",
    "startTime": "2023-01-01T00:00:00Z",
    "endTime": "2023-01-31T23:59:59Z"
  }
]

Changes

Changed in 23 of the 73 revisions of this API.122031

    • added the new influxdb enum value to the items/southType response property for the response status 200

      response-property-enum-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • removed the influxdb enum value from the items/southType response property for the response status 200

      response-property-enum-value-removed

    This revision also has 29 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added the new influxdb enum value to the items/southType response property for the response status 200

      response-property-enum-value-added

    • removed the influxdb enum value from the items/southType response property for the response status 200

      response-property-enum-value-removed

    This revision also has 23 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added the new influxdb enum value to the items/southType response property for the response status 200

      response-property-enum-value-added

    • removed the influxdb enum value from the items/southType response property for the response status 200

      response-property-enum-value-removed

    This revision also has 23 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added the new influxdb enum value to the items/southType response property for the response status 200

      response-property-enum-value-added

    • removed the influxdb enum value from the items/southType response property for the response status 200

      response-property-enum-value-removed

    This revision also has 23 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added the new influxdb enum value to the items/southType response property for the response status 200

      response-property-enum-value-added

    • removed the influxdb enum value from the items/southType response property for the response status 200

      response-property-enum-value-removed

    This revision also has 22 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog