Create events using an Event Type
- Last UpdatedDec 15, 2025
- 2 minute read
To reference an Event Type, the event’s typeId property should be set to the id of the type. Because the type defines the data type of each property, only the property value needs to be included in the event. The type properties appear directly on the event as top-level fields. Type relationships are included within the same relationship list as ad hoc relationships.
Typed event request example
{
"id": "wind-turbine-maintenance-001",
"name": "Annual Turbine Maintenance",
"description": "Scheduled annual maintenance for wind turbine #12 including gear inspection and blade balancing.",
"typeId": "TurbineMaintenanceEvent",
"startTime": "2025-05-08T08:00:00.0000000+00:00",
"endTime": "2025-05-08T16:00:00.0000000+00:00",
"parent": "wind-turbine-asset-102",
"relationships": [
{
"Id": "RequiredParts",
"Targets": [
{
"Id": "gearbox-replacement-kit",
"TargetBase": "Entity",
"RelationshipType": "Related"
}
]
},
{
"Id": "PreviousMaintenanceEvent",
"Targets": [
{
"Id": "wind-turbine-maintenance-000",
"TargetBase": "Event",
"RelationshipType": "Parent"
}
]
}
],
"adhocProperties": [
{
"Id": "gearbox-condition",
"Value": "gears corroded",
"TypeCode": "String"
}
],
"MaintenancePerformedBy": "John Smith",
"MaintenanceType": "Inspection",
"EstimatedDuration": "01:02:03",
"PowerOutput": 5.2
}
Typed event response example
{
"id": "wind-turbine-maintenance-001",
"name": "Annual Turbine Maintenance",
"description": "Scheduled annual maintenance for wind turbine #12 including gear inspection and blade balancing.",
"version": 1,
"typeId": "TurbineMaintenanceEvent",
"startTime": "2025-05-08T08:00:00+00:00",
"endTime": "2025-05-08T16:00:00+00:00",
"parent": "wind-turbine-asset-102",
"state": "Closed",
"duration": "08:00:00",
"createdDate": "2025-07-30T15:41:49.7735271+00:00",
"createdBy": "46ffddec-4f2e-4b2c-b77e-42fb9b964a84",
"modifiedDate": "2025-07-30T15:41:49.7735271+00:00",
"modifiedBy": "46ffddec-4f2e-4b2c-b77e-42fb9b964a84",
"relationships": [
{
"id": "parent",
"targets": [
{
"id": "wind-turbine-asset-102",
"targetBase": "Entity",
"relationshipType": "parent"
}
]
},
{
"id": "PreviousMaintenanceEvent",
"targets": [
{
"id": "wind-turbine-maintenance-000",
"targetBase": "Event",
"relationshipType": "Parent"
}
]
},
{
"id": "RequiredParts",
"targets": [
{
"id": "gearbox-replacement-kit",
"targetBase": "Entity",
"relationshipType": "Related"
}
]
}
],
"adhocProperties": [
{
"id": "gearbox-condition",
"value": "gears corroded",
"typeCode": "String"
}
],
"MaintenancePerformedBy": "John Smith",
"MaintenanceType": "Inspection",
"EstimatedDuration": "01:02:03",
"PowerOutput": {
"value": 5.2,
"uom": "kilowatt"
}
}
The diagram below gives an example of how you can model complex data using relationships between different types of events, reference data, and assets.
