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.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”The asset’s id.
The language tag of the track to remove, exactly as stored, such as en-US.
Responses
Section titled “ Responses ”The track was removed.
Authentication required, missing, or invalid
object
Human-readable error summary
Example
the request could not be completedExample
{ "error": "authentication required: sign in and retry with a valid session or API token"}Resource not found
object
Human-readable error summary
Example
the request could not be completedRequest shape is valid but the action doesn’t apply (e.g. subtitles on a non-video/audio asset).
object
Human-readable error summary
Example
the request could not be completed