Skip to main content

Camera Set

PUT 

/camera/:camera_name/set/:feature/:sub_command

Access: Admin role required.

Set a camera feature state. Use camera_name='*' to target all cameras.

The value to set is sent in the request body as {"value": "<value>"}.

FeatureAccepted values
enabledON, OFF
detectON, OFF
motionON, OFF
recordingsON, OFF
snapshotsON, OFF
audioON, OFF
audio_transcriptionON, OFF
notificationsON, OFF
review_alertsON, OFF
review_detectionsON, OFF
object_descriptionsON, OFF
review_descriptionsON, OFF
improve_contrastON, OFF
ptz_autotrackerON, OFF
birdseyeON, OFF
birdseye_modeCONTINUOUS, MOTION, OBJECTS
motion_contour_areainteger
motion_thresholdinteger
motion_maskON, OFF
object_maskON, OFF
zoneON, OFF
profilea profile name, or none to deactivate

motion_mask, object_mask, and zone require the sub_command path parameter to be set to the name of the mask or zone. All other features reject a sub-command.

profile applies globally rather than per camera, so it requires camera_name to be *.

These features map to the equivalent MQTT topics, which document the behavior of each value in more detail.

Request​

Responses​

Successful Response