telephony

Email Owner

E-mail the site's property contact about this event. The destination is resolved from the named contact's row — no address is ever accepted from the client. 503 until OWNER_EMAIL_ENABLED is set.

post/events/{event_id}/email-owner

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}/email-owner
Auth
HTTP bearer

Path parameters

event_idstring required

Request body

contact_idstring required

Site contact to e-mail; must belong to the event's site

subjectstring nullable

Subject line. Omitted or blank falls back to a server-composed default naming the incident, site and camera.

messagestring required

Message body, sent verbatim above a fixed footer. AI-drafted client-side; the operator owns the final text. Whitespace only is rejected.

attach_snapshotboolean

Attach the event's alert-frame JPEG to the e-mail. 409 SNAPSHOT_UNAVAILABLE when this event has no snapshot - nothing is written and nothing is sent in that case. Absent or false behaves exactly as before.

snapshot_offset_msinteger nullable

WHICH moment of the clip to attach, as cut by POST /events/{id}/snapshot-frame. Only meaningful with attach_snapshot (422 otherwise). Absent, the alert-frame poster is attached.

include_clip_linkboolean

Append a login-free, expiring link to this event's clip, above the footer. The URL is added by the SERVER. 503 when clip links are not configured on this deployment, 409 when the event has no clip.

Example request

{
  "contact_id": "2dd7154e-21dc-408f-ac25-b2918d591e29",
  "subject": "Verdun Security: Intrusion at Example Yard (North Gate)",
  "message": "We saw two people on foot near the loading dock at 23:14.",
  "snapshot_offset_ms": 7300
}

Response

Successful Response

object required

Changes

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