messages.updatePinnedMessage

Pin a message

func (c *Client) MessagesUpdatePinnedMessage(ctx context.Context, request *MessagesUpdatePinnedMessageRequest) (UpdatesClass, error)

Calling this method

client.Run(ctx, func(ctx context.Context) error {
	api := client.API()
	
	res, err := api.MessagesUpdatePinnedMessage(ctx, &tg.MessagesUpdatePinnedMessageRequest{
		// see Parameters
	})
	if err != nil {
		return err
	}
	_ = res // UpdatesClass
	return nil
})

Parameters

Name	Type	Required	Description
Silent	bool	—	Pin the message silently, without triggering a notification
Unpin	bool	—	Whether the message should unpinned or pinned
PmOneside	bool	—	Whether the message should only be pinned on the local side of a one-to-one chat
Peer	InputPeerClass	yes	The peer where to pin the message
ID	int	yes	The message to pin or unpin

Returns

UpdatesClass

Possible errors

Code	Type	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_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.
403	CHAT_WRITE_FORBIDDEN	You can't write in this chat.
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.

References

• Official documentation
• Generated Go reference
• TL definition: messages.updatePinnedMessage#d2aaf7ec