Skip to content

Create Insight Name

All Insights are related to an Insight Name.

Before you can create new Insight events you need to create the Insight Names.

You can read how to create insight names when creating Insights in the Operations Tools documentation here.

API cURL Example
1
2
3
4
5
6
7
8
9
curl -X 'POST' \
  'https://<url.kelvin.ai>/api/v4/datatags/tags/create' \
  -H 'Authorization: Bearer <Your Current Token>' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "Demo Doc Tag",
      "metadata": {}
}'

The response will look like this;

API cURL Example Response
1
2
3
4
5
6
{
"name": "Demo Doc Tag",
"metadata": {},
"created": "2025-06-14T10:32:19.614397Z",
"updated": "2025-06-14T10:32:19.614397Z"
}
API Client (Python) Example
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
from kelvin.api.client import Client

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

# Create Data Tag Name
response = client.data_tag.create_tag(data={
        "name": "Demo Doc Tag",
        "metadata": {}
    })

print(response)

The response will look like this;

API Client (Python) Example Response
1
name='Demo Doc Tag' metadata={} created=datetime.datetime(2024, 6, 14, 11, 28, 53, 792472, tzinfo=datetime.timezone.utc) updated=datetime.datetime(2024, 6, 14, 11, 28, 53, 792472, tzinfo=datetime.timezone.utc)