sites

Pause Site Cameras

Hold back NEW alarms on cameras for 5, 10 or 15 minutes (operator ask 2026-10-28).

review_label_alarms AND the site in the caller's scope (the service checks it), the same keys as the early disarm: every operator who works the queue and a Parent Manager, not a customer account or location manager nor a read-only login. The limits, the whole-site rule and the pre-registration block are enforced in the service under the site lock; going over them needs an ops lead with limit_override and a note.

post/sites/{site_id}/camera-pauses

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}/camera-pauses
Auth
HTTP bearer

Path parameters

site_idstring required

Request body

camera_idsstring[] required

Cameras at this site to pause now. All-or-nothing: one camera that cannot be paused refuses the whole request and names it.

minutes5 | 10 | 15 required

How long to pause: 5, 10 or 15 minutes. It ends by itself; there is no extend.

reason'delivery' | 'maintenance' | 'cleaning' | 'other' required

Why the operator is pausing. 'other' requires a note.

notestring nullable

Free text kept on the pause and in the Activity Log. Staff only; never shown to customers.

request_idstring uuid required

Client-generated idempotency key for this press. A retry with the same id returns the rows the first attempt wrote and uses up no limit.

limit_overrideboolean

An ops lead only: pause past the per-site and per-camera limits, or past the rule that stops every monitored camera at a site being paused. Requires a note. The pause is still capped at 15 minutes.

Example request

{
  "minutes": 10,
  "reason": "delivery",
  "note": "Linen truck at dock, driver on the phone with the manager"
}

Response

Successful Response

site_idstring uuid required

The site.

timezonestring required

The site's IANA zone.

as_ofstring date-time required

The server instant everything here was resolved at.

changed_camera_idsstring[]

On a pause or resume: the cameras this request actually changed.

deduplicatedboolean

True when this was a retry of an earlier pause and nothing new was written.

Example response

{
  "timezone": "America/Chicago",
  "limits": {
    "allowed_minutes": [
      5,
      10,
      15
    ]
  },
  "cameras": [
    {
      "paused": {
        "minutes": 10,
        "reason": "delivery"
      }
    }
  ]
}

Changes

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