Set Objective Grouping
set_objective_groupingGroup or ungroup a threat model's objectives by asset groups, creating a new model version and remapping controls as objectives move.
Instructions
Group a model's objectives by asset groups, or stop grouping them. Mutating; creates a model version. Calls no model, so nothing is estimated: the judgements the new version re-keys are queued as for any edit.
Read get_objective_grouping first, relay the groups and the
objective counts to the person, and pass the model_version it
returned: a model that moved since is refused 409 review_stale.
Grouping is refused 409 behavioural_off where
get_objective_grouping reports available false; stopping is
never refused for it. The write gate refuses it while a control build
holds the model.
Grouping forms the groups from scratch; stopping deletes every group,
so each asset has its own objectives again. Either way the controls'
mappings move with the objectives (moved: each retired objective to
where its mappings went), each mitigation group landing as a group of
its own. A disposition on a retired objective does not carry over.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| enabled | Yes | ``true`` to group, ``false`` to stop grouping. | |
| model_id | Yes | ID of the threat model. | |
| model_version | Yes | The version read with ``get_objective_grouping``. | |
| server_version | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||