v1

latestOpenAPI 3.1.02026-07-171921144.8 KB
verification

Verify alert on demand

Async on-demand verification using category-based prompt lookup. Returns HTTP 202 with a correlationId immediately. VLM processing runs in the background and results are published to Kafka / Elasticsearch via the same sink as the Kafka pipeline.

post/api/v1/verification/ondemand

Request body

categorystring required
infoobject required

Must contain media_urls (list) and media_type ('video'|'image')

Example request

{
  "category": "collision",
  "end": "2026-04-22T10:00:30Z",
  "id": "incident-123",
  "info": {
    "media_type": "video",
    "media_urls": [
      "http://localhost:30888/vst/sim/media/incident.mp4"
    ]
  },
  "sensorId": "sensor-01",
  "timestamp": "2026-04-22T10:00:00Z"
}

Response

Verification request accepted for background processing

statusstring required
correlationIdstring required
messagestring required
timestampstring date-time required