Risk programs: accept, assess, close, treat

Reference for Risk, one group of Risk programs.

Risk.accept

Accept records an officer’s signed Decision to carry a Risk untreated until its next review. Verb page.

Text

do: return await $.Risk.accept(input)

Emits Risk.accepted.

Inputs

Input	Type	Required	Description
`risk`	Risk	required	The Risk to carry.
`reason`	`text`	required	Why it is carried, recorded as a Decision.

Returns

Output	Type	Required	Description
`risk`	Risk	required	The accepted Risk.

Refuses when

Check	Error	Fix	Then call
The key is valid, but its scopes do not allow this operation.	`forbidden`	Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them.	None.

Example

JSON

{
  "name": "do",
  "arguments": {
    "code": "return await $.Risk.accept({ risk: 'risk_a3Rw0qcmRy', reason: 'Example reason' })"
  }
}

Risk.assess

Assess scores a Risk’s likelihood and impact from the Startup’s records and sets its next review date. Verb page.

Text

do: return await $.Risk.assess(input)

Emits Risk.assessed.

Inputs

Input	Type	Required	Description
`risk`	Risk	required	The Risk to score.
`likelihood`	`integer`	required	Likelihood from 1 to 5.
`impact`	`integer`	required	Impact from 1 to 5.

Returns

Output	Type	Required	Description
`risk`	Risk	required	The scored Risk.

Refuses when

Check	Error	Fix	Then call
The key is valid, but its scopes do not allow this operation.	`forbidden`	Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them.	None.

Example

JSON

{
  "name": "do",
  "arguments": {
    "code": "return await $.Risk.assess({ risk: 'risk_a3Rw0qcmRy', likelihood: 1, impact: 1 })"
  }
}

Risk.close

Close ends a Risk that can no longer happen and keeps it, with its scores and treatments, forever. Verb page.

Text

do: return await $.Risk.close(input)

Emits Risk.closed.

Inputs

Input	Type	Required	Description
`risk`	Risk	required	The Risk to close.
`reason`	`text`	required	Why it can no longer happen.

Returns

Output	Type	Required	Description
`risk`	Risk	required	The closed Risk, kept forever.

Refuses when

Check	Error	Fix	Then call
The key is valid, but its scopes do not allow this operation.	`forbidden`	Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them.	None.

Example

JSON

{
  "name": "do",
  "arguments": {
    "code": "return await $.Risk.close({ risk: 'risk_a3Rw0qcmRy', reason: 'Example reason' })"
  }
}

Risk.treat

Treat links a Risk to the Controls that lower it and records the score it should reach. Verb page.

Text

do: return await $.Risk.treat(input)

Emits Risk.treated.

Inputs

Input	Type	Required	Description
`risk`	Risk	required	The Risk to treat.
`controls`	list of Control	required	The Controls that lower it.

Returns

Output	Type	Required	Description
`risk`	Risk	required	The treated Risk.

Refuses when

Check	Error	Fix	Then call
The key is valid, but its scopes do not allow this operation.	`forbidden`	Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them.	None.

Example

JSON

{
  "name": "do",
  "arguments": {
    "code": "return await $.Risk.treat({ risk: 'risk_a3Rw0qcmRy', controls: ['control_o4pMmXUeCH'] })"
  }
}

Risk.acceptCopy Anchor Link

Risk.assessCopy Anchor Link

Risk.closeCopy Anchor Link

Risk.treatCopy Anchor Link

Risk.accept

Risk.assess

Risk.close

Risk.treat