v1

latestOpenAPI 3.1.02026-07-171921144.8 KB
incident-submission

Submit Incident for Processing

Submit a new incident (NvSchema) for processing and publish to Kafka. Accepts NvSchema Incident JSON (default) or a serialized Protobuf Incident (set Content-Type: application/x-protobuf).

post/api/v1/incidents

Request body

idstring required
timestampstring date-time required
endstring date-time
sensorIdstring required
categorystring
infoobject
eventobject

Response

Incident accepted and queued

statusstring required

Submission status

idstring required

Original event ID (used for correlation)

messagestring required

Human-readable status message

timestampstring required

Processing timestamp (ISO 8601)

Example response

{
  "id": "evt-12345-67890",
  "message": "Alert queued for processing",
  "status": "accepted",
  "timestamp": "2025-01-15T14:30:05Z"
}