API Reference · v1
Introduction
The COHESION scoring API turns oversight telemetry into a signed score against the specification. Every response is verifiable after the fact.
Authentication
All requests authenticate with a scoped key in the X-API-Key header. Keys are scoped per environment and never appear in evidence receipts.
HTTPX-API-Key: $COHESION_API_KEY
The evidence envelope
Scores are returned inside a documented judgment envelope: the payload, score fields, request metadata, and timestamp. The /v1/admin/audit/verify-chain endpoint checks the audit chain without re-scoring; signed per-decision receipts are issued from the DRS gate path and receipt service.
Score an interaction
Post the telemetry for one human-AI interaction. The response carries the Judgment Independence Score, the seven per dimension scores, and the band.
cURL$ curl -X POST api.cohesionauth.com/v1/score \
-H "X-API-Key: $COHESION_API_KEY" \
-H "Content-Type: application/json" \
-d @interaction.json
# 200 OK
{
"jis": 82.4,
"dimensions": {
"escalation_integrity": 88,
"review_cadence": 81,
"decision_authority": 79
},
"compliance": {
"band": "proficient",
"status": "compliant",
"jis": 82.4,
"article14_met": true,
"action_required": "none",
"thresholds": {
"current": 82.4,
"target": 75,
"compliant_minimum": 60,
"critical": 40
}
}
}
Endpoints
POST /v1/score Score one human-AI interaction; return the Judgment Independence envelope.
POST /v1/score/batch Score multiple interactions in a single signed request.
POST /v1/decision/score Return a Decision Risk Score and a routing recommendation.
GET /v1/operator/{id}/profile Retrieve a reviewer's JIS band over time.
GET /v1/admin/audit/verify-chain Verify the signature and hash chain of issued receipts.