Overview

Base URL: https://api.athenatrust.ai/v1 Version: 1.0.0

Authentication

All requests require an API key:

Authorization: Bearer YOUR_API_KEY

Endpoints

Trust Calibration

Method	Endpoint	Description
POST	/calibrate	Real-time trust calibration analysis
POST	/trust-score	Calculate aggregate trust score
GET	/trust-score/trend	Historical trust score trend

Bias Detection

Method	Endpoint	Description
POST	/detect-bias	Real-time bias detection
GET	/bias/feed	Bias alert feed
GET	/bias/subgroups	Subgroup performance analysis

External Bias Integration (v1.1.0)

Method	Endpoint	Description
POST	/model-fairness-signals	Ingest external fairness signal
GET	/model-fairness-signals	List fairness signals
GET	/model-fairness-signals/:id	Get single signal
GET	/bias/amplification	List amplification alerts
GET	/bias/amplification/:id	Get single alert
PATCH	/bias/amplification/:id	Update alert status
POST	/bias/amplification/analyze/:signalId	Trigger amplification analysis

Audit Trail

Method	Endpoint	Description
POST	/log	Log AI-mediated decision
GET	/audit-trail	Retrieve audit trail

Compliance Exports

Method	Endpoint	Description
POST	/export	Generate compliance report
GET	/export/templates	List available templates

Webhooks

Method	Endpoint	Description
POST	/webhooks	Create webhook
GET	/webhooks	List webhooks
PATCH	/webhooks/:id	Update webhook
DELETE	/webhooks/:id	Delete webhook
POST	/webhooks/:id/test	Send test event
POST	/webhooks/:id/rotate-secret	Rotate secret
POST	/webhooks/:id/enable	Enable webhook
GET	/webhooks/:id/deliveries	Delivery history

Admin

Method	Endpoint	Description
POST	/admin/api-keys	Create API key
GET	/admin/api-keys	List API keys
DELETE	/admin/api-keys/:id	Revoke API key
POST	/admin/api-keys/:id/rotate	Rotate API key

System

Method	Endpoint	Description
GET	/health	Health check
GET	/engines/status	Engine status
GET	/metrics	APM metrics

Request Format

All POST requests accept JSON:

Content-Type: application/json

Response Format

All responses return JSON:

{
  "data": { ... },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2025-12-25T10:00:00Z"
  }
}

Error Format

{
  "error": {
    "code": "invalid_request",
    "message": "Missing required field: user_id",
    "param": "user_id",
    "doc_url": "https://docs.athenatrust.ai/errors"
  }
}

HTTP Status Codes

Status	Meaning
200	Success
201	Created
400	Invalid request
401	Authentication failed
403	Forbidden
404	Not found
429	Rate limit exceeded
500	Server error

---

Next: Trust Calibration API