Place for information about telematics hub updates.

We supported special streaming protocol called nis . This protocol is used in Russia only, and although it is very stupidly designed - HTTP/SOAP based with just one message per HTTP request - it is quite popular on CIS space for inter-servers communications. Feel free to use it.

nis streaming protocol was updated to send values for Digital inputs, outputs and Analog inputs. The number of streamed Analog inputs is limited up to 8 for nis and wialon_retranslator streams.

We have removed deprecated fields " ident " and " phone " from the devices REST API. These fields was left for backward compatibility for a few months. In addition, we have removed old stream subscriptions REST API methods also marked as deprecated a few months ago. More details are placed in this article: https://flespi.com/blog/sync-up-with-changes-in-the-flespi-device-api

Platform has changed the way it accumulating logs when operating under subaccounts hierarchy . Say you have account root with subaccount sub and it branched another subaccount subsub . Tree looks like this: root<=sub<=subsub. Now imagine that you have log message for the subsub account, for example device was connected. Before the update : logs both in realtime (subscribing to flespi/logs/#) and in history mode (accessible via REST ) where placed by the system into an account subsub and all its parents: sub and root . Thus when operating with large volumes we have quite a big storage size of root top-account basically multiplied by the number of subbaccounts it has. After the update : the log message will be stored exactly and only at the account where it was generated. E.g if you have device or channel that belong to some subaccount you can access log messages for this entity only from its account. This is applied to both REST and MQTT. Toolbox was modified accordingly and now has account selector whenever you have some flespi accounts to switch between.

We increased telemetry expiration time up to 370 days.

We've added the "status" field for each device setting. It's indicating the source of the current setting value (if available) and the flespi platform intention to read the new current value or apply the pending setting value. The full documentation is available here: https://flespi.io/docs/#/gw/!/devices

Platform update affects devices with ident collisions. Collision occurs when two or more devices have the same ident, device type and share a common channel. The device with the lowest identifier remains unlocked, other devices will be blocked using the "bad configuration" code.

adsa We have reverted update until some problems being solved.

Next Monday, on October 14, we will install an update with the small change in our Telematics Gateway REST API. Once installed, the devices creation method ( POST , https://flespi.io/docs/#/gw/!/devices/post_devices ) will require the " device_type_id " and " configuration " fields to be specified. Also, the " configuration " object for all device types will require an " ident " field. Please review your integrations and correct them to always include such fields when you're creating devices. If you have any questions, please contact us in the chat embedded in the flespi.io panel or on forum.flespi.com

adsa The problems were resolved and the update was installed.

[Changelog] flespi telematics hub

adsa

We have introduced the ability to assign geofences to individual devices, simplifying configurations on top of flespi. Now, each device can have its own unique set of geofences. For example, a plugin can combine its own assigned set of geofences with the device's geofence set.

GET, POST, DELETE /gw/devices/{device-selector}/geofences/{geofence-selector}

We will also support such assignments for calculators.

adsa

We have added an alternative set of parameters to the hit test geofences REST API method.

The first set tests whether the coordinate hits the selected geofences.

GET /gw/geofences/{geofences-selector}/hittest
{
 "lat": 0,
 "lon": 0
}

The second set returns a set of geofences that are within the specified boundary.

GET /gw/geofences/{geofences-selector}/hittest
{
 "max_lat": 0,
 "max_lon": 0,
 "min_lat": 0,
 "min_lon": 0
}

adsa

We've implemented some changes to CDNs:

You can attach custom metadata to CDN.
You can grant access to the CDNs to subaccounts.

shal

We enhanced device media transparency with new log message (event code = 28) that is published when the media file is accessed via HTTP.

shal

For those who are using method POST /gw/devices/{device-id}/calculate we have important change that requires from your an action.

There are 2 variants how to trigger this API call and provide to flespi configuration for calculation:

Providing all configuration for counters, selectors, validators directly in the REST API call.
Providing calc_id (ID of calculator) from which this selectors, counters, validators will be used during the actual calculation.

We are deprecating a second variant of data provisioning in this API call - when calculation configuration is provided via referenced calc_id. On January 14, 2025 an attempt to use this method with calc_id in the parameters will return an error. From today when you are calling this REST API method with second variant configuration it adds deprecated warning into REST API call response.

Please modify your integration and provide into this API method all selectors, counters and validation configuration directly. You can add a GET /gw/calculators/{calc_id} call to retrieve calculator configuration beforehand and supplying its parameters to the calculation call. Or just hard code the configuration to calculate in the code directly.

adsa

Upcoming Update (Scheduled for April 1st, 2025)

The following API methods will now require the data parameter as a mandatory field:

DELETE /storage/cdns/files
DELETE /storage/containers/messages
DELETE /gw/devices/media

Action Required

Update your API calls to ensure they include the required data payload.
Review integrations and webhooks that interact with these endpoints.

If you have any questions or need support, please reach out to our development team.

YuryAheichyk

For custom user-data ingestion protocols (such as http, mqtt, etc) following device-specific parameters are now automatically removed from channel messages:

device.id
device.type.id
device.name

Previously only channel-specific parameters (ident, peer, protocol.id etc) were automatically replaced with their actual values.

These are reserved system parameters in flespi and should not be present in custom message payloads.

shal

In assets that are designed to track drivers, trailers, etc and available now in experimental mode we renamed last_interval asset property to last to keep naming in sync with devices and calculators. Please update your integration in case you are already started to use it.

adsa

Important: Upcoming Change to Parameter Naming Validation

We've identified an inconsistency in how flespi handles parameter names containing minus signs (-) that we need to address.

Current Situation:

Device messages currently accept parameter names with minus signs (e.g., "engine-rpm", "custom-value")
However, device telemetry doesn't support minus signs in parameter names
This causes parameters with minus signs to be missing from telemetry, even though they appear in messages

What's Changing:
To ensure consistency across the platform, we will synchronize the validation rules. After this update, device messages will no longer accept parameter names containing minus signs.

Impact:

Any existing parameters with minus signs will need to be renamed
This affects custom parameters sent via HTTP/MQTT channels or created by plugins
Standard flespi parameters are not affected (they already follow the correct naming convention)

Recommended Actions:

Review your device configurations and custom integrations for parameter names containing minus signs
Replace minus signs with underscores (e.g., "engine-rpm" → "engine_rpm") or dots for hierarchy (e.g., "engine-rpm" → "engine.rpm")
Update any applications or scripts that send data to flespi with the new parameter names
If using plugins that create parameters with minus signs, update their configuration

Best Practice Reminder:
Parameter names should only contain:

letters (a-z)(A-Z)
Numbers (0-9)
Dots (.) for hierarchy
Underscores (_) as separators

This change ensures that all parameters visible in messages will also be available in telemetry, providing a more consistent and reliable experience.

adsa

The maximum webhook response size has been reduced from 32MB to 8MB, and responses exceeding this limit will now interrupt processing.

shal

We added "blacklisted IP" field for all protocols using which you may block certain IP networks from posting messages to your channel.

And we introduced new limit on number of UDP packets per minute channel can pass through.

kial

We've added an optional "meta":{...} field for commands sent through device commands queue or in real-time mode. More details in kb article

shal

We added to assets the possibility to track currently active interval via MQTT topic flespi/state/gw/assets/{id}/active. This enhances assets application for assignments planning purposes.

We also modified recently added device commands customization by renaming the field from metadata to meta in the API call for naming consistency with other flespi systems.

adsa

Maximum nesting level for webhook message JSON payloads is now limited to 16 levels.

adsa

We discovered an incorrect response format in the POST /gw/devices/{dev-selector}/messages REST API method. The current response contains an unnecessary nested array within the result array, which deviates from standard flespi API response format.

Current (Incorrect) Response Format:

{
  "result": [
    [
      {
        "device_id": 123,
        "msgs_count": 5
      }
    ]
  ],
  "errors": []
}

New (Correct) Response Format:

{
  "result": [
    {
      "device_id": 123,
      "msgs_count": 5
    }
  ],
  "errors": []
}

What's Changing:

The secondary nested array will be removed from the response
Each device's result will be a direct object within the result array
This aligns the response format with other flespi REST API methods

Timeline:

Announcement Date: October 2, 2025
Implementation Date: November 1, 2025 (30 days from announcement)

Action Required:
If your application parses the response from POST /gw/devices/{dev-selector}/messages, please update your code to handle the corrected response format before November 1, 2025.

Note: This change only affects the response structure. Request format and API functionality remain unchanged.

adsa

We've added messages and traffic fields to device REST API and MQTT retained topics.

messages - Message count received in the last minute
traffic - Traffic in bytes received/sent in the last minute

shal

According to recent announce device media traffic (video/photo/tacho uploads) is now again counting towards channel traffic limit.

This affects all active users of video telematics functionality in flespi and may require plan upgrade or distributing devices across multiple channels to manage traffic effectively.

When channel traffic limits are exceeded, the platform now implements smart blocking:

Identifies the most active devices (by traffic volume in the last minute)
Blocks only the minimal number of devices needed to bring traffic below limits
Blocked devices are automatically unblocked after 1 minute

As a part of this update we removed legacy media_traffic field from connection logs and channel properties.

shal

We extended the device commands queue API with three new optional fields that provide fine-grained control over how queued commands are executed:

priority — defines the execution order of commands in the queue. Commands with higher priority values are picked for execution first, regardless of when they were added. This is useful when you need to ensure critical commands (like engine immobilization) are processed before routine configuration updates.

max_attempts — limits the number of delivery attempts before the command is rejected. An attempt is counted when the device doesn't respond or something goes wrong during delivery. Once the limit is reached, the command moves to commands-result with failed status. Default behavior remains unchanged for commands without this field.

condition — a flespi expression evaluated against current device telemetry before each execution attempt. The command stays in queue until the condition becomes true or the command expires. You can use metadata() to access device metadata and geofences() to check assigned geofences in the condition expression.

YuryAheichyk

Video Streaming: HTTP-FLV support

Added support for HTTP-FLV video streaming from devices. In addition to the existing HLS streaming, devices can now stream video in FLV format, which provides significantly lower latency (1-2 seconds vs 5-10 seconds for HLS) by delivering a continuous video stream directly to the client without segment buffering.

Device log changes: "mediastream from device started" (event_code:308)

The log message reported when a media stream starts has been updated with the following field changes:

mediastream (new) — indicates the stream format: "hls" or "flv"
url (new) — contains the full URL for accessing the stream

Deprecation notice: the "hls" field from "mediastream from device started" (event_code:308) log will be removed on March 26, 2026

YuryAheichyk

request_video command result format change

The request_video device command result format will be updated on April 3, 2026.

Some devices may send multiple media files in response to a single request_video command. To support this, the response field in the command result will change from a JSON object to a JSON array.

Old format (object):

{
  "result": true,
  "response": {
    "url": "https://media.flespi.io/...",
    "uuid": "...",
    "mime": "video/mp4",
    "name": "video.mp4",
    "size": 12345,
    "created": 1731390161,
    "meta": {
      "channel": 1,
      "type": "video",
      "video_codec": "h264"
    }
  }
}

New format (array):

{
  "result": true,
  "response": [
    {
      "url": "https://media.flespi.io/...",
      "uuid": "...",
      "mime": "video/mp4",
      "name": "video.mp4",
      "size": 12345,
      "created": 1731390161,
      "meta": {
        "channel": 1,
        "type": "video",
        "video_codec": "h264"
      }
    }
  ]
}

If your integration relies on the response field of request_video command results, please update your code to handle a JSON array in addition to of a single object.