messages.setChatWallPaper

Set a custom wallpaper » in a specific private chat with another user.

 Method schema is available as of layer 167. Switch »

Parameters

Name Type Description
flags # Flags, see TL conditional fields
for_both flags.3?true Only for Premium users, sets the specified wallpaper for both users of the chat, without requiring confirmation from the other user.
revert flags.4?true If we don't like the new wallpaper the other user of the chat has chosen for us using the for_both flag, we can re-set our previous wallpaper just on our side using this flag.
peer InputPeer The private chat where the wallpaper will be set
wallpaper flags.0?InputWallPaper The wallpaper », obtained as described in the wallpaper documentation »; must not be provided when installing a wallpaper obtained from a messageActionSetChatWallPaper service message (id must be provided, instead).
settings flags.2?WallPaperSettings Wallpaper settings, obtained as described in the wallpaper documentation » or from messageActionSetChatWallPaper.wallpaper.settings.
id flags.1?int If the wallpaper was obtained from a messageActionSetChatWallPaper service message, must contain the ID of that message.

Result

Updates

Possible errors

Code Type Description
400 PEER_ID_INVALID The provided peer id is invalid.
400 WALLPAPER_INVALID The specified wallpaper is invalid.
400 WALLPAPER_NOT_FOUND The specified wallpaper could not be found.

Related pages

Telegram Premium

Telegram Premium is an optional subscription service that unlocks additional exclusive client-side and API-side features, while helping support the development of the app.

Wallpapers

Telegram apps support generating, sharing and synchronizing chat backgrounds.

messageActionSetChatWallPaper

The wallpaper » of the current chat was changed.