Streamio API Documentation

Subtitles - Create

Create a subtitle on your account with the specified parameters. Don't forget to specify POST as the request method as GET will call the list action rather than create.

Request

Url

https://streamio.com/api/v1/subtitles.format

Request Method

POST

Parameters

  • file The subtitle file you want to upload. This is the only required parameter. The file has to be in WebVTT format or SRT (will be auto-converted to VTT)
  • title The title of the subtitle. If you don't specify this the filename of the file parameter will be used.
  • display_title The display title of the subtitle shown in the player
  • description A textual description of the subtitle
  • language 2-letter ISO 639-1 language code
  • tags The tags you wish to set for the subtitle. Multiple tags are separated by comma.

Response

Code

201

Body

Examples

A simple create

Simplest case scenario is to just post with the file parameter set to a subtitle file on your hard drive.

curl -u username:password \
     -X POST \
     -F file=@path/to/subtitle.vtt \
     https://streamio.com/api/v1/subtitles.json