For Agents
Register IoT devices, list the fleet, and ingest telemetry through MerrenIO's three-endpoint device-management API.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the MerrenIO API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with MerrenIO API.
Register a new IoT device against the MerrenIO tenant for tracking and telemetry
List the current fleet of registered devices for inventory and dashboards
Ingest telemetry payloads from devices into the MerrenIO backend
GET STARTED
Use for: I need to register a new IoT device with MerrenIO, List all devices currently registered in the tenant, Send telemetry from a sensor to MerrenIO, Check the size of our connected device fleet
Not supported: Does not handle firmware OTA, device shadows, alerting, or analytics dashboards — use for MerrenIO device registration, fleet listing, and telemetry ingestion only.
Jentic publishes the only available OpenAPI specification for MerrenIO API, keeping it validated and agent-ready. MerrenIO offers a lightweight IoT backend for registering connected devices, listing the current device fleet, and ingesting telemetry from those devices. The API is intentionally small, exposing the three primitives a device gateway or operations dashboard needs to bootstrap onboarding flows and time-series ingestion without standing up a full IoT platform.
Bootstrap device onboarding workflows from a gateway or provisioning script
Feed an operations dashboard with the latest device roster on demand
Patterns agents use MerrenIO API for, with concrete tasks.
★ Device Fleet Onboarding
Operations teams rolling out new IoT hardware can register each device with POST /devices and then verify the inventory with GET /devices. This pattern fits manufacturing rollouts, smart-building installs, and field deployments where the registration step happens at install time and the inventory query feeds operations dashboards.
Call POST /devices with the new gateway's identifier and metadata, then GET /devices to confirm the registration succeeded.
Telemetry Ingestion
Connected devices can stream readings to the MerrenIO backend via POST /telemetry. The endpoint accepts payloads from sensors, gateways, or edge functions, supporting use cases like environmental monitoring, equipment health tracking, and asset utilisation reporting where periodic ingestion drives downstream analytics.
Call POST /telemetry with the device ID and a JSON payload of the latest sensor readings.
Operations Dashboard Data Source
Internal dashboards that show fleet status can call GET /devices on a schedule to refresh the device roster. This avoids running a separate inventory store and keeps the dashboard aligned with whatever the MerrenIO backend currently knows about, which is the source of truth for registration.
Call GET /devices and render the response as a fleet-status table in the operations dashboard.
Agent-Driven IoT Operations
An AI agent embedded in an operations workflow can take instructions like 'register the new gateway in zone 4' or 'upload last hour's readings' and call MerrenIO via Jentic. The agent searches Jentic for the device or telemetry operation, loads the schema, and posts the request without writing custom MerrenIO client code.
Search Jentic for 'register an IoT device with MerrenIO', load POST /devices, and execute it with the gateway's identifier and zone metadata.
3 endpoints — jentic publishes the only available openapi specification for merrenio api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/devices
List registered IoT devices
/devices
Register a new IoT device
/telemetry
Ingest a device telemetry payload
/devices
List registered IoT devices
/devices
Register a new IoT device
/telemetry
Ingest a device telemetry payload
Three things that make agents converge on Jentic-routed access.
Credential isolation
MerrenIO API keys are stored in the Jentic vault. Agents authenticate with a scoped Jentic token and Jentic injects the Authorization header at the gateway, so the raw IoT key is never exposed to the agent.
Intent-based discovery
Agents search Jentic with intents like 'register an IoT device' or 'send telemetry to MerrenIO' and receive the matching POST /devices or POST /telemetry operation with its request schema.
Time to first call
Direct MerrenIO integration: half a day for auth, registration, and telemetry posts. Through Jentic: under an hour.
Alternatives and complements available in the Jentic catalogue.
Specific to using MerrenIO API through Jentic.
Why is there no official OpenAPI spec for MerrenIO API?
MerrenIO does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call MerrenIO API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the MerrenIO API use?
MerrenIO uses an API key sent in the Authorization header. Through Jentic, that key is stored in the credential vault and the agent calls the API with a scoped Jentic token, so the raw MerrenIO key never enters the agent context.
Can I send a batch of telemetry readings in one call?
POST /telemetry accepts a JSON payload representing one or more device readings. For very large batches the recommended pattern is to chunk by device and post in parallel rather than aggregating all devices into a single body, which keeps the per-request size manageable.
What are the rate limits for the MerrenIO API?
The OpenAPI spec does not declare rate limits. MerrenIO applies tenant-level throttling on the production endpoint; high-frequency telemetry should batch readings per device and back off on 429 responses rather than streaming one reading per HTTP call.
How do I register a device with MerrenIO through Jentic?
Install the SDK with pip install jentic, search for 'register an IoT device with MerrenIO', load the POST /devices operation, and execute it with the device identifier and metadata. Jentic handles authentication and posts to api.merren.io.
How do I get the current list of MerrenIO devices?
Call GET /devices. The endpoint returns the current registered fleet for the authenticated tenant, suitable for refreshing operations dashboards or reconciling against a separate inventory system.