Captions

List all available captions for the given media

get
Authorizations
Path parameters
media_idinteger · int64Required

The ID of the media.

Responses
200
The list of captions that are available for the media.
application/json
get
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-06-27T08:04:15.362Z"
    }
  ]
}

Create a new caption for the given media

post
Authorizations
Path parameters
media_idinteger · int64Required

The ID of the media.

Query parameters
srclangstringRequired

The language of the caption.

Body
caption_filestringRequired

The file to be uploaded.

Responses
201
The caption object that was created.
application/json
post
POST /api/public/v1/media/{media_id}/caption_files 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-06-27T08:04:15.362Z"
  }
}

Download a caption by id

get
Authorizations
Path parameters
caption_file_idinteger · int64Required

The ID of the caption.

Responses
200
The caption file itself
get
GET /api/public/v1/caption_files/{caption_file_id}/download HTTP/1.1
Host: tw.instructuremedia.com
Authorization: YOUR_API_KEY
Accept: */*

No content

Last updated

Was this helpful?