Skip to main content
GET
/
threats
List threat events
curl --request GET \
  --url https://api.truu.ai/api/v1/external/threats \
  --header 'X-API-Key: <api-key>'
{
  "data": [
    {
      "kind": "threat",
      "event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "severity": "<string>",
      "category": [
        "<string>"
      ],
      "subcategory": [
        "<string>"
      ],
      "signal_type": "<string>",
      "source": "<string>",
      "title": "<string>",
      "summary": "<string>",
      "user_name": "<string>",
      "user_email": "<string>",
      "platform_event_id": "<string>",
      "flagged": true,
      "safe": true,
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "pagination": {
    "page": 123,
    "per_page": 123,
    "total": 123
  }
}

Authorizations

X-API-Key
string
header
required

Domain-scoped API key. Generate and manage keys from the API Keys page in Settings. Pass via the X-API-Key header.

Query Parameters

email
string
event_id
string<uuid>
severity
string

Exact match on stored severity (freeform; not restricted to a fixed set).

category
string

Substring filter against the threat's category list (any single category token stored on the event; not an enum).

source
string

Exact match on stored source identifier (freeform).

flagged
boolean
created_after
string<date-time>
created_before
string<date-time>
page
integer
default:1
per_page
integer
default:50
Required range: x <= 200

Response

Paginated list of threat events

data
object[]
pagination
object