VEverdun
site summaries

Update Site Summary Settings

Upsert this site's summary settings (owner or site manager only).

The activity log is recorded AFTER the commit and records field names only — the same rule every other write in this repo follows.

put/sites/{site_id}/summary-settings

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/sites/{site_id}/summary-settings
  • Auth
    HTTP bearer

Path parameters

site_idstring uuid required

Request body

email_enabledboolean required

Send the daily e-mail for this site at all.

send_local_timestring required

24h HH:MM wall clock in the SITE's timezone, no seconds and no offset. Before noon closes last night's window; noon or later closes today's.

send_on_quiet_daysboolean required

Send even when nothing happened.

min_outage_minutesinteger required

Shortest camera outage worth reporting, in minutes (1..1440).

sectionsobject

Which e-mail sections render, by the four keys narrative/stats/escalations/outages. A missing key means ON; an unknown key is ignored.

Example request

{
  "email_enabled": true,
  "send_local_time": "07:00",
  "send_on_quiet_days": true,
  "min_outage_minutes": 10,
  "sections": {
    "escalations": true,
    "narrative": true,
    "outages": false,
    "stats": true
  }
}

Response

Successful Response

site_idstring required

Site UUID these settings belong to.

email_enabledboolean required

Whether the daily e-mail is sent for this site at all. Defaults to false — a site opts in.

send_local_timestring required

24h HH:MM wall clock in the site's timezone. The noon pivot reads off it: a morning send closes last night, an evening send closes today.

send_on_quiet_daysboolean required

Send even when nothing happened. False skips the mail and records a skipped_quiet send row.

min_outage_minutesinteger required

Shortest camera outage worth reporting, in minutes. Quantised to 5-minute telemetry buckets downstream, so the rendered value reads 'about N min'.

sectionsobject required

Which of the four e-mail sections render: narrative, stats, escalations, outages. Always all four keys.

is_defaultboolean required

True when NO settings row exists and these are the defaults. A row that happens to equal the defaults reads false.

Example response

{
  "site_id": "3f1e0d2c-1111-4222-8333-444455556666",
  "send_local_time": "07:00",
  "send_on_quiet_days": true,
  "min_outage_minutes": 10,
  "sections": {
    "escalations": true,
    "narrative": true,
    "outages": true,
    "stats": true
  },
  "is_default": true
}

Changes

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