reevaluate_threat_model_factors
Re-evaluate threat model factors by re-running LLM judgment on all assets and attackers to refresh ratings after changes, preserving controls and assertions.
Instructions
Re-run the LLM factor judgment on every asset and attacker in a threat model. Useful for re-baselining factors after a bug fix or feature-description change, without regenerating the whole model (which would destroy controls, assertions, components).
Each entity's factors and rationale are replaced with a fresh
LLM-judged decomposition; the composed impact / likelihood is
re-derived deterministically from the new factors. Each re-rating
is recorded as a rating revision in the audit trail with
change_reason (default: "LLM factor re-evaluation") so the
starting-point regeneration is distinguishable from operator-
supplied factor overrides via edit_asset / edit_attacker.
The platform's LLM factor judgment is a starting point. For
deployment-specific factor adjustments (e.g., elevated
regulatory_scope because your tenant is HIPAA-covered, or
Commodity prevalence because your endpoint is public-internet
exposed), use edit_asset / edit_attacker afterward with a
change_reason documenting the operator override.
Per-entity soft-fail: an LLM failure on one entity is recorded in
the response's failed_entities list (with id, kind, and
reason); the remaining entities are still re-evaluated and
their rating revisions persisted as they complete. The endpoint
returns 503 only when every live entity failed — in which case
nothing was persisted; retry when the evaluator is reachable.
Soft-deleted assets and attackers are skipped.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model_id | Yes | ID of the threat model to re-rate. | |
| change_reason | No | Optional override of the audit-trail reason (default: "LLM factor re-evaluation"). Use this to thread a higher-level reason like "Re-eval after refinement bug fix shipped in vN.N.N" when running the tool as part of a broader workflow. | |
| server_version | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||