VEverdun
camera-health

Check Camera View Flag Now

"Check now": ask the item's camera for a fresh frame and run the AI view check on it as soon as it lands (about a minute), instead of waiting for the next sweep. 202: the answer arrives as a new entry in the item's checks with received_at >= requested_at; poll GET /camera-health/flags. 409 when the item is no longer open or confirmed; 422 UNSUPPORTED_CAMERA for a camera with no health sampler. Not activity-logged: like "Re-check cameras", it changes no configuration.

post/camera-health/flags/{flag_id}/check-now

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/camera-health/flags/{flag_id}/check-now
  • Auth
    HTTP bearer

Path parameters

flag_idstring uuid required

Response

Successful Response

requested_atstring date-time required

Server time of the frame request. The answer is the item's first check with received_at at or after this. Inside the re-check cooldown it is the pending request's stamp, which this call rides.

camera_idstring uuid required

The item's camera.

already_pendingboolean required

True when a frame request was already pending (re-check cooldown); no new request was stamped.

woke_cameraboolean

True when the camera was outside its monitoring schedule (no stream running) and this call woke it the way live view does, for about 420 s, so its first frame can answer; motion and alarms stay suppressed. The answer takes longer (expected_within_seconds reflects it).

expected_within_secondsinteger required

How long the answer usually takes (ingestor poll + one sample + one vision call).

Example response

{
  "expected_within_seconds": 60
}

Changes

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