Skip to main content
GET
List mouse events on a clip

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Path Parameters

id
string
required

Video identifier

Example:

"vid_abc123def456"

clipId
string
required

Clip identifier

Example:

"cl_xyz789ghi012"

Query Parameters

startTimeMs
integer

Only return items at or after this time, in ms on the clip's playback timeline. Defaults to the clip's start.

Required range: 0 <= x <= 9007199254740991
Example:

60000

endTimeMs
integer

Only return items before this time (exclusive), in ms on the clip's playback timeline. Must be greater than startTimeMs. Defaults to the clip's end. Page through a long clip with windows that meet end to start.

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

120000

intervalMs
integer

Thin move events to at most one per this many ms of playback — clicks are always kept. Defaults to 100. Pass 0 for every recorded event (can be tens of thousands on long recordings).

Required range: 0 <= x <= 9007199254740991
Example:

100

types
string

Comma-separated event kinds to return: clicks, moves. Default: both. Use types=clicks for the positions where a mouse button went down — one event per press, not one per sample of a held button.

Example:

"clicks"

Response

OK

Mouse events from the clip's screen recording. Empty when the recording has no mouse data (camera-only clips, uploads, older recorder versions).

events
object[]
required
Last modified on October 6, 2026