telegram api method · layer 229 · #d2aaf7ec

messages.updatePinnedMessage

usable by users and bots

Pin a message

definition

messages.updatePinnedMessage#d2aaf7ec flags:# silent:flags.0?true unpin:flags.1?true pm_oneside:flags.2?true peer:InputPeer id:int = Updates;

name	type	description
`flags`	#	Flags, see TL conditional fields
`silent`	flags.0?true	Pin the message silently, without triggering a notification
`unpin`	flags.1?true	Whether the message should unpinned or pinned
`pm_oneside`	flags.2?true	Whether the message should only be pinned on the local side of a one-to-one chat
`peer`	InputPeer	The peer where to pin the message
`id`	int	The message to pin or unpin

code	error	description
400	BOT_ONESIDE_NOT_AVAIL	Bots can't pin messages in PM just for themselves.
400	BUSINESS_CONNECTION_INVALID	The `connection_id` passed to the wrapping invokeWithBusinessConnection call is invalid.
400	BUSINESS_CONNECTION_NOT_ALLOWED	This 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.
400	BUSINESS_PEER_INVALID	Messages can't be set to the specified peer through the current business connection.
400	CHANNEL_PRIVATE	You haven't joined this channel/supergroup.
400	CHAT_ADMIN_REQUIRED	You must be an admin in this chat to do this.
400	CHAT_INVALID	Invalid chat.
400	CHAT_NOT_MODIFIED	No changes were made to chat information because the new information you passed is identical to the current information.
400	INPUT_USER_DEACTIVATED	The specified user was deleted.
400	MESSAGE_ID_INVALID	The provided message id is invalid.
400	PEER_ID_INVALID	The provided peer id is invalid.
400	PIN_RESTRICTED	You can't pin messages.
400	USER_BANNED_IN_CHANNEL	You're banned from sending messages in supergroups/channels.
401	AUTH_KEY_UNREGISTERED	The specified authorization key is not registered in the system (for example, a PFS temporary key has expired).
403	CHAT_WRITE_FORBIDDEN	You can't write in this chat.

present in layers 87–229

id	layers
#d2aaf7ec	87–229