--- title: "Update a Monitor" method: PUT path: "/skynet/monitor/{id}" tags: ["Tracking_Monitor"] --- # Update a Monitor `PUT /skynet/monitor/{id}` ## Path parameters - `id` string, required ## Query parameters - `key` string, 32 character alphanumeric string, required ## Request body - DtoUpdateMonitorInput - `description` string — Use this parameter to update the description of the monitor. - `geofence_ids` string[] — Use this parameter to update the geofences linked to the monitor by providing the geofence id as , separated strings. Geofences are geographic boundaries that can be used to trigger events based on an asset's location. - `meta_data` Metadata — Any valid json object data. Can be used to save customized data. Max size is 65kb. - `name` string — Use this parameter to update the name of the monitor. Users can add meaningful names to the monitors like "warehouse_exit", "depot_entry" etc. - `tags` string[] — Use this parameter to update the tags of the monitor. tags can be used for filtering monitors in the *Get Monitor List* operation. They can also be used for easy identification of monitors. Using this parameter overwrites the existing tags of the monitor. Please note that valid tags are strings, consisting of alphanumeric characters (A-Z, a-z, 0-9) along with the underscore ('_') and hyphen ('-') symbols. - `type` 'enter' | 'exit' | 'enter_and_exit' | 'speeding' | 'idle' — Use this parameter to update the type of the monitor. The monitor will be able to detect the specified type of activity and create events for eligible asset. A monitor can detect following types of asset activity: - enter: The monitor will create an event when a linked asset enters into the specified geofence. - exit: The monitor will create an event when a linked asset exits the specified geofence. - enter_and_exit: The monitor will create an event when a linked asset either enters or exits the specified geofence. - speeding: The monitor will create an event when a linked asset exceeds a given speed limit. - idle: The monitor will create an event when a linked asset exhibits idle activity. Please note that assets and geofences can be linked to a monitor using the match_filter and geofence_config attributes respectively. - `match_filter` MonitorMatchFilterUpdateRequest — Use this object to update the attributes of the monitor. Please note that using this property will overwrite the existing attributes that the monitor might be using currently to match any asset(s). - `include_all_of_attributes` object — A string type dictionary object to specify the attributes. Only the assets having all of the attributes added to this parameter will be linked to this monitor. Once an asset is linked to a monitor, the monitor will be able to create events for that asset whenever an activity specified in type is detected. Multiple attributes should be separated by a comma ,. Please note that this parameter can not be used in conjunction with include_any_of_attributes. Also, the maximum number of key:value pairs that this parameter can take is 100 and the overall size of the match_filter object should not exceed 65kb. - `include_any_of_attributes` object — A string type dictionary object to specify the attributes. The assets having at least one of the attributes added to this parameter will be linked to this monitor. Once an asset is linked to a monitor, the monitor will be able to create events for that asset whenever an activity specified in type is detected. Multiple attributes should be separated by a comma ,. Please note that this parameter can not be used in conjunction with include_all_of_attributes. Also, the maximum number of key:value pairs that this parameter can take is 100 and the overall size of the match_filter object should not exceed 65kb. - `idle_config` object — idle_config is used to update the constraints for creating idle events. When an asset associated with the monitor has not moved a given distance within a given time, the Live Tracking API can create events to denote such instances. Please note that this object is mandatory when the monitor type is idle. - `distance_tolerance` number, required — Use this parameter to update the distance threshold that will be used to determine if the asset was idle or not. When the asset, within time_tolerance duration, moves less than the value for this parameter, the monitor creates an idle event against the asset. The distance_tolerance should be provided in meters. Please note distance_tolerance is mandatory when idle_config attribute is used. - `time_tolerance` integer — Use this parameter to update the time duration for which the monitor would track the distance covered by an asset before triggering an idle event. The time_tolerance should be provided in milliseconds. If the distance covered by the asset during a time_tolerance is less than that specified in distance_tolerance the asset will be assumed to be idle. This attribute along with distance_tolerance parameter can be used to control the "sensitivity" of the monitor with respect to idle alerts. It is recommended to use these properties with appropriate values to trigger genuine idle events. The appropriate values might depend on the traffic conditions, nature of operations that the asset is involved in, type of asset and other factors. - `speeding_config` object — speeding_config is used to update the tolerance values for creating over-speed events. When an asset associated with a monitor is traveling at a speed above the given limits, Live Tracking API creates events to indicate such instances. Please note that this object is mandatory when the monitor type is speeding. - `time_tolerance` integer — Use this parameter to update the time tolerance before triggering an event. Adding a tolerance would make the Tracking service wait for the specified time before triggering the event. Consequently, an event is triggered only when the time for which the asset has been over-speeding continuously, exceeds the configured tolerance time. The unit for this parameter is milliseconds. It can be seen that this attribute is used to control the "sensitivity" of the monitor with respect to speed alerts. Higher the value of time_tolerance the less sensitive the monitor would be to instances of over-speeding. Conversely, if 'time_tolerance' is set to 0, the monitor will be extremely sensitive and will create an event as soon as tracking information with a speed value greater than the specified limit is received. - `customer_speed_limit` string — Use this parameter to update the speed limit value that the monitor will use to create events, depending on the time_tolerance value. The speed limit should be specified in meters per second. Please note that customer_speed_limit is mandatory when use_admin_speed_limit is false. However, when use_admin_speed_limit is true, customer_speed_limit is ineffective. - `use_admin_speed_limit` boolean — Use this attribute to update which speed limit values will be used by the monitor. When use_admin_speed_limit is true, the administrative speed limit of the road on which the asset is located, is used to generate events when the asset’s tracked speed exceeds it. Whereas, when use_admin_speed_limit is false, the customer_speed_limit specified will be used to generate events when the asset's tracked speed exceeds it. Please note that if use_admin_speed_limit is false, customer_speed_limit is mandatory, otherwise when use_admin_speed_limit is true then customer_speed_limit is ineffective. - `geofence_config` object — geofence_config is used to update the set of geofences linked to the monitor for creating enter or exit type of events based on the asset's location. Please note that this object is mandatory when the monitor type belongs to one of enter, exit or enter_and_exit. - `geofence_ids` string[], required — Use this array to update the geofence IDs that should be linked to the monitor. Please note geofence_ids are mandatory when using the geofence_config attribute. ## Response `200` OK - DtoSimpleResp - `message` string — Displays the error message in case of a failed request. If the request is successful, this field is not present in the response. - `status` string — A string indicating the state of the response. On successful responses, the value will be Ok. Indicative error messages are returned for different errors. See the [API Error Codes](#api-error-codes) section below for more information. ## Other responses - `400` — Bad Request - `500` — Internal Server Error --- [API](https://skmtc.net/nextbillion-ai/apis/one-spec-service.md) · [All operations](https://skmtc.net/nextbillion-ai/apis/one-spec-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nextbillion-ai/one-spec-service/versions/b647f1808dda/schema)