COcotool
Detections

List detection hits

Retrieve a flattened hit feed across all detections in the current organization. Pass detectionId to restrict the feed (and its aggregate summary) to a single detection — used by the detection-agent detail page to surface verifier evidence + cited tool calls without leaving the page. Uses a single batch query instead of N concurrent queries per detection.

get/api/detections/hits

Request

  • Base URL
    https://app.cotool.ai
  • Auth
    HTTP bearer

Query parameters

limitinteger

Maximum number of hits to return per page (1-200, default: 100)

offsetinteger

Number of hits to skip for pagination (default: 0)

detectionIdstring uuid

Restrict the feed to hits produced by a single detection agent. When omitted, returns hits across all accessible detections.

severityFilterstring

Comma-separated severities to include, such as "high,critical". When omitted, returns all severities.

excludeAlerted'true' | 'false'

Opt-in. "true" leaves out hits that already created an alert (alerts.origin_detection_hit_id). Default: false, all open hits.

includeSummary'true' | 'false'

Opt-in. "false" skips the aggregate summary queries, so the response has no summary. Default: true (summary is returned when offset is 0).

Response

Successful response

totalCountnumber required

Total number of hits across all detections (for pagination)

Changes

No recorded changes to this operation across all 2 revisions of this API.