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;
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
400 FILE_PARTS_INVALID The number of file parts is invalid
400 MEDIA_INVALID Media invalid
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

Related pages


An empty constructor, no user or chat is defined.

Uploading and Downloading Files

How to transfer large data batches correctly.