new MultiReddit()
A class representing a multireddit.
Example
// Get a multireddit belonging to a specific user r.getUser('multi-mod').getMultireddit('coding_languages')
Methods
-
copy(options)
Copies this multireddit to the requester's own account.
-
Parameters:
Name Type Description options
object Properties
Name Type Description newName
string The new name for the copied multireddit
Returns:
A Promise for the newly-copied multireddit
- Type
- Promise
Example
r.getUser('multi-mod').getMultireddit('coding_languages').copy({newName: 'my_coding_languages_copy'})
-
rename(options)
Renames this multireddit.
-
Note: This method mutates this MultiReddit.
Parameters:
Name Type Description options
object Properties
Name Type Description newName
string The new name for this multireddit.
- Deprecated:
-
- Reddit no longer provides the corresponding API endpoint. Please use `edit()` with a new name.
Returns:
A Promise that fulfills with this multireddit
- Type
- Promise
Example
r.getUser('multi-mod').getMultireddit('coding_languages').copy({newName: 'cookie_languages '})
-
edit(options)
Edits the properties of this multireddit.
-
Note: Any omitted properties here will simply retain their previous values.
Parameters:
Name Type Description options
object Properties
Name Type Argument Description name
string <optional>
The name of the new multireddit. 50 characters max.
description
string <optional>
A description for the new multireddit, in markdown.
visibility
string <optional>
The multireddit's visibility setting. One of
private
,public
,hidden
.icon_name
string <optional>
One of
art and design
,ask
,books
,business
,cars
,comics
,cute animals
,diy
,entertainment
,food and drink
,funny
,games
,grooming
,health
,life advice
,military
,models pinup
,music
,news
,philosophy
,pictures and gifs
,science
,shopping
,sports
,style
,tech
,travel
,unusual stories
,video
,None
key_color
string <optional>
A six-digit RGB hex color, preceded by '#'
weighting_scheme
string <optional>
One of 'classic', 'fresh'
Returns:
The updated version of this multireddit
- Type
- Promise
Example
r.getUser('not_an_aardvark').getMultireddit('cookie_languages').edit({visibility: 'hidden'})
-
addSubreddit(sub)
Adds a subreddit to this multireddit.
-
Parameters:
Name Type Description sub
Subreddit The Subreddit object to add (or a string representing a subreddit name)
Returns:
A Promise that fulfills with this multireddit when the reuqest is complete
- Type
- Promise
Example
r.getUser('not_an_aardvark').getMultireddit('cookie_languages').addSubreddit('cookies')
-
removeSubreddit(sub)
Removes a subreddit from this multireddit.
-
Parameters:
Name Type Description sub
Subreddit The Subreddit object to remove (or a string representing a subreddit name)
Returns:
A Promise that fulfills with this multireddit when the request is complete
- Type
- Promise
Example
r.getUser('not_an_aardvark').getMultireddit('cookie_languages').removeSubreddit('cookies')
-
delete()
Deletes this multireddit.
-
Returns:
A Promise that fulfills when this request is complete
- Type
- Promise
Example
r.getUser('not_an_aardvark').getMultireddit('cookie_languages').delete()