Aegis API reference (overview)

Base URL - Default local: http://localhost:8000 - Production: behind TLS and mTLS as configured - Roles: admin, operator, viewer (use header X-Role in examples)

Participants - Register: POST /participants

http POST :8000/participants X-Role:admin client_id=c1 key_hex=aa

Datasets - Register client dataset metadata: POST /dataset/register

curl -fsS -H 'X-Role: admin' -H 'Content-Type: application/json' \
  -d '{"client_id":"c1","num_samples":500,"num_features":10,"missing_fraction":0.0,
       "class_counts":{"0":450,"1":50},"schema":["f1","f2"]}' \
  http://localhost:8000/dataset/register

Privacy configuration - Set DP config: POST /dp/config

http POST :8000/dp/config X-Role:operator clipping_norm:=1.0 noise_multiplier:=1.0 sample_rate:=0.01 delta:=1e-5 accountant=rdp

Federated strategy - Select aggregator: POST /strategy

http POST :8000/strategy X-Role:operator strategy=trimmed_mean

Training sessions - Start: POST /training/start

http POST :8000/training/start X-Role:operator session_id=run1 rounds:=5

- Status: GET /training/status?session_id=run1

http GET :8000/training/status X-Role:viewer session_id==run1

- Stop: POST /training/stop

http POST :8000/training/stop X-Role:operator session_id=run1

Compliance report - Generate Markdown JSON and extract .markdown:

curl -fsS -H 'X-Role: viewer' :8000/compliance/report | jq -r .markdown > report.md

- Or request a PDF directly:

http GET :8000/compliance/report?format=pdf X-Role:viewer > report.pdf

See OpenAPI at /docs or /openapi.json for full schemas and error responses.