{"uid":"cap_ytouicilr6wF6WHQfQ2Mj","slug":"halowerk-iot-mesh-route-planner-617f1332","name":"Halowerk IoT Mesh Route Planner","description":"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.","url":"https://iot.halowerk.com/v1/mesh-route","method":"POST","headers":{},"bodySchema":{"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}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VDU1IzjT359ZCZrz3VUrE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes a deterministic shortest path through a caller-supplied directed or bidirectional weighted graph using non-negative edge costs.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"IoT sensor-to-gateway routing","prompt":"I have a mesh of IoT sensors and I need the cheapest path from 'temp-sensor-3' to 'cloud-gateway', here are the bidirectional links: temp-sensor-3→hub-A at cost 3, hub-A→hub-B at cost 5, hub-B→cloud-gateway at cost 2, temp-sensor-3→repeater-1 at cost 6, repeater-1→cloud-gateway at cost 1. What's the optimal route?"},{"title":"Logistics warehouse traversal planning","prompt":"Can you find the least-cost route from 'dock-entrance' to 'storage-zone-9' through my warehouse graph? The directed links are: dock-entrance→aisle-1 cost 10, aisle-1→junction-B cost 4, junction-B→storage-zone-9 cost 3, dock-entrance→aisle-2 cost 6, aisle-2→storage-zone-9 cost 9."},{"title":"Network topology failover path finding","prompt":"My primary route from 'edge-node-1' to 'core-router' is down — can you compute the shortest alternate path using these remaining links: edge-node-1→switch-A cost 2, switch-A→switch-C cost 8, edge-node-1→switch-B cost 5, switch-B→core-router cost 3, switch-A→core-router cost 10, all bidirectional?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:41:43.924Z","isFirstParty":false}