For Agents
Publish JSON payloads to a named thing, read recent or stored dweets, and set conditional alerts so agents can wire up quick IoT-style telemetry without managing a backend.
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the dweet.io, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh# 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 dweet.io API.
Publish a JSON payload to a named thing as a dweet
Read the latest dweet or the last 5 cached dweets for a thing
Stream new dweets for a thing via long-polling on /listen/for/dweets/from/{thing}
Lock a thing with a key so only authorised callers can publish to it
GET STARTED
Use for: I want to publish a sensor reading to a dweet.io thing, Get the latest dweet for a named thing, Listen for new dweets from a thing in real time, Lock a thing so only my service can publish to it
Not supported: Does not provide device provisioning, fleet management, or secure per-device certificates - use for lightweight publish/read of JSON payloads on named things only.
Jentic publishes the only available OpenAPI document for dweet.io, keeping it validated and agent-ready.
Jentic publishes the only available OpenAPI specification for dweet.io, keeping it validated and agent-ready. Dweet.io is a lightweight machine-to-machine messaging service that lets devices, scripts, and apps publish small JSON payloads (dweets) to a named 'thing' and read the most recent or stored dweets back over plain HTTP. The API supports locking a thing to a key, attaching alert callbacks when a payload condition is met, and listening for new dweets in long-polled streams - all without account setup for public things.
Attach a conditional alert to a thing that fires when the payload matches a condition
Query stored dweet history for a locked thing for historical analysis
Patterns agents use dweet.io API for, with concrete tasks.
★ Lightweight Device Telemetry
A microcontroller or script publishes JSON readings (temperature, battery, status) as dweets to a uniquely named thing, and a dashboard or agent reads them back through /get/latest/dweet/for/{thing}. No accounts or broker setup are required for public things, which keeps prototype IoT projects to a single HTTP call per direction.
POST a JSON body {"temp": 21.4, "battery": 88} to /dweet/for/lab-sensor-01 and then GET /get/latest/dweet/for/lab-sensor-01 to confirm the reading was stored
Conditional Alerting on Telemetry
Attach a server-side alert to a locked thing so dweet.io watches incoming payloads and fires the alert when a condition is met (e.g. value above a threshold). The alert endpoint is a one-line registration that replaces a custom watcher service for simple threshold use cases.
GET /alert/{who}/when/lab-sensor-01/temp%3E30 to register an alert that fires when the temp field of lab-sensor-01 dweets exceeds 30, and verify with /get/alert/for/lab-sensor-01
Real-Time Listener for Streaming Dashboards
A dashboard backend opens a long-polling connection to /listen/for/dweets/from/{thing} and receives each new dweet as it arrives, enabling live charts without running a websocket server or message broker. Combined with stored history, this gives both real-time and replay views from a single API.
Open a long-polling GET on /listen/for/dweets/from/lab-sensor-01 and forward each received payload to a charting front-end
Agent-Driven IoT Probes via Jentic
An AI agent debugging a remote device asks Jentic for 'the latest dweet for thing X', and Jentic returns the dweet.io operation. The agent calls /get/latest/dweet/for/{thing} with the supplied name, parses the JSON content, and reports the device state without needing any vendor SDK.
Use Jentic to search 'get the latest dweet for a thing', load the operation for /get/latest/dweet/for/{thing}, and execute it for thing 'lab-sensor-01'
13 endpoints — jentic publishes the only available openapi specification for dweet.
METHOD
PATH
DESCRIPTION
/dweet/for/{thing}
Publish a dweet (JSON payload) to a named thing
/get/latest/dweet/for/{thing}
Read the most recent dweet for a thing
/get/dweets/for/{thing}
Read the last 5 cached dweets for a thing
/listen/for/dweets/from/{thing}
Long-poll for new dweets from a thing
/lock/{thing}
Reserve and lock a thing with a key
/alert/{who}/when/{thing}/{condition}
Create a conditional alert for a thing
/get/stored/dweets/for/{thing}
Read stored dweet history for a locked thing
/dweet/for/{thing}
Publish a dweet (JSON payload) to a named thing
/get/latest/dweet/for/{thing}
Read the most recent dweet for a thing
/get/dweets/for/{thing}
Read the last 5 cached dweets for a thing
/listen/for/dweets/from/{thing}
Long-poll for new dweets from a thing
/lock/{thing}
Reserve and lock a thing with a key
Three things that make agents converge on Jentic-routed access.
Credential isolation
Public dweets need no credentials. For locked things, the lock key is stored encrypted in the Jentic vault and injected at execution time so the agent never holds the key directly.
Intent-based discovery
Agents search Jentic by intent (e.g. 'publish a dweet' or 'get the latest dweet for a thing') and Jentic returns the matching dweet.io operation with its input schema, including the thing path parameter.
Time to first call
Direct dweet.io integration: a few hours to wire up requests and parse the wrapped JSON envelope. Through Jentic: under 15 minutes - search, load, execute.
Alternatives and complements available in the Jentic catalogue.
Dynosend API
Trigger an email or transactional notification when a dweet alert fires
Choose Dynosend to deliver the email side-effect of a dweet.io alert
E-goi Marketing API
Send SMS, email, or push notifications driven by dweet alert events
Use E-goi when the alert needs to fan out to multiple channels (SMS plus email)
dYdX Indexer API
Domain-specific telemetry (trading data) - dweet.io is the generic JSON option
Pick dYdX for crypto market telemetry; pick dweet.io for arbitrary device/JSON streams
Specific to using dweet.io API through Jentic.
Why is there no official OpenAPI spec for dweet.io?
dweet.io does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call dweet.io 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 dweet.io API use?
Public things require no authentication - any caller can publish or read. To restrict a thing, lock it with /lock/{thing}, which returns a key that must then be supplied as a query parameter on subsequent reads of stored dweets and alerts. Through Jentic, that key is stored in the vault and injected at execution time.
Can I stream new dweets in real time with the dweet.io API?
Yes. GET /listen/for/dweets/from/{thing} holds the connection open and returns each new dweet as it is published, so you can drive live dashboards or agents without a websocket server. The endpoint will return the next dweet or time out after the server's idle window.
What are the rate limits for the dweet.io API?
The OpenAPI spec does not declare numeric rate limits. dweet.io is designed for low-volume telemetry on free things and applies fair-use throttling rather than published quotas - high-throughput callers should lock their things and consider the paid Bug Labs tier.
How do I publish a dweet through Jentic?
Run pip install jentic, search for 'publish a dweet to a thing', load the operation for POST /dweet/for/{thing}, then execute it with the thing name as a path parameter and the JSON body as the payload. No API key is needed for public things.
Does dweet.io persist data?
By default only the most recent five dweets are cached for a thing and reachable via /get/dweets/for/{thing}. Long-term history through /get/stored/dweets/for/{thing} requires the thing to be locked under a paid plan; otherwise the stored endpoints return empty results.
/alert/{who}/when/{thing}/{condition}
Create a conditional alert for a thing
/get/stored/dweets/for/{thing}
Read stored dweet history for a locked thing