Navixy IoT Logic API
Build and manage IoT data flows with the Navixy IoT Logic API. Connect devices, transform data in real time, and route processed telemetry to external systems.
IoT Logic is the data processing layer of the Navixy platform. It receives messages from connected devices, decodes and transforms them in real time, and delivers the results to Navixy or to an external system. Flows are normally built in a visual editor. The IoT Logic API exposes the same functionality programmatically, so flow configuration can live in your own code and deployment pipeline instead.
Use the API to:
Create, read, update, and delete flows, the pipelines that define how device data is processed.
Choose which devices feed each flow, and merge data from an external system into a device's stream.
Calculate new attributes from raw readings with Navixy IoT Logic Expression Language.
Route messages conditionally and send commands back to devices.
Deliver processed data to the Navixy platform, to an MQTT broker, or to an HTTP endpoint, standardized as Navixy Generic Protocol messages.
The API is built for developers and system integrators who manage device data at scale, who need transformations that standard platform features don't cover, or who want the same flows reproduced across several accounts.
How to use this documentation
This space documents the IoT Logic API in full. Choose the path below depending on who, or what, is reading.
For developers
Start with Key concepts below to see how flows and nodes fit together, then get access: Authentication explains which credential to use and links to how to obtain it.
Once you're authenticated, build something. Quick start: create your first flow creates a working flow with one request, with every parameter explained. From there, Guides walks through other common integrations, like sending data to an external MQTT broker or adding calculated attributes to the Navixy UI.
While you build, look things up in Technical reference (rate limits, error codes, validation rules), Flow object structure (the JSON shape of a flow), or the interactive API reference with its "Try it out" tool. Once a flow is running, WebSocket access to Data Stream Analyzer lets you watch the data it actually produces in real time.
For AI agents and LLMs
OpenAPI specification: the raw JSON specification for every endpoint, parameter, and schema. Treat this as the technical source of truth.
Navixy docs via MCP: connect to query this documentation interactively instead of parsing static pages.
AI flow generation guide: authoritative rules and canonical examples for generating IoT Logic flow JSON.
Underlying technologies
Both paths eventually touch the protocols IoT Logic is built on: Navixy Generic Protocol, the message format flows use, and Navixy IoT Logic Expression Language, the syntax for calculated attributes and conditions.
Key concepts
Navixy IoT Logic operates based on two fundamental components that work together to process device data:
Flows
A Flow is the foundation for all data logic in the product. It defines how data moves through stages of reception, enrichment, and transmission. Each flow consists of connected nodes that determine what happens to the data at each processing stage.
Key characteristics of flows:
Flows can be enabled or disabled to control data processing
Every flow requires at least one data source and one output endpoint
A device can belong to multiple flows at the same time. Flows that include the same device all process its data simultaneously, results merge rather than one flow excluding another. See Connector configuration for a case where this matters: two flows pushing the same attribute name to a shared device can silently overwrite each other
Flows process data in real-time as it arrives from devices
Nodes
Nodes are the functional elements of a flow, with each node handling a specific stage of the data lifecycle. Common node types include:
Data Source node: selects which devices send data into the flow, and can merge data from an external system into an existing device's stream through its connector fields
Initiate Attribute node: transforms and enriches data using Navixy IoT Logic Expression Language
Logic node: routes data based on conditions
Webhook node: sends HTTP POST requests to your external endpoint
Device action node: sends commands to devices
Output Endpoint node: transmits data using the Navixy Generic Protocol. This node can be configured to use different endpoint types:
Default endpoint: Pre-configured destination for sending data to the Navixy platform
MQTT endpoint: Configurable connection for sending data to third-party systems and services
Nodes are connected through transitions (edges) that define the path data follows through the flow.
How data moves through a flow
A single flow can stream data continuously to one destination while also branching conditionally to trigger side effects elsewhere. The diagram below shows both patterns together: a Data Source feeding an MQTT Output Endpoint directly, and the same source, through an Initiate Attribute node, feeding a Logic node that evaluates each message.
Because the Logic node evaluates every message independently, each branch can run several destinations in parallel instead of following one fixed path. Terminal nodes like Action and Webhook always run alongside an Output Endpoint, so triggering a side effect never costs you visibility into the underlying data in Data Stream Analyzer.
See Nodes for the full schema and options for every node type.
Next steps
To build a working flow in one request, see Quick start: create your first flow.
To send processed data to your own MQTT broker, see Sending device data to an external system.
To look up the fields of a specific node type, see Nodes.
To understand a formula error, see Formula error reference.
For questions and support, contact [email protected].
Last updated
Was this helpful?