POST media/subtitles/delete

Overview

Use this endpoint to dissociate subtitles from a video and delete the subtitles. You can dissociate subtitles from a video before or after Tweeting.

Request

Requests should be HTTP POST with a JSON content body, and Content-Type application/json; charset=UTF-8

Note: The domain for this endpoint is upload.twitter.com

Response Codes

This endpoint returns the following HTTP responses:

Status Text Description
200 OK The request to create the subtitle was successful.
400 Bad Request Generally, this response occurs due to the presence of invalid JSON in the request, or where the request failed to send any JSON payload. In this case this error could indicate an invalid subtitle file.
403 Unauthorized HTTP authentication failed due to invalid credentials. Check your OAuth keys and tokens.
404 Not Found The resource was not found at the URL to which the request was sent, likely because an incorrect media_id
500 Internal Server Error There was an error on Twitter’s side. Retry your request using an exponential backoff pattern.
503 Service Unavailable There was an error on Twitter’s side. Retry your request using an exponential backoff pattern.

Resource URL

https://upload.twitter.com/1.1/media/subtitles/delete.json

Resource Information

Response formats JSON
Requires authentication? Yes (user context only)
Rate limited? Yes

Example Request

POST https://upload.twitter.com/1.1/media/subtitles/delete.json

  {
    "media_id":"692797692624265216",
    "media_category":"TweetVideo",
    "subtitle_info": {
      "subtitles": [
        "language_code":"EN", //The language code should be a BCP47 code (e.g. 'en", "sp")
      ]
    }
  }