Incidents
GET /incidents
Lists the tenant's incidents, ordered by createdAt desc. Cursor pagination (cursor, limit default 25/max 100).
POST /incidents
Register an incident.
Body:
{
"title": "Acesso indevido a servidor de ficheiros",
"description": "...",
"type": "UNAUTHORIZED_ACCESS",
"severity": "HIGH",
"detectedAt": "2026-03-25T08:30:00Z"
}
type accepts: DATA_BREACH | RANSOMWARE | PHISHING | DDoS | INSIDER_THREAT | MALWARE | UNAUTHORIZED_ACCESS | PHYSICAL | WORKPLACE_ACCIDENT | OTHER.
severity accepts: LOW | MEDIUM | HIGH | CRITICAL.
When type = WORKPLACE_ACCIDENT (OHS module), it accepts additional optional fields: accidentLocation, injuryDescription, accidentCause, witnesses, catNumber, lostWorkDays.
Note: EterShield automatically calculates the CNCS (24h) and CNPD (72h) deadlines and the NIS2 deadlines from detectedAt.
GET /incidents/:id
Details of an incident. Returns id, title, type, severity, status, description, detectedAt, resolvedAt, notifiedCNCS, notifiedCNPD, createdAt, updatedAt.
PATCH /incidents/:id
Update an incident. Body: { "status": "...", "notes": "..." }.
Integration note: the notes field of the body is stored internally in the incident's rootCause field; the response returns { id, title, status, rootCause, updatedAt }.
DELETE /incidents/:id
Deletes the incident.