list_reconciliation_candidates
Lists pending or rejected duplicate-entity matches between a threat model and its ancestors, separating certain from heuristic matches, so operators can triage and resolve duplicates before they distort coverage.
Instructions
Reconciliation triage surface between this model and its ancestors.
When a model inherits entities (assets, attackers, components, trust
boundaries) from an ancestor and the operator has authored a
locally-named entity that looks like the same real-world thing, the
reconciliation engine pairs them so the operator can decide whether to
alias the local entity onto the inherited qualified id. disposition
selects which side of the triage queue to read:
disposition="active"(default) — the OPEN candidate queue: detected pairs the operator has not yet acted on. Tiercertainis a deterministic match (same qid or structurally identical) and is safe to auto-apply viaapply_certain_reconciliation_match; tierheuristicis a fuzzy name/description match that needs review. Previously-rejected pairs are filtered out of this queue. Paginated viapage/page_size. Returns{model_id, flag_enabled, total, tiers: {certain: int, heuristic: int}, page, page_size, candidates: [{kind, own_qid, inherited_qid, tier: "certain"|"heuristic", reasons: [str, ...]}, ...]}. When composition is disabled on the backend,totalis 0,candidatesis empty, andflag_enabled: false.disposition="rejected"— the operator's persisted "these are NOT duplicates" decisions, inrejected_atascending order (the same set the candidate detector consults to filter the active queue). Use this to render the rejected section of a triage view, or to find the surrogateidneeded byunreject_reconciliation_candidate. NOT paginated —page/page_sizeare ignored. Returns{model_id, flag_enabled, rejections: [{id, model_id, kind, own_qid, inherited_qid, rejected_by, rejected_at}, ...]}. When composition is disabled on the backend,rejectionsis empty andflag_enabled: false; the same empty list is returned withflag_enabled: truewhen the rejection store is not configured on the instance.
Use on child models in a recursive tree to find duplicates that should be collapsed before they distort coverage.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ACTIVE disposition only. 1-indexed page number. Default 1. Ignored when ``disposition="rejected"``. | |
| model_id | Yes | ID of the descendant threat model. | |
| page_size | No | ACTIVE disposition only. Items per page. Default 50. Ignored when ``disposition="rejected"``. | |
| disposition | No | Which side of the queue to read — ``"active"`` (default, open candidates) or ``"rejected"`` (persisted not-a-duplicate decisions). | active |
| server_version | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||