docs/API_REFERENCE.md

API Reference

All endpoints are implemented in server/app.py.

Core Environment Endpoints

Method	Path	Purpose
POST	/reset	start a new episode (task, optional seed)
POST	/step	multi-session step with action map
POST	/step_single	single-session RL step (action)
GET	/state	current environment snapshot
GET	/tools	discover supported tool functions
GET	/health	liveness check

Tool Endpoints

• POST /tool/evaluate_session
  • body: { "kwargs": { "session_id": "..." } }
• POST /tool/take_action
  • body: { "kwargs": { "session_id": "...", "action": 1 } }
• POST /tool/get_network_stats
  • body: { "kwargs": {} }
• POST /tool/get_threat_intelligence
  • body: { "kwargs": {} }

Typical Loop

1. POST /reset
2. GET /state to list candidate sessions
3. POST /tool/evaluate_session for selected sessions
4. POST /step or POST /step_single
5. repeat until done=true