/v1/definitions/{key}/underwriting/{id}/evaluateEvaluate a deal against an underwriting rule set
Runs the machine over a deal's scorecard and answers the NEW version's rows. It mints version n+1, COPIES every answer from version n into it (nothing in n is ever touched), adds a pending row for any active criterion the template has gained since, then answers the criteria this service can decide by itself — leaving alone any a person has already decided. Reach for it after new documents land; a person's own answers are saved with put_definitions_key_underwriting_id_criteria instead. Deals page only.
Access class: def:read.
Send request
Use the documented inputs to call this endpoint directly.
Parameters
Values are applied to the request and the example on the right.
Request body
application/jsonrequiredResponses
the action's answer
{
"data": [
{
"criterion": {
"active": "string",
"autoSource": "string",
"category": "string",
"comparison": "string",
"createdAt": "string",
"id": "",
"key": "string",
"label": "string",
"sortOrder": "string",
"threshold": "string",
"updatedAt": "string",
"valueKind": "string"
},
"criterionId": 1,
"evaluatedAt": "string",
"evaluatedBy": 1,
"evidence": "string",
"id": 1,
"note": "string",
"numericValue": 1.5,
"source": "string",
"status": "string",
"version": 1
}
]
}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}