TRtrycompai
Risks

List organization risks

Changed on

List organization risks with owners, departments, severity, mitigation status, and evidence for risk management reporting.

get/v1/risks

Request

  • Base URL
    https://api.trycomp.ai
  • Auth
    API key in header X-API-Key

Query parameters

titlestring
Example:data breach

Search by title (case-insensitive contains)

pagenumber
Example:1

Page number (1-indexed)

perPagenumber
Example:50

Number of items per page

sort'createdAt' | 'updatedAt' | 'title' | 'status'

Sort by field

sortDirection'asc' | 'desc'

Sort direction

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

Filter by status

category'customer' | 'fraud' | 'governance' | 'operations' | 'other' | 'people' | 'regulatory' | 'reporting' | 'resilience' | 'technology' | 'vendor_management'

Filter by category

departmentstring
Example:it

Filter by department. Built-in values: none, admin, gov, hr, it, itsm, qms. Custom department names are also accepted.

assigneeIdstring
Example:mem_abc123def456

Filter by assignee member ID

Response

Risks retrieved successfully

countnumber

Total number of risks

authType'api-key' | 'session'

How the request was authenticated

Example response

{
  "data": [
    {
      "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",
      "status": "open",
      "likelihood": "possible",
      "impact": "major",
      "treatmentStrategy": "mitigate",
      "assigneeId": "mem_abc123def456"
    }
  ],
  "count": 15,
  "authenticatedUser": {
    "id": "usr_def456ghi789",
    "email": "user@example.com"
  }
}

Changes

  • 33c685841b7aRevision changes
    • breaking

      removed the enum value admin from the query request parameter department

    • breaking

      removed the enum value gov from the query request parameter department

    • breaking

      removed the enum value hr from the query request parameter department

    • breaking

      removed the enum value it from the query request parameter department

    • breaking

      removed the enum value itsm from the query request parameter department

    • breaking

      removed the enum value none from the query request parameter department

    • breaking

      removed the enum value qms from the query request parameter department

    • warning

      for the query request parameter department, the maxLength was set to 64

  • 7ca7c363a732Revision changes
    • breaking

      the query request parameter department was restricted to a list of enum values

    • info

      added the new enum value admin to the query request parameter department

    • info

      added the new enum value gov to the query request parameter department

    • info

      added the new enum value hr to the query request parameter department

    • info

      added the new enum value it to the query request parameter department

    • info

      added the new enum value itsm to the query request parameter department

    • info

      added the new enum value none to the query request parameter department

    • info

      added the new enum value qms to the query request parameter department