---
title: "Set Camera Health Reference"
method: POST
path: "/cameras/{camera_id}/health-reference"
tags: ["cameras"]
---

# Set Camera Health Reference

`POST /cameras/{camera_id}/health-reference`

## 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}/health-reference`
- Auth: HTTP bearer

## Path parameters

- `camera_id` string, required

## Request body

- SetCameraHealthReferenceRequest
  - `sample_id` string, uuid, nullable: Health sample whose captured frame becomes the reference image. Omit or send null to use the camera's most recent sample that actually has a frame. A sample belonging to another camera, or one with no frame, is rejected with 400.

## Response `200`

Successful Response

- SetCameraHealthReferenceResponse
  - `id` string, uuid, required: The camera id.
  - `reference_set_at` string, date-time, required: When this reference image was adopted.
  - `reference_url` string, required: Presigned GET URL for the reference image.
  - `expires_in` integer, required: Seconds the presigned reference_url stays valid, counted from this response.

## 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/35a2a6ebedda?raw)