Captions
The ID of the media.
The list of captions that are available for the media.
Authorization information is missing or invalid.
If a user without proper permissions tries to call this endpoint, the call is rejected with 403 Forbidden.
The media was not found by ID.
Invalid media_id is provided.
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-08-25T07:15:14.819Z"
}
]
}
The ID of the media.
The language of the caption.
The file to be uploaded.
The caption object that was created.
Authorization information is missing or invalid.
If a user without proper permissions tries to call this endpoint, the call is rejected with 403 Forbidden.
The media was not found by ID.
Invalid media_id is provided.
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-08-25T07:15:14.819Z"
}
}
The ID of the caption.
The caption file itself
Authorization information is missing or invalid.
If a user without proper permissions tries to call this endpoint, the call is rejected with 403 Forbidden.
The caption was not found by id.
Invalid caption_file_id is provided.
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?