Skip to content

Remove a subtitle track

DELETE
/assets/{id}/subtitle-tracks/{lang}

Removes an asset’s subtitle track in one language. lang must match the stored tag exactly, including case. Tracks made by AI transcription can be removed the same way.

Only the track goes. Its WebVTT file stays in storage, and the server doesn’t delete stored bytes at the moment; the asset itself isn’t changed.

The asset’s type is checked first: an asset that isn’t Video, Audio or Audiobook gets a 422 even if you name a track, and an unknown id or an asset in the trash gets a 404. Then a lang that matches no track gets a 404; the tag’s shape isn’t checked here.

Any signed-in account can remove tracks from any such asset; ownership and edit rights aren’t checked yet. If the database fails, the server currently answers 200 with an empty body instead of an error, and you can’t tell whether the track was removed.

id
required
string format: uuid

The asset’s id.

lang
required
string

The language tag of the track to remove, exactly as stored, such as en-US.

The track was removed.

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed

Request shape is valid but the action doesn’t apply (e.g. subtitles on a non-video/audio asset).

object
error
required

Human-readable error summary

string
Example
the request could not be completed