API Overview
Optra Prism exposes two backend services with REST APIs.
Services
Section titled “Services”| Service | Port | Purpose |
|---|---|---|
| Ingest | 9005 | Receives OTLP telemetry (logs, metrics, traces) |
| Prism Engine | 9007 | Queries telemetry, scoring, intelligence, insights |
Base URLs
Section titled “Base URLs”| Environment | Ingest | Engine |
|---|---|---|
| Local | http://localhost:9005 | http://localhost:9007 |
| Dev | https://ingest.prism.dev.optra-ai.com | Internal (private) |
| Staging | https://ingest.prism.staging.optra-ai.com | Internal (private) |
| Production | https://ingest.prism.optra-ai.com | Internal (private) |
The engine is not publicly exposed in deployed environments — the dashboard accesses it via internal networking.
Authentication
Section titled “Authentication”See Authentication for details on API key usage.
Response format
Section titled “Response format”All endpoints return JSON:
{ "data": { ... }}Errors return:
{ "code": 401, "message": "Invalid API key"}HTTP status codes
Section titled “HTTP status codes”| Code | Meaning |
|---|---|
| 200 | Success |
| 400 | Bad request (validation error) |
| 401 | Unauthorized (missing or invalid API key) |
| 413 | Payload too large |
| 500 | Internal server error |
| 503 | Service unavailable (includes Retry-After: 5 header) |