dweet.io

Name: dweet.io API
Brand: dweet.io
Availability: InStock

★ Only Publicly Available OpenAPI DocumentIOTSensor Datanone13 EndpointsREST

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.

Install Jentic One Beta

Connect the dweet.io to your agent

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.

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 | sh

Step 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 instance

Jentic 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.

Capabilities

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

Start building with dweet.io API

Explore with Jentic

View OpenAPI Document

Use Cases

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'

Key Endpoints

13 endpoints — jentic publishes the only available openapi specification for dweet.

METHOD

PATH

DESCRIPTION

POST

/dweet/for/{thing}

Publish a dweet (JSON payload) to a named thing

GET

/get/latest/dweet/for/{thing}

Read the most recent dweet for a thing

GET

/get/dweets/for/{thing}

Read the last 5 cached dweets for a thing

GET

/listen/for/dweets/from/{thing}

Long-poll for new dweets from a thing

GET

/lock/{thing}

Reserve and lock a thing with a key

GET

/alert/{who}/when/{thing}/{condition}

Create a conditional alert for a thing

GET

/get/stored/dweets/for/{thing}

Read stored dweet history for a locked thing

POST

/dweet/for/{thing}

Publish a dweet (JSON payload) to a named thing

GET

/get/latest/dweet/for/{thing}

Read the most recent dweet for a thing

GET

/get/dweets/for/{thing}

Read the last 5 cached dweets for a thing

GET

/listen/for/dweets/from/{thing}

Long-poll for new dweets from a thing

GET

/lock/{thing}

Reserve and lock a thing with a key

Why Jentic?

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.

FAQs

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.