Skip to main content

Cotool + TheHive

Connect TheHive to Cotool so agents list and update alerts, create cases from alerts, add observables and comments, and attach files to cases.

Incident Response
Updated

The short answer

With TheHive connected, Cotool agents list alerts and cases with time filters, update alerts, create a case from an alert, add observables and comments, and attach files directly to cases, so investigations land in the case management system your team already uses.[1][2]

How it connects: Cotool calls TheHive's API on your instance. What it can do depends on the permissions of the TheHive account behind the API key; TheHive gates actions such as importing alerts and updating cases by named permission.[2][4][5]

What Cotool uses from TheHive

Alerts
TheHive alerts are security events from detection tools such as SIEM, IDS, EDR, firewalls, or MISP. Agents list them with filters before deciding what to escalate.[1][5]
Cases
Agents list cases with an updatedAt filter to find recent investigations and check whether a related case is already in progress.[1][4]

Response actions

These change state in TheHive, so they are the steps teams usually gate behind approval.

Create a case from an alert
Agents promote an alert to a case when further investigation is needed. TheHive requires manageAlert/import for creating cases from alerts or adding alerts to existing cases.[1][4]
Observables, comments, and attachments
Agents add observables such as IPs, hashes, and domains, comment on cases, and upload files from their investigation as case attachments.[1]

Detections, hunts, and triage

Triage TheHive alertsTriage
An agent reads a new alert, enriches its observables, and either updates the alert with a verdict or creates a case and attaches the evidence it gathered.[1][3]
Keep the case record completeResponse
During a response, the agent writes its findings as comments and uploads files, such as exported logs, so the case holds the full record for reviewers.[1][4]

Setup and permissions

Create an API key for a TheHive account whose profile grants only the permissions agents need, such as updating alerts and cases and importing alerts.[4]

PermissionAccess
manageAlert/updateUpdate alerts, such as status or verdict.[4]Write
manageAlert/importCreate cases from alerts or add alerts to existing cases.[4]Write
manageCase/updateUpdate cases, including comments and attachments.[4]Write
  • TheHive rejects a new alert when another with the same type, source, and source reference exists, which stops connected tools from importing the same event twice.[5]

How Cotool works with TheHive

  • Cotool added TheHive observables in release 0.21.0, case creation from alerts in 0.29.0, and case attachment uploads in 0.49.0.[1]

FAQ

Can an agent merge duplicate cases in TheHive?
TheHive supports merging similar cases with the manageCase/merge permission, but merging is not among the TheHive actions Cotool lists. Agents check for an existing case before creating one.[1][4]

Sources

  1. Changelog (Cotool docs) · accessed November 16, 2026
  2. Integrations (Cotool) · accessed November 16, 2026
  3. Respond to every signal (Cotool Respond) · accessed November 16, 2026
  4. About cases (TheHive docs) · accessed November 16, 2026
  5. About alerts (TheHive docs) · accessed November 16, 2026

Related integrations

All integrations

Use cases with TheHive

Attackers are scaling with tokens

Cotool helps defenders operate at machine speed. See how security teams are scaling Detection & Response.

Book a demo