telegram api method · layer 229 · #8ffacae1

messages.setChatWallPaper

usable by users

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

definition

messages.setChatWallPaper#8ffacae1 flags:# for_both:flags.3?true revert:flags.4?true peer:InputPeer wallpaper:flags.0?InputWallPaper settings:flags.2?WallPaperSettings id:flags.1?int = Updates;

parameters

nametypedescription
flags#Flags, see TL conditional fields
for_bothflags.3?trueOnly for Premium users, sets the specified wallpaper for both users of the chat, without requiring confirmation from the other user.
revertflags.4?trueIf 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.
peerInputPeerThe private chat where the wallpaper will be set
wallpaperflags.0?InputWallPaperThe 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).
settingsflags.2?WallPaperSettingsWallpaper settings, obtained as described in the wallpaper documentation » or from messageActionSetChatWallPaper.wallpaper.settings.
idflags.1?intIf the wallpaper was obtained from a messageActionSetChatWallPaper service message, must contain the ID of that message.

returns

Updates

errors (5)

codeerrordescription
400BUSINESS_CONNECTION_NOT_ALLOWEDThis method was invoked over a business connection using invokeWithBusinessConnection, but either (1) we're a user, and users cannot invoke methods over a business connection; (2) we're a bot, but business mode was disabled in @botfather or (3); we're a bot, but this method cannot be invoked over a business connection.
400PEER_ID_INVALIDThe provided peer id is invalid.
400WALLPAPER_INVALIDThe specified wallpaper is invalid.
400WALLPAPER_NOT_FOUNDThe specified wallpaper could not be found.
401AUTH_KEY_UNREGISTEREDThe specified authorization key is not registered in the system (for example, a PFS temporary key has expired).

history

present in layers 158–229

idlayers
#8ffacae1158–229