Send an album or grouped media
API section: Working with messages
messages.sendMultiMedia#1bf89d74 flags:# silent:flags.5?true background:flags.6?true clear_draft:flags.7?true noforwards:flags.14?true update_stickersets_order:flags.15?true invert_media:flags.16?true allow_paid_floodskip:flags.19?true peer:InputPeer reply_to:flags.0?InputReplyTo multi_media:Vector<InputSingleMedia> schedule_date:flags.10?int send_as:flags.13?InputPeer quick_reply_shortcut:flags.17?InputQuickReplyShortcut effect:flags.18?long allow_paid_stars:flags.21?long = Updates;
| Name | Type | Description |
|---|---|---|
| flags | # | Bit mask: a field written flags.N?T is present only when bit N is set. |
| silent | flags.5?true | Send without sound: the recipient gets no notification. |
| background | flags.6?true | Background send: no notification and the chat is not bumped. |
| clear_draft | flags.7?true | Clear the draft in this chat after sending. |
| noforwards | flags.14?true | |
| update_stickersets_order | flags.15?true | |
| invert_media | flags.16?true | Show the attachment below the text rather than above it. |
| allow_paid_floodskip | flags.19?true | |
| peer | InputPeer | The user or chat the request is about. |
| reply_to | flags.0?InputReplyTo | What the message replies to. |
| multi_media | Vector<InputSingleMedia> | |
| schedule_date | flags.10?int | When to send, unix time. If set, the message goes out later. |
| send_as | flags.13?InputPeer | Which identity to send as — a channel or another profile. |
| quick_reply_shortcut | flags.17?InputQuickReplyShortcut | |
| effect | flags.18?long | |
| allow_paid_stars | flags.21?long |
Read out of the handler itself — this is what the server actually returns for this method.
| Code | Type | What it means |
|---|---|---|
| 400 | MEDIA_INVALID |
The attachment is malformed or unsupported. |
| Code | Type | What it means |
|---|---|---|
| 401 | AUTH_KEY_UNREGISTERED |
The server does not know this session: the key was revoked, expired, or the call was made before authorisation. |
| 401 | API_ID_INVALID |
This api_id was never issued or has been blocked. Keys come from my.ansible.su. |
| 400 | CONNECTION_LAYER_INVALID |
The client did not declare a layer, or declared one the server does not know. |
| 420 | FLOOD_WAIT_X |
Too often. Do not retry for X seconds — the number arrives in the error text. |
| 500 | INTERNAL |
A failure on our side. The request may be retried; if it keeps failing, it is a bug of ours. |
This call counts as expensive: its cost grows with the amount of data, so under peak load it goes through admission control and may answer
FLOOD_WAITwhere cheap calls always pass. Build retries with a backoff.