Tools: Risks

listRisks

🔍 Read-only

List all risks with filtering and pagination.

Parameters: {
  "organization_id": "org_xxx",
  "size": 50,
  "cursor": "optional_cursor",
  "filter": {
    "query": "search term",
    "status": "OPEN",
    "min_residual_risk_score": 15
  },
  "order_by": { "field": "RESIDUAL_RISK_SCORE", "direction": "DESC" }
}

Supports: Pagination, search, filtering, sorting Returns: Array of risks with scores and treatment status, next_cursor for pagination

Example:
AI: "Show me all high-priority risks"
    [Uses listRisks tool with filter]
AI: "List risks with a score above 15"
    [Uses listRisks tool with min_residual_risk_score filter]

getRisk

🔍 Read-only

Get detailed information about a specific risk.

Parameters: {
  "organization_id": "org_xxx",
  "risk_id": "risk_xxx"
}

Returns: Full risk details including assessment, mitigation, and history

Example:
AI: "Get details for risk risk_abc123"
    [Uses getRisk tool]

addRisk

✏️ Write

Add a new risk to the organization.

Parameters: {
  "organization_id": "org_xxx",
  "name": "Risk Name",
  "description": "Risk description",
  "likelihood": 5,
  "impact": 4,
  "treatment": "MITIGATE"
}

Returns: Created risk object with calculated risk scores

Example:
AI: "Add a risk for potential data breach with high likelihood and impact"
    [Uses addRisk tool]

updateRisk

✏️ Write

Update an existing risk assessment.

Parameters: {
  "organization_id": "org_xxx",
  "risk_id": "risk_xxx",
  "likelihood": 3,
  "impact": 3,
  "treatment": "ACCEPT"
}

Returns: Updated risk object with recalculated scores

Example:
AI: "Update risk risk_abc123 to set treatment as ACCEPT"
    [Uses updateRisk tool]

deleteRisk

✏️ Write

Delete a risk.

Parameters: {
  "organization_id": "org_xxx",
  "risk_id": "risk_xxx"
}

Returns: Confirmation of deletion

Example:
AI: "Delete risk risk_abc123"
    [Uses deleteRisk tool]

listRiskObligations

🔍 Read-only

List obligations linked to a risk.

Parameters: {
  "organization_id": "org_xxx",
  "risk_id": "risk_xxx"
}

Returns: Array of obligations associated with the risk

Example:
AI: "Show obligations linked to risk risk_abc123"
    [Uses listRiskObligations tool]

linkRisk

✏️ Write

Link a risk to a resource (document, measure, or obligation). The resource type is determined from the resource GID.

Parameters: {
  "organization_id": "org_xxx",
  "risk_id": "risk_xxx",
  "resource_id": "gid://resource_xxx"
}

Returns: Updated risk with new link

Example:
AI: "Link risk risk_abc123 to measure measure_abc123"
    [Uses linkRisk tool]

unlinkRisk

✏️ Write

Unlink a risk from a resource (document, measure, or obligation). The resource type is determined from the resource GID.

Parameters: {
  "organization_id": "org_xxx",
  "risk_id": "risk_xxx",
  "resource_id": "gid://resource_xxx"
}

Returns: Updated risk with link removed

Example:
AI: "Unlink risk risk_abc123 from measure measure_abc123"
    [Uses unlinkRisk tool]