Skip to Content

TwentyThree™ API

API Method: /api/photo/subtitle/upload

Update subtitles to a video.


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:


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",
  "p": "1",
  "size": "1",
  "site": { ... },
  "endpoint": "/api/photo/subtitle/upload"