copy_story_album()

async Client.copy_story_album()

Copy all stories from a story album (highlight) to another chat and create a new album.

Usable by Users Bots
Parameters:
  • chat_id (int | str) – Unique identifier (int) or username (str) of the target chat.

  • from_chat_id (int | str) – Unique identifier (int) or username (str) of the source chat where the original album is located.

  • album_id (int) – Identifier of the story album to copy.

  • title (str, optional) – New title for the album. If not specified, the original album title will be used.

Returns:

StoryAlbum – On success, the newly created story album is returned.

Example

# Copy a story album to another chat
album = await app.copy_story_album(
    chat_id="target_channel",
    from_chat_id="source_channel",
    album_id=123
)
print(album.title)