---
title: "Check Camera View Flag Now"
method: POST
path: "/camera-health/flags/{flag_id}/check-now"
tags: ["camera-health"]
---

# Check Camera View Flag Now

`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

"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.

## Path parameters

- `flag_id` string, uuid, required

## Response `202`

Successful Response

- CheckCameraViewFlagNowResponse
  - `requested_at` string, 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_id` string, uuid, required: The item's camera.
  - `already_pending` boolean, required: True when a frame request was already pending (re-check cooldown); no new request was stamped.
  - `woke_camera` boolean: 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_seconds` integer, required: How long the answer usually takes (ingestor poll + one sample + one vision call).

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verdun/apis/verdun-api.md) - [All operations](https://skmtc.dev/verdun/apis/verdun-api/llms.txt) - [OpenAPI document](https://skmtc.dev/verdun/apis/verdun-api/revisions/a19366be50a3?raw)