Skip to main content
PATCH
/
v1
/
videos
/
{id}
/
clips
/
{clipId}
/
zooms
/
{zoomId}
Update a zoom
curl --request PATCH \
  --url https://api.tella.com/v1/videos/{id}/clips/{clipId}/zooms/{zoomId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "durationMs": 123,
  "scale": 2,
  "startTimeMs": 4503599627370495,
  "type": "manualZoom"
}
'
{
  "zoom": {
    "durationMs": 2000,
    "id": "ef_abc123",
    "startTimeMs": 1000,
    "type": "manualZoom",
    "focusPoint": {
      "xPct": 50,
      "yPct": 50
    },
    "scale": 2
  }
}

Documentation Index

Fetch the complete documentation index at: https://tella.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key obtained from your Tella account settings

Path Parameters

​
id
string
required

Video ID

​
clipId
string
required

Clip ID

​
zoomId
string
required

Zoom ID

Body

application/json

Update an existing zoom

​
durationMs
integer
Required range: x <= 9007199254740991
​
focusPoint
object

Point on the screen recording to zoom into, expressed as percentages of the screen dimensions. Required for manualZoom; ignored for trackingZoom.

​
scale
number

Magnification factor (1 = no zoom, 3.5 = max).

Required range: 1 <= x <= 3.5
Example:

2

​
startTimeMs
integer
Required range: 0 <= x <= 9007199254740991
​
type
enum<string>

manualZoom zooms into a fixed focusPoint on the screen. trackingZoom automatically follows the cursor in the screen recording.

Available options:
manualZoom,
trackingZoom
Example:

"manualZoom"

Response

OK

A zoom on a clip

​
zoom
object
required

A zoom effect applied to the clip's screen layer (does not affect the camera). Use manualZoom with a focusPoint, or trackingZoom to follow the cursor automatically.