Promote Alert To Case
thehive.promote_alert_to_case
ActionBusiness appsconnection required
Calls the TheHive API with the connection's credentials.
Turn an alert into a new case, optionally overriding its fields.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- Bearer token
- Providers
- TheHive
- Secret shape
- the TheHive API key, or {"api_key": "…"}
- Config it needs
- base_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
2 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
alert_id TheHive id of the alert. | string | Yes | — | — | ~41353304 |
fields Case fields to override as a JSON object, e.g. {"caseTemplate": "phishing", "assignee": "analyst"}. Leave empty to take everything from the alert. | object | No | — | — | {"assignee":"analyst","caseTemplate":"phishing"} |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"alert_id": "~41353304",
"fields": {
"assignee": "analyst",
"caseTemplate": "phishing"
}
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
_id TheHive's internal id for the case. | string | — |
number The human-facing case number. | number | — |
title The case title. | string | — |
description The case description, as Markdown. | string | — |
severity Severity as TheHive's numeric code. | number | — |
severityLabel The label TheHive shows for that severity. | string | — |
status Where the case is in its lifecycle, e.g. New or InProgress. | string | — |
stage The broader stage the status belongs to. | string | — |
tlp Traffic Light Protocol level as TheHive's numeric code. | number | — |
tlpLabel The label TheHive shows for that TLP level. | string | — |
pap Permissible Actions Protocol level as a numeric code. | number | — |
tags The tags carried by the case. | array | — |
assignee Login of the analyst the case is assigned to. | string | — |
startDate When the case started, in epoch milliseconds. | number | — |
_createdAt When the case was created, in epoch milliseconds. | number | — |
_createdBy Login of the user who created the case. | string | — |
{
"_createdAt": 0,
"_createdBy": "",
"_id": "",
"assignee": "",
"description": "",
"number": 0,
"pap": 0,
"severity": 0,
"severityLabel": "",
"stage": "",
"startDate": 0,
"status": "",
"tags": [],
"title": "",
"tlp": 0,
"tlpLabel": ""
}See Promote Alert To Case run in a workflow.
In a technical demo we add the TheHive connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.