Captions

List all available captions for the given media

get

Authorizations

UserSession

AuthorizationstringRequired

Path parameters

media_idinteger · int64Required

The ID of the media.

Responses

200

The list of captions that are available for the media.

application/json

401

Authorization information is missing or invalid.

403

If a user without proper permissions tries to call this endpoint, the call is rejected with 403 Forbidden.

404

The media was not found by ID.

422

Invalid media_id is provided.

get

/media/{media_id}/caption_files

HTTPcURLJavaScriptPython

GET /api/public/v1/media/{media_id}/caption_files HTTP/1.1
Host: tw.instructuremedia.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "caption_files": [
    {
      "id": 1,
      "url": "text",
      "srclang": "text",
      "subtitle_format": "text",
      "label": "text",
      "status": "text",
      "created_at": "2025-12-27T10:51:59.725Z"
    }
  ]
}

Create a new caption for the given media

post

Authorizations

UserSession

AuthorizationstringRequired

Path parameters

media_idinteger · int64Required

The ID of the media.

Query parameters

srclangstringRequired

The language of the caption.

Body

multipart/form-data

caption_filestringRequired

The file to be uploaded.

Responses

201

The caption object that was created.

application/json

401

Authorization information is missing or invalid.

403

If a user without proper permissions tries to call this endpoint, the call is rejected with 403 Forbidden.

404

The media was not found by ID.

422

Invalid media_id is provided.

post

/media/{media_id}/caption_files

HTTPcURLJavaScriptPython

POST /api/public/v1/media/{media_id}/caption_files?srclang=text HTTP/1.1
Host: tw.instructuremedia.com
Authorization: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 23

{
  "caption_file": "text"
}

{
  "caption_file": {
    "id": 1,
    "url": "text",
    "srclang": "text",
    "subtitle_format": "text",
    "label": "text",
    "status": "text",
    "created_at": "2025-12-27T10:51:59.725Z"
  }
}

Download a caption by id

get

Authorizations

UserSession

AuthorizationstringRequired

Path parameters

caption_file_idinteger · int64Required

The ID of the caption.

Responses

200

The caption file itself

401

Authorization information is missing or invalid.

403

If a user without proper permissions tries to call this endpoint, the call is rejected with 403 Forbidden.

404

The caption was not found by id.

422

Invalid caption_file_id is provided.

get

/caption_files/{caption_file_id}/download

HTTPcURLJavaScriptPython

GET /api/public/v1/caption_files/{caption_file_id}/download HTTP/1.1
Host: tw.instructuremedia.com
Authorization: YOUR_API_KEY
Accept: */*

No content