Skip to content

Update an Insight

Reference:

Field Description
start_date Start date for the Insight. Time is based on UTC timezone, formatted in RFC 3339.
end_date End date for the Insight. Time is based on UTC timezone, formatted in RFC 3339.
tag_name Tag name to categorize the Insight
resource The Asset that this Insight is related to. This is in KRN format (e.g. krn:asset:bp_01)
source The process that created this Insight. This can be a user or an automated process like a workload, Applications, etc. This is KRN format.
description Detailed description of the Insight.
contexts A list of associated resources with this Insight. This can be a Data Stream, Applications or any other valid resource in the Kelvin Platform.

Update an Insight

You can read how to update insights in the Operations Tools documentation here.

API cURL Example
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
curl -X 'POST' \
  'https://<url.kelvin.ai>/api/v4/datatags/118f5665-fdad-4c28-a09f-ca0a416202ff/update' \
  -H 'Authorization: Bearer <Your Current Token>' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "start_date": "2025-06-13T21:07:30.741Z",
  "end_date": "2025-06-14T09:07:30.741Z",
  "tag_name": "Low Temperature",
  "resource": "krn:asset:esp_06",
  "source": "krn:user:ivo.fernandes@kelvininc.com",
  "description": null,
  "contexts": []
}'

The response will look like this;

API cURL Example Response
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
{
  "id": "118f5665-fdad-4c28-a09f-ca0a416202ff",
  "start_date": "2025-06-13T21:07:30.741Z",
  "end_date": "2025-06-14T09:07:30.741Z",
  "tag_name": "Low Temperature",
  "resource": "krn:asset:esp_06",
  "source": "krn:user:ivo.fernandes@kelvininc.com",
  "description": null,
  "contexts": [],
  "created": "2025-06-14T09:54:23.352478Z",
  "updated": "2025-06-14T11:56:35.192941Z"
}
API Client (Python) Example
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
from kelvin.api.client import Client

# Login
client = Client(url="https://<url.kelvin.ai>", username="<your_username>")
client.login(password="<your_password>")

# Update Data Tag
response = client.data_tag.update_data_tag(datatag_id="118f5665-fdad-4c28-a09f-ca0a416202ff/", data={
    "start_date": "2025-06-13T21:07:30.741Z",
    "end_date": "2025-06-14T09:07:30.741Z",
    "tag_name": "Low Temperature",
    "resource": "krn:asset:esp_06",
    "source": "krn:user:ivo.fernandes@kelvininc.com",
    "description": None,
    "contexts": []
    })

print(response)

The response will look like this;

API Client (Python) Example Response
1
id=UUID('118f5665-fdad-4c28-a09f-ca0a416202ff') start_date=datetime.datetime(2024, 6, 13, 21, 7, 30, 741000, tzinfo=datetime.timezone.utc) end_date=datetime.datetime(2024, 6, 14, 9, 7, 30, 741000, tzinfo=datetime.timezone.utc) tag_name='Low Temperature' resource=KRNAsset(asset='esp_06') source=KRN(krn:user:ivo.fernandes@kelvininc.com) description=None contexts=[] created=datetime.datetime(2024, 6, 14, 9, 54, 23, 352478, tzinfo=datetime.timezone.utc) updated=datetime.datetime(2024, 6, 14, 12, 0, 7, 458680, tzinfo=datetime.timezone.utc)