REST API Reference

Authentication uses HTTP Basic Auth (username/password from .env). Read endpoints require no auth.

---

READ 30 req/min · no auth

Method	Endpoint	Description
GET	/api/system_status	System summary + ROS connection status
GET	/api/nodes	All registered nodes
GET	/api/nodes/<id>	Single node detail
GET	/api/failures	Full failure history
GET	/api/nodes/<id>/logs	Log lines filtered for node
GET	/api/tasks	Task status dict
GET	/health	Health check (rate-limit exempt)

WRITE 10 req/min · Basic Auth required

Method	Endpoint	Description
POST	/api/update_node	Update node status or health score
POST	/api/add_failure	Log a new failure for a node

---

Examples

# System status
curl http://localhost:5050/api/system_status

# Update node status (auth required)
curl -u admin:password \
  -X POST -H "Content-Type: application/json" \
  -d '{"node_id": 1, "status": "standby"}' \
  http://localhost:5050/api/update_node