> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.doc-detective.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.doc-detective.com/_mcp/server.

# Recording verify guards

> Structural assertions on the produced video file, evaluated when the recording stops. Unlike checkpoint drift (a WARNING), a violated guard FAILs the stopRecord step — these are properties you explicitly demand of the artifact.

Structural assertions on the produced video file, evaluated when the recording stops. Unlike checkpoint drift (a WARNING), a violated guard FAILs the stopRecord step — these are properties you explicitly demand of the artifact.

## Referenced In

* [Record (detailed)](/reference/schemas/record-detailed)

## Fields

| Field       | Type                                                                                                      | Description                                                                                                                                                                                                                                                                                                                               | Default |
| :---------- | :-------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------ |
| minDuration | number                                                                                                    | Optional. Fail if the video is shorter than this many seconds. Minimum: 0                                                                                                                                                                                                                                                                 | —       |
| maxDuration | number                                                                                                    | Optional. Fail if the video is longer than this many seconds. Minimum: 0                                                                                                                                                                                                                                                                  | —       |
| resolution  | one of: - boolean - object([Verify resolution (detailed)](/reference/schemas/verify-resolution-detailed)) | Optional. Verify the video's dimensions (±2 pixels — encoders round to even dimensions). `true` compares against the capture plan's resolved expectation (the crop rectangle when a window/viewport crop applied, else the capture frame size; skipped when no expectation exists for the engine). An object compares literal dimensions. | —       |
| notBlack    | boolean                                                                                                   | Optional. Fail if the video is essentially all black (black frames cover 95% or more of its duration) — the classic symptom of a broken screen capture.                                                                                                                                                                                   | —       |

## Examples

```json
{
  "minDuration": 42,
  "maxDuration": 42,
  "resolution": true,
  "notBlack": true
}
```