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

# PUT /cameras/{cameraId}/ptz/position

`PUT /cameras/{cameraId}/ptz/position`

This endpoint moves the camera to a specific position, in a specific direction, or to a specific center point on the screen. The endpoint accepts a move object that can be either a position move, a direction move or a center move.

## Request body

- union
  - object — Move the center of the camera to the indicated(clicked) point within the shown image. The point is encoded as the relative x and y based on the width and height of the shown image on a scale from 0 to 1, where the (0,0) coordinate is top left and (1,1) is bottom right.
    - `moveType` 'centerOn', required
    - `relativeX` number, double, required — Relative x coordinate.
    - `relativeY` number, double, required — Relative y coordinate.
  - object — Move the camera in the given direction.
    - `moveType` 'direction', required
    - `direction` string[], required — The direction to move in.
    - `stepSize` 'small' | 'medium' | 'large' — How much we will move, if no stepSize is given then `medium` stepsize is taken.
  - object — 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).
    - `moveType` 'position', required

## Response `204`

Camera moved to given position.

## 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.
- `409` — There was a conflict while trying to perform your request. See error details for more information.
- `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)