> ## Documentation Index
> Fetch the complete documentation index at: https://www.tella.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Blurs and highlights

> Blur sensitive regions or highlight areas of the screen for a time range.

Mask a rectangular region of the clip's screen layer to either blur it (hide sensitive info) or highlight it (draw attention). Both share the same shape: a rectangle defined by a top-left `point` and `dimensions`, both in percentages, plus an optional `intensity` from 0 to 1:

* For a blur, `intensity` scales the blur strength — 0 is the standard blur, 1 is three times as heavy. The content stays fully hidden at every value.
* For a highlight, it sets how dark the area outside the highlight goes — 0 is no dimming, 1 is black. Defaults to 0.7.

<Note>
  **All times are milliseconds on the clip's playback timeline** — the video as watched, with cuts applied. It is the same timeline as `get_transcript`, thumbnails, and previews, so nothing needs converting. A start at or past the end of the clip is rejected with a `400`.
</Note>

## list\_blurs

List blur masks on a clip.

<ParamField path="videoId" type="string" required>
  Video ID
</ParamField>

<ParamField path="clipId" type="string" required>
  Clip ID
</ParamField>

## add\_blur

Add a blur mask to a clip.

<ParamField path="videoId" type="string" required>
  Video ID
</ParamField>

<ParamField path="clipId" type="string" required>
  Clip ID
</ParamField>

<ParamField path="startTimeMs" type="integer" required>
  Start time in ms
</ParamField>

<ParamField path="durationMs" type="integer" required>
  Duration in ms
</ParamField>

<ParamField path="point" type="object" required>
  Top-left corner — `{xPct, yPct}` (0-100)

  <Expandable title="properties">
    <ParamField path="xPct" type="number" required>
      0-100
    </ParamField>

    <ParamField path="yPct" type="number" required>
      0-100
    </ParamField>
  </Expandable>
</ParamField>

<ParamField path="dimensions" type="object" required>
  Rectangle size — `{widthPct, heightPct}` (0-100)

  <Expandable title="properties">
    <ParamField path="widthPct" type="number" required>
      0-100
    </ParamField>

    <ParamField path="heightPct" type="number" required>
      0-100
    </ParamField>
  </Expandable>
</ParamField>

<ParamField path="intensity" type="number">
  Blur strength (0-1). 0 is the standard blur, 1 blurs three times as heavily. Defaults to 0.
</ParamField>

## update\_blur

Update an existing blur.

<ParamField path="videoId" type="string" required>
  Video ID
</ParamField>

<ParamField path="clipId" type="string" required>
  Clip ID
</ParamField>

<ParamField path="maskId" type="string" required>
  Mask ID
</ParamField>

<ParamField path="startTimeMs" type="integer">
  New start time in ms
</ParamField>

<ParamField path="durationMs" type="integer">
  New duration
</ParamField>

<ParamField path="point" type="object">
  New top-left

  <Expandable title="properties">
    <ParamField path="xPct" type="number" required>
      0-100
    </ParamField>

    <ParamField path="yPct" type="number" required>
      0-100
    </ParamField>
  </Expandable>
</ParamField>

<ParamField path="dimensions" type="object">
  New size

  <Expandable title="properties">
    <ParamField path="widthPct" type="number" required>
      0-100
    </ParamField>

    <ParamField path="heightPct" type="number" required>
      0-100
    </ParamField>
  </Expandable>
</ParamField>

<ParamField path="intensity" type="number">
  New blur strength (0-1)
</ParamField>

## remove\_blur

Remove a blur from a clip.

<ParamField path="videoId" type="string" required>
  Video ID
</ParamField>

<ParamField path="clipId" type="string" required>
  Clip ID
</ParamField>

<ParamField path="maskId" type="string" required>
  Mask ID
</ParamField>

## list\_highlights

List highlight masks on a clip.

<ParamField path="videoId" type="string" required>
  Video ID
</ParamField>

<ParamField path="clipId" type="string" required>
  Clip ID
</ParamField>

## add\_highlight

Add a highlight mask to a clip.

<ParamField path="videoId" type="string" required>
  Video ID
</ParamField>

<ParamField path="clipId" type="string" required>
  Clip ID
</ParamField>

<ParamField path="startTimeMs" type="integer" required>
  Start time in ms
</ParamField>

<ParamField path="durationMs" type="integer" required>
  Duration in ms
</ParamField>

<ParamField path="point" type="object" required>
  Top-left corner — `{xPct, yPct}` (0-100)

  <Expandable title="properties">
    <ParamField path="xPct" type="number" required>
      0-100
    </ParamField>

    <ParamField path="yPct" type="number" required>
      0-100
    </ParamField>
  </Expandable>
</ParamField>

<ParamField path="dimensions" type="object" required>
  Rectangle size — `{widthPct, heightPct}` (0-100)

  <Expandable title="properties">
    <ParamField path="widthPct" type="number" required>
      0-100
    </ParamField>

    <ParamField path="heightPct" type="number" required>
      0-100
    </ParamField>
  </Expandable>
</ParamField>

<ParamField path="intensity" type="number">
  How dark the area outside the highlight goes (0-1, 1 is black). Defaults to 0.7.
</ParamField>

## update\_highlight

Update an existing highlight.

<ParamField path="videoId" type="string" required>
  Video ID
</ParamField>

<ParamField path="clipId" type="string" required>
  Clip ID
</ParamField>

<ParamField path="maskId" type="string" required>
  Mask ID
</ParamField>

<ParamField path="startTimeMs" type="integer">
  New start time in ms
</ParamField>

<ParamField path="durationMs" type="integer">
  New duration
</ParamField>

<ParamField path="point" type="object">
  New top-left

  <Expandable title="properties">
    <ParamField path="xPct" type="number" required>
      0-100
    </ParamField>

    <ParamField path="yPct" type="number" required>
      0-100
    </ParamField>
  </Expandable>
</ParamField>

<ParamField path="dimensions" type="object">
  New size

  <Expandable title="properties">
    <ParamField path="widthPct" type="number" required>
      0-100
    </ParamField>

    <ParamField path="heightPct" type="number" required>
      0-100
    </ParamField>
  </Expandable>
</ParamField>

<ParamField path="intensity" type="number">
  New dimming level outside the highlight (0-1)
</ParamField>

## remove\_highlight

Remove a highlight from a clip.

<ParamField path="videoId" type="string" required>
  Video ID
</ParamField>

<ParamField path="clipId" type="string" required>
  Clip ID
</ParamField>

<ParamField path="maskId" type="string" required>
  Mask ID
</ParamField>


## Related topics

- [Blur or highlight part of the screen](/docs/help/editing/blurring-and-highlighting.md)
- [Update a highlight](/docs/api-reference/clips/update-a-highlight.md)
- [Update a blur](/docs/api-reference/clips/update-a-blur.md)
- [Add a highlight to a clip](/docs/api-reference/clips/add-a-highlight-to-a-clip.md)
- [List highlights on a clip](/docs/api-reference/clips/list-highlights-on-a-clip.md)