VEverdun
events

The alarm's picture: the poster, else a frame cut from the clip

Returns a presigned URL for the event's alert picture: one frame cut from the clip where the AI boxed a person or vehicle; else the ingestor's poster when it exists; else a frame cut at the alarm's trigger moment (server-chosen offsets), stored under snapshots/ so later calls are a HEAD and a presign. The first call for an event can take a few seconds. Tenant scope and visibility exactly like clip-url. 409 SNAPSHOT_UNAVAILABLE when there is no poster and no frame can be cut (no clip, clip expired, demo/training rows).

get/events/{event_id}/snapshot

Request

  • Base URL
    https://api.verdun.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.verdun.ai/events/{event_id}/snapshot
  • Auth
    HTTP bearer

Path parameters

event_idstring required

Response

Successful Response

source'poster' | 'clip_frame' required

poster = the ingestor's alert-frame JPEG (events before 2026-09-10); clip_frame = a frame cut from the clip where the AI boxed a person or vehicle, else at the alarm's trigger moment.

offset_msinteger nullable

For clip_frame, the clip offset the frame was cut at; null for poster.

urlstring required

Presigned image URL. A bearer: never persist it, never log it.

expires_ininteger required

Seconds until url expires

Changes

No recorded changes to this operation across all 2 revisions of this API.