POST media/metadata/create

Overview¶

This endpoint can be used to provide additional information about the uploaded media_id. This feature is currently only supported for images and GIFs.

The request flow should be:

1. Upload media using either the simple upload endpoint or the (preferred) chunked upload endpoint.
2. Call this endpoint to attach additional metadata such as image alt text.
3. Create Tweet with media_id(s) attached.

Request¶

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

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

Response¶

A successful response returns HTTP 2xx.

Resource URL¶

https://upload.twitter.com/1.1/media/metadata/create.json

Resource Information¶

Example Request¶

POST https://upload.twitter.com/1.1/media/metadata/create.json

{
  "media_id":"692797692624265216",
  // image alt text metadata
  "alt_text": {
    "text":"dancing cat" // Must be <= 1000 chars
  }
}