Clips

Update a sound effect

Changed on Sep 28, 2026

Update a sound effect's name, timing, or volume. Only the fields you send are changed.

patch/v1/videos/{id}/clips/{clipId}/sound-effects/{soundEffectId}

Request

Base URL
https://api.tella.com
Auth
HTTP bearer
TypeScript
https://skmtc.dev/withchima/apis/tella-public-api/docs/v1/videos/:id/clips/:clipId/sound-effects/:soundEffectId/patch.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

idstring required

Video ID

clipIdstring required

Clip ID

soundEffectIdstring required

Sound effect ID

Request body

durationMsinteger

namestring

startTimeMsinteger

Start time. Milliseconds on the clip playback timeline (with cuts applied) — the same timeline as the cut transcript.

volumenumber

Playback volume (0 = muted, 1 = original).

Response

Example response

{
  "soundEffect": {
    "durationMs": 3000,
    "id": "ly_abc123",
    "name": "Whoosh",
    "sourceId": "su_abc123",
    "startTimeMs": 1000,
    "volume": 1
  }
}

Changes

Sep 28, 2026ac47c99c144f Revision changes
- warning
  added the new edit_conflict enum value to the response property for the response status
- warning
  added the new edit_conflict enum value to the response property for the response status
- warning
  added the new edit_conflict enum value to the response property for the response status
- warning
  added the new edit_conflict enum value to the response property for the response status
- warning
  added the new edit_conflict enum value to the response property for the response status
- warning
  added the new edit_conflict enum value to the response property for the response status
- warning
  added the new edit_conflict enum value to the response property for the response status
- warning
  added the new edit_conflict enum value to the response property for the response status
- warning
  added the new edit_conflict enum value to the response property for the response status
Sep 9, 20266b1132ef42fb Revision changes
- warning
  added the new conflict enum value to the response property for the response status
- warning
  added the new conflict enum value to the response property for the response status
- warning
  added the new conflict enum value to the response property for the response status
- warning
  added the new conflict enum value to the response property for the response status
- warning
  added the new conflict enum value to the response property for the response status
- warning
  added the new conflict enum value to the response property for the response status
- warning
  added the new conflict enum value to the response property for the response status
- warning
  added the new unavailable enum value to the response property for the response status
- warning
  added the new unavailable enum value to the response property for the response status
- warning
  added the new unavailable enum value to the response property for the response status
- warning
  added the new unavailable enum value to the response property for the response status
- warning
  added the new unavailable enum value to the response property for the response status
- warning
  added the new unavailable enum value to the response property for the response status
- warning
  added the new unavailable enum value to the response property for the response status
- info
  added the non-success response with the status
- info
  added the non-success response with the status

Operation history