API
API
keen-pbr includes an embedded HTTP REST API for monitoring, health checking, and configuration management.
Availability
The API is available when:
- The binary was built with
with_api=true(the default) - The config has
api.enabled: true - The
--no-apiflag was not passed at startup
Configuration
{
"api": {
"enabled": true,
"listen": "127.0.0.1:8080"
}
}The default listen address is 127.0.0.1:8080. To expose the API on all interfaces, use 0.0.0.0:8080.
Endpoints
See Endpoints for full documentation of all available endpoints.
| Method | Path | Description |
|---|---|---|
GET |
/api/health/service |
Daemon version, routing runtime status, and outbound health |
POST |
/api/service/start |
Start the routing runtime |
POST |
/api/service/stop |
Stop the routing runtime |
POST |
/api/service/restart |
Restart the routing runtime |
GET |
/api/config |
Get current config as JSON |
POST |
/api/config |
Validate and stage config in memory |
POST |
/api/config/save |
Persist and apply the staged config |
GET |
/api/health/routing |
Live kernel routing/firewall verification |