List Simulations
list_simulationsRetrieve adversary-emulation simulation scenarios and atomic test commands grouped by threat. Use offset and limit to page through results and explore threat simulation coverage.
Instructions
DEPRECATED (generation stopped 2026-08-03; archived rows only). List adversary-emulation simulation scenarios across the platform (atomic test commands grouped by threat). total / total_simulations are CORPUS-wide; the page you got is returned / page_simulations, and has_more + next_offset walk the rest. The correlation block (shared_techniques, attack_chain_similarities, platform/tactic coverage) is computed over the RETURNED PAGE only — it carries scope:"page" and changes with limit. Pass limit (default 50, max 200) and offset. include_facets=true adds the corpus filter vocabulary (~20 KB of actor/nation/category strings) — off by default. Prefer get_flow_coverage and get_attack_flow — ATT&CK Flows replaced simulations.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max threats in this page (default 50, max 200) | |
| offset | No | Row offset for paging (default 0). Use next_offset from the previous response. | |
| include_facets | No | Include the corpus filter vocabulary (filter_meta). Default false — it is ~20 KB and does not shrink with limit. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | No | Corpus-wide threats that have simulations. | |
| threats | No | ||
| has_more | No | ||
| returned | No | Threats in THIS page. | |
| deprecated | No | ||
| correlation | No | ||
| filter_meta | No | ||
| next_offset | No | ||
| page_simulations | No | Simulation rows across the returned page only. | |
| total_simulations | No | Corpus-wide simulation rows. | |
| generation_stopped | No |