cameras

Update Detection Mode

put/cameras/{camera_id}/detection-mode

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/cameras/{camera_id}/detection-mode
  • Auth
    HTTP bearer

Path parameters

camera_idstring required

Request body

detection_mode'legacy' | 'ii_gated' nullable required

'ii_gated' delegates the DeepAlert object-of-interest gate to incident intelligence for this camera's clips; 'legacy' keeps today's upstream ingestion-side DeepAlert gating. null is accepted and means exactly 'legacy' (it is how an unflipped camera reads). Required — omitting the field is a 422, not a no-op.

Example request

{
  "detection_mode": "ii_gated"
}

Response

Successful Response

idstring uuid required

Camera row id.

camera_labelstring nullable

Human label.

detection_modestring required

The camera's detection mode after this call: 'legacy' | 'ii_gated'. Never null.

previous_detection_modestring required

The canonical mode before this call, same vocabulary. Equal to detection_mode on a no-op.

changedboolean required

False when the requested mode already matched (no write, no health-signal clear, nothing journaled).

ii_enabledboolean required

Whether incident intelligence is on for this camera (ii_gated requires it).

ii_deepalert_statestring nullable

II-side DeepAlert health observation after this call; null after any real mode change (cleared on flip).

ii_deepalert_atstring date-time nullable

Ordering key / observation date for ii_deepalert_state; null after any real mode change.

Example response

{
  "camera_label": "18 - SW Exterior Quad - North",
  "detection_mode": "ii_gated",
  "previous_detection_mode": "legacy",
  "ii_deepalert_state": "ok"
}

Changes

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