SetChatThemeRequest

Only users can use this request. See code examples.

---functions---
messages.setChatTheme#e63be13f peer:InputPeer emoticon:string = Updates

Returns

Updates

This type can be an instance of either:

UpdateShortUpdateShortChatMessage
UpdateShortMessageUpdateShortSentMessage
UpdatesUpdatesCombined
UpdatesTooLong

Parameters

peerInputPeerAnything entity-like will work if the library can find its Input version (e.g., usernames, Peer, User or Channel objects, etc.).
emoticonstring

Known RPC errors

This request can cause 3 known errors:

EmojiInvalidErrorThe specified theme emoji is valid.
EmojiNotModifiedErrorThe theme wasn't changed.
PeerIdInvalidErrorAn invalid Peer was used. Make sure to pass the right peer type and that the value is valid (for instance, bots cannot start conversations).

You can import these from telethon.errors.

Example

from telethon.sync import TelegramClient
from telethon import functions, types

with TelegramClient(name, api_id, api_hash) as client:
    result = client(functions.messages.SetChatThemeRequest(
        peer='username',
        emoticon='some string here'
    ))
    print(result.stringify())