The EvalPort reference API server provides endpoints for storing and retrieving eval suites and result sets.
npx tsx api/server.ts
# EvalPort API running on http://localhost:9876Store an eval suite (validated on intake).
curl -X POST http://localhost:9876/suites \
-H "Content-Type: application/json" \
-d @examples/basic-suite.jsonResponse: 201 Created
{"id": "suite_qa_basic", "message": "Suite stored"}If invalid: 400 Bad Request
{"error": "Invalid suite", "details": [{"path": "$.version", "message": "...", "code": "INVALID_VERSION"}]}List all stored suite IDs.
curl http://localhost:9876/suitesRetrieve a stored suite.
curl http://localhost:9876/suites/suite_qa_basicSubmit results for a suite run. Creates a ResultSet with computed summary.
curl -X POST http://localhost:9876/results \
-H "Content-Type: application/json" \
-d '{"suite_id": "suite_qa_basic", "run_id": "run_001", "results": [...]}'Retrieve a stored result set.
Health check.
{"status": "ok", "suites": 3, "results": 5}The reference server uses in-memory storage. For production use, replace the Map with a database (PostgreSQL, MongoDB, etc.).