---
title: "PATCH /cameras/{cameraId}/ptz/settings"
method: PATCH
path: "/cameras/{cameraId}/ptz/settings"
tags: ["PTZ"]
---

# PATCH /cameras/{cameraId}/ptz/settings

`PATCH /cameras/{cameraId}/ptz/settings`

Updates the PTZ settings for the given camera.

## Request body

- PtzSettings
  - `presets` PtzPreset[] — Saved positions. Order of this array will be used by the tour mode.
    - `name` string, required
    - `position` ApiPtzPosition, required — The ptz coordinates of the camera in a space defined as pan:(-1,1), tilt:(-1,1), zoom:(0,1).
      - `x` number, double — Pan coordinate given as value between -1(max left) and 1(max right).
      - `y` number, double — Tilt coordinate given as value between -1(max down) and 1(max up).
      - `z` number, double — Zoom coordinate given as value between 0(fully zoomed out) and 1(fully zoomed in).
    - `timeAtPreset` integer, required — Specifies the number of seconds to remain at a preset when in tour mode.
  - `homePreset` string, nullable — Name of the default preset to which the camera will return if set to homeReturn after the specified auto start delay.
  - `mode` 'homeReturn' | 'tour' | 'manualOnly' — The following modes are available: * `manualOnly`: The PTZ camera will only move when issued a direct command by the user. * `homeReturn`: After a specified amount of time without receiving a command, the PTZ camera will navigate back to the home preset position. If none is set, this will be the factory default position. * `tour`: After the specified auto start delay, the PTZ camera will tour through all presets in the order specified by the user. It will continue doing so until interrupted and will resume after the aforementioned auto start delay.
  - `autoStartDelay` integer — The time in seconds after which the PTZ camera should resume Touring or return to Home when idling.

## Response `204`

Camera Updated

## Other responses

- `400` — The supplied object is invalid. Error detail will contain the validation error.
- `401` — You are not authenticated. Please authenticate and try again.
- `403` — You have no permission to access the specified resource.
- `404` — Referenced resource could not be found.
- `500` — Something went wrong in the server. Please try again.

---

[API](https://skmtc.net/eagleeyenetworks/apis/devices.md) · [All operations](https://skmtc.net/eagleeyenetworks/apis/devices/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eagleeyenetworks/devices/versions/df57313de545/schema)