# Halowerk IoT Mesh Route Planner

> Halowerk IoT Mesh Route Planner is a paid API for AI agents from iot.halowerk.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-14).

Computes a deterministic shortest path through a caller-supplied directed or bidirectional weighted graph using non-negative edge costs.

## Facts

- Endpoint: POST https://iot.halowerk.com/v1/mesh-route
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-iot-mesh-route-planner-617f1332
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ytouicilr6wF6WHQfQ2Mj

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability halowerk-iot-mesh-route-planner-617f1332 -d '<json body>'
```

Example prompt: Find the shortest path from node 'sensor-A' to node 'gateway-Z' in my mesh network — the links are: sensor-A to relay-1 costs 4, relay-1 to gateway-Z costs 7, sensor-A to relay-2 costs 2, relay-2 to gateway-Z costs 5, all bidirectional.

## When to prefer this

Choose this endpoint when you have a static, caller-defined graph topology and need a deterministic, reproducible shortest-path computation. Ideal for IoT mesh routing simulation, logistics pathfinding, or any graph traversal problem where you supply all node and edge data yourself. Not suitable when you need live radio signal data, real-time network state, dynamic capacity reservation, or actual device configuration.

## Known failure modes

- No path exists between start and goal nodes — returns error or empty path
- Start or goal node not present in supplied node list or links — validation error
- Negative edge costs supplied — rejected as invalid input
- Graph exceeds 500 nodes or 10,000 links — request rejected with size limit error
- Malformed link objects missing required from/to/cost fields — schema validation failure

## How this service works

Computes a deterministic shortest path over caller-supplied directed or bidirectional links with non-negative costs. It does not measure live radio conditions, reserve capacity or push routes to devices.

## Output

Returns an ordered sequence of node identifiers representing the least-cost path from start to goal, along with the total accumulated edge cost. If no path exists, an appropriate error or empty result is returned.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "goal": {
   "type": "string",
   "maxLength": 64,
   "minLength": 1
  },
  "links": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "from",
     "to",
     "cost"
    ],
    "properties": {
     "to": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1
     },
     "cost": {
      "type": "number",
      "maximum": 1000000000,
      "minimum": 0
     },
     "from": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1
     },
     "bidirectional": {
      "type": "boolean",
      "default": true
     }
    },
    "additionalProperties": false
   },
   "maxItems": 10000,
   "minItems": 1
  },
  "nodes": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 64,
    "minLength": 1
   },
   "maxItems": 500,
   "minItems": 2,
   "uniqueItems": true
  },
  "start": {
   "type": "string",
   "maxLength": 64,
   "minLength": 1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-iot-mesh-route-planner-617f1332/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from iot.halowerk.com](https://www.zero.xyz/host/iot.halowerk.com/llms.txt)