Remove a subtitle track

DELETE

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

• Local development behind nginx (port 8088 by default)

Deletes the (asset, lang) subtitle track. The underlying WebVTT file in CAS stays (storage GC is a separate process).

Returns 422 when the asset’s renderable kind doesn’t support subtitles — the policy gate fires BEFORE the row lookup, so a Delete on an image asset returns “not applicable” (422) rather than “not found” (404).

Authorizations

• cookieAuth
• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

lang

required

string

RFC 5646 language tag of the track to delete.

Responses

204

Track deleted.

401

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"
}

404

Resource not found

object

error

required

Human-readable error summary

string

Example

the request could not be completed

422

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