Home / Servers / X (Twitter) API / initialize_media_upload

Initialize Media Upload

An MCP tool from the X (Twitter) API server, hosted on mcp.hjlabs.in.

Initialize Media Upload Initializes a media upload. [POST /2/media/upload/initialize]

Name on the gateway: x_api__initialize_media_upload · may change things.

Parameters

Name	Type	Description
`additional_owners`	`array`	User ids granted access to the uploaded media.
`media_category`	`amplify_video \| tweet_gif \| tweet_image \| tweet_video \| dm_gif \| dm_image \| dm_video \| subtitles`	The media category of the upload.
`media_type`	`video/mp4 \| video/webm \| video/mp2t \| video/quicktime \| text/srt \| text/vtt \| image/jpeg \| image/gif \| image/bmp \| image/png \| image/webp \| image/pjpeg \| image/tiff \| model/gltf-binary \| model/vnd.usdz+zip`	The type of media.
`shared`	`boolean`	Whether this media is shared or not.
`total_bytes`	`integer`	The total size of the media upload in bytes.

Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:

call_tool arguments

{
  "name": "x_api__initialize_media_upload",
  "arguments": {}
}

Or connect the X (Twitter) API server directly, which lists 258 tools including this one:

Run in your terminal

claude mcp add --transport http hj-x-api https://mcp.hjlabs.in/mcp/x-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Use the initialize media upload tool with additional_owners set to ….