Endpoints / compute-contract-score

Compute / recompute a contract score

POST/api/v1/contracts/{id}/scoredeveloperwrite

Idempotent on (contract_id, engine_name, engine_version). Requires `write` scope.

Path parameters

Name	Type	Required	Description
id	string	no	Contract id

Query parameters

Name	Type	Required	Description
engine	string	no	Engine name

Examples

curl -X POST -H "x-api-key: $INTELLIGENCE_API_KEY" \
  "https://intelligence-beryl.vercel.app/api/v1/contracts/:id/score"

Responses

200Updated signal

json

{
  "signal": {
    "id": "8e728629-a546-436d-b483-a7dfb47f0c90",
    "contract_id": "CONT_AWD_N0001925C0070_9700_-NONE-_-NONE-",
    "engine_name": "simple",
    "engine_version": "0.1.0",
    "engine_tier": "simple",
    "signal_score": 67,
    "importance_score": 91,
    "confidence_score": 100,
    "risk_score": 21,
    "computed_at": "2026-05-12T13:56:18.123Z"
  }
}

403Insufficient scope