v56

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014121451.1 MB

Risks

Get organization risk

Retrieve one organization risk with owner, department, likelihood, impact, mitigation, and remediation context.

get/v1/risks/{id}

Path parameters

idstring required

Example:rsk_abc123def456

Risk ID

Response

Risk retrieved successfully

idstring

Risk ID

titlestring

Risk title

descriptionstring

Risk description

department'none' | 'admin' | 'gov' | 'hr' | 'it' | 'itsm' | 'qms' nullable

status'open' | 'pending' | 'closed' | 'archived'

likelihood'very_unlikely' | 'unlikely' | 'possible' | 'likely' | 'very_likely'

impact'insignificant' | 'minor' | 'moderate' | 'major' | 'severe'

residualLikelihood'very_unlikely' | 'unlikely' | 'possible' | 'likely' | 'very_likely'

residualImpact'insignificant' | 'minor' | 'moderate' | 'major' | 'severe'

treatmentStrategyDescriptionstring nullable

treatmentStrategy'accept' | 'avoid' | 'mitigate' | 'transfer'

organizationIdstring

assigneeIdstring nullable

ID of the user assigned to this risk

createdAtstring date-time

When the risk was created

updatedAtstring date-time

When the risk was last updated

authType'api-key' | 'session'

How the request was authenticated

Example response

{
  "id": "rsk_abc123def456",
  "title": "Data breach vulnerability in user authentication system",
  "description": "Weak password requirements could lead to unauthorized access to user accounts",
  "category": "technology",
  "department": "it",
  "status": "open",
  "likelihood": "possible",
  "impact": "major",
  "residualLikelihood": "unlikely",
  "residualImpact": "minor",
  "treatmentStrategyDescription": "Implement multi-factor authentication and strengthen password requirements",
  "treatmentStrategy": "mitigate",
  "organizationId": "org_abc123def456",
  "assigneeId": "mem_abc123def456",
  "authenticatedUser": {
    "id": "usr_def456ghi789",
    "email": "user@example.com"
  }
}