Deleting Signal Data

Falkonry Time Series Intelligence is designed to receive large numbers of time series. The Connection settings control the data transformation. When data with incorrect time settings get into a signal, the data becomes unusable. In such case, following REST API can be used to delete a portion of data. This API returns a flow ID and triggers a long running process.

Request Payload

{
  "name": "signaldatacleanup flow",
  "flowType": "SIGNALDATACLEANUP",
  "spec": {
    "sourceIds":["<signal-id>"],
    "startTime": "YYYY-MM-DDTHH:mm:SS.SSSSSSZ",
    "endTime": "YYYY-MM-DDTHH:mm:SS.SSSSSSZ"
  }
}

Example curl request

curl --location --request POST 'https://app3.falkonry.ai/api/1.2/accounts/xxxxxxxxxxxxxxx/flows' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data-raw '{
      "name": "signaldatacleanup flow", 
      "flowType": "SIGNALDATACLEANUP", 
      "spec": { "sourceIds": ["yyyyyyyyyyyy"], 
                "startTime": "YYYY-MM-DDTHH:mm:SS.SSSZ",
                "endTime": "YYYY-MM-DDTHH:mm:SS.SSSZ" 
              }}'

Example with python

import requests 
URL = 'https://app3.falkonry.ai/api/1.2/accounts/xxxxxxxxxxxxxxx/flows'
TOKEN = '<token>' 
HEADERS = {'Authorization': f'Bearer {TOKEN}'} 
PAYLOAD = { "name": "signaldatacleanup flow", 
              "flowType": "SIGNALDATACLEANUP", 
              "spec": { "sourceIds": ["yyyyyyyyyyyy"], 
                        "startTime": "YYYY-MM-DDTHH:mm:SS.SSSSSSZ",
                          "endTime": "YYYY-MM-DDTHH:mm:SS.SSSSSSZ" 
                      } 
          }

response = requests.post(URL, headers=HEADERS, data=PAYLOAD)
print(response.json())

Example response

{
  "id": "zzzzzzzzzzzzzz",
  "type": "entities.flow",
  "tenant": "xxxxxxxxxxxxxxx",
  "flowType": "SIGNALDATACLEANUP",
  "status": "CREATED",
  "name": "signaldatacleanup flow",
  "spec": {
    "sourceIds": ["yyyyyyyyyyyy"],
    "startTime": "YYYY-MM-DDTHH:mm:SS.SSSSSSZ",
    "endTime": "YYYY-MM-DDTHH:mm:SS.SSSSSSZ"
  }
}

Note

The startTime and endTime should be in UTC timezone.

The flow takes few minutes to finish. The status should be available under in-app Activity panel.