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.
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
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/importfor 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
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]
| Permission | Access | Why |
|---|---|---|
manageAlert/updateUpdate alerts, such as status or verdict.[4] | Write | Update alerts, such as status or verdict.[4] |
manageAlert/importCreate cases from alerts or add alerts to existing cases.[4] | Write | Create cases from alerts or add alerts to existing cases.[4] |
manageCase/updateUpdate cases, including comments and attachments.[4] | Write | Update cases, including comments and attachments.[4] |
- 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
Sources
- Changelog (Cotool docs) · accessed November 16, 2026
- Integrations (Cotool) · accessed November 16, 2026
- Respond to every signal (Cotool Respond) · accessed November 16, 2026
- About cases (TheHive docs) · accessed November 16, 2026
- About alerts (TheHive docs) · accessed November 16, 2026
