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 signed envelope: the payload, a SHA-256 hash, an audit-chain entry, and a timestamp. The /v1/admin/audit/verify-chain endpoint checks the signature chain without re-scoring.
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,
"band": "proficient",
"dimensions": {
"escalation_integrity": 88,
"review_cadence": 81,
"decision_authority": 79
},
"article_14": "7/7"
}
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.