POST media/metadata/create

POST media/metadata/create


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.


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


A successful response returns HTTP 2xx.

Resource URL

Resource Information

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

Example Request


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