Prelude Documentation

Prelude v1.0 · API Usage

Decision request

curl -X POST https://api.precion.io/v1/decision \
  -H "Content-Type: application/json" \
  -H "X-API-Token: <token>" \
  -d '{
    "action": "deploy",
    "actor": "release-bot",
    "timestamp": "2025-01-01T00:00:00.000Z",
    "state": {
      "service": "api",
      "environment": "prod"
    }
  }'

Response:

{
  "decision": "BLOCK",
  "reason": "internal_error",
  "decision_id": "uuid"
}

Latest decision

curl -X GET https://api.precion.io/v1/can-proceed \
  -H "X-API-Token: <token>"

Health / Ready

curl https://api.precion.io/health
curl https://api.precion.io/ready

Audit listing

curl -G https://api.precion.io/v1/audit/decisions \
  -H "X-API-Token: <token>" \
  --data-urlencode "limit=50" \
  --data-urlencode "offset=0"

All responses are JSON, deterministic, and include `decision_id` for audit correlation.