VEverdun
events

Get Event Clip Url

Freshly presign the event's clip (1h). The clip object is HEAD-checked first: 404 when the event has no clip key, 409 CLIP_UNAVAILABLE when the key exists but the object is gone from storage (the clips/ lifecycle). A starred event plays from its retained starred-clips/ copy when it has one. continued_clip_url (same expiry) is set only once the ingestor has committed a continued clip for the alarm; extended_clip_url is presigned blind.

get/events/{event_id}/clip-url

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}/clip-url
  • Auth
    HTTP bearer

Path parameters

event_idstring required

Response

Successful Response

clip_urlstring required

Freshly presigned URL for the event's clip

expires_ininteger required

Seconds until the presigned URL expires

extended_clip_urlstring nullable

Presigned URL for the event's extended pre-roll ("Rewind") clip, valid for the same expires_in as clip_url. Null when the clip key does not derive one (demo/training/pre-cutover rows) or the presign failed. Presigned BLIND: a non-null URL does NOT mean the object exists — probe it (a 403/404 means the extended clip was never uploaded or has expired by the clips-extended/ 7-day lifecycle).

continued_clip_urlstring nullable

Presigned URL for the event's continued clip (the extra seconds cut when motion was still firing after the clip's post-roll), valid for the same expires_in as clip_url. Null when the alarm has no committed continued clip (event.has_continued_clip false), when the continuation is older than the clip retention window (it has expired from storage; same window as the main clip's clips/ lifecycle) or the presign failed. Unlike extended_clip_url it is NOT blind: it is only minted after the ingestor committed the upload.

continued_poster_urlstring nullable

Presigned URL for the continued clip's poster frame (JPEG), valid for the same expires_in as clip_url. Set under exactly the same conditions as continued_clip_url, else null. Presigned BLIND: the ingestor writes the poster best-effort, so the object may be absent; fall back on a load error.

clip_display_rotationinteger nullable

Display rotation (degrees CCW: 0, 90, 180 or 270) already applied by clip_url's own container tag. 0 = untagged; null = unknown (HEAD failed/timed out or stamp unreadable). Players must not turn a clip again that is tagged non-zero.

extended_clip_display_rotationinteger nullable

Same as clip_display_rotation, for extended_clip_url (Rewind). Inferred from the main clip when the camera was never rotated (not an availability signal); otherwise probed with one HEAD, and then null when the object is absent or the HEAD did not answer within 1 s. Null when there is no extended URL.

continued_clip_display_rotationinteger nullable

Same as clip_display_rotation, for continued_clip_url. Inferred from the main clip when the camera was never rotated (not an availability signal); otherwise probed with one HEAD, and then null when the object is absent or the HEAD did not answer within 1 s. Null when there is no continued clip.

Changes

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