v1

latestOpenAPI 3.1.02026-07-171921144.8 KB
alert-submission

Submit Alert for Processing

Submit a new alert for processing through the Alert Agent pipeline. Accepts NvSchema Behavior JSON (default) or a serialized Protobuf Behavior (set Content-Type: application/x-protobuf).

post/api/v1/alerts

Request body

idstring required
timestampstring date-time required
endstring date-time
videoPathstring

Response

Alert accepted and queued for processing

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"
}