KOkontainer
DAM: Files

Updates a subtitle track of a DAM file

Updates the attributes sent. Sending cues (JSON) or srt (SubRip text) replaces every cue of the track; send one of them, not both. See the two request examples. The response does not carry the cues; read them from the track's cue list.

patch/dam/files/{file_id}/subtitles/{subtitle_id}

Request

Path parameters

file_idstring required

ID of File

subtitle_idstring required

ID of Subtitle

Request body

Example request

{
  "data": {
    "type": "file_subtitle",
    "attributes": {
      "language": "da",
      "label": "Dansk",
      "is_default": true,
      "cues": [
        {
          "start_ms": 1000,
          "end_ms": 3500,
          "text": "Welcome to Kontainer."
        }
      ]
    }
  }
}

Response

success

Example response

{
  "data": {
    "id": "42",
    "type": "file_subtitle",
    "attributes": {
      "language": "da",
      "label": "Dansk",
      "source": "import",
      "is_default": true,
      "version": 1,
      "created_at": "2026-10-14T10:00:00.000000Z",
      "updated_at": "2026-10-14T10:00:00.000000Z"
    },
    "relationships": {
      "cues": {
        "links": {
          "related": "https://example.kontainer.com/jsonapi/v1/dam/files/12/subtitles/42/cues"
        }
      }
    },
    "links": {
      "self": "https://example.kontainer.com/jsonapi/v1/dam/files/12/subtitles/42"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.