Bowtie One

Creates a new bowtie in this Bowtie One account from a description of the whole board: a project name, the hazard, the unwanted event, the threats each with their prevention barriers, and the consequences each with their mitigation barriers; any barrier can carry escalation factors and their controls. The board is saved in one go or not at all, and nothing existing is changed. Returns the new board, its risk and gaps, and a link to open it. A repeated request_id within 10 minutes returns the board already made.

create_bowtie

Returns Bowtie One's method as reference text: how a bowtie is structured here (topic `method`), the likelihood, severity and risk-band scales and barrier types (`scales`), or what each gap code means (`gap_codes`).

get_method_guide

Lists the bowties this Bowtie One account can open, most recently used first: project id, name, your role (owner, editor or viewer), when it was last saved and whether you saved it, and whether it is shared with other people. Optional filter by name.

list_bowties

Moves a barrier to a new position on the line it is on (1 = nearest the threat or consequence). Requires the `revision` from get_bowtie or from the last change, and refuses a stale one without saving. The previous version is kept in the board's version history.

move_barrier

Puts a barrier that is already on the bowtie onto another threat's or consequence's line as well, as the same barrier. Nothing already there changes. Requires the `revision` from get_bowtie or from the last change, and refuses a stale one without saving. The previous version is kept in the board's version history.

place_barrier_on_another_line

Returns one bowtie: its stage (work as imagined or work as done), hazard, unwanted event, threats and consequences with their ratings and barriers in order, escalation factors and their controls, the ids every change refers to, a link to open it in Bowtie One, and its current `revision`, which every change requires.

get_bowtie

Removes one barrier from the bowtie, from every line it is on, with its escalation factors. Requires the `revision` from get_bowtie or from the last change, and refuses a stale one without saving. The previous version is kept in the board's version history.

remove_barrier

Removes one consequence from the bowtie, with the barriers on its line and their escalation factors. Requires the `revision` from get_bowtie or from the last change, and refuses a stale one without saving. The previous version is kept in the board's version history.

remove_consequence

Removes one threat from the bowtie, with the barriers on its line and their escalation factors. Requires the `revision` from get_bowtie or from the last change, and refuses a stale one without saving. The previous version is kept in the board's version history.

remove_threat

Removes one escalation factor from a barrier, with its escalation factor controls. Requires the `revision` from get_bowtie or from the last change, and refuses a stale one without saving. The previous version is kept in the board's version history.

remove_escalation_factor

Removes one escalation factor control. Requires the `revision` from get_bowtie or from the last change, and refuses a stale one without saving. The previous version is kept in the board's version history.

remove_escalation_control

Renames one escalation factor. Requires the `revision` from get_bowtie or from the last change, and refuses a stale one without saving. The previous version is kept in the board's version history.

update_escalation_factor

Returns Bowtie One's risk assessment of a bowtie, the same as its management view: every threat-to-consequence pathway worst first with its score with no controls and with controls, the gaps with the action each needs, the design status of each line, and method warnings.

review_bowtie

Switches the bowtie between Work as imagined (design: every barrier counts as working) and Work as done (monitoring: a barrier counts once somebody has checked it). Requires the `revision` from get_bowtie or from the last change, and refuses a stale one without saving. The previous version is kept in the board's version history.

set_board_stage

Takes a barrier off one line, leaving it on any other line it is on (if it is on no other line, it is removed). Requires the `revision` from get_bowtie or from the last change, and refuses a stale one without saving. The previous version is kept in the board's version history.

remove_barrier_from_line