Upload a custom profile picture for a contact, or suggest a new profile picture to a contact.
The file, video and video_emoji_markup flags are mutually exclusive.
Method schema is available as of layer 152. Switch ยป
| Name | Type | Description |
|---|---|---|
| flags | # | Flags, see TL conditional fields |
| suggest | flags.3?true | If set, will send a messageActionSuggestProfilePhoto service message to user_id, suggesting them to use the specified profile picture; otherwise, will set a personal profile picture for the user (only visible to the current user). |
| save | flags.4?true | If set, removes a previously set personal profile picture (does not affect suggested profile pictures, to remove them simply delete the messageActionSuggestProfilePhoto service message with messages.deleteMessages). |
| user_id | InputUser | The contact |
| file | flags.0?InputFile | Profile photo |
| video | flags.1?InputFile | Animated profile picture video |
| video_start_ts | flags.2?double | Floating point UNIX timestamp in seconds, indicating the frame of the video/sticker that should be used as static preview; can only be used if video or video_emoji_markup is set. |
| video_emoji_markup | flags.5?VideoSize | Animated sticker profile picture, must contain either a videoSizeEmojiMarkup or a videoSizeStickerMarkup constructor. |
| Code | Type | Description |
|---|---|---|
| 400 | CONTACT_MISSING | The specified user is not a contact. |
| 400 | USER_ID_INVALID | The provided user ID is invalid. |
A new profile picture was suggested using photos.uploadContactProfilePhoto.
Deletes messages by their identifiers.
How to transfer large data batches correctly.
An animated profile picture based on a custom emoji sticker.
An animated profile picture based on a sticker.