CLI: Risks

The prb risk commands let you create, list, view, update, and delete risks. In interactive mode, prb risk create prompts you for required fields.

Create a risk

prb risk create \
  --name "Data breach via unpatched systems" \
  --category "Technical" \
  --treatment MITIGATED \
  --inherent-likelihood 4 \
  --inherent-impact 5

Flag	Required	Description
--name	Yes*	Risk name
--category	Yes*	Risk category
--treatment	Yes*	Treatment strategy: MITIGATED, ACCEPTED, AVOIDED, TRANSFERRED
--inherent-likelihood	No	Inherent likelihood score (1–5)
--inherent-impact	No	Inherent impact score (1–5)
--residual-likelihood	No	Residual likelihood score (1–5)
--residual-impact	No	Residual impact score (1–5)
--org	No	Organization ID
--description	No	Risk description
--note	No	Additional notes
--owner	No	Risk owner (user ID)

* Prompted interactively if not provided.

List risks

prb risk list

Flag	Default	Description
--org	—	Organization ID
--limit, -L	30	Maximum number of results
--order-by	CREATED_AT	Sort field: CREATED_AT, NAME, CATEGORY, TREATMENT, INHERENT_RISK_SCORE, RESIDUAL_RISK_SCORE
--order-direction	DESC	Sort direction: ASC or DESC
--filter, -q	—	Filter risks by text
--output	—	Output format

View a risk

prb risk view RISK_ID

Displays the risk details including inherent and residual scores, likelihood, and impact.

Flag	Description
--output, -o	Output format

Update a risk

prb risk update RISK_ID --treatment ACCEPTED --residual-likelihood 2 --residual-impact 3

Flag	Description
--name	Updated risk name
--category	Updated category
--treatment	Updated treatment strategy
--inherent-likelihood	Updated inherent likelihood (1–5)
--inherent-impact	Updated inherent impact (1–5)
--residual-likelihood	Updated residual likelihood (1–5)
--residual-impact	Updated residual impact (1–5)
--description	Updated description
--note	Updated notes
--owner	Updated owner

Delete a risk

prb risk delete RISK_ID