class praw.models.DraftHelper(reddit: praw.Reddit, _data: dict[str, Any] | None)#

Provide a set of functions to interact with Draft instances.


The methods provided by this class will only work on the currently authenticated user’s Drafts.

__call__(draft_id: str | None = None) list[praw.models.Draft] | praw.models.Draft#

Return a list of Draft instances.


draft_id – When provided, return Draft instance (default: None).


A Draft instance if draft_id is provided. Otherwise, a list of Draft objects.


Drafts fetched using a specific draft ID are lazily loaded, so you might have to access an attribute to get all the expected attributes.

This method can be used to fetch a specific draft by ID, like so:

draft_id = "124862bc-e1e9-11eb-aa4f-e68667a77cbb"
draft = reddit.drafts(draft_id)
__init__(reddit: praw.Reddit, _data: dict[str, Any] | None)#

Initialize a PRAWBase instance.


reddit – An instance of Reddit.

create(*, flair_id: str | None = None, flair_text: str | None = None, is_public_link: bool = False, nsfw: bool = False, original_content: bool = False, selftext: str | None = None, send_replies: bool = True, spoiler: bool = False, subreddit: str | praw.models.Subreddit | praw.models.UserSubreddit | None = None, title: str | None = None, url: str | None = None, **draft_kwargs: Any) praw.models.Draft#

Create a new Draft.

  • flair_id – The flair template to select (default: None).

  • flair_text – If the template’s flair_text_editable value is True, this value will set a custom text (default: None). flair_id is required when flair_text is provided.

  • is_public_link – Whether to enable public viewing of the draft before it is submitted (default: False).

  • nsfw – Whether the draft should be marked NSFW (default: False).

  • original_content – Whether the submission should be marked as original content (default: False).

  • selftext – The Markdown formatted content for a text submission draft. Use None to make a title-only submission draft (default: None). selftext can not be provided if url is provided.

  • send_replies – When True, messages will be sent to the submission author when comments are made to the submission (default: True).

  • spoiler – Whether the submission should be marked as a spoiler (default: False).

  • subreddit – The subreddit to create the draft for. This accepts a subreddit display name, Subreddit object, or UserSubreddit object. If None, the UserSubreddit of currently authenticated user will be used (default: None).

  • title – The title of the draft (default: None).

  • url – The URL for a link submission draft (default: None). url can not be provided if selftext is provided.

Additional keyword arguments can be provided to handle new parameters as Reddit introduces them.


The new Draft object.

classmethod parse(data: dict[str, Any], reddit: praw.Reddit) Any#

Return an instance of cls from data.

  • data – The structured data.

  • reddit – An instance of Reddit.