Method reply

praw/models/reddit/modmail.py:220–258

Reply to the conversation. :param author_hidden: When ``True``, author is hidden from non-moderators (default: ``False``). :param body: The Markdown formatted content for a message. :param internal: When ``True``, message is a private moderator note, hidden from

(self, *, author_hidden: bool = False, body: str, internal: bool = False)

        self._reddit.post(API_PATH["modmail_read"], data=data)

    def reply(self, *, author_hidden: bool = False, body: str, internal: bool = False) -> ModmailMessage:
        """Reply to the conversation.

        :param author_hidden: When ``True``, author is hidden from non-moderators
            (default: ``False``).
        :param body: The Markdown formatted content for a message.
        :param internal: When ``True``, message is a private moderator note, hidden from
            non-moderators (default: ``False``).

        :returns: A :class:`.ModmailMessage` object for the newly created message.

        For example, to reply to the non-mod user while hiding your username:

        .. code-block:: python

            conversation = reddit.subreddit("test").modmail("2gmz")
            conversation.reply(body="Message body", author_hidden=True)

        To create a private moderator note on the conversation:

        .. code-block:: python

            conversation.reply(body="Message body", internal=True)

        """
        data = {
            "body": body,
            "isAuthorHidden": author_hidden,
            "isInternal": internal,
        }
        response = self._reddit.post(API_PATH["modmail_conversation"].format(id=self.id), data=data)
        if isinstance(response, dict):
            # Reddit recently changed the response format, so we need to handle both in case they change it back
            message_id = response["conversation"]["objIds"][-1]["id"]
            message_data = response["messages"][message_id]
            message = self._reddit._objector.objectify(data=message_data)
            assert isinstance(message, ModmailMessage)
            return message
        return next(message for message in response.messages if message.id == response.obj_ids[-1]["id"])

    def unarchive(self) -> None:
        """Unarchive the conversation.