Upload a file and associate it to a chat (without actually sending it to the chat)

messageMediaEmpty#3ded6320 = MessageMedia;
messageMediaPhoto#695150d7 flags:# photo:flags.0?Photo ttl_seconds:flags.2?int = MessageMedia;
messageMediaGeo#56e0d474 geo:GeoPoint = MessageMedia;
messageMediaContact#cbf24940 phone_number:string first_name:string last_name:string vcard:string user_id:int = MessageMedia;
messageMediaUnsupported#9f84f49e = MessageMedia;
messageMediaDocument#9cb070d7 flags:# document:flags.0?Document ttl_seconds:flags.2?int = MessageMedia;
messageMediaWebPage#a32dd600 webpage:WebPage = MessageMedia;
messageMediaVenue#2ec0533f geo:GeoPoint title:string address:string provider:string venue_id:string venue_type:string = MessageMedia;
messageMediaGame#fdb19008 game:Game = MessageMedia;
messageMediaInvoice#84551347 flags:# shipping_address_requested:flags.1?true test:flags.3?true title:string description:string photo:flags.0?WebDocument receipt_msg_id:flags.2?int currency:string total_amount:long start_param:string = MessageMedia;
messageMediaGeoLive#7c3c2609 geo:GeoPoint period:int = MessageMedia;
messageMediaPoll#4bd6e798 poll:Poll results:PollResults = MessageMedia;
messageMediaDice#3f7ee58b value:int emoticon:string = MessageMedia;
messages.uploadMedia#519bc2b1 peer:InputPeer media:InputMedia = MessageMedia;


Name Type Description
peer InputPeer The chat, can be an inputPeerEmpty for bots
media InputMedia File uploaded in chunks as described in files ยป



Possible errors

Code Type Description
400 BOT_MISSING This method can only be run by a bot
403 CHAT_WRITE_FORBIDDEN You can't write in this chat
400 FILE_PARTS_INVALID The number of file parts is invalid
400 IMAGE_PROCESS_FAILED Failure while processing image
400 MEDIA_INVALID Media invalid
400 MSG_ID_INVALID Invalid message ID provided
400 PEER_ID_INVALID The provided peer id is invalid
400 PHOTO_EXT_INVALID The extension of the photo is invalid
400 WEBPAGE_CURL_FAILED Failure while fetching the webpage with cURL

Bots can use this method

Related pages


An empty constructor, no user or chat is defined.

Uploading and Downloading Files

How to transfer large data batches correctly.