Update a PTZ preset position

Updates an existing preset to the camera's current position. Move the camera first. This is allowed
for ACTIVE presets and FAILED presets with error.code PRESET_OVERWRITTEN_BY_EDGE. The record moves
through PENDING and returns as ACTIVE when confirmed.

The camera may assign a different token; always use the returned value. Token conflicts return
EDGE_RETURNED_RESERVED_TOKEN (409). PRESET_FINALIZATION_PENDING (202) means the camera accepted the
change but Cloud finalization is incomplete. EDGE_RESULT_UNKNOWN (202) means the camera result is unknown.

HTTP 202 means the result is unconfirmed. Do not retry after a 202, timeout or connection loss until
you refresh the relevant data and reconcile the camera state.

Required scope: write:ptz

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Camera identifier from the Cameras API; must belong to the API-key organization.

string
required
^[a-fA-F0-9]{24}$

Cloud preset _id from GET presets, not the camera presetToken.

Responses

429

Too many requests. Try again later.

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json