DKBSignDocs

API reference

POSTRequires Bearer token

Risk-review a document

/api/ai/documents/{document_id}/risk-review

Returns risk_score (0–100), risk_level (faible|moyen|eleve), sensitive / missing / non-conform clauses. Optional async=true.

Path parameters

FieldTypeDescription
document_id
Required
stringPath parameter document_id.

Query parameters

FieldTypeDescription
async
booleanIf true, returns 202 and a job id.
e.g. false

Request body

FieldTypeDescription
reference_model_id
stringOptional reference model to compare against.

Responses

StatusMeaning
200Risk review
401Missing or invalid Bearer token.

Request

curl
curl -X POST 'https://api.dkbsigns.com/api/ai/documents/uuid_or_id/risk-review?async=false' \
  -H 'Authorization: Bearer $DKBSIGN_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"reference_model_id":"uuid_or_id"}'

Response 200

json
{
  "type": "risk_review",
  "result": {
    "risk_score": 32,
    "risk_level": "faible",
    "sensitive_clauses": []
  }
}