Operation is used to create new streetlight. Available from product version 3.2.2.
Token issued for API consumer.
Streetlight to be created
Additional information about warranty fix details. Available from product version 2025.3.
Streetlight group change date
Streetlight group cleaning date
Installation date
Installation height
Installation year
Streetlight lamp change date
Streetlight lamp dimmer change date. Deprecated since product version 2026.2 — use dimming_profile instead.
Lamp position
Streetlight lamp warranty expiration date
Lamp warranty period length
Streetlight latest warranty fix date. Available from product version 2025.3.
Streetlight change date
Streetlight checkout date
Streetlight connection change date
Streetlight warranty expiration date
Streetlight warranty period length
Geographical location
Luminaire angle. Available from product version 3.2.22
Luminaire product code. Available from product version 2026.2.
Luminous flux
mapper name
mapping date
List of phase connection values
Connection
purlin angle
Purlin diameter
Reflector position
Remarks. Available from product version 3.2.14.
Streetlight riser change date
unknown
Streetlight choker type id
Streetlight color rendering index. Available from product version 3.2.20.
Streetlight color temperature type id
Streetlight contractor id
Streetlight control device type id. Available from product version 3.2.20.
Luminaire-level control interface type id. Available from product version 2026.2.
Streetlight control profile type id. Available from product version 3.2.20.
Configured dimming profile type id. Available from product version 2026.2.
Downstream device attached to a streetlight (write/input format). Available from product version 2026.2.
Device identification string
Device installation date
Warranty period in months
Device color id (TxtConstant with groupname COLOR)
Downstream device type id (TxtConstant with groupname EL_LIGHT_DOWNSTREAM_DEVICE)
Height accuracy id
Streetlight IK class type id. Available from product version 3.2.20.
Streetlight installation type id
Streetlight IP class type id. Available from product version 3.2.20.
Streetlight lamp dimmer type id. Deprecated since product version 2026.2 — use dimming_profile instead.
Streetlight lamp dimming class id. Deprecated since product version 2026.2 — use dimming_profile instead.
Streetlight lamp manufacturer id (field hidden in UI but kept for compatibility). Deprecated since product version 2026.2.
Streetlight lamp model id
Light power type id (legacy field name, maps to same field as light_power). Deprecated since product version 2026.2.
Streetlight lamp shade type id
Streetlight lamp socket type id
Light source type id (legacy field name, maps to same field as light_source_type). Deprecated since product version 2026.2.
Streetlight lamp usage class id
Streetlight condition id
Streetlight connection type id
Streetlight distribution type id
Streetlight manufacturer id
Light power type id - primary field name since product version 2026.2
Light source type id - primary field name since product version 2026.2
Streetlight specifier type id
Streetlight lightning class id
Location accuracy id
Mapping method id
Network area id
Owner id
Plan id
Streetlight pole id
Streetlight protection type id. Available from product version 3.2.20.
Streetlight purlin holder type id
Streetlight connection phase type id
Streetlight riser cable type id
Side device attached to a streetlight (write/input format). Available from product version 2026.2.
Device identification string
Device installation date
Warranty period in months
Device color id (TxtConstant with groupname COLOR)
Side device type id (TxtConstant with groupname EL_LIGHT_SIDE_DEVICE)
Upstream device attached to a streetlight (write/input format). Available from product version 2026.2.
Device identification string
Device installation date
Warranty period in months
Device color id (TxtConstant with groupname COLOR)
Upstream device type id (TxtConstant with groupname EL_LIGHT_UPSTREAM_DEVICE)
Usage state id
Warranty fix type id. Available from product version 2025.3.
A created Streetlight
{
"additional_information": null,
"choker": null,
"color_rendering_index": null,
"color_temperature": null,
"contractor": null,
"control_device": null,
"control_interface": null,
"control_profile": null,
"creation_date": "2019-05-03T15:28:22.508Z",
"creator": "api@keypro.fi",
"dimming_profile": null,
"downstream_device": {
"color": 500020,
"downstream_device": 500030,
"identification": "DN-001",
"install_date": "2026-01-15",
"warranty_period": 12
},
"group_change_date": null,
"group_cleaning_date": null,
"height_accuracy": null,
"id": 1989,
"ik_class": null,
"installation_date": null,
"installation_height": null,
"installation_type": null,
"installation_year": null,
"ip_class": null,
"lamp_change_date": null,
"lamp_dimmer": null,
"lamp_dimmer_change_date": null,
"lamp_dimming_class": null,
"lamp_manufacturer": null,
"lamp_model": null,
"lamp_position": null,
"lamp_power": 300270,
"lamp_shade": null,
"lamp_socket": null,
"lamp_type": 300750,
"lamp_usage_class": null,
"lamp_warranty_exp_date": null,
"lamp_warranty_period": null,
"latest_warranty_fix_date": null,
"light_change_date": null,
"light_checkout_date": null,
"light_condition": null,
"light_connection": null,
"light_connection_change_date": null,
"light_distribution": null,
"light_manufacturer": null,
"light_power": 300270,
"light_source_type": 300750,
"light_specifier": null,
"light_warranty_exp_date": null,
"light_warranty_period": null,
"lightning_class": null,
"location": null,
"location_accuracy": null,
"luminaire_angle": null,
"luminaire_product_code": null,
"luminous_flux": null,
"mapper": null,
"mapping_date": null,
"mapping_method": null,
"network_area": null,
"owner": null,
"phase_values": [
{
"phase_1": 0,
"phase_1_saving": 0,
"phase_2": 0,
"phase_2_saving": 0,
"phase_3": 0,
"phase_3_saving": 0
}
],
"plan": null,
"pole": null,
"protection": null,
"purlin_angle": null,
"purlin_diameter": null,
"purlin_holder": null,
"purlin_phase": null,
"reflector_position": null,
"remarks": "",
"riser": null,
"riser_change_date": null,
"side_device": null,
"survey_amount": null,
"update_date": "2019-05-03T15:28:22.508Z",
"updated_by": "api@keypro.fi",
"upstream_device": {
"color": 500020,
"identification": "UP-001",
"install_date": "2026-01-15",
"upstream_device": 500010,
"warranty_period": 24
},
"usage_state": 303330,
"warranty_fix_type": null
}Additional information about warranty fix details. Available from product version 2025.3.
creation date and time
object creator
Streetlight group change date
Streetlight group cleaning date
Primary key
Installation date
Installation height
Installation year
Streetlight lamp change date
Streetlight lamp dimmer change date. Deprecated since product version 2026.2 — use dimming_profile instead.
Lamp position
Streetlight lamp warranty expiration date
Lamp warranty period length
Streetlight latest warranty fix date. Available from product version 2025.3.
Streetlight change date
Streetlight checkout date
Streetlight connection change date
Streetlight warranty expiration date
Streetlight warranty period length
Geographical location
Luminaire angle. Available from product version 3.2.22
Luminaire product code. Available from product version 2026.2.
Luminous flux
mapper name
mapping date
List of phase connection values
Connection
Streetlight cable connection phase 1
Streetlight cable connection phase 1 saving
Streetlight cable connection phase 2
Streetlight cable connection phase 2 saving
Streetlight cable connection phase 3
Streetlight cable connection phase 3 saving
purlin angle
Purlin diameter
Reflector position
Remarks. Available from product version 3.2.14.
Streetlight riser change date
unknown
last update date time
object last updater
Streetlight choker type id
Streetlight color rendering index. Available from product version 3.2.20.
Streetlight color temperature type id
Streetlight contractor id
Streetlight control device type id. Available from product version 3.2.20.
Luminaire-level control interface type id. Available from product version 2026.2.
Streetlight control profile type id. Available from product version 3.2.20.
Configured dimming profile type id. Available from product version 2026.2.
Downstream device attached to a streetlight (write/input format). Available from product version 2026.2.
Device identification string
Device installation date
Warranty period in months
Device color id (TxtConstant with groupname COLOR)
Downstream device type id (TxtConstant with groupname EL_LIGHT_DOWNSTREAM_DEVICE)
Height accuracy id
Streetlight IK class type id. Available from product version 3.2.20.
Streetlight installation type id
Streetlight IP class type id. Available from product version 3.2.20.
Streetlight lamp dimmer type id. Deprecated since product version 2026.2 — use dimming_profile instead.
Streetlight lamp dimming class id. Deprecated since product version 2026.2 — use dimming_profile instead.
Streetlight lamp manufacturer id (field hidden in UI but kept for compatibility). Deprecated since product version 2026.2.
Streetlight lamp model id
Light power type id (legacy field name, maps to same field as light_power). Deprecated since product version 2026.2.
Streetlight lamp shade type id
Streetlight lamp socket type id
Light source type id (legacy field name, maps to same field as light_source_type). Deprecated since product version 2026.2.
Streetlight lamp usage class id
Streetlight condition id
Streetlight connection type id
Streetlight distribution type id
Streetlight manufacturer id
Light power type id - primary field name since product version 2026.2
Light source type id - primary field name since product version 2026.2
Streetlight specifier type id
Streetlight lightning class id
Location accuracy id
Mapping method id
Network area id
Owner id
Plan id
Streetlight pole id
Streetlight protection type id. Available from product version 3.2.20.
Streetlight purlin holder type id
Streetlight connection phase type id
Streetlight riser cable type id
Side device attached to a streetlight (write/input format). Available from product version 2026.2.
Device identification string
Device installation date
Warranty period in months
Device color id (TxtConstant with groupname COLOR)
Side device type id (TxtConstant with groupname EL_LIGHT_SIDE_DEVICE)
Upstream device attached to a streetlight (write/input format). Available from product version 2026.2.
Device identification string
Device installation date
Warranty period in months
Device color id (TxtConstant with groupname COLOR)
Upstream device type id (TxtConstant with groupname EL_LIGHT_UPSTREAM_DEVICE)
Usage state id
Warranty fix type id. Available from product version 2025.3.
There was an error in request. Usually field validation failed.
{
"type": [
"This field is required."
],
"usage_state": [
"This field is required."
]
}Fields which failed validation
List of validation errors for this fieldname
Validation error
Authentication credentials are missing or invalid
{
"details": "Authentication credentials were not provided"
}Standard error response payload
Detailed description of error