API Reference
All endpoints use Bearer JWT authentication. Responses follow a consistent envelope: { success, data | error }. Errors include structured codes (AUTH-001, WX-401, etc.) and recovery metadata.
Base URL
http://localhost:8000·All endpoints prefixed with /api/v1Authentication
2 endpointsIncident Management
3 endpointsAI Orchestration
2 endpointsMemory Engine
1 endpointAnalytics
3 endpointsTelemetry
3 endpointsSystem
1 endpointError Code Registry
| Code | Meaning | HTTP | Recoverable |
|---|---|---|---|
| AUTH-001 | Invalid credentials | 401 | No |
| AUTH-002 | Token expired | 401 | Yes — re-login |
| AUTHZ-001 | Permission denied | 403 | No |
| VAL-001 | Invalid request payload | 422 | Yes |
| AGENT-101 | Agent timeout | 503 | Yes — retry ×2 |
| MEM-201 | Embedding generation failed | 503 | Yes — fallback |
| GIS-301 | Invalid coordinates | 422 | Yes |
| GIS-302 | Route calculation failed | 503 | Yes — fallback |
| WX-401 | Weather API unavailable | 503 | Yes — cached |
| AI-601 | Bedrock timeout | 503 | Yes — retry ×3 |
| DB-501 | CockroachDB transaction conflict | 503 | Yes — retry ×5 |
| DB-502 | Record not found | 404 | No |
| SYS-999 | Unexpected platform error | 500 | No — escalated |