Skip to main content
POST
/
2
/
media
/
metadata
Create Media metadata
curl --request POST \
  --url https://api.x.com/2/media/metadata \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "1146654567674912769",
  "metadata": {
    "allow_download_status": {
      "allow_download": true
    },
    "audience_policy": {
      "creator_subscriptions": [
        "Any"
      ],
      "x_subscriptions": [
        "Any"
      ]
    },
    "geo_restrictions": {
      "blacklisted_country_codes": [
        "us"
      ],
      "whitelisted_country_codes": [
        "us"
      ]
    },
    "sensitive_media_warning": {
      "adult_content": true,
      "graphic_violence": true,
      "other": false
    }
  }
}
'
{
  "data": {
    "associated_metadata": {
      "allow_download_status": {
        "allow_download": true
      },
      "alt_text": {
        "text": "A dancing cat"
      },
      "audience_policy": {
        "creator_subscriptions": [
          "Any"
        ],
        "x_subscriptions": [
          "Any"
        ]
      },
      "content_expiration": {
        "timestamp_sec": 1740787200
      },
      "domain_restrictions": {
        "whitelist": [
          "<string>"
        ]
      },
      "found_media_origin": {
        "id": "u5BzatR15TZ04",
        "provider": "giphy"
      },
      "geo_restrictions": {
        "blacklisted_country_codes": [
          "us"
        ],
        "whitelisted_country_codes": [
          "us"
        ]
      },
      "management_info": {
        "managed": false
      },
      "preview_image": {
        "media_key": {
          "media": "1146654567674912769",
          "media_category": "TweetImage"
        }
      },
      "sensitive_media_warning": {
        "adult_content": true,
        "graphic_violence": true,
        "other": false
      },
      "shared_info": {
        "shared": false
      },
      "sticker_info": {
        "stickers": [
          {
            "aspect_ratio": 1.78,
            "group_annotation_id": 987654321098765,
            "id": "12345",
            "sticker_set_annotation_id": 123456789012345,
            "transform_a": 1,
            "transform_b": 0,
            "transform_c": 0,
            "transform_d": 1,
            "transform_tx": 10.5,
            "transform_ty": -5.2
          }
        ]
      },
      "upload_source": {
        "upload_source": "gallery"
      }
    },
    "id": "1146654567674912769"
  },
  "errors": [
    {
      "title": "<string>",
      "type": "<string>",
      "detail": "<string>",
      "status": 123
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.x.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
id
string
required

The unique identifier of this Media.

Pattern: ^[0-9]{1,19}$
Example:

"1146654567674912769"

metadata
object

Response

The request has succeeded.

data
object
errors
object[]
Minimum array length: 1

An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).