Skip to Content

TwentyThree

TwentyThree™ API

API Method: /api/photo/subtitle/upload

Update subtitles to a video.

Parameters

ParameterDescription
photo_id (required)The video the subtitles are being uploaded to.
locale (required)A valid locale for the uploaded file.
file (required)The subtitle file, usually in .srt, .sub or .json formats.

If a subtitle file is uploaded for an object and locale which already has subtitles, the existing set will be overwritten by the upload.

Please note that for multipart form request, the full contents of the request body should NOT be included in the OAuth 1.0a signature.

Permission level

The minimum required permission level is:

write

Example XML Response

<response status="ok" permission_level="write" 
  message="The subtitles were successfully added" cached="0"/>

Example JSON Response

{
  "status": "ok", 
  "message":"The subtitles were successfully added",
  "permission_level":"write",
  "cached":"0",
  "photo":{},
  "p": "1",
  "size": "1",
  "site": { ... },
  "endpoint": "/api/photo/subtitle/upload"
}