report_story()

async Client.report_story()

Report stories of a user or channel for rule violations.

Usable by Users Bots
Parameters:

  • chat_id (int | str) – Unique identifier (int) or username (str) of the target chat/user.

  • story_ids (int | Iterable of int) – A single story id or an iterable of story ids to report.

  • reason (ReportReason | str, optional) – The reason for reporting. Defaults to SPAM.

  • message (str, optional) – Additional explanatory text or details about the report. Defaults to “” (empty string).

  • option (bytes, optional) – Specific report option bytes, if known beforehand. Defaults to b””.

Returns:

bool – True on success.

Example

from pyrogram.enums import ReportReason

# Report a story for spam
await app.report_story(chat_id, 1, ReportReason.SPAM)