Integration

REST API v1

Platform agent telemetry and tenant workload APIs. Site hosts do not use this API. Data center operators and WeAD platform services only. Base: https://homecloud.wead.live

Node Endpoints (data center agent · platform)

Called by agents in data-center-funded, locked Data House units — provisioned at install. Never exposed to site hosts.

Method	Endpoint	Description
POST	/api/v1/nodes/register	Register new edge node
POST	/api/v1/nodes/{id}/heartbeat	Ingest telemetry → score + class
GET	/api/v1/nodes	List fleet with latest metrics
GET	/api/v1/nodes/{id}	Node detail + 50-point history

Workload Endpoints

Method	Endpoint	Description
POST	/api/v1/workloads	Queue workload job
POST	/api/v1/workloads/{id}/assign	Auto-route to optimal node
GET	/api/v1/workloads	List recent workloads

Example — Submit & Assign

$ curl -X POST https://homecloud.wead.live/api/v1/workloads \
  -H "Content-Type: application/json" \
  -d '{"kind":"inference","bandwidth_class":"B","payload":{"model":"llama-3-8b"}}'

$ curl -X POST https://homecloud.wead.live/api/v1/workloads/wl_abc123/assign

→ { "workload_id": "wl_abc123", "assigned_node_id": "node_…", "status": "assigned" }

Health Check

GET /health
→ { "ok": true, "service": "homecloud-control", "version": "0.1.0" }

Machine-readable schema: /docs (OpenAPI 3.0)

OpenAPI /docs