diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..6592857
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,70 @@
+# Created by .ignore support plugin (hsz.mobi)
+### JetBrains template
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio and Webstorm
+# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
+
+# User-specific stuff:
+.idea/workspace.xml
+.idea/tasks.xml
+.idea/dictionaries
+.idea/vcs.xml
+.idea/jsLibraryMappings.xml
+
+# Sensitive or high-churn files:
+.idea/dataSources.ids
+.idea/dataSources.xml
+.idea/dataSources.local.xml
+.idea/sqlDataSources.xml
+.idea/dynamic.xml
+.idea/uiDesigner.xml
+
+# Gradle:
+.idea/gradle.xml
+.idea/libraries
+
+# Mongo Explorer plugin:
+.idea/mongoSettings.xml
+
+## File-based project format:
+*.iws
+
+## Plugin-specific files:
+
+# IntelliJ
+/out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+fabric.properties
+### Java template
+*.class
+
+# Mobile Tools for Java (J2ME)
+.mtj.tmp/
+
+# Package Files #
+*.jar
+*.war
+*.ear
+
+# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
+hs_err_pid*
+### Maven template
+target/
+pom.xml.tag
+pom.xml.releaseBackup
+pom.xml.versionsBackup
+pom.xml.next
+release.properties
+dependency-reduced-pom.xml
+buildNumber.properties
+.mvn/timing.properties
+
diff --git a/README.md b/README.md
index 238c954..cc0aca9 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,39 @@
 # ethtrader-ticker
+
 Creates a 'ticker' by pulling in various pieces of data and uploads it to reddit.
+
+# Configuration
+
+See the 'ticker.conf' https://github.com/jaycarey/ethtrader-ticker-conf at for inspiration.
+
+Structure:
+- `ticker.conf` - the main configuration file for the ticker. This file is quite elaborate to try and make it as flexible as possible, it's probably best to learn by example from the existing configuration above.
+- `ticker.css` - CSS that applies to the ticker as a whole.
+- `per-ticker.css` - tickers have an 'upper' and 'lower' portion - this css is include for each one with certain placeholders applied.
+- `img/` - these are the images referred to in 'ticker.conf'
+
+# Build
+
+```
+mvn clean package
+```
+
+# Deploy
+
+Unzip the zip at `target/ethtrader-ticker-zip.zip` to the desired location.
+
+# Run
+
+An 'application' must be created. See here while logged in as the bot: https://www.reddit.com/prefs/apps/
+
+```
+bash bin/start.sh <<subreddit>> <<username>> <<password>> <<clientId>> <<secret>> <<resourceUrl>>
+```
+
+*subreddit* - is the name of the subreddit to show the ticker on.
+*username* - is the name of the bot's (must have the ability to modify CSS on the reddit.)
+*password* - password of the bot.
+*clientId* - the clientId from the application created above.
+*secret* - the secret from the application created above.
+*resourceUrl* - The base of the url the ticker's configuration is located at, e.g. for the configuration above: https://github.com/jaycarey/ethtrader-ticker-conf/blob/master/ would be the base.
+
diff --git a/pom.xml b/pom.xml
new file mode 100644
index 0000000..d3036b7
--- /dev/null
+++ b/pom.xml
@@ -0,0 +1,164 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>com.jay</groupId>
+    <artifactId>ethtrader-ticker</artifactId>
+    <version>1.0-SNAPSHOT</version>
+
+    <properties>
+        <kotlin.version>1.0.0</kotlin.version>
+        <jackson.version>2.7.1</jackson.version>
+    </properties>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.jetbrains.kotlin</groupId>
+                <artifactId>kotlin-maven-plugin</artifactId>
+                <version>${kotlin.version}</version>
+                <executions>
+                    <execution>
+                        <id>compile</id>
+                        <phase>process-sources</phase>
+                        <goals>
+                            <goal>compile</goal>
+                        </goals>
+                        <configuration>
+                            <sourceDirs>
+                                <source>src/main/java</source>
+                            </sourceDirs>
+                        </configuration>
+                    </execution>
+                    <execution>
+                        <id>test-compile</id>
+                        <phase>process-test-sources</phase>
+                        <goals>
+                            <goal>test-compile</goal>
+                        </goals>
+                        <configuration>
+                            <sourceDirs>
+                                <source>src/test/java</source>
+                            </sourceDirs>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.3</version>
+                <configuration>
+                    <source>1.8</source>
+                    <target>1.8</target>
+                </configuration>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-assembly-plugin</artifactId>
+                <version>2.5.1</version>
+                <configuration>
+                    <descriptor>src/assembly/zip.xml</descriptor>
+                    <finalName>ethtrader-ticker</finalName>
+                </configuration>
+                <executions>
+                    <execution>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>single</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
+                <artifactId>exec-maven-plugin</artifactId>
+                <groupId>org.codehaus.mojo</groupId>
+                <executions>
+                    <execution>
+                        <id>Version Calculation</id>
+                        <phase>deploy</phase>
+                        <goals>
+                            <goal>exec</goal>
+                        </goals>
+                        <configuration>
+                            <executable>${basedir}/src/scripts/deploy.sh</executable>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+    <dependencies>
+        <dependency>
+            <groupId>org.jetbrains.kotlin</groupId>
+            <artifactId>kotlin-stdlib</artifactId>
+            <version>${kotlin.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>com.fasterxml.jackson.core</groupId>
+            <artifactId>jackson-annotations</artifactId>
+            <version>${jackson.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>com.fasterxml.jackson.jaxrs</groupId>
+            <artifactId>jackson-jaxrs-base</artifactId>
+            <version>${jackson.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>com.fasterxml.jackson.jaxrs</groupId>
+            <artifactId>jackson-jaxrs-json-provider</artifactId>
+            <version>${jackson.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>com.fasterxml.jackson.datatype</groupId>
+            <artifactId>jackson-datatype-joda</artifactId>
+            <version>${jackson.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>com.fasterxml.jackson.module</groupId>
+            <artifactId>jackson-module-kotlin</artifactId>
+            <version>${jackson.version}-2</version>
+        </dependency>
+
+        <dependency>
+            <groupId>org.glassfish.jersey.core</groupId>
+            <artifactId>jersey-client</artifactId>
+            <version>2.22.2</version>
+        </dependency>
+        <dependency>
+            <groupId>org.glassfish.jersey.media</groupId>
+            <artifactId>jersey-media-multipart</artifactId>
+            <version>2.22.2</version>
+        </dependency>
+        <dependency>
+            <groupId>com.typesafe</groupId>
+            <artifactId>config</artifactId>
+            <version>1.3.0</version>
+        </dependency>
+        <dependency>
+            <groupId>org.jsoup</groupId>
+            <artifactId>jsoup</artifactId>
+            <version>1.7.1</version>
+        </dependency>
+
+        <dependency>
+            <groupId>junit</groupId>
+            <artifactId>junit</artifactId>
+            <version>4.12</version>
+        </dependency>
+        <dependency>
+            <groupId>org.hamcrest</groupId>
+            <artifactId>hamcrest-all</artifactId>
+            <version>1.3</version>
+        </dependency>
+        <dependency>
+            <groupId>org.mockito</groupId>
+            <artifactId>mockito-all</artifactId>
+            <version>1.9.5</version>
+        </dependency>
+    </dependencies>
+
+
+</project>
\ No newline at end of file
diff --git a/src/assembly/zip.xml b/src/assembly/zip.xml
new file mode 100644
index 0000000..6cb2199
--- /dev/null
+++ b/src/assembly/zip.xml
@@ -0,0 +1,25 @@
+<assembly xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3"
+          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+          xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3 http://maven.apache.org/xsd/assembly-1.1.3.xsd">
+    <id>zip</id>
+    <formats>
+        <format>zip</format>
+    </formats>
+    <includeBaseDirectory>false</includeBaseDirectory>
+    <dependencySets>
+        <dependencySet>
+            <outputDirectory>lib</outputDirectory>
+            <useProjectArtifact>true</useProjectArtifact>
+            <scope>runtime</scope>
+        </dependencySet>
+    </dependencySets>
+
+    <fileSets>
+        <fileSet>
+            <directory>src/main/bin</directory>
+            <outputDirectory>bin</outputDirectory>
+            <lineEnding>unix</lineEnding>
+            <fileMode>0755</fileMode>
+        </fileSet>
+    </fileSets>
+</assembly>
\ No newline at end of file
diff --git a/src/main/bin/start.sh b/src/main/bin/start.sh
new file mode 100644
index 0000000..673a918
--- /dev/null
+++ b/src/main/bin/start.sh
@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+
+cd "$(dirname "$0")/.."
+
+mkdir -p logs
+
+LOG=logs/ticket.$(date "+%Y-%m-%d").$$.log
+nohup java -cp .:lib/* org/ethtrader/ticker/EntryKt $* >> $LOG 2>&1 &
+
+tail -F $LOG
diff --git a/src/main/java/org/ethtrader/ticker/Api.kt b/src/main/java/org/ethtrader/ticker/Api.kt
new file mode 100644
index 0000000..f1623e7
--- /dev/null
+++ b/src/main/java/org/ethtrader/ticker/Api.kt
@@ -0,0 +1,4061 @@
+package org.ethtrader.ticker
+
+import com.fasterxml.jackson.databind.DeserializationFeature
+import com.fasterxml.jackson.databind.ObjectMapper
+import com.fasterxml.jackson.databind.PropertyNamingStrategy
+import com.fasterxml.jackson.module.kotlin.KotlinModule
+import com.fasterxml.jackson.module.kotlin.readValue
+import org.glassfish.jersey.media.multipart.FormDataMultiPart
+import org.glassfish.jersey.media.multipart.MultiPart
+import org.glassfish.jersey.media.multipart.file.StreamDataBodyPart
+import java.io.InputStream
+import javax.ws.rs.client.Entity
+import javax.ws.rs.core.MediaType
+import javax.ws.rs.core.Response
+
+data class JsonError(val error: Int)
+
+internal fun List<String>?.csv(): String? =
+        this?.joinToString(",")
+
+fun Array<out Pair<String, Any?>>.multipart(): Entity<MultiPart> =
+        Entity.entity(fold(FormDataMultiPart()) { multiPart, pair ->
+            when (pair.second) {
+                is InputStream ->
+                    multiPart.bodyPart(StreamDataBodyPart(pair.first, pair.second as InputStream)) as FormDataMultiPart
+                else ->
+                    multiPart.field (pair.first, pair.second.toString())
+            }
+        }, MediaType.MULTIPART_FORM_DATA)
+
+private val objectMapper = ObjectMapper()
+        .registerModule(KotlinModule())
+        .setPropertyNamingStrategy(PropertyNamingStrategy.SNAKE_CASE)
+        .disable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES)
+
+private fun Response.getResponse(): ResponseWrapper {
+    val string = readEntity(String::class.java)
+    println(string)
+    try {
+        return objectMapper.readValue(string)
+    } catch (e: Throwable) {
+        val error: JsonError = objectMapper.readValue(string)
+        throw RuntimeException("Error Json Object returned, error code: ${error.error}", e)
+    }
+}
+
+data class ResponseWrapper(val kind: String?, val errors: List<String>?, val data: Map<String, Any?>?)
+
+// Generated API start.
+
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/apiv1/user.py#L57>
+ * # <https://www.reddit.com/dev/api#GET_api_v1_me>GET /api/v1/meidentity 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Returns the identity of the user currently authenticated via OAuth.
+ **/
+fun OAuthClient.getV1Me() =
+        retry(3) { requestApi("/api/v1/me").get().getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/apiv1/user.py#L106>
+ * # <https://www.reddit.com/dev/api#GET_api_v1_me_karma>GET /api/v1/me/karma
+ * mysubreddits <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Return a breakdown of subreddit karma.
+ **/
+fun OAuthClient.getV1MeKarma() =
+        retry(3) { requestApi("/api/v1/me/karma").get().getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/apiv1/user.py#L67>
+ * # <https://www.reddit.com/dev/api#GET_api_v1_me_prefs>GET /api/v1/me/prefs
+ * identity <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Return the preference settings of the logged in user
+ *  - fieldsA comma-separated list of items from this set:
+ *  - threaded_messages
+ * hide_downs
+ * email_messages
+ * show_link_flair
+ * creddit_autorenew
+ * show_trending
+ * private_feeds
+ * monitor_mentions
+ * research
+ * ignore_suggested_sort
+ * media
+ * clickgadget
+ * use_global_defaults
+ * label_nsfw
+ * domain_details
+ * show_stylesheets
+ * highlight_controversial
+ * no_profanity
+ * default_theme_sr
+ * lang
+ * hide_ups
+ * hide_from_robots
+ * compress
+ * store_visits
+ * threaded_modmail
+ * beta
+ * other_theme
+ * show_gold_expiration
+ * over_18
+ * enable_default_themes
+ * show_promote
+ * min_comment_score
+ * public_votes
+ * organic
+ * collapse_read_messages
+ * show_flair
+ * mark_messages_read
+ * hide_ads
+ * min_link_score
+ * newwindow
+ * numsites
+ * legacy_search
+ * num_comments
+ * highlight_new_comments
+ * default_comment_sort
+ * hide_locationbar
+ **/
+fun OAuthClient.getV1MePrefs(fields: List<String>?) =
+        retry(3) { requestApi("/api/v1/me/prefs",
+                "fields" to fields.csv()).get().getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/apiv1/user.py#L123>
+ * # <https://www.reddit.com/dev/api#PATCH_api_v1_me_prefs>PATCH /api/v1/me/prefs
+ * account <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - This endpoint expects JSON data of this format{ "beta": boolean value, 
+ * "clickgadget": boolean value, "collapse_read_messages": boolean value, 
+ * "compress": boolean value, "creddit_autorenew": boolean value, 
+ * "default_comment_sort": one of (`confidence`, `old`, `top`, `qa`, 
+ * `controversial`, `new`), "domain_details": boolean value, "email_messages": 
+ * boolean value, "enable_default_themes": boolean value, "hide_ads": boolean 
+ * value, "hide_downs": boolean value, "hide_from_robots": boolean value, 
+ * "hide_locationbar": boolean value, "hide_ups": boolean value, 
+ * "highlight_controversial": boolean value, "highlight_new_comments": boolean 
+ * value, "ignore_suggested_sort": boolean value, "label_nsfw": boolean value, 
+ * "lang": a valid IETF language tag (underscore separated), "legacy_search": 
+ * boolean value, "mark_messages_read": boolean value, "media": one of (`on`, 
+ * `off`, `subreddit`), "min_comment_score": an integer between -100 and 100, 
+ * "min_link_score": an integer between -100 and 100, "monitor_mentions": boolean 
+ * value, "newwindow": boolean value, "no_profanity": boolean value, 
+ * "num_comments": an integer between 1 and 500, "numsites": an integer between 1 
+ * and 100, "organic": boolean value, "other_theme": subreddit name, "over_18": 
+ * boolean value, "private_feeds": boolean value, "public_votes": boolean value, 
+ * "research": boolean value, "show_flair": boolean value, "show_gold_expiration": 
+ * boolean value, "show_link_flair": boolean value, "show_promote": boolean value, 
+ * "show_stylesheets": boolean value, "show_trending": boolean value, 
+ * "store_visits": boolean value, "theme_selector": subreddit name, 
+ * "threaded_messages": boolean value, "threaded_modmail": boolean value, 
+ * "use_global_defaults": boolean value, } 
+ **/
+fun OAuthClient.patchV1MePrefs(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/v1/me/prefs").method("patch").getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/apiv1/user.py#L94>
+ * # <https://www.reddit.com/dev/api#GET_api_v1_me_trophies>GET /api/v1/me/trophies
+ * identity <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Return a list of trophies for the current user.
+ **/
+fun OAuthClient.getV1MeTrophies() =
+        retry(3) { requestApi("/api/v1/me/trophies").get().getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1818>
+ * # <https://www.reddit.com/dev/api#GET_prefs_{where}>GET /prefs/whereread 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /prefs/friends
+ *  * → /prefs/blocked
+ *  * → /api/v1/me/friends
+ *  * → /api/v1/me/blockedThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getPrefsWhere(where: String, after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/prefs/$where",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1818>
+ * # <https://www.reddit.com/dev/api#GET_prefs_{where}>GET /prefs/whereread 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /prefs/friends
+ *  * → /prefs/blocked
+ *  * → /api/v1/me/friends
+ *  * → /api/v1/me/blockedThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getPrefsFriends(after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/prefs/friends",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1818>
+ * # <https://www.reddit.com/dev/api#GET_prefs_{where}>GET /prefs/whereread 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /prefs/friends
+ *  * → /prefs/blocked
+ *  * → /api/v1/me/friends
+ *  * → /api/v1/me/blockedThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getPrefsBlocked(after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/prefs/blocked",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1818>
+ * # <https://www.reddit.com/dev/api#GET_prefs_{where}>GET /prefs/whereread 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /prefs/friends
+ *  * → /prefs/blocked
+ *  * → /api/v1/me/friends
+ *  * → /api/v1/me/blockedThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getV1MeFriends(after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/api/v1/me/friends",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1818>
+ * # <https://www.reddit.com/dev/api#GET_prefs_{where}>GET /prefs/whereread 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /prefs/friends
+ *  * → /prefs/blocked
+ *  * → /api/v1/me/friends
+ *  * → /api/v1/me/blockedThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getV1MeBlocked(after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/api/v1/me/blocked",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L335># 
+ * <https://www.reddit.com/dev/api#GET_api_needs_captcha>GET /api/needs_captchaany 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Check whether CAPTCHAs are needed for API methods that define the "captcha" 
+ * and "iden" parameters.
+ **/
+fun OAuthClient.getNeeds_captcha() =
+        retry(3) { requestApi("/api/needs_captcha").get().getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L145># 
+ * <https://www.reddit.com/dev/api#POST_api_new_captcha>POST /api/new_captchaany 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Responds with an iden of a new CAPTCHA.
+ *  - Use this endpoint if a user cannot read a given CAPTCHA, and wishes to 
+ * receive a new CAPTCHA.
+ *  - To request the CAPTCHA image for an iden, use /captcha/iden 
+ * <https://www.reddit.com/dev/api#GET_captcha_%7Biden%7D>.
+ *  - api_typethe string json
+ **/
+fun OAuthClient.postNew_captcha(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/new_captcha").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/captcha.py#L32>#
+ *  <https://www.reddit.com/dev/api#GET_captcha_{iden}>GET /captcha/idenany 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Request a CAPTCHA image given an iden.
+ *  - An iden is given as the captcha field with a BAD_CAPTCHA error, you should 
+ * use this endpoint if you get aBAD_CAPTCHA error response.
+ *  - Responds with a 120x50 image/png which should be displayed to the user.
+ *  - The user's response to the CAPTCHA should be sent as captcha along with your 
+ * request.
+ *  - To request a new CAPTCHA, use /api/new_captcha 
+ * <https://www.reddit.com/dev/api#POST_api_new_captcha>.
+ **/
+fun OAuthClient.getCaptchaIden(iden: String) =
+        retry(3) { requestApi("/captcha/$iden").get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L4280># 
+ * <https://www.reddit.com/dev/api#POST_api_clearflairtemplates>POST [/r/subreddit
+ * ]/api/clearflairtemplatesmodflair <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - api_typethe string json
+ *  - flair_typeone of (USER_FLAIR, LINK_FLAIR)
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postRSubredditClearflairtemplates(subreddit: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/clearflairtemplates").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L4022># 
+ * <https://www.reddit.com/dev/api#POST_api_deleteflair>POST [/r/subreddit
+ * ]/api/deleteflairmodflair <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - api_typethe string json
+ *  - namea user by name
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postRSubredditDeleteflair(subreddit: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/deleteflair").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L4261># 
+ * <https://www.reddit.com/dev/api#POST_api_deleteflairtemplate>POST [/r/subreddit
+ * ]/api/deleteflairtemplatemodflair <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - api_typethe string json
+ *  - flair_template_iduh / X-Modhash headera modhash 
+ * <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postRSubredditDeleteflairtemplate(subreddit: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/deleteflairtemplate").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3968># 
+ * <https://www.reddit.com/dev/api#POST_api_flair>POST [/r/subreddit]/api/flair
+ * modflair <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - api_typethe string json
+ *  - css_classa valid subreddit image name
+ *  - linka fullname <https://www.reddit.com/dev/api#fullname> of a link
+ *  - namea user by name
+ *  - texta string no longer than 64 characters
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postRSubredditFlair(subreddit: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/flair").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L4127># 
+ * <https://www.reddit.com/dev/api#POST_api_flairconfig>POST [/r/subreddit
+ * ]/api/flairconfigmodflair <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - api_typethe string json
+ *  - flair_enabledboolean value
+ *  - flair_positionone of (left, right)
+ *  - flair_self_assign_enabledboolean value
+ *  - link_flair_positionone of (`,left,right`)
+ *  - link_flair_self_assign_enabledboolean value
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postRSubredditFlairconfig(subreddit: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/flairconfig").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L4042># 
+ * <https://www.reddit.com/dev/api#POST_api_flaircsv>POST [/r/subreddit
+ * ]/api/flaircsvmodflair <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Change the flair of multiple users in the same subreddit with a single API 
+ * call.
+ *  - Requires a string 'flair_csv' which has up to 100 lines of the form 'user,
+ * flairtext,cssclass' (Lines beyond the 100th are ignored).
+ *  - If both cssclass and flairtext are the empty string for a given user, instead 
+ * clears that user's flair.
+ *  - Returns an array of objects indicating if each flair setting was applied, or 
+ * a reason for the failure.
+ *  - flair_csvcomma-seperated flair information
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postRSubredditFlaircsv(subreddit: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/flaircsv").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L4169># 
+ * <https://www.reddit.com/dev/api#GET_api_flairlist>GET [/r/subreddit
+ * ]/api/flairlistmodflair <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 1000)
+ *  - namea user by name
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getRSubredditFlairlist(subreddit: String, after: String?, before: String?, count: Int?, limit: Int?, name: String?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/r/$subreddit/api/flairlist",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "name" to name, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L4295># 
+ * <https://www.reddit.com/dev/api#POST_api_flairselector>POST [/r/subreddit
+ * ]/api/flairselectorflair <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Return information about a users's flair options.
+ *  - If link is given, return link flair options. Otherwise, return user flair 
+ * options for this subreddit.
+ *  - The logged in user's flair is also returned. Subreddit moderators may give a 
+ * user byname to instead retrieve that user's flair.
+ *  - linka fullname <https://www.reddit.com/dev/api#fullname> of a link
+ *  - namea user by name
+ **/
+fun OAuthClient.postRSubredditFlairselector(subreddit: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/flairselector").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L4187># 
+ * <https://www.reddit.com/dev/api#POST_api_flairtemplate>POST [/r/subreddit
+ * ]/api/flairtemplatemodflair <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - api_typethe string json
+ *  - css_classa valid subreddit image name
+ *  - flair_template_idflair_typeone of (USER_FLAIR, LINK_FLAIR)
+ *  - texta string no longer than 64 characters
+ *  - text_editableboolean value
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postRSubredditFlairtemplate(subreddit: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/flairtemplate").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L4341># 
+ * <https://www.reddit.com/dev/api#POST_api_selectflair>POST [/r/subreddit
+ * ]/api/selectflairflair <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - api_typethe string json
+ *  - flair_template_idlinka fullname <https://www.reddit.com/dev/api#fullname> of 
+ * a link
+ *  - namea user by name
+ *  - texta string no longer than 64 characters
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postRSubredditSelectflair(subreddit: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/selectflair").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L4117># 
+ * <https://www.reddit.com/dev/api#POST_api_setflairenabled>POST [/r/subreddit
+ * ]/api/setflairenabledflair <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - api_typethe string json
+ *  - flair_enabledboolean value
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postRSubredditSetflairenabled(subreddit: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/setflairenabled").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/apiv1/gold.py#L77>
+ * # <https://www.reddit.com/dev/api#POST_api_v1_gold_gild_{fullname}>POST 
+ * /api/v1/gold/gild/fullnamecreddits 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - fullnamefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ **/
+fun OAuthClient.postV1GoldGildFullname(fullname: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/v1/gold/gild/$fullname").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/apiv1/gold.py#L102>
+ * # <https://www.reddit.com/dev/api#POST_api_v1_gold_give_{username}>POST 
+ * /api/v1/gold/give/usernamecreddits 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - monthsan integer between 1 and 36
+ *  - usernameA valid, existing reddit username
+ **/
+fun OAuthClient.postV1GoldGiveUsername(username: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/v1/gold/give/$username").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L2060># 
+ * <https://www.reddit.com/dev/api#POST_api_comment>POST /api/commentany 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Submit a new comment or reply to a message.
+ *  - parent is the fullname of the thing being replied to. Its value changes the 
+ * kind of object created by this request:
+ *  * the fullname of a Link: a top-level comment in that Link's thread. (requires
+ * submit scope) 
+ *  * the fullname of a Comment: a comment reply to that comment. (requires submit
+ *  scope) 
+ *  * the fullname of a Message: a message reply to that message. (requires 
+ * privatemessages scope) text should be the raw markdown body of the comment or 
+ * message.
+ *  - To start a new message thread, use /api/compose 
+ * <https://www.reddit.com/dev/api#POST_api_compose>.
+ *  - api_typethe string json
+ *  - textraw markdown text
+ *  - thing_idfullname <https://www.reddit.com/dev/api#fullnames> of parent thing
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postComment(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/comment").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1491># 
+ * <https://www.reddit.com/dev/api#POST_api_del>POST /api/deledit 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Delete a Link or Comment.
+ *  - idfullname <https://www.reddit.com/dev/api#fullnames> of a thing created by 
+ * the user
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postDel(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/del").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1975># 
+ * <https://www.reddit.com/dev/api#POST_api_editusertext>POST /api/editusertextedit
+ *  <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Edit the body text of a comment or self-post.
+ *  - api_typethe string json
+ *  - textraw markdown text
+ *  - thing_idfullname <https://www.reddit.com/dev/api#fullnames> of a thing 
+ * created by the user
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postEditusertext(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/editusertext").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3472># 
+ * <https://www.reddit.com/dev/api#POST_api_hide>POST /api/hidereport 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Hide a link.
+ *  - This removes it from the user's default view of subreddit listings.
+ *  - See also: /api/unhide <https://www.reddit.com/dev/api#POST_api_unhide>.
+ *  - idA comma-separated list of link fullnames 
+ * <https://www.reddit.com/dev/api#fullnames>
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postHide(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/hide").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L173># 
+ * <https://www.reddit.com/dev/api#GET_api_info>GET [/r/subreddit]/api/inforead 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Return a listing of things specified by their fullnames.
+ *  - Only Links, Comments, and Subreddits are allowed.
+ *  - idA comma-separated list of thing fullnames 
+ * <https://www.reddit.com/dev/api#fullnames>
+ *  - urla valid URL
+ **/
+fun OAuthClient.getRSubredditInfo(subreddit: String, id: List<String>?, url: String?) =
+        retry(3) { requestApi("/r/$subreddit/api/info",
+                "id" to id.csv(), 
+                "url" to url).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1522># 
+ * <https://www.reddit.com/dev/api#POST_api_lock>POST /api/lockmodposts 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Lock a link.
+ *  - Prevents a post from receiving new comments.
+ *  - See also: /api/unlock <https://www.reddit.com/dev/api#POST_api_unlock>.
+ *  - idfullname <https://www.reddit.com/dev/api#fullnames> of a link
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postLock(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/lock").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1568># 
+ * <https://www.reddit.com/dev/api#POST_api_marknsfw>POST /api/marknsfwmodposts 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Mark a link NSFW.
+ *  - See also: /api/unmarknsfw <https://www.reddit.com/dev/api#POST_api_unmarknsfw>
+ * .
+ *  - idfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postMarknsfw(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/marknsfw").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3535># 
+ * <https://www.reddit.com/dev/api#GET_api_morechildren>GET /api/morechildrenread 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Retrieve additional comments omitted from a base comment tree.
+ *  - When a comment tree is rendered, the most relevant comments are selected for 
+ * display first. Remaining comments are stubbed out with "MoreComments" links. 
+ * This API call is used to retrieve the additional comments represented by those 
+ * stubs, up to 20 at a time.
+ *  - The two core parameters required are link and children. link is the fullname 
+ * of the link whose comments are being fetched.children is a comma-delimited list 
+ * of comment ID36s that need to be fetched.
+ *  - If id is passed, it should be the ID of the MoreComments object this call is 
+ * replacing. This is needed only for the HTML UI's purposes and is optional 
+ * otherwise.
+ *  - NOTE: you may only make one request at a time to this API endpoint. Higher 
+ * concurrency will result in an error being returned.
+ *  - api_typethe string json
+ *  - childrena comma-delimited list of comment ID36s
+ *  - id(optional) id of the associated MoreChildren object
+ *  - link_idfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - sortone of (confidence, top, new, controversial, old, random, qa)
+ **/
+fun OAuthClient.getMorechildren(apiType: String?, children: List<String>?, id: String?, linkId: String?, sort: String?) =
+        retry(3) { requestApi("/api/morechildren",
+                "api_type" to apiType, 
+                "children" to children.csv(), 
+                "id" to id, 
+                "link_id" to linkId, 
+                "sort" to sort).get().getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1749># 
+ * <https://www.reddit.com/dev/api#POST_api_report>POST /api/reportreport 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Report a link, comment or message.
+ *  - Reporting a thing brings it to the attention of the subreddit's moderators. 
+ * Reporting a message sends it to a system for admin review.
+ *  - For links and comments, the thing is implicitly hidden as well (see /api/hide 
+ * <https://www.reddit.com/dev/api#POST_api_hide> for details).
+ *  - api_typethe string json
+ *  - other_reasona string no longer than 100 characters
+ *  - reasona string no longer than 100 characters
+ *  - site_reasona string no longer than 100 characters
+ *  - thing_idfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postReport(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/report").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3340># 
+ * <https://www.reddit.com/dev/api#POST_api_save>POST /api/savesave 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Save a link or comment.
+ *  - Saved things are kept in the user's saved listing for later perusal.
+ *  - See also: /api/unsave <https://www.reddit.com/dev/api#POST_api_unsave>.
+ *  - categorya category name
+ *  - idfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postSave(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/save").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3323># 
+ * <https://www.reddit.com/dev/api#GET_api_saved_categories>GET 
+ * /api/saved_categoriessave <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Get a list of categories in which things are currently saved.
+ *  - See also: /api/save <https://www.reddit.com/dev/api#POST_api_save>.
+ **/
+fun OAuthClient.getSaved_categories() =
+        retry(3) { requestApi("/api/saved_categories").get().getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1619># 
+ * <https://www.reddit.com/dev/api#POST_api_sendreplies>POST /api/sendrepliesedit 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Enable or disable inbox replies for a link or comment.
+ *  - state is a boolean that indicates whether you are enabling or disabling inbox 
+ * replies - true to enable, false to disable.
+ *  - idfullname <https://www.reddit.com/dev/api#fullnames> of a thing created by 
+ * the user
+ *  - stateboolean value
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postSendreplies(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/sendreplies").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1680># 
+ * <https://www.reddit.com/dev/api#POST_api_set_contest_mode>POST 
+ * /api/set_contest_modemodposts <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Set or unset "contest mode" for a link's comments.
+ *  - state is a boolean that indicates whether you are enabling or disabling 
+ * contest mode - true to enable, false to disable.
+ *  - api_typethe string json
+ *  - idstateboolean value
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postSet_contest_mode(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/set_contest_mode").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1706># 
+ * <https://www.reddit.com/dev/api#POST_api_set_subreddit_sticky>POST 
+ * /api/set_subreddit_stickymodposts <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Set or unset a Link as the sticky in its subreddit.
+ *  - state is a boolean that indicates whether to sticky or unsticky this post - 
+ * true to sticky, false to unsticky.
+ *  - The num argument is optional, and only used when stickying a post. It allows 
+ * specifying a particular "slot" to sticky the post into, and if there is already 
+ * a post stickied in that slot it will be replaced. If there is no post in the 
+ * specified slot to replace, ornum is None, the bottom-most slot will be used.
+ *  - api_typethe string json
+ *  - idnuman integer between 1 and 2
+ *  - stateboolean value
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postSet_subreddit_sticky(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/set_subreddit_sticky").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1654># 
+ * <https://www.reddit.com/dev/api#POST_api_set_suggested_sort>POST 
+ * /api/set_suggested_sortmodposts <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Set a suggested sort for a link.
+ *  - Suggested sorts are useful to display comments in a certain preferred way for 
+ * posts. For example, casual conversation may be better sorted by new by default, 
+ * or AMAs may be sorted by Q&A. A sort of an empty string clears the default sort.
+ *  - api_typethe string json
+ *  - idsortone of (confidence, top, new, controversial, old, random, qa, blank)
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postSet_suggested_sort(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/set_suggested_sort").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L5090># 
+ * <https://www.reddit.com/dev/api#POST_api_store_visits>POST /api/store_visitssave
+ *  <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Requires a subscription to reddit gold <https://www.reddit.com/gold/about>
+ *  - linksA comma-separated list of link fullnames 
+ * <https://www.reddit.com/dev/api#fullnames>
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postStore_visits(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/store_visits").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L438># 
+ * <https://www.reddit.com/dev/api#POST_api_submit>POST /api/submitsubmit 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Submit a link to a subreddit.
+ *  - Submit will create a link or self-post in the subreddit sr with the title 
+ * title. If kind is "link", then url is expected to be a valid URL to link to. 
+ * Otherwise,text, if present, will be the body of the self-post.
+ *  - If a link with the same URL has already been submitted to the specified 
+ * subreddit an error will be returned unlessresubmit is true. extension is used 
+ * for determining which view-type (e.g.json, compact etc.) to use for the 
+ * redirect that is generated if theresubmit error occurs.
+ *  - api_typethe string json
+ *  - captchathe user's response to the CAPTCHA challenge
+ *  - extensionextension used for redirects
+ *  - identhe identifier of the CAPTCHA challenge
+ *  - kindone of (link, self)
+ *  - resubmitboolean value
+ *  - sendrepliesboolean value
+ *  - srname of a subreddit
+ *  - textraw markdown text
+ *  - titletitle of the submission. up to 300 characters long
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ *  - urla valid URL
+ **/
+fun OAuthClient.postSubmit(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/submit").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3490># 
+ * <https://www.reddit.com/dev/api#POST_api_unhide>POST /api/unhidereport 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Unhide a link.
+ *  - See also: /api/hide <https://www.reddit.com/dev/api#POST_api_hide>.
+ *  - idA comma-separated list of link fullnames 
+ * <https://www.reddit.com/dev/api#fullnames>
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postUnhide(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/unhide").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1545># 
+ * <https://www.reddit.com/dev/api#POST_api_unlock>POST /api/unlockmodposts 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Unlock a link.
+ *  - Allow a post to receive new comments.
+ *  - See also: /api/lock <https://www.reddit.com/dev/api#POST_api_lock>.
+ *  - idfullname <https://www.reddit.com/dev/api#fullnames> of a link
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postUnlock(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/unlock").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1589># 
+ * <https://www.reddit.com/dev/api#POST_api_unmarknsfw>POST /api/unmarknsfwmodposts
+ *  <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Remove the NSFW marking from a link.
+ *  - See also: /api/marknsfw <https://www.reddit.com/dev/api#POST_api_marknsfw>.
+ *  - idfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postUnmarknsfw(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/unmarknsfw").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3367># 
+ * <https://www.reddit.com/dev/api#POST_api_unsave>POST /api/unsavesave 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Unsave a link or comment.
+ *  - This removes the thing from the user's saved listings as well.
+ *  - See also: /api/save <https://www.reddit.com/dev/api#POST_api_save>.
+ *  - idfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postUnsave(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/unsave").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L2308># 
+ * <https://www.reddit.com/dev/api#POST_api_vote>POST /api/votevote 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Cast a vote on a thing.
+ *  - id should be the fullname of the Link or Comment to vote on.
+ *  - dir indicates the direction of the vote. Voting 1 is an upvote, -1 is a 
+ * downvote, and0 is equivalent to "un-voting" by clicking again on a highlighted 
+ * arrow.
+ *  - Note: votes must be cast by humans. That is, API clients proxying a human's 
+ * action one-for-one are OK, but bots deciding how to vote on content or 
+ * amplifying a human's vote are not. Seethe reddit rules 
+ * <https://www.reddit.com/rules> for more details on what constitutes vote 
+ * cheating.
+ *  - dirvote direction. one of (1, 0, -1)
+ *  - idfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - rankan integer greater than 1
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postVote(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/vote").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L715>
+ * # <https://www.reddit.com/dev/api#GET_by_id_{names}>GET /by_id/namesread 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Get a listing of links by fullname.
+ *  - names is a list of fullnames for links separated by commas or spaces.
+ *  - namesA comma-separated list of link fullnames 
+ * <https://www.reddit.com/dev/api#fullnames>
+ **/
+fun OAuthClient.getBy_idNames(names: List<String>) =
+        retry(3) { requestApi("/by_id/$names",
+                "names" to names.csv()).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L214># 
+ * <https://www.reddit.com/dev/api#GET_comments_{article}>GET [/r/subreddit
+ * ]/comments/articleread <https://github.com/reddit/reddit/wiki/OAuth2>rss support
+ *  <https://www.reddit.com/wiki/rss>
+ *  - Get the comment tree for a given Link article.
+ *  - If supplied, comment is the ID36 of a comment in the comment tree for article
+ * . This comment will be the (highlighted) focal point of the returned view and
+ * context will be the number of parents shown.
+ *  - depth is the maximum depth of subtrees in the thread.
+ *  - limit is the maximum number of comments to return.
+ *  - See also: /api/morechildren 
+ * <https://www.reddit.com/dev/api#GET_api_morechildren> and /api/comment 
+ * <https://www.reddit.com/dev/api#POST_api_comment>.
+ *  - articleID36 of a link
+ *  - comment(optional) ID36 of a comment
+ *  - contextan integer between 0 and 8
+ *  - depth(optional) an integer
+ *  - limit(optional) an integer
+ *  - showeditsboolean value
+ *  - showmoreboolean value
+ *  - sortone of (confidence, top, new, controversial, old, random, qa)
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getRSubredditCommentsArticle(subreddit: String, article: String, comment: String?, context: String?, depth: String?, limit: String?, showedits: String?, showmore: String?, sort: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/r/$subreddit/comments/$article",
+                "article" to article, 
+                "comment" to comment, 
+                "context" to context, 
+                "depth" to depth, 
+                "limit" to limit, 
+                "showedits" to showedits, 
+                "showmore" to showmore, 
+                "sort" to sort, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L1004>#
+ *  <https://www.reddit.com/dev/api#GET_duplicates_{article}>GET /duplicates/
+ * articleread <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  - Return a list of other submissions of the same URL
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - articleThe base 36 ID of a Link
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getDuplicatesArticle(article: String, after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/duplicates/$article",
+                "after" to after, 
+                "article" to article, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L543>
+ * # <https://www.reddit.com/dev/api#GET_hot>GET [/r/subreddit]/hotread 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getRSubredditHot(subreddit: String, after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/r/$subreddit/hot",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L572>
+ * # <https://www.reddit.com/dev/api#GET_new>GET [/r/subreddit]/newread 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getRSubredditNew(subreddit: String, after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/r/$subreddit/new",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L128># 
+ * <https://www.reddit.com/dev/api#GET_random>GET [/r/subreddit]/randomread 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - The Serendipity button
+ **/
+fun OAuthClient.getRSubredditRandom(subreddit: String) =
+        retry(3) { requestApi("/r/$subreddit/random").get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L625>
+ * # <https://www.reddit.com/dev/api#GET_{sort}>GET [/r/subreddit]/sortread 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → [/r/subreddit]/top
+ *  * → [/r/subreddit]/controversialThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - tone of (hour, day, week, month, year, all)
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getRSubredditSort(subreddit: String, sort: String, t: String?, after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/r/$subreddit/$sort",
+                "t" to t, 
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L625>
+ * # <https://www.reddit.com/dev/api#GET_{sort}>GET [/r/subreddit]/sortread 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → [/r/subreddit]/top
+ *  * → [/r/subreddit]/controversialThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - tone of (hour, day, week, month, year, all)
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getRSubredditTop(subreddit: String, t: String?, after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/r/$subreddit/top",
+                "t" to t, 
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L625>
+ * # <https://www.reddit.com/dev/api#GET_{sort}>GET [/r/subreddit]/sortread 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → [/r/subreddit]/top
+ *  * → [/r/subreddit]/controversialThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - tone of (hour, day, week, month, year, all)
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getRSubredditControversial(subreddit: String, t: String?, after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/r/$subreddit/controversial",
+                "t" to t, 
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * Real-time updates on reddit.
+ *  - In addition to the standard reddit API, WebSockets play a huge role in reddit 
+ * live. Receiving push notification of changes to the thread via websockets is 
+ * much better than polling the thread repeatedly.
+ *  - To connect to the websocket server, fetch /live/thread/about.json 
+ * <https://www.reddit.com/dev/api#GET_live_%7Bthread%7D_about.json> and get the 
+ * websocket_url field. The websocket URL expires after a period of time; if it 
+ * does, fetch a new one from that endpoint.
+ *  - Once connected to the socket, a variety of messages can come in. All messages 
+ * will be in text frames containing a JSON object with two keys:type and payload. 
+ * Live threads can send messages with manytypes:
+ *  * update - a new update has been posted in the thread. the payload contains 
+ * the JSON representation of the update. 
+ *  * activity - periodic update of the viewer counts for the thread. 
+ *  * settings - the thread's settings have changed. the payload is an object 
+ * with each key being a property of the thread (as inabout.json) and its new 
+ * value. 
+ *  * delete - an update has been deleted (removed from the thread). the payload 
+ * is the ID of the deleted update. 
+ *  * strike - an update has been stricken (marked incorrect and crossed out). the
+ * payload is the ID of the stricken update. 
+ *  * embeds_ready - a previously posted update has been parsed and embedded 
+ * media is available for it now. thepayload contains a liveupdate_id and list of 
+ * embeds to add to it. 
+ *  * complete - the thread has been marked complete. no further updates will be 
+ * sent. See /r/live <https://www.reddit.com/r/live> for more information.
+ **/
+fun OAuthClient.get() =
+        retry(3) { requestApi("").get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L1015>
+ * # <https://www.reddit.com/dev/api#POST_api_live_create>POST /api/live/create
+ * submit <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Create a new live thread.
+ *  - Once created, the initial settings can be modified with /api/live/thread/edit 
+ * <https://www.reddit.com/dev/api#POST_api_live_%7Bthread%7D_edit> and new 
+ * updates can be posted with/api/live/thread/update 
+ * <https://www.reddit.com/dev/api#POST_api_live_%7Bthread%7D_update>.
+ *  - api_typethe string json
+ *  - descriptionraw markdown text
+ *  - nsfwboolean value
+ *  - resourcesraw markdown text
+ *  - titlea string no longer than 120 characters
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postLiveCreate(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/live/create").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L620>
+ * # 
+ * <https://www.reddit.com/dev/api#POST_api_live_{thread}_accept_contributor_invite>
+ * POST /api/live/thread/accept_contributor_invitelivemanage 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Accept a pending invitation to contribute to the thread.
+ *  - See also: /api/live/thread/leave_contributor 
+ * <https://www.reddit.com/dev/api#POST_api_live_%7Bthread%7D_leave_contributor>.
+ *  - api_typethe string json
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postLiveThreadAccept_contributor_invite(thread: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/live/$thread/accept_contributor_invite").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L828>
+ * # <https://www.reddit.com/dev/api#POST_api_live_{thread}_close_thread>POST 
+ * /api/live/thread/close_threadlivemanage 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Permanently close the thread, disallowing future updates.
+ *  - Requires the close permission for this thread.
+ *  - api_typethe string json
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postLiveThreadClose_thread(thread: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/live/$thread/close_thread").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L770>
+ * # <https://www.reddit.com/dev/api#POST_api_live_{thread}_delete_update>POST 
+ * /api/live/thread/delete_updateedit 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Delete an update from the thread.
+ *  - Requires that specified update must have been authored by the user or that 
+ * you have theedit permission for this thread.
+ *  - See also: /api/live/thread/update 
+ * <https://www.reddit.com/dev/api#POST_api_live_%7Bthread%7D_update>.
+ *  - api_typethe string json
+ *  - idthe ID of a single update. e.g. 
+ * LiveUpdate_ff87068e-a126-11e3-9f93-12313b0b3603
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postLiveThreadDelete_update(thread: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/live/$thread/delete_update").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L427>
+ * # <https://www.reddit.com/dev/api#POST_api_live_{thread}_edit>POST /api/live/
+ * thread/editlivemanage <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Configure the thread.
+ *  - Requires the settings permission for this thread.
+ *  - See also: /live/thread/about.json 
+ * <https://www.reddit.com/dev/api#GET_live_%7Bthread%7D_about.json>.
+ *  - api_typethe string json
+ *  - descriptionraw markdown text
+ *  - nsfwboolean value
+ *  - resourcesraw markdown text
+ *  - titlea string no longer than 120 characters
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postLiveThreadEdit(thread: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/live/$thread/edit").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L517>
+ * # <https://www.reddit.com/dev/api#POST_api_live_{thread}_invite_contributor>
+ * POST /api/live/thread/invite_contributorlivemanage 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Invite another user to contribute to the thread.
+ *  - Requires the manage permission for this thread. If the recipient accepts the 
+ * invite, they will be granted the permissions specified.
+ *  - See also: /api/live/thread/accept_contributor_invite 
+ * <https://www.reddit.com/dev/api#POST_api_live_%7Bthread%7D_accept_contributor_invite>
+ * , and/api/live/thread/rm_contributor_invite 
+ * <https://www.reddit.com/dev/api#POST_api_live_%7Bthread%7D_rm_contributor_invite>
+ * .
+ *  - api_typethe string json
+ *  - namethe name of an existing user
+ *  - permissionspermission description e.g. +update,+edit,-manage
+ *  - typeone of (liveupdate_contributor_invite, liveupdate_contributor)
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postLiveThreadInvite_contributor(thread: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/live/$thread/invite_contributor").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L580>
+ * # <https://www.reddit.com/dev/api#POST_api_live_{thread}_leave_contributor>POST 
+ * /api/live/thread/leave_contributorlivemanage 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Abdicate contributorship of the thread.
+ *  - See also: /api/live/thread/accept_contributor_invite 
+ * <https://www.reddit.com/dev/api#POST_api_live_%7Bthread%7D_accept_contributor_invite>
+ * , and/api/live/thread/invite_contributor 
+ * <https://www.reddit.com/dev/api#POST_api_live_%7Bthread%7D_invite_contributor>.
+ *  - api_typethe string json
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postLiveThreadLeave_contributor(thread: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/live/$thread/leave_contributor").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L851>
+ * # <https://www.reddit.com/dev/api#POST_api_live_{thread}_report>POST /api/live/
+ * thread/reportreport <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Report the thread for violating the rules of reddit.
+ *  - api_typethe string json
+ *  - typeone of (spam, vote-manipulation, personal-information, sexualizing-minors,
+ * site-breaking)
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postLiveThreadReport(thread: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/live/$thread/report").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L702>
+ * # <https://www.reddit.com/dev/api#POST_api_live_{thread}_rm_contributor>POST 
+ * /api/live/thread/rm_contributorlivemanage 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Revoke another user's contributorship.
+ *  - Requires the manage permission for this thread.
+ *  - See also: /api/live/thread/invite_contributor 
+ * <https://www.reddit.com/dev/api#POST_api_live_%7Bthread%7D_invite_contributor>.
+ *  - api_typethe string json
+ *  - idfullname <https://www.reddit.com/dev/api#fullnames> of a account
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postLiveThreadRm_contributor(thread: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/live/$thread/rm_contributor").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L599>
+ * # <https://www.reddit.com/dev/api#POST_api_live_{thread}_rm_contributor_invite>
+ * POST /api/live/thread/rm_contributor_invitelivemanage 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Revoke an outstanding contributor invite.
+ *  - Requires the manage permission for this thread.
+ *  - See also: /api/live/thread/invite_contributor 
+ * <https://www.reddit.com/dev/api#POST_api_live_%7Bthread%7D_invite_contributor>.
+ *  - api_typethe string json
+ *  - idfullname <https://www.reddit.com/dev/api#fullnames> of a account
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postLiveThreadRm_contributor_invite(thread: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/live/$thread/rm_contributor_invite").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L649>
+ * # 
+ * <https://www.reddit.com/dev/api#POST_api_live_{thread}_set_contributor_permissions>
+ * POST /api/live/thread/set_contributor_permissionslivemanage 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Change a contributor or contributor invite's permissions.
+ *  - Requires the manage permission for this thread.
+ *  - See also: /api/live/thread/invite_contributor 
+ * <https://www.reddit.com/dev/api#POST_api_live_%7Bthread%7D_invite_contributor> 
+ * and/api/live/thread/rm_contributor 
+ * <https://www.reddit.com/dev/api#POST_api_live_%7Bthread%7D_rm_contributor>.
+ *  - api_typethe string json
+ *  - namethe name of an existing user
+ *  - permissionspermission description e.g. +update,+edit,-manage
+ *  - typeone of (liveupdate_contributor_invite, liveupdate_contributor)
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postLiveThreadSet_contributor_permissions(thread: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/live/$thread/set_contributor_permissions").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L799>
+ * # <https://www.reddit.com/dev/api#POST_api_live_{thread}_strike_update>POST 
+ * /api/live/thread/strike_updateedit 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Strike (mark incorrect and cross out) the content of an update.
+ *  - Requires that specified update must have been authored by the user or that 
+ * you have theedit permission for this thread.
+ *  - See also: /api/live/thread/update 
+ * <https://www.reddit.com/dev/api#POST_api_live_%7Bthread%7D_update>.
+ *  - api_typethe string json
+ *  - idthe ID of a single update. e.g. 
+ * LiveUpdate_ff87068e-a126-11e3-9f93-12313b0b3603
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postLiveThreadStrike_update(thread: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/live/$thread/strike_update").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L722>
+ * # <https://www.reddit.com/dev/api#POST_api_live_{thread}_update>POST /api/live/
+ * thread/updatesubmit <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Post an update to the thread.
+ *  - Requires the update permission for this thread.
+ *  - See also: /api/live/thread/strike_update 
+ * <https://www.reddit.com/dev/api#POST_api_live_%7Bthread%7D_strike_update>, and 
+ * /api/live/thread/delete_update 
+ * <https://www.reddit.com/dev/api#POST_api_live_%7Bthread%7D_delete_update>.
+ *  - api_typethe string json
+ *  - bodyraw markdown text
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postLiveThreadUpdate(thread: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/live/$thread/update").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L259>
+ * # <https://www.reddit.com/dev/api#GET_live_{thread}>GET /live/threadread 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  - Get a list of updates posted in this thread.
+ *  - See also: /api/live/thread/update 
+ * <https://www.reddit.com/dev/api#POST_api_live_%7Bthread%7D_update>.
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterthe ID of a single update. e.g. 
+ * LiveUpdate_ff87068e-a126-11e3-9f93-12313b0b3603
+ *  - beforethe ID of a single update. e.g. 
+ * LiveUpdate_ff87068e-a126-11e3-9f93-12313b0b3603
+ *  - counta positive integer (default: 0)
+ *  - is_embed(internal use only)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - stylesrsubreddit name
+ **/
+fun OAuthClient.getLiveThread(thread: String, after: String?, before: String?, count: Int?, isEmbed: String?, limit: Int?, stylesr: String?) =
+        retry(3) { requestApi("/live/$thread",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "is_embed" to isEmbed, 
+                "limit" to limit, 
+                "stylesr" to stylesr).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L382>
+ * # <https://www.reddit.com/dev/api#GET_live_{thread}_about>GET /live/thread/about
+ * read <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Get some basic information about the live thread.
+ *  - See also: /api/live/thread/edit 
+ * <https://www.reddit.com/dev/api#POST_api_live_%7Bthread%7D_edit>.
+ **/
+fun OAuthClient.getLiveThreadAbout(thread: String) =
+        retry(3) { requestApi("/live/$thread/about").get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L472>
+ * # <https://www.reddit.com/dev/api#GET_live_{thread}_contributors>GET /live/
+ * thread/contributorsread <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Get a list of users that contribute to this thread.
+ *  - See also: /api/live/thread/invite_contributor 
+ * <https://www.reddit.com/dev/api#POST_api_live_%7Bthread%7D_invite_contributor>, 
+ * and/api/live/thread/rm_contributor 
+ * <https://www.reddit.com/dev/api#POST_api_live_%7Bthread%7D_rm_contributor>.
+ **/
+fun OAuthClient.getLiveThreadContributors(thread: String) =
+        retry(3) { requestApi("/live/$thread/contributors").get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L398>
+ * # <https://www.reddit.com/dev/api#GET_live_{thread}_discussions>GET /live/thread
+ * /discussionsread <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  - Get a list of reddit submissions linking to this thread.
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getLiveThreadDiscussions(thread: String, after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/live/$thread/discussions",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1842># 
+ * <https://www.reddit.com/dev/api#POST_api_block>POST /api/blockprivatemessages 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - For blocking via inbox.
+ *  - idfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postBlock(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/block").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3403># 
+ * <https://www.reddit.com/dev/api#POST_api_collapse_message>POST 
+ * /api/collapse_message
+ *  - Collapse a message
+ *  - See also: /api/uncollapse_message 
+ * <https://www.reddit.com/dev/api#POST_uncollapse_message>
+ *  - idA comma-separated list of thing fullnames 
+ * <https://www.reddit.com/dev/api#fullnames>
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postCollapse_message(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/collapse_message").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L345># 
+ * <https://www.reddit.com/dev/api#POST_api_compose>POST /api/compose
+ * privatemessages <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Handles message composition under /message/compose.
+ *  - api_typethe string json
+ *  - captchathe user's response to the CAPTCHA challenge
+ *  - from_srsubreddit name
+ *  - identhe identifier of the CAPTCHA challenge
+ *  - subjecta string no longer than 100 characters
+ *  - textraw markdown text
+ *  - tothe name of an existing user
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postCompose(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/compose").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3455># 
+ * <https://www.reddit.com/dev/api#POST_api_read_all_messages>POST 
+ * /api/read_all_messagesprivatemessages 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Queue up marking all messages for a user as read.
+ *  - This may take some time, and returns 202 to acknowledge acceptance of the 
+ * request.
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postRead_all_messages(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/read_all_messages").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3441># 
+ * <https://www.reddit.com/dev/api#POST_api_read_message>POST /api/read_message
+ * privatemessages <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - idA comma-separated list of thing fullnames 
+ * <https://www.reddit.com/dev/api#fullnames>
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postRead_message(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/read_message").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1881># 
+ * <https://www.reddit.com/dev/api#POST_api_unblock_subreddit>POST 
+ * /api/unblock_subredditprivatemessages 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - idfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postUnblock_subreddit(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/unblock_subreddit").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3415># 
+ * <https://www.reddit.com/dev/api#POST_api_uncollapse_message>POST 
+ * /api/uncollapse_message
+ *  - Uncollapse a message
+ *  - See also: /api/collapse_message 
+ * <https://www.reddit.com/dev/api#POST_collapse_message>
+ *  - idA comma-separated list of thing fullnames 
+ * <https://www.reddit.com/dev/api#fullnames>
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postUncollapse_message(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/uncollapse_message").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3427># 
+ * <https://www.reddit.com/dev/api#POST_api_unread_message>POST /api/unread_message
+ * privatemessages <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - idA comma-separated list of thing fullnames 
+ * <https://www.reddit.com/dev/api#fullnames>
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postUnread_message(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/unread_message").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1299>
+ * # <https://www.reddit.com/dev/api#GET_message_{where}>GET /message/where
+ * privatemessages <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /message/inbox
+ *  * → /message/unread
+ *  * → /message/sentThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - markone of (true, false)
+ *  - midafterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getMessageWhere(where: String, mark: Boolean?, after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/message/$where",
+                "mark" to mark, 
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1299>
+ * # <https://www.reddit.com/dev/api#GET_message_{where}>GET /message/where
+ * privatemessages <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /message/inbox
+ *  * → /message/unread
+ *  * → /message/sentThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - markone of (true, false)
+ *  - midafterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getMessageInbox(mark: Boolean?, after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/message/inbox",
+                "mark" to mark, 
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1299>
+ * # <https://www.reddit.com/dev/api#GET_message_{where}>GET /message/where
+ * privatemessages <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /message/inbox
+ *  * → /message/unread
+ *  * → /message/sentThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - markone of (true, false)
+ *  - midafterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getMessageUnread(mark: Boolean?, after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/message/unread",
+                "mark" to mark, 
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1299>
+ * # <https://www.reddit.com/dev/api#GET_message_{where}>GET /message/where
+ * privatemessages <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /message/inbox
+ *  * → /message/unread
+ *  * → /message/sentThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - markone of (true, false)
+ *  - midafterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getMessageSent(mark: Boolean?, after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/message/sent",
+                "mark" to mark, 
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/apiv1/scopes.py#L34>
+ * # <https://www.reddit.com/dev/api#GET_api_v1_scopes>GET /api/v1/scopesany 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Retrieve descriptions of reddit's OAuth2 scopes.
+ *  - If no scopes are given, information on all scopes are returned.
+ *  - Invalid scope(s) will result in a 400 error with body that indicates the 
+ * invalid scope(s).
+ *  - scopes(optional) An OAuth2 scope string
+ **/
+fun OAuthClient.getV1Scopes(scopes: String?) =
+        retry(3) { requestApi("/api/v1/scopes",
+                "scopes" to scopes).get().getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L593># 
+ * <https://www.reddit.com/dev/api#GET_about_log>GET [/r/subreddit]/about/logmodlog
+ *  <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  - Get a list of recent moderation actions.
+ *  - Moderator actions taken within a subreddit are logged. This listing is a view 
+ * of that log with various filters to aid in analyzing the information.
+ *  - The optional mod parameter can be a comma-delimited list of moderator names 
+ * to restrict the results to, or the stringa to restrict the results to admin 
+ * actions taken within the subreddit.
+ *  - The type parameter is optional and if sent limits the log entries returned to 
+ * only those of the type specified.
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 500)
+ *  - mod(optional) a moderator filter
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ *  - typeone of (banuser, unbanuser, removelink, approvelink, removecomment, 
+ * approvecomment, addmoderator, invitemoderator, uninvitemoderator, 
+ * acceptmoderatorinvite, removemoderator, addcontributor, removecontributor, 
+ * editsettings, editflair, distinguish, marknsfw, wikibanned, wikicontributor, 
+ * wikiunbanned, wikipagelisted, removewikicontributor, wikirevise, wikipermlevel, 
+ * ignorereports, unignorereports, setpermissions, setsuggestedsort, sticky, 
+ * unsticky, setcontestmode, unsetcontestmode, lock, unlock, muteuser, unmuteuser, 
+ * createrule, editrule, deleterule)
+ **/
+fun OAuthClient.getRSubredditAboutLog(subreddit: String, after: String?, before: String?, count: Int?, limit: Int?, mod: String?, show: String?, srDetail: Boolean?, type: String?) =
+        retry(3) { requestApi("/r/$subreddit/about/log",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "mod" to mod, 
+                "show" to show, 
+                "sr_detail" to srDetail, 
+                "type" to type).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L818># 
+ * <https://www.reddit.com/dev/api#GET_about_{location}>GET [/r/subreddit]/about/
+ * locationread <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  * → [/r/subreddit]/about/reports
+ *  * → [/r/subreddit]/about/spam
+ *  * → [/r/subreddit]/about/modqueue
+ *  * → [/r/subreddit]/about/unmoderated
+ *  * → [/r/subreddit]/about/editedReturn a listing of posts relevant to 
+ * moderators.
+ *  * reports: Things that have been reported. 
+ *  * spam: Things that have been marked as spam or otherwise removed. 
+ *  * modqueue: Things requiring moderator review, such as reported things and 
+ * items caught by the spam filter. 
+ *  * unmoderated: Things that have yet to be approved/removed by a mod. 
+ *  * edited: Things that have been edited recently. Requires the "posts" 
+ * moderator permission for the subreddit.
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - locationonlyone of (links, comments)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getRSubredditAboutLocation(subreddit: String, location: String, after: String?, before: String?, count: Int?, limit: Int?, only: String?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/r/$subreddit/about/$location",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "only" to only, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L818># 
+ * <https://www.reddit.com/dev/api#GET_about_{location}>GET [/r/subreddit]/about/
+ * locationread <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  * → [/r/subreddit]/about/reports
+ *  * → [/r/subreddit]/about/spam
+ *  * → [/r/subreddit]/about/modqueue
+ *  * → [/r/subreddit]/about/unmoderated
+ *  * → [/r/subreddit]/about/editedReturn a listing of posts relevant to 
+ * moderators.
+ *  * reports: Things that have been reported. 
+ *  * spam: Things that have been marked as spam or otherwise removed. 
+ *  * modqueue: Things requiring moderator review, such as reported things and 
+ * items caught by the spam filter. 
+ *  * unmoderated: Things that have yet to be approved/removed by a mod. 
+ *  * edited: Things that have been edited recently. Requires the "posts" 
+ * moderator permission for the subreddit.
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - locationonlyone of (links, comments)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getRSubredditAboutReports(subreddit: String, after: String?, before: String?, count: Int?, limit: Int?, only: String?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/r/$subreddit/about/reports",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "only" to only, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L818># 
+ * <https://www.reddit.com/dev/api#GET_about_{location}>GET [/r/subreddit]/about/
+ * locationread <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  * → [/r/subreddit]/about/reports
+ *  * → [/r/subreddit]/about/spam
+ *  * → [/r/subreddit]/about/modqueue
+ *  * → [/r/subreddit]/about/unmoderated
+ *  * → [/r/subreddit]/about/editedReturn a listing of posts relevant to 
+ * moderators.
+ *  * reports: Things that have been reported. 
+ *  * spam: Things that have been marked as spam or otherwise removed. 
+ *  * modqueue: Things requiring moderator review, such as reported things and 
+ * items caught by the spam filter. 
+ *  * unmoderated: Things that have yet to be approved/removed by a mod. 
+ *  * edited: Things that have been edited recently. Requires the "posts" 
+ * moderator permission for the subreddit.
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - locationonlyone of (links, comments)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getRSubredditAboutSpam(subreddit: String, after: String?, before: String?, count: Int?, limit: Int?, only: String?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/r/$subreddit/about/spam",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "only" to only, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L818># 
+ * <https://www.reddit.com/dev/api#GET_about_{location}>GET [/r/subreddit]/about/
+ * locationread <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  * → [/r/subreddit]/about/reports
+ *  * → [/r/subreddit]/about/spam
+ *  * → [/r/subreddit]/about/modqueue
+ *  * → [/r/subreddit]/about/unmoderated
+ *  * → [/r/subreddit]/about/editedReturn a listing of posts relevant to 
+ * moderators.
+ *  * reports: Things that have been reported. 
+ *  * spam: Things that have been marked as spam or otherwise removed. 
+ *  * modqueue: Things requiring moderator review, such as reported things and 
+ * items caught by the spam filter. 
+ *  * unmoderated: Things that have yet to be approved/removed by a mod. 
+ *  * edited: Things that have been edited recently. Requires the "posts" 
+ * moderator permission for the subreddit.
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - locationonlyone of (links, comments)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getRSubredditAboutModqueue(subreddit: String, after: String?, before: String?, count: Int?, limit: Int?, only: String?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/r/$subreddit/about/modqueue",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "only" to only, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L818># 
+ * <https://www.reddit.com/dev/api#GET_about_{location}>GET [/r/subreddit]/about/
+ * locationread <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  * → [/r/subreddit]/about/reports
+ *  * → [/r/subreddit]/about/spam
+ *  * → [/r/subreddit]/about/modqueue
+ *  * → [/r/subreddit]/about/unmoderated
+ *  * → [/r/subreddit]/about/editedReturn a listing of posts relevant to 
+ * moderators.
+ *  * reports: Things that have been reported. 
+ *  * spam: Things that have been marked as spam or otherwise removed. 
+ *  * modqueue: Things requiring moderator review, such as reported things and 
+ * items caught by the spam filter. 
+ *  * unmoderated: Things that have yet to be approved/removed by a mod. 
+ *  * edited: Things that have been edited recently. Requires the "posts" 
+ * moderator permission for the subreddit.
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - locationonlyone of (links, comments)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getRSubredditAboutUnmoderated(subreddit: String, after: String?, before: String?, count: Int?, limit: Int?, only: String?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/r/$subreddit/about/unmoderated",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "only" to only, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L818># 
+ * <https://www.reddit.com/dev/api#GET_about_{location}>GET [/r/subreddit]/about/
+ * locationread <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  * → [/r/subreddit]/about/reports
+ *  * → [/r/subreddit]/about/spam
+ *  * → [/r/subreddit]/about/modqueue
+ *  * → [/r/subreddit]/about/unmoderated
+ *  * → [/r/subreddit]/about/editedReturn a listing of posts relevant to 
+ * moderators.
+ *  * reports: Things that have been reported. 
+ *  * spam: Things that have been marked as spam or otherwise removed. 
+ *  * modqueue: Things requiring moderator review, such as reported things and 
+ * items caught by the spam filter. 
+ *  * unmoderated: Things that have yet to be approved/removed by a mod. 
+ *  * edited: Things that have been edited recently. Requires the "posts" 
+ * moderator permission for the subreddit.
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - locationonlyone of (links, comments)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getRSubredditAboutEdited(subreddit: String, after: String?, before: String?, count: Int?, limit: Int?, only: String?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/r/$subreddit/about/edited",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "only" to only, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1317># 
+ * <https://www.reddit.com/dev/api#POST_api_accept_moderator_invite>POST [/r/
+ * subreddit]/api/accept_moderator_invitemodself 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Accept an invite to moderate the specified subreddit.
+ *  - The authenticated user must have been invited to moderate the subreddit by 
+ * one of its current moderators.
+ *  - See also: /api/friend <https://www.reddit.com/dev/api#POST_api_friend> and 
+ * /subreddits/mine 
+ * <https://www.reddit.com/dev/api#GET_subreddits_mine_%7Bwhere%7D>.
+ *  - api_typethe string json
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postRSubredditAccept_moderator_invite(subreddit: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/accept_moderator_invite").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3096># 
+ * <https://www.reddit.com/dev/api#POST_api_approve>POST /api/approvemodposts 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Approve a link or comment.
+ *  - If the thing was removed, it will be re-inserted into appropriate listings. 
+ * Any reports on the approved thing will be discarded.
+ *  - See also: /api/remove <https://www.reddit.com/dev/api#POST_api_remove>.
+ *  - idfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postApprove(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/approve").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3192># 
+ * <https://www.reddit.com/dev/api#POST_api_distinguish>POST /api/distinguish
+ * modposts <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Distinguish a thing's author with a sigil.
+ *  - This can be useful to draw attention to and confirm the identity of the user 
+ * in the context of a link or comment of theirs. The options for distinguish are 
+ * as follows:
+ *  * yes - add a moderator distinguish ([M]). only if the user is a moderator of 
+ * the subreddit the thing is in. 
+ *  * no - remove any distinguishes. 
+ *  * admin - add an admin distinguish ([A]). admin accounts only. 
+ *  * special - add a user-specific distinguish. depends on user. The first time 
+ * a top-level comment is moderator distinguished, the author of the link the 
+ * comment is in reply to will get a notification in their inbox.
+ *  - api_typethe string json
+ *  - howone of (yes, no, admin, special)
+ *  - idfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postDistinguish(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/distinguish").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3140># 
+ * <https://www.reddit.com/dev/api#POST_api_ignore_reports>POST /api/ignore_reports
+ * modposts <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Prevent future reports on a thing from causing notifications.
+ *  - Any reports made about a thing after this flag is set on it will not cause 
+ * notifications or make the thing show up in the various moderation listings.
+ *  - See also: /api/unignore_reports 
+ * <https://www.reddit.com/dev/api#POST_api_unignore_reports>.
+ *  - idfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postIgnore_reports(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/ignore_reports").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L812># 
+ * <https://www.reddit.com/dev/api#POST_api_leavecontributor>POST 
+ * /api/leavecontributormodself <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Abdicate approved submitter status in a subreddit.
+ *  - See also: /api/friend <https://www.reddit.com/dev/api#POST_api_friend>.
+ *  - idfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postLeavecontributor(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/leavecontributor").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L796># 
+ * <https://www.reddit.com/dev/api#POST_api_leavemoderator>POST /api/leavemoderator
+ * modself <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Abdicate moderator status in a subreddit.
+ *  - See also: /api/friend <https://www.reddit.com/dev/api#POST_api_friend>.
+ *  - idfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postLeavemoderator(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/leavemoderator").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1901># 
+ * <https://www.reddit.com/dev/api#POST_api_mute_message_author>POST 
+ * /api/mute_message_authormodcontributors 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - For muting user via modmail.
+ *  - idfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postMute_message_author(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/mute_message_author").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3034># 
+ * <https://www.reddit.com/dev/api#POST_api_remove>POST /api/removemodposts 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Remove a link, comment, or modmail message.
+ *  - If the thing is a link, it will be removed from all subreddit listings. If 
+ * the thing is a comment, it will be redacted and removed from all subreddit 
+ * comment listings.
+ *  - See also: /api/approve <https://www.reddit.com/dev/api#POST_api_approve>.
+ *  - idfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - spamboolean value
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postRemove(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/remove").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3168># 
+ * <https://www.reddit.com/dev/api#POST_api_unignore_reports>POST 
+ * /api/unignore_reportsmodposts <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Allow future reports on a thing to cause notifications.
+ *  - See also: /api/ignore_reports 
+ * <https://www.reddit.com/dev/api#POST_api_ignore_reports>.
+ *  - idfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postUnignore_reports(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/unignore_reports").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1945># 
+ * <https://www.reddit.com/dev/api#POST_api_unmute_message_author>POST 
+ * /api/unmute_message_authormodcontributors 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - For unmuting user via modmail.
+ *  - idfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postUnmute_message_author(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/unmute_message_author").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L556># 
+ * <https://www.reddit.com/dev/api#GET_stylesheet>GET [/r/subreddit]/stylesheet
+ * modconfig <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Redirect to the subreddit's stylesheet if one exists.
+ *  - See also: /api/subreddit_stylesheet 
+ * <https://www.reddit.com/dev/api#POST_api_subreddit_stylesheet>.
+ **/
+fun OAuthClient.getRSubredditStylesheet(subreddit: String) =
+        retry(3) { requestApi("/r/$subreddit/stylesheet").get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L285># 
+ * <https://www.reddit.com/dev/api#POST_api_multi_copy>POST /api/multi/copy
+ * subscribe <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Copy a multi.
+ *  - Responds with 409 Conflict if the target already exists.
+ *  - A "copied from ..." line will automatically be appended to the description.
+ *  - display_namea string no longer than 50 characters
+ *  - frommultireddit url path
+ *  - todestination multireddit url path
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postMultiCopy(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/multi/copy").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L115># 
+ * <https://www.reddit.com/dev/api#GET_api_multi_mine>GET /api/multi/mineread 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Fetch a list of multis belonging to the current user.
+ *  - expand_srsboolean value
+ **/
+fun OAuthClient.getMultiMine(expandSrs: String?) =
+        retry(3) { requestApi("/api/multi/mine",
+                "expand_srs" to expandSrs).get().getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L334># 
+ * <https://www.reddit.com/dev/api#POST_api_multi_rename>POST /api/multi/rename
+ * subscribe <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Rename a multi.
+ *  - display_namea string no longer than 50 characters
+ *  - frommultireddit url path
+ *  - todestination multireddit url path
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postMultiRename(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/multi/rename").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L104># 
+ * <https://www.reddit.com/dev/api#GET_api_multi_user_{username}>GET 
+ * /api/multi/user/usernameread <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Fetch a list of public multis belonging to username
+ *  - expand_srsboolean value
+ *  - usernameA valid, existing reddit username
+ **/
+fun OAuthClient.getMultiUserUsername(username: String, expandSrs: String?) =
+        retry(3) { requestApi("/api/multi/user/$username",
+                "expand_srs" to expandSrs, 
+                "username" to username).get().getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L255># 
+ * <https://www.reddit.com/dev/api#DELETE_api_multi_{multipath}>DELETE /api/multi/
+ * multipathsubscribe <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  * → /api/filter/filterpathDelete a multi.
+ *  - multipathmultireddit url path
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ *  - expand_srsboolean value
+ **/
+fun OAuthClient.deleteMultiMultipath(multipath: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/multi/$multipath").method("delete").getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L255># 
+ * <https://www.reddit.com/dev/api#DELETE_api_multi_{multipath}>DELETE /api/multi/
+ * multipathsubscribe <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  * → /api/filter/filterpathDelete a multi.
+ *  - multipathmultireddit url path
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ *  - expand_srsboolean value
+ **/
+fun OAuthClient.deleteFilterFilterpath(filterpath: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/filter/$filterpath").method("delete").getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L127># 
+ * <https://www.reddit.com/dev/api#GET_api_multi_{multipath}>GET /api/multi/
+ * multipathread <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  * → /api/filter/filterpathFetch a multi's data and subreddit list by name.
+ *  - expand_srsboolean value
+ *  - multipathmultireddit url path
+ **/
+fun OAuthClient.getMultiMultipath(multipath: String, expandSrs: String?) =
+        retry(3) { requestApi("/api/multi/$multipath",
+                "expand_srs" to expandSrs, 
+                "multipath" to multipath).get().getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L127># 
+ * <https://www.reddit.com/dev/api#GET_api_multi_{multipath}>GET /api/multi/
+ * multipathread <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  * → /api/filter/filterpathFetch a multi's data and subreddit list by name.
+ *  - expand_srsboolean value
+ *  - multipathmultireddit url path
+ **/
+fun OAuthClient.getFilterFilterpath(filterpath: String, expandSrs: String?, multipath: String?) =
+        retry(3) { requestApi("/api/filter/$filterpath",
+                "expand_srs" to expandSrs, 
+                "multipath" to multipath).get().getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L199># 
+ * <https://www.reddit.com/dev/api#POST_api_multi_{multipath}>POST /api/multi/
+ * multipathsubscribe <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  * → /api/filter/filterpathCreate a multi. Responds with 409 Conflict if it 
+ * already exists.
+ *  - modeljson data:
+ *  - { "description_md": raw markdown text, "display_name": a string no longer 
+ * than 50 characters, "icon_name": 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": a 6-digit rgb hex color, e.g. `#AABBCC`, 
+ * "subreddits": [ { "name": subreddit name, }, ... ], "visibility": one of 
+ * (`private`, `public`, `hidden`), "weighting_scheme": one of (`classic`, 
+ * `fresh`), } multipathmultireddit url path
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ *  - expand_srsboolean value
+ **/
+fun OAuthClient.postMultiMultipath(multipath: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/multi/$multipath").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L199># 
+ * <https://www.reddit.com/dev/api#POST_api_multi_{multipath}>POST /api/multi/
+ * multipathsubscribe <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  * → /api/filter/filterpathCreate a multi. Responds with 409 Conflict if it 
+ * already exists.
+ *  - modeljson data:
+ *  - { "description_md": raw markdown text, "display_name": a string no longer 
+ * than 50 characters, "icon_name": 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": a 6-digit rgb hex color, e.g. `#AABBCC`, 
+ * "subreddits": [ { "name": subreddit name, }, ... ], "visibility": one of 
+ * (`private`, `public`, `hidden`), "weighting_scheme": one of (`classic`, 
+ * `fresh`), } multipathmultireddit url path
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ *  - expand_srsboolean value
+ **/
+fun OAuthClient.postFilterFilterpath(filterpath: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/filter/$filterpath").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L233># 
+ * <https://www.reddit.com/dev/api#PUT_api_multi_{multipath}>PUT /api/multi/
+ * multipathsubscribe <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  * → /api/filter/filterpathCreate or update a multi.
+ *  - modeljson data:
+ *  - { "description_md": raw markdown text, "display_name": a string no longer 
+ * than 50 characters, "icon_name": 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": a 6-digit rgb hex color, e.g. `#AABBCC`, 
+ * "subreddits": [ { "name": subreddit name, }, ... ], "visibility": one of 
+ * (`private`, `public`, `hidden`), "weighting_scheme": one of (`classic`, 
+ * `fresh`), } multipathmultireddit url path
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ *  - expand_srsboolean value
+ **/
+fun OAuthClient.putMultiMultipath(multipath: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/multi/$multipath").method("put").getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L233># 
+ * <https://www.reddit.com/dev/api#PUT_api_multi_{multipath}>PUT /api/multi/
+ * multipathsubscribe <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  * → /api/filter/filterpathCreate or update a multi.
+ *  - modeljson data:
+ *  - { "description_md": raw markdown text, "display_name": a string no longer 
+ * than 50 characters, "icon_name": 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": a 6-digit rgb hex color, e.g. `#AABBCC`, 
+ * "subreddits": [ { "name": subreddit name, }, ... ], "visibility": one of 
+ * (`private`, `public`, `hidden`), "weighting_scheme": one of (`classic`, 
+ * `fresh`), } multipathmultireddit url path
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ *  - expand_srsboolean value
+ **/
+fun OAuthClient.putFilterFilterpath(filterpath: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/filter/$filterpath").method("put").getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L427># 
+ * <https://www.reddit.com/dev/api#GET_api_multi_{multipath}_description>GET 
+ * /api/multi/multipath/descriptionread 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Get a multi's description.
+ *  - multipathmultireddit url path
+ **/
+fun OAuthClient.getMultiMultipathDescription(multipath: String) =
+        retry(3) { requestApi("/api/multi/$multipath/description",
+                "multipath" to multipath).get().getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L440># 
+ * <https://www.reddit.com/dev/api#PUT_api_multi_{multipath}_description>PUT 
+ * /api/multi/multipath/descriptionread 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Change a multi's markdown description.
+ *  - modeljson data:
+ *  - { "body_md": raw markdown text, } multipathmultireddit url path
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.putMultiMultipathDescription(multipath: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/multi/$multipath/description").method("put").getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L410># 
+ * <https://www.reddit.com/dev/api#DELETE_api_multi_{multipath}_r_{srname}>DELETE 
+ * /api/multi/multipath/r/srnamesubscribe 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  * → /api/filter/filterpath/r/srnameRemove a subreddit from a multi.
+ *  - multipathmultireddit url path
+ *  - srnamesubreddit name
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.deleteMultiMultipathRSrname(multipath: String, srname: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/multi/$multipath/r/$srname").method("delete").getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L410># 
+ * <https://www.reddit.com/dev/api#DELETE_api_multi_{multipath}_r_{srname}>DELETE 
+ * /api/multi/multipath/r/srnamesubscribe 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  * → /api/filter/filterpath/r/srnameRemove a subreddit from a multi.
+ *  - multipathmultireddit url path
+ *  - srnamesubreddit name
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.deleteFilterFilterpathRSrname(filterpath: String, srname: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/filter/$filterpath/r/$srname").method("delete").getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L371># 
+ * <https://www.reddit.com/dev/api#GET_api_multi_{multipath}_r_{srname}>GET 
+ * /api/multi/multipath/r/srnameread <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  * → /api/filter/filterpath/r/srnameGet data about a subreddit in a multi.
+ *  - multipathmultireddit url path
+ *  - srnamesubreddit name
+ **/
+fun OAuthClient.getMultiMultipathRSrname(multipath: String, srname: String) =
+        retry(3) { requestApi("/api/multi/$multipath/r/$srname",
+                "multipath" to multipath, 
+                "srname" to srname).get().getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L371># 
+ * <https://www.reddit.com/dev/api#GET_api_multi_{multipath}_r_{srname}>GET 
+ * /api/multi/multipath/r/srnameread <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  * → /api/filter/filterpath/r/srnameGet data about a subreddit in a multi.
+ *  - multipathmultireddit url path
+ *  - srnamesubreddit name
+ **/
+fun OAuthClient.getFilterFilterpathRSrname(filterpath: String, srname: String, multipath: String?) =
+        retry(3) { requestApi("/api/filter/$filterpath/r/$srname",
+                "multipath" to multipath, 
+                "srname" to srname).get().getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L386># 
+ * <https://www.reddit.com/dev/api#PUT_api_multi_{multipath}_r_{srname}>PUT 
+ * /api/multi/multipath/r/srnamesubscribe 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  * → /api/filter/filterpath/r/srnameAdd a subreddit to a multi.
+ *  - modeljson data:
+ *  - { "name": subreddit name, } multipathmultireddit url path
+ *  - srnamesubreddit name
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.putMultiMultipathRSrname(multipath: String, srname: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/multi/$multipath/r/$srname").method("put").getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L386># 
+ * <https://www.reddit.com/dev/api#PUT_api_multi_{multipath}_r_{srname}>PUT 
+ * /api/multi/multipath/r/srnamesubscribe 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  * → /api/filter/filterpath/r/srnameAdd a subreddit to a multi.
+ *  - modeljson data:
+ *  - { "name": subreddit name, } multipathmultireddit url path
+ *  - srnamesubreddit name
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.putFilterFilterpathRSrname(filterpath: String, srname: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/filter/$filterpath/r/$srname").method("put").getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L1092>#
+ *  <https://www.reddit.com/dev/api#GET_search>GET [/r/subreddit]/searchread 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  - Search links page.
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - include_facetsboolean value
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - qa string no longer than 512 characters
+ *  - restrict_srboolean value
+ *  - show(optional) the string all
+ *  - sortone of (relevance, hot, top, new, comments)
+ *  - sr_detail(optional) expand subreddits
+ *  - syntaxone of (cloudsearch, lucene, plain)
+ *  - tone of (hour, day, week, month, year, all)
+ *  - type(optional) comma-delimited list of result types (sr, link)
+ **/
+fun OAuthClient.getRSubredditSearch(subreddit: String, after: String?, before: String?, count: Int?, includeFacets: String?, limit: Int?, q: String?, restrictSr: String?, show: String?, sort: String?, srDetail: Boolean?, syntax: String?, t: String?, type: List<String>?) =
+        retry(3) { requestApi("/r/$subreddit/search",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "include_facets" to includeFacets, 
+                "limit" to limit, 
+                "q" to q, 
+                "restrict_sr" to restrictSr, 
+                "show" to show, 
+                "sort" to sort, 
+                "sr_detail" to srDetail, 
+                "syntax" to syntax, 
+                "t" to t, 
+                "type" to type.csv()).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1855>
+ * # <https://www.reddit.com/dev/api#GET_about_{where}>GET [/r/subreddit]/about/
+ * whereread <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → [/r/subreddit]/about/banned
+ *  * → [/r/subreddit]/about/muted
+ *  * → [/r/subreddit]/about/wikibanned
+ *  * → [/r/subreddit]/about/contributors
+ *  * → [/r/subreddit]/about/wikicontributors
+ *  * → [/r/subreddit]/about/moderatorsThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ *  - userA valid, existing reddit username
+ **/
+fun OAuthClient.getRSubredditAboutWhere(subreddit: String, where: String, after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?, user: String?) =
+        retry(3) { requestApi("/r/$subreddit/about/$where",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail, 
+                "user" to user).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1855>
+ * # <https://www.reddit.com/dev/api#GET_about_{where}>GET [/r/subreddit]/about/
+ * whereread <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → [/r/subreddit]/about/banned
+ *  * → [/r/subreddit]/about/muted
+ *  * → [/r/subreddit]/about/wikibanned
+ *  * → [/r/subreddit]/about/contributors
+ *  * → [/r/subreddit]/about/wikicontributors
+ *  * → [/r/subreddit]/about/moderatorsThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ *  - userA valid, existing reddit username
+ **/
+fun OAuthClient.getRSubredditAboutBanned(subreddit: String, after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?, user: String?) =
+        retry(3) { requestApi("/r/$subreddit/about/banned",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail, 
+                "user" to user).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1855>
+ * # <https://www.reddit.com/dev/api#GET_about_{where}>GET [/r/subreddit]/about/
+ * whereread <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → [/r/subreddit]/about/banned
+ *  * → [/r/subreddit]/about/muted
+ *  * → [/r/subreddit]/about/wikibanned
+ *  * → [/r/subreddit]/about/contributors
+ *  * → [/r/subreddit]/about/wikicontributors
+ *  * → [/r/subreddit]/about/moderatorsThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ *  - userA valid, existing reddit username
+ **/
+fun OAuthClient.getRSubredditAboutMuted(subreddit: String, after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?, user: String?) =
+        retry(3) { requestApi("/r/$subreddit/about/muted",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail, 
+                "user" to user).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1855>
+ * # <https://www.reddit.com/dev/api#GET_about_{where}>GET [/r/subreddit]/about/
+ * whereread <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → [/r/subreddit]/about/banned
+ *  * → [/r/subreddit]/about/muted
+ *  * → [/r/subreddit]/about/wikibanned
+ *  * → [/r/subreddit]/about/contributors
+ *  * → [/r/subreddit]/about/wikicontributors
+ *  * → [/r/subreddit]/about/moderatorsThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ *  - userA valid, existing reddit username
+ **/
+fun OAuthClient.getRSubredditAboutWikibanned(subreddit: String, after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?, user: String?) =
+        retry(3) { requestApi("/r/$subreddit/about/wikibanned",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail, 
+                "user" to user).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1855>
+ * # <https://www.reddit.com/dev/api#GET_about_{where}>GET [/r/subreddit]/about/
+ * whereread <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → [/r/subreddit]/about/banned
+ *  * → [/r/subreddit]/about/muted
+ *  * → [/r/subreddit]/about/wikibanned
+ *  * → [/r/subreddit]/about/contributors
+ *  * → [/r/subreddit]/about/wikicontributors
+ *  * → [/r/subreddit]/about/moderatorsThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ *  - userA valid, existing reddit username
+ **/
+fun OAuthClient.getRSubredditAboutContributors(subreddit: String, after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?, user: String?) =
+        retry(3) { requestApi("/r/$subreddit/about/contributors",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail, 
+                "user" to user).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1855>
+ * # <https://www.reddit.com/dev/api#GET_about_{where}>GET [/r/subreddit]/about/
+ * whereread <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → [/r/subreddit]/about/banned
+ *  * → [/r/subreddit]/about/muted
+ *  * → [/r/subreddit]/about/wikibanned
+ *  * → [/r/subreddit]/about/contributors
+ *  * → [/r/subreddit]/about/wikicontributors
+ *  * → [/r/subreddit]/about/moderatorsThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ *  - userA valid, existing reddit username
+ **/
+fun OAuthClient.getRSubredditAboutWikicontributors(subreddit: String, after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?, user: String?) =
+        retry(3) { requestApi("/r/$subreddit/about/wikicontributors",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail, 
+                "user" to user).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1855>
+ * # <https://www.reddit.com/dev/api#GET_about_{where}>GET [/r/subreddit]/about/
+ * whereread <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → [/r/subreddit]/about/banned
+ *  * → [/r/subreddit]/about/muted
+ *  * → [/r/subreddit]/about/wikibanned
+ *  * → [/r/subreddit]/about/contributors
+ *  * → [/r/subreddit]/about/wikicontributors
+ *  * → [/r/subreddit]/about/moderatorsThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ *  - userA valid, existing reddit username
+ **/
+fun OAuthClient.getRSubredditAboutModerators(subreddit: String, after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?, user: String?) =
+        retry(3) { requestApi("/r/$subreddit/about/moderators",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail, 
+                "user" to user).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L2539># 
+ * <https://www.reddit.com/dev/api#POST_api_delete_sr_banner>POST [/r/subreddit
+ * ]/api/delete_sr_bannermodconfig <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Remove the subreddit's custom mobile banner.
+ *  - See also: /api/upload_sr_img 
+ * <https://www.reddit.com/dev/api#POST_api_upload_sr_img>.
+ *  - api_typethe string json
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postRSubredditDelete_sr_banner(subreddit: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/delete_sr_banner").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L2479># 
+ * <https://www.reddit.com/dev/api#POST_api_delete_sr_header>POST [/r/subreddit
+ * ]/api/delete_sr_headermodconfig <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Remove the subreddit's custom header image.
+ *  - The sitewide-default header image will be shown again after this call.
+ *  - See also: /api/upload_sr_img 
+ * <https://www.reddit.com/dev/api#POST_api_upload_sr_img>.
+ *  - api_typethe string json
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postRSubredditDelete_sr_header(subreddit: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/delete_sr_header").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L2512># 
+ * <https://www.reddit.com/dev/api#POST_api_delete_sr_icon>POST [/r/subreddit
+ * ]/api/delete_sr_iconmodconfig <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Remove the subreddit's custom mobile icon.
+ *  - See also: /api/upload_sr_img 
+ * <https://www.reddit.com/dev/api#POST_api_upload_sr_img>.
+ *  - api_typethe string json
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postRSubredditDelete_sr_icon(subreddit: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/delete_sr_icon").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L2447># 
+ * <https://www.reddit.com/dev/api#POST_api_delete_sr_img>POST [/r/subreddit
+ * ]/api/delete_sr_imgmodconfig <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Remove an image from the subreddit's custom image set.
+ *  - The image will no longer count against the subreddit's image limit. However, 
+ * the actual image data may still be accessible for an unspecified amount of 
+ * time. If the image is currently referenced by the subreddit's stylesheet, that 
+ * stylesheet will no longer validate and won't be editable until the image 
+ * reference is removed.
+ *  - See also: /api/upload_sr_img 
+ * <https://www.reddit.com/dev/api#POST_api_upload_sr_img>.
+ *  - api_typethe string json
+ *  - img_namea valid subreddit image name
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postRSubredditDelete_sr_img(subreddit: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/delete_sr_img").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L5046># 
+ * <https://www.reddit.com/dev/api#GET_api_recommend_sr_{srnames}>GET 
+ * /api/recommend/sr/srnamesread <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Return subreddits recommended for the given subreddit(s).
+ *  - Gets a list of subreddits recommended for srnames, filtering out any that 
+ * appear in the optionalomit param.
+ *  - omitcomma-delimited list of subreddit names
+ *  - srnamescomma-delimited list of subreddit names
+ **/
+fun OAuthClient.getRecommendSrSrnames(srnames: List<String>, omit: List<String>?) =
+        retry(3) { requestApi("/api/recommend/sr/$srnames",
+                "omit" to omit.csv(), 
+                "srnames" to srnames.csv()).get().getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L4592># 
+ * <https://www.reddit.com/dev/api#POST_api_search_reddit_names>POST 
+ * /api/search_reddit_namesread <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - List subreddit names that begin with a query string.
+ *  - Subreddits whose names begin with query will be returned. If include_over_18 
+ * is false, subreddits with over-18 content restrictions will be filtered from 
+ * the results.
+ *  - If exact is true, only an exact match will be returned.
+ *  - exactboolean value
+ *  - include_over_18boolean value
+ *  - querya string up to 50 characters long, consisting of printable characters.
+ **/
+fun OAuthClient.postSearch_reddit_names(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/search_reddit_names").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L2710># 
+ * <https://www.reddit.com/dev/api#POST_api_site_admin>POST /api/site_admin
+ * modconfig <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Create or configure a subreddit.
+ *  - If sr is specified, the request will attempt to modify the specified 
+ * subreddit. If not, a subreddit with namename will be created.
+ *  - This endpoint expects all values to be supplied on every request. If 
+ * modifying a subset of options, it may be useful to get the current settings from
+ * /about/edit.json 
+ * <https://www.reddit.com/dev/api#GET_r_%7Bsubreddit%7D_about_edit.json> first.
+ *  - For backwards compatibility, description is the sidebar text and 
+ * public_description is the publicly visible subreddit description.
+ *  - Most of the parameters for this endpoint are identical to options visible in 
+ * the user interface and their meanings are best explained there.
+ *  - See also: /about/edit.json 
+ * <https://www.reddit.com/dev/api#GET_r_%7Bsubreddit%7D_about_edit.json>.
+ *  - allow_topboolean value
+ *  - api_typethe string json
+ *  - captchathe user's response to the CAPTCHA challenge
+ *  - collapse_deleted_commentsboolean value
+ *  - comment_score_hide_minsan integer between 0 and 1440 (default: 0)
+ *  - descriptionraw markdown text
+ *  - exclude_banned_modqueueboolean value
+ *  - header-titlea string no longer than 500 characters
+ *  - hide_adsboolean value
+ *  - identhe identifier of the CAPTCHA challenge
+ *  - langa valid IETF language tag (underscore separated)
+ *  - link_typeone of (any, link, self)
+ *  - namesubreddit name
+ *  - over_18boolean value
+ *  - public_descriptionraw markdown text
+ *  - public_trafficboolean value
+ *  - show_mediaboolean value
+ *  - spam_commentsone of (low, high, all)
+ *  - spam_linksone of (low, high, all)
+ *  - spam_selfpostsone of (low, high, all)
+ *  - srfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - submit_link_labela string no longer than 60 characters
+ *  - submit_textraw markdown text
+ *  - submit_text_labela string no longer than 60 characters
+ *  - suggested_comment_sortone of (confidence, top, new, controversial, old, random
+ * ,qa)
+ *  - titlea string no longer than 100 characters
+ *  - typeone of (gold_restricted, archived, restricted, gold_only, employees_only, 
+ * private, public)
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ *  - wiki_edit_agean integer greater than 0 (default: 0)
+ *  - wiki_edit_karmaan integer greater than 0 (default: 0)
+ *  - wikimodeone of (disabled, modonly, anyone)
+ **/
+fun OAuthClient.postSite_admin(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/site_admin").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L417># 
+ * <https://www.reddit.com/dev/api#GET_api_submit_text>GET [/r/subreddit
+ * ]/api/submit_textsubmit <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Get the submission text for the subreddit.
+ *  - This text is set by the subreddit moderators and intended to be displayed on 
+ * the submission form.
+ *  - See also: /api/site_admin <https://www.reddit.com/dev/api#POST_api_site_admin>
+ * .
+ **/
+fun OAuthClient.getRSubredditSubmit_text(subreddit: String) =
+        retry(3) { requestApi("/r/$subreddit/api/submit_text").get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L2364># 
+ * <https://www.reddit.com/dev/api#POST_api_subreddit_stylesheet>POST [/r/subreddit
+ * ]/api/subreddit_stylesheetmodconfig 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Update a subreddit's stylesheet.
+ *  - op should be save to update the contents of the stylesheet.
+ *  - api_typethe string json
+ *  - opone of (save, preview)
+ *  - reasona string up to 256 characters long, consisting of printable characters.
+ *  - stylesheet_contentsthe new stylesheet content
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postRSubredditSubreddit_stylesheet(subreddit: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/subreddit_stylesheet").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L4738># 
+ * <https://www.reddit.com/dev/api#GET_api_subreddits_by_topic>GET 
+ * /api/subreddits_by_topicread <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Return a list of subreddits that are relevant to a search query.
+ *  - querya string no longer than 50 characters
+ **/
+fun OAuthClient.getSubreddits_by_topic(query: String?) =
+        retry(3) { requestApi("/api/subreddits_by_topic",
+                "query" to query).get().getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3774># 
+ * <https://www.reddit.com/dev/api#POST_api_subscribe>POST /api/subscribesubscribe 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Subscribe to or unsubscribe from a subreddit.
+ *  - To subscribe, action should be sub. To unsubscribe, action should be unsub. 
+ * The user must have access to the subreddit to be able to subscribe to it.
+ *  - See also: /subreddits/mine/ 
+ * <https://www.reddit.com/dev/api#GET_subreddits_mine_%7Bwhere%7D>.
+ *  - actionone of (sub, unsub)
+ *  - srthe name of a subreddit
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postSubscribe(vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/subscribe").post(urlParams.multipart()).getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L2577># 
+ * <https://www.reddit.com/dev/api#POST_api_upload_sr_img>POST [/r/subreddit
+ * ]/api/upload_sr_imgmodconfig <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Add or replace a subreddit image, custom header logo, custom mobile icon, or 
+ * custom mobile banner.
+ *  * If the upload_type value is img, an image for use in the subreddit 
+ * stylesheet is uploaded with the name specified inname. 
+ *  * If the upload_type value is header then the image uploaded will be the 
+ * subreddit's new logo andname will be ignored. 
+ *  * If the upload_type value is icon then the image uploaded will be the 
+ * subreddit's new mobile icon andname will be ignored. 
+ *  * If the upload_type value is banner then the image uploaded will be the 
+ * subreddit's new mobile banner andname will be ignored. For backwards 
+ * compatibility, ifupload_type is not specified, the header field will be used 
+ * instead:
+ *  * If the header field has value 0, then upload_type is img. 
+ *  * If the header field has value 1, then upload_type is header. The img_type 
+ * field specifies whether to store the uploaded image as a PNG or JPEG.
+ *  - Subreddits have a limited number of images that can be in use at any given 
+ * time. If no image with the specified name already exists, one of the slots will 
+ * be consumed.
+ *  - If an image with the specified name already exists, it will be replaced. This 
+ * does not affect the stylesheet immediately, but will take effect the next time 
+ * the stylesheet is saved.
+ *  - See also: /api/delete_sr_img 
+ * <https://www.reddit.com/dev/api#POST_api_delete_sr_img>, /api/delete_sr_header 
+ * <https://www.reddit.com/dev/api#POST_api_delete_sr_header>, /api/delete_sr_icon 
+ * <https://www.reddit.com/dev/api#POST_api_delete_sr_icon>, and 
+ * /api/delete_sr_banner <https://www.reddit.com/dev/api#POST_api_delete_sr_banner>
+ * .
+ *  - filefile upload with maximum size of 500 KiB
+ *  - formid(optional) can be ignored
+ *  - headeran integer between 0 and 1
+ *  - img_typeone of png or jpg (default: png)
+ *  - namea valid subreddit image name
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ *  - upload_typeone of (img, header, icon, banner)
+ **/
+fun OAuthClient.postRSubredditUpload_sr_img(subreddit: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/upload_sr_img").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L919># 
+ * <https://www.reddit.com/dev/api#GET_r_{subreddit}_about>GET /r/subreddit/about
+ * read <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Return information about the subreddit.
+ *  - Data includes the subscriber count, description, and header image.
+ **/
+fun OAuthClient.getRSubredditAbout(subreddit: String) =
+        retry(3) { requestApi("/r/$subreddit/about").get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L897># 
+ * <https://www.reddit.com/dev/api#GET_r_{subreddit}_about_edit>GET /r/subreddit
+ * /about/editmodconfig <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Get the current settings of a subreddit.
+ *  - In the API, this returns the current settings of the subreddit as used by 
+ * /api/site_admin <https://www.reddit.com/dev/api#POST_api_site_admin>. On the 
+ * HTML site, it will display a form for editing the subreddit.
+ *  - createdone of (true, false)
+ *  - location
+ **/
+fun OAuthClient.getRSubredditAboutEdit(subreddit: String, created: Boolean?) =
+        retry(3) { requestApi("/r/$subreddit/about/edit",
+                "created" to created).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L938># 
+ * <https://www.reddit.com/dev/api#GET_rules>GET [/r/subreddit]/rulesread 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Get the rules for the current subreddit
+ **/
+fun OAuthClient.getRSubredditRules(subreddit: String) =
+        retry(3) { requestApi("/r/$subreddit/rules").get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L931># 
+ * <https://www.reddit.com/dev/api#GET_sidebar>GET [/r/subreddit]/sidebarread 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Get the sidebar for the current subreddit
+ **/
+fun OAuthClient.getRSubredditSidebar(subreddit: String) =
+        retry(3) { requestApi("/r/$subreddit/sidebar").get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/lib/validator/validator.py#L200>
+ * # <https://www.reddit.com/dev/api#GET_sticky>GET [/r/subreddit]/stickyread 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Redirect to one of the posts stickied in the current subreddit
+ *  - The "num" argument can be used to select a specific sticky, and will default 
+ * to 1 (the top sticky) if not specified. Will 404 if there is not currently a 
+ * sticky post in this subreddit.
+ *  - numan integer between 1 and 2 (default: 1)
+ **/
+fun OAuthClient.getRSubredditSticky(subreddit: String, num: String?) =
+        retry(3) { requestApi("/r/$subreddit/sticky",
+                "num" to num).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1626>
+ * # <https://www.reddit.com/dev/api#GET_subreddits_mine_{where}>GET 
+ * /subreddits/mine/wheremysubreddits 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /subreddits/mine/subscriber
+ *  * → /subreddits/mine/contributor
+ *  * → /subreddits/mine/moderatorGet subreddits the user has a relationship with.
+ *  - The where parameter chooses which subreddits are returned as follows:
+ *  * subscriber - subreddits the user is subscribed to 
+ *  * contributor - subreddits the user is an approved submitter in 
+ *  * moderator - subreddits the user is a moderator of See also: /api/subscribe 
+ * <https://www.reddit.com/dev/api#POST_api_subscribe>, /api/friend 
+ * <https://www.reddit.com/dev/api#POST_api_friend>, and 
+ * /api/accept_moderator_invite 
+ * <https://www.reddit.com/dev/api#POST_api_accept_moderator_invite>.
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getSubredditsMineWhere(where: String, after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/subreddits/mine/$where",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1626>
+ * # <https://www.reddit.com/dev/api#GET_subreddits_mine_{where}>GET 
+ * /subreddits/mine/wheremysubreddits 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /subreddits/mine/subscriber
+ *  * → /subreddits/mine/contributor
+ *  * → /subreddits/mine/moderatorGet subreddits the user has a relationship with.
+ *  - The where parameter chooses which subreddits are returned as follows:
+ *  * subscriber - subreddits the user is subscribed to 
+ *  * contributor - subreddits the user is an approved submitter in 
+ *  * moderator - subreddits the user is a moderator of See also: /api/subscribe 
+ * <https://www.reddit.com/dev/api#POST_api_subscribe>, /api/friend 
+ * <https://www.reddit.com/dev/api#POST_api_friend>, and 
+ * /api/accept_moderator_invite 
+ * <https://www.reddit.com/dev/api#POST_api_accept_moderator_invite>.
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getSubredditsMineSubscriber(after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/subreddits/mine/subscriber",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1626>
+ * # <https://www.reddit.com/dev/api#GET_subreddits_mine_{where}>GET 
+ * /subreddits/mine/wheremysubreddits 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /subreddits/mine/subscriber
+ *  * → /subreddits/mine/contributor
+ *  * → /subreddits/mine/moderatorGet subreddits the user has a relationship with.
+ *  - The where parameter chooses which subreddits are returned as follows:
+ *  * subscriber - subreddits the user is subscribed to 
+ *  * contributor - subreddits the user is an approved submitter in 
+ *  * moderator - subreddits the user is a moderator of See also: /api/subscribe 
+ * <https://www.reddit.com/dev/api#POST_api_subscribe>, /api/friend 
+ * <https://www.reddit.com/dev/api#POST_api_friend>, and 
+ * /api/accept_moderator_invite 
+ * <https://www.reddit.com/dev/api#POST_api_accept_moderator_invite>.
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getSubredditsMineContributor(after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/subreddits/mine/contributor",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1626>
+ * # <https://www.reddit.com/dev/api#GET_subreddits_mine_{where}>GET 
+ * /subreddits/mine/wheremysubreddits 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /subreddits/mine/subscriber
+ *  * → /subreddits/mine/contributor
+ *  * → /subreddits/mine/moderatorGet subreddits the user has a relationship with.
+ *  - The where parameter chooses which subreddits are returned as follows:
+ *  * subscriber - subreddits the user is subscribed to 
+ *  * contributor - subreddits the user is an approved submitter in 
+ *  * moderator - subreddits the user is a moderator of See also: /api/subscribe 
+ * <https://www.reddit.com/dev/api#POST_api_subscribe>, /api/friend 
+ * <https://www.reddit.com/dev/api#POST_api_friend>, and 
+ * /api/accept_moderator_invite 
+ * <https://www.reddit.com/dev/api#POST_api_accept_moderator_invite>.
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getSubredditsMineModerator(after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/subreddits/mine/moderator",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L1034>#
+ *  <https://www.reddit.com/dev/api#GET_subreddits_search>GET /subreddits/search
+ * read <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  - Search subreddits by title and description.
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - qa search query
+ *  - show(optional) the string all
+ *  - sortone of (relevance, activity)
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getSubredditsSearch(after: String?, before: String?, count: Int?, limit: Int?, q: String?, show: String?, sort: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/subreddits/search",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "q" to q, 
+                "show" to show, 
+                "sort" to sort, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1507>
+ * # <https://www.reddit.com/dev/api#GET_subreddits_{where}>GET /subreddits/where
+ * read <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /subreddits/popular
+ *  * → /subreddits/new
+ *  * → /subreddits/gold
+ *  * → /subreddits/defaultGet all subreddits.
+ *  - The where parameter chooses the order in which the subreddits are displayed. 
+ * popular sorts on the activity of the subreddit and the position of the 
+ * subreddits can shift around.new sorts the subreddits based on their creation 
+ * date, newest first.
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getSubredditsWhere(where: String, after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/subreddits/$where",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1507>
+ * # <https://www.reddit.com/dev/api#GET_subreddits_{where}>GET /subreddits/where
+ * read <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /subreddits/popular
+ *  * → /subreddits/new
+ *  * → /subreddits/gold
+ *  * → /subreddits/defaultGet all subreddits.
+ *  - The where parameter chooses the order in which the subreddits are displayed. 
+ * popular sorts on the activity of the subreddit and the position of the 
+ * subreddits can shift around.new sorts the subreddits based on their creation 
+ * date, newest first.
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getSubredditsPopular(after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/subreddits/popular",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1507>
+ * # <https://www.reddit.com/dev/api#GET_subreddits_{where}>GET /subreddits/where
+ * read <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /subreddits/popular
+ *  * → /subreddits/new
+ *  * → /subreddits/gold
+ *  * → /subreddits/defaultGet all subreddits.
+ *  - The where parameter chooses the order in which the subreddits are displayed. 
+ * popular sorts on the activity of the subreddit and the position of the 
+ * subreddits can shift around.new sorts the subreddits based on their creation 
+ * date, newest first.
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getSubredditsNew(after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/subreddits/new",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1507>
+ * # <https://www.reddit.com/dev/api#GET_subreddits_{where}>GET /subreddits/where
+ * read <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /subreddits/popular
+ *  * → /subreddits/new
+ *  * → /subreddits/gold
+ *  * → /subreddits/defaultGet all subreddits.
+ *  - The where parameter chooses the order in which the subreddits are displayed. 
+ * popular sorts on the activity of the subreddit and the position of the 
+ * subreddits can shift around.new sorts the subreddits based on their creation 
+ * date, newest first.
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getSubredditsGold(after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/subreddits/gold",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1507>
+ * # <https://www.reddit.com/dev/api#GET_subreddits_{where}>GET /subreddits/where
+ * read <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /subreddits/popular
+ *  * → /subreddits/new
+ *  * → /subreddits/gold
+ *  * → /subreddits/defaultGet all subreddits.
+ *  - The where parameter chooses the order in which the subreddits are displayed. 
+ * popular sorts on the activity of the subreddit and the position of the 
+ * subreddits can shift around.new sorts the subreddits based on their creation 
+ * date, newest first.
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getSubredditsDefault(after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/subreddits/default",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1020># 
+ * <https://www.reddit.com/dev/api#POST_api_friend>POST [/r/subreddit]/api/friend
+ * any <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Create a relationship between a user and another user or subreddit
+ *  - OAuth2 use requires appropriate scope based on the 'type' of the relationship:
+ *  * moderator: Use "moderator_invite" 
+ *  * moderator_invite: modothers 
+ *  * contributor: modcontributors 
+ *  * banned: modcontributors 
+ *  * muted: modcontributors 
+ *  * wikibanned: modcontributors and modwiki 
+ *  * wikicontributor: modcontributors and modwiki 
+ *  * friend: Use /api/v1/me/friends/{username} 
+ * <https://www.reddit.com/dev/api#PUT_api_v1_me_friends_%7Busername%7D> 
+ *  * enemy: Use /api/block <https://www.reddit.com/dev/api#POST_api_block> 
+ * Complement toPOST_unfriend <https://www.reddit.com/dev/api#POST_api_unfriend>
+ *  - api_typethe string json
+ *  - ban_messageraw markdown text
+ *  - ban_reasona string no longer than 100 characters
+ *  - containerdurationan integer between 1 and 999
+ *  - namethe name of an existing user
+ *  - notea string no longer than 300 characters
+ *  - permissionstypeone of (friend, moderator, moderator_invite, contributor, 
+ * banned, muted, wikibanned, wikicontributor)
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postRSubredditFriend(subreddit: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/friend").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L974># 
+ * <https://www.reddit.com/dev/api#POST_api_setpermissions>POST [/r/subreddit
+ * ]/api/setpermissionsmodothers <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - api_typethe string json
+ *  - namethe name of an existing user
+ *  - permissionstypeuh / X-Modhash headera modhash 
+ * <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postRSubredditSetpermissions(subreddit: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/setpermissions").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L868># 
+ * <https://www.reddit.com/dev/api#POST_api_unfriend>POST [/r/subreddit
+ * ]/api/unfriendany <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Remove a relationship between a user and another user or subreddit
+ *  - The user can either be passed in by name (nuser) or by fullname 
+ * <https://www.reddit.com/dev/api#fullnames> (iuser). If type is friend or enemy, 
+ * 'container' MUST be the current user's fullname; for other types, the subreddit 
+ * must be set via URL (e.g.,/r/funny/api/unfriend 
+ * <https://www.reddit.com/r/funny/api/unfriend>)
+ *  - OAuth2 use requires appropriate scope based on the 'type' of the relationship:
+ *  * moderator: modothers 
+ *  * moderator_invite: modothers 
+ *  * contributor: modcontributors 
+ *  * banned: modcontributors 
+ *  * muted: modcontributors 
+ *  * wikibanned: modcontributors and modwiki 
+ *  * wikicontributor: modcontributors and modwiki 
+ *  * friend: Use /api/v1/me/friends/{username} 
+ * <https://www.reddit.com/dev/api#DELETE_api_v1_me_friends_%7Busername%7D> 
+ *  * enemy: privatemessages Complement to POST_friend 
+ * <https://www.reddit.com/dev/api#POST_api_friend>
+ *  - containeridfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - namethe name of an existing user
+ *  - typeone of (friend, enemy, moderator, moderator_invite, contributor, banned, 
+ * muted, wikibanned, wikicontributor)
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postRSubredditUnfriend(subreddit: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/unfriend").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L238># 
+ * <https://www.reddit.com/dev/api#GET_api_username_available>GET 
+ * /api/username_available
+ *  - Check whether a username is available for registration.
+ *  - usera valid, unused, username
+ **/
+fun OAuthClient.getUsername_available(user: String?) =
+        retry(3) { requestApi("/api/username_available",
+                "user" to user).get().getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/apiv1/user.py#L202>
+ * # <https://www.reddit.com/dev/api#DELETE_api_v1_me_friends_{username}>DELETE 
+ * /api/v1/me/friends/usernamesubscribe 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Stop being friends with a user.
+ *  - idA valid, existing reddit username
+ **/
+fun OAuthClient.deleteV1MeFriendsUsername(username: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/v1/me/friends/$username").method("delete").getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/apiv1/user.py#L191>
+ * # <https://www.reddit.com/dev/api#GET_api_v1_me_friends_{username}>GET 
+ * /api/v1/me/friends/usernamemysubreddits 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Get information about a specific 'friend', such as notes.
+ *  - idA valid, existing reddit username
+ **/
+fun OAuthClient.getV1MeFriendsUsername(username: String, id: String?) =
+        retry(3) { requestApi("/api/v1/me/friends/$username",
+                "id" to id).get().getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/apiv1/user.py#L146>
+ * # <https://www.reddit.com/dev/api#PUT_api_v1_me_friends_{username}>PUT 
+ * /api/v1/me/friends/usernamesubscribe 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Create or update a "friend" relationship.
+ *  - This operation is idempotent. It can be used to add a new friend, or update 
+ * an existing friend (e.g., add/change the note on that friend)
+ *  - This endpoint expects JSON data of this format{ "name": A valid, existing 
+ * reddit username, "note": a string no longer than 300 characters, } 
+ **/
+fun OAuthClient.putV1MeFriendsUsername(username: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/api/v1/me/friends/$username").method("put").getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/apiv1/user.py#L82>
+ * # <https://www.reddit.com/dev/api#GET_api_v1_user_{username}_trophies>GET 
+ * /api/v1/user/username/trophiesread 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Return a list of trophies for the a given user.
+ *  - idA valid, existing reddit username
+ **/
+fun OAuthClient.getV1UserUsernameTrophies(username: String, id: String?) =
+        retry(3) { requestApi("/api/v1/user/$username/trophies",
+                "id" to id).get().getResponse() }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1015>
+ * # <https://www.reddit.com/dev/api#GET_user_{username}_about>GET /user/username
+ * /aboutread <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Return information about the user, including karma and gold status.
+ *  - usernamethe name of an existing user
+ **/
+fun OAuthClient.getUserUsernameAbout(username: String) =
+        retry(3) { requestApi("/user/$username/about",
+                "username" to username).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L890>
+ * # <https://www.reddit.com/dev/api#GET_user_{username}_{where}>GET /user/username
+ * /wherehistory <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /user/username/overview
+ *  * → /user/username/submitted
+ *  * → /user/username/comments
+ *  * → /user/username/upvoted
+ *  * → /user/username/downvoted
+ *  * → /user/username/hidden
+ *  * → /user/username/saved
+ *  * → /user/username/gildedThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - showone of (given)
+ *  - sortone of (hot, new, top, controversial)
+ *  - tone of (hour, day, week, month, year, all)
+ *  - usernamethe name of an existing user
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getUserUsernameWhere(username: String, where: String, show: String?, sort: String?, t: String?, after: String?, before: String?, count: Int?, limit: Int?, srDetail: Boolean?) =
+        retry(3) { requestApi("/user/$username/$where",
+                "show" to show, 
+                "sort" to sort, 
+                "t" to t, 
+                "username" to username, 
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L890>
+ * # <https://www.reddit.com/dev/api#GET_user_{username}_{where}>GET /user/username
+ * /wherehistory <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /user/username/overview
+ *  * → /user/username/submitted
+ *  * → /user/username/comments
+ *  * → /user/username/upvoted
+ *  * → /user/username/downvoted
+ *  * → /user/username/hidden
+ *  * → /user/username/saved
+ *  * → /user/username/gildedThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - showone of (given)
+ *  - sortone of (hot, new, top, controversial)
+ *  - tone of (hour, day, week, month, year, all)
+ *  - usernamethe name of an existing user
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getUserUsernameOverview(username: String, show: String?, sort: String?, t: String?, after: String?, before: String?, count: Int?, limit: Int?, srDetail: Boolean?) =
+        retry(3) { requestApi("/user/$username/overview",
+                "show" to show, 
+                "sort" to sort, 
+                "t" to t, 
+                "username" to username, 
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L890>
+ * # <https://www.reddit.com/dev/api#GET_user_{username}_{where}>GET /user/username
+ * /wherehistory <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /user/username/overview
+ *  * → /user/username/submitted
+ *  * → /user/username/comments
+ *  * → /user/username/upvoted
+ *  * → /user/username/downvoted
+ *  * → /user/username/hidden
+ *  * → /user/username/saved
+ *  * → /user/username/gildedThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - showone of (given)
+ *  - sortone of (hot, new, top, controversial)
+ *  - tone of (hour, day, week, month, year, all)
+ *  - usernamethe name of an existing user
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getUserUsernameSubmitted(username: String, show: String?, sort: String?, t: String?, after: String?, before: String?, count: Int?, limit: Int?, srDetail: Boolean?) =
+        retry(3) { requestApi("/user/$username/submitted",
+                "show" to show, 
+                "sort" to sort, 
+                "t" to t, 
+                "username" to username, 
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L890>
+ * # <https://www.reddit.com/dev/api#GET_user_{username}_{where}>GET /user/username
+ * /wherehistory <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /user/username/overview
+ *  * → /user/username/submitted
+ *  * → /user/username/comments
+ *  * → /user/username/upvoted
+ *  * → /user/username/downvoted
+ *  * → /user/username/hidden
+ *  * → /user/username/saved
+ *  * → /user/username/gildedThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - showone of (given)
+ *  - sortone of (hot, new, top, controversial)
+ *  - tone of (hour, day, week, month, year, all)
+ *  - usernamethe name of an existing user
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getUserUsernameComments(username: String, show: String?, sort: String?, t: String?, after: String?, before: String?, count: Int?, limit: Int?, srDetail: Boolean?) =
+        retry(3) { requestApi("/user/$username/comments",
+                "show" to show, 
+                "sort" to sort, 
+                "t" to t, 
+                "username" to username, 
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L890>
+ * # <https://www.reddit.com/dev/api#GET_user_{username}_{where}>GET /user/username
+ * /wherehistory <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /user/username/overview
+ *  * → /user/username/submitted
+ *  * → /user/username/comments
+ *  * → /user/username/upvoted
+ *  * → /user/username/downvoted
+ *  * → /user/username/hidden
+ *  * → /user/username/saved
+ *  * → /user/username/gildedThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - showone of (given)
+ *  - sortone of (hot, new, top, controversial)
+ *  - tone of (hour, day, week, month, year, all)
+ *  - usernamethe name of an existing user
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getUserUsernameUpvoted(username: String, show: String?, sort: String?, t: String?, after: String?, before: String?, count: Int?, limit: Int?, srDetail: Boolean?) =
+        retry(3) { requestApi("/user/$username/upvoted",
+                "show" to show, 
+                "sort" to sort, 
+                "t" to t, 
+                "username" to username, 
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L890>
+ * # <https://www.reddit.com/dev/api#GET_user_{username}_{where}>GET /user/username
+ * /wherehistory <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /user/username/overview
+ *  * → /user/username/submitted
+ *  * → /user/username/comments
+ *  * → /user/username/upvoted
+ *  * → /user/username/downvoted
+ *  * → /user/username/hidden
+ *  * → /user/username/saved
+ *  * → /user/username/gildedThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - showone of (given)
+ *  - sortone of (hot, new, top, controversial)
+ *  - tone of (hour, day, week, month, year, all)
+ *  - usernamethe name of an existing user
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getUserUsernameDownvoted(username: String, show: String?, sort: String?, t: String?, after: String?, before: String?, count: Int?, limit: Int?, srDetail: Boolean?) =
+        retry(3) { requestApi("/user/$username/downvoted",
+                "show" to show, 
+                "sort" to sort, 
+                "t" to t, 
+                "username" to username, 
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L890>
+ * # <https://www.reddit.com/dev/api#GET_user_{username}_{where}>GET /user/username
+ * /wherehistory <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /user/username/overview
+ *  * → /user/username/submitted
+ *  * → /user/username/comments
+ *  * → /user/username/upvoted
+ *  * → /user/username/downvoted
+ *  * → /user/username/hidden
+ *  * → /user/username/saved
+ *  * → /user/username/gildedThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - showone of (given)
+ *  - sortone of (hot, new, top, controversial)
+ *  - tone of (hour, day, week, month, year, all)
+ *  - usernamethe name of an existing user
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getUserUsernameHidden(username: String, show: String?, sort: String?, t: String?, after: String?, before: String?, count: Int?, limit: Int?, srDetail: Boolean?) =
+        retry(3) { requestApi("/user/$username/hidden",
+                "show" to show, 
+                "sort" to sort, 
+                "t" to t, 
+                "username" to username, 
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L890>
+ * # <https://www.reddit.com/dev/api#GET_user_{username}_{where}>GET /user/username
+ * /wherehistory <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /user/username/overview
+ *  * → /user/username/submitted
+ *  * → /user/username/comments
+ *  * → /user/username/upvoted
+ *  * → /user/username/downvoted
+ *  * → /user/username/hidden
+ *  * → /user/username/saved
+ *  * → /user/username/gildedThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - showone of (given)
+ *  - sortone of (hot, new, top, controversial)
+ *  - tone of (hour, day, week, month, year, all)
+ *  - usernamethe name of an existing user
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getUserUsernameSaved(username: String, show: String?, sort: String?, t: String?, after: String?, before: String?, count: Int?, limit: Int?, srDetail: Boolean?) =
+        retry(3) { requestApi("/user/$username/saved",
+                "show" to show, 
+                "sort" to sort, 
+                "t" to t, 
+                "username" to username, 
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L890>
+ * # <https://www.reddit.com/dev/api#GET_user_{username}_{where}>GET /user/username
+ * /wherehistory <https://github.com/reddit/reddit/wiki/OAuth2>rss support 
+ * <https://www.reddit.com/wiki/rss>
+ *  * → /user/username/overview
+ *  * → /user/username/submitted
+ *  * → /user/username/comments
+ *  * → /user/username/upvoted
+ *  * → /user/username/downvoted
+ *  * → /user/username/hidden
+ *  * → /user/username/saved
+ *  * → /user/username/gildedThis endpoint is a listing 
+ * <https://www.reddit.com/dev/api#listings>.
+ *  - showone of (given)
+ *  - sortone of (hot, new, top, controversial)
+ *  - tone of (hour, day, week, month, year, all)
+ *  - usernamethe name of an existing user
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getUserUsernameGilded(username: String, show: String?, sort: String?, t: String?, after: String?, before: String?, count: Int?, limit: Int?, srDetail: Boolean?) =
+        retry(3) { requestApi("/user/$username/gilded",
+                "show" to show, 
+                "sort" to sort, 
+                "t" to t, 
+                "username" to username, 
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/wiki.py#L452># 
+ * <https://www.reddit.com/dev/api#POST_api_wiki_alloweditor_{act}>POST [/r/
+ * subreddit]/api/wiki/alloweditor/actmodwiki 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  * → [/r/subreddit]/api/wiki/alloweditor/del
+ *  * → [/r/subreddit]/api/wiki/alloweditor/addAllow/deny username to edit this 
+ * wikipage
+ *  - actone of (del, add)
+ *  - pagethe name of an existing wiki page
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ *  - usernamethe name of an existing user
+ **/
+fun OAuthClient.postRSubredditWikiAlloweditorAct(subreddit: String, act: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/wiki/alloweditor/$act").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/wiki.py#L452># 
+ * <https://www.reddit.com/dev/api#POST_api_wiki_alloweditor_{act}>POST [/r/
+ * subreddit]/api/wiki/alloweditor/actmodwiki 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  * → [/r/subreddit]/api/wiki/alloweditor/del
+ *  * → [/r/subreddit]/api/wiki/alloweditor/addAllow/deny username to edit this 
+ * wikipage
+ *  - actone of (del, add)
+ *  - pagethe name of an existing wiki page
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ *  - usernamethe name of an existing user
+ **/
+fun OAuthClient.postRSubredditWikiAlloweditorDel(subreddit: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/wiki/alloweditor/del").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/wiki.py#L452># 
+ * <https://www.reddit.com/dev/api#POST_api_wiki_alloweditor_{act}>POST [/r/
+ * subreddit]/api/wiki/alloweditor/actmodwiki 
+ * <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  * → [/r/subreddit]/api/wiki/alloweditor/del
+ *  * → [/r/subreddit]/api/wiki/alloweditor/addAllow/deny username to edit this 
+ * wikipage
+ *  - actone of (del, add)
+ *  - pagethe name of an existing wiki page
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ *  - usernamethe name of an existing user
+ **/
+fun OAuthClient.postRSubredditWikiAlloweditorAdd(subreddit: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/wiki/alloweditor/add").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/wiki.py#L376># 
+ * <https://www.reddit.com/dev/api#POST_api_wiki_edit>POST [/r/subreddit
+ * ]/api/wiki/editwikiedit <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Edit a wiki page
+ *  - contentpagethe name of an existing page or a new page to create
+ *  - previousthe starting point revision for this edit
+ *  - reasona string up to 256 characters long, consisting of printable characters.
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postRSubredditWikiEdit(subreddit: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/wiki/edit").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/wiki.py#L493># 
+ * <https://www.reddit.com/dev/api#POST_api_wiki_hide>POST [/r/subreddit
+ * ]/api/wiki/hidemodwiki <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Toggle the public visibility of a wiki page revision
+ *  - pagethe name of an existing wiki page
+ *  - revisiona wiki revision ID
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postRSubredditWikiHide(subreddit: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/wiki/hide").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/wiki.py#L508># 
+ * <https://www.reddit.com/dev/api#POST_api_wiki_revert>POST [/r/subreddit
+ * ]/api/wiki/revertmodwiki <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Revert a wiki page to revision
+ *  - pagethe name of an existing wiki page
+ *  - revisiona wiki revision ID
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postRSubredditWikiRevert(subreddit: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/api/wiki/revert").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/lib/validator/validator.py#L200>
+ * # <https://www.reddit.com/dev/api#GET_wiki_discussions_{page}>GET [/r/subreddit
+ * ]/wiki/discussions/pagewikiread <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Retrieve a list of discussions about this wiki page
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - pagethe name of an existing wiki page
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getRSubredditWikiDiscussionsPage(subreddit: String, page: String, after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/r/$subreddit/wiki/discussions/$page",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "page" to page, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/controllers/wiki.py#L258># 
+ * <https://www.reddit.com/dev/api#GET_wiki_pages>GET [/r/subreddit]/wiki/pages
+ * wikiread <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Retrieve a list of wiki pages in this subreddit
+ **/
+fun OAuthClient.getRSubredditWikiPages(subreddit: String) =
+        retry(3) { requestApi("/r/$subreddit/wiki/pages").get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/lib/validator/validator.py#L200>
+ * # <https://www.reddit.com/dev/api#GET_wiki_revisions>GET [/r/subreddit
+ * ]/wiki/revisionswikiread <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Retrieve a list of recently changed wiki pages in this subreddit
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getRSubredditWikiRevisions(subreddit: String, after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/r/$subreddit/wiki/revisions",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/lib/validator/validator.py#L200>
+ * # <https://www.reddit.com/dev/api#GET_wiki_revisions_{page}>GET [/r/subreddit
+ * ]/wiki/revisions/pagewikiread <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Retrieve a list of revisions of this wiki page
+ *  - This endpoint is a listing <https://www.reddit.com/dev/api#listings>.
+ *  - afterfullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - beforefullname <https://www.reddit.com/dev/api#fullnames> of a thing
+ *  - counta positive integer (default: 0)
+ *  - limitthe maximum number of items desired (default: 25, maximum: 100)
+ *  - pagethe name of an existing wiki page
+ *  - show(optional) the string all
+ *  - sr_detail(optional) expand subreddits
+ **/
+fun OAuthClient.getRSubredditWikiRevisionsPage(subreddit: String, page: String, after: String?, before: String?, count: Int?, limit: Int?, show: String?, srDetail: Boolean?) =
+        retry(3) { requestApi("/r/$subreddit/wiki/revisions/$page",
+                "after" to after, 
+                "before" to before, 
+                "count" to count, 
+                "limit" to limit, 
+                "page" to page, 
+                "show" to show, 
+                "sr_detail" to srDetail).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/lib/validator/validator.py#L200>
+ * # <https://www.reddit.com/dev/api#GET_wiki_settings_{page}>GET [/r/subreddit
+ * ]/wiki/settings/pagemodwiki <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Retrieve the current permission settings for page
+ *  - pagethe name of an existing wiki page
+ **/
+fun OAuthClient.getRSubredditWikiSettingsPage(subreddit: String, page: String) =
+        retry(3) { requestApi("/r/$subreddit/wiki/settings/$page",
+                "page" to page).get().readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/lib/validator/validator.py#L200>
+ * # <https://www.reddit.com/dev/api#POST_wiki_settings_{page}>POST [/r/subreddit
+ * ]/wiki/settings/pagemodwiki <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Update the permissions and visibility of wiki page
+ *  - listedboolean value
+ *  - pagethe name of an existing wiki page
+ *  - permlevelan integer
+ *  - uh / X-Modhash headera modhash <https://www.reddit.com/dev/api#modhashes>
+ **/
+fun OAuthClient.postRSubredditWikiSettingsPage(subreddit: String, page: String, vararg urlParams: Pair<String, Any?>) =
+        retry(3) { requestApi("/r/$subreddit/wiki/settings/$page").post(urlParams.multipart()).readEntity(String::class.java) }
+
+/*
+ * view code 
+ * <https://github.com/reddit/reddit/blob/master/r2/r2/lib/validator/validator.py#L200>
+ * # <https://www.reddit.com/dev/api#GET_wiki_{page}>GET [/r/subreddit]/wiki/page
+ * wikiread <https://github.com/reddit/reddit/wiki/OAuth2>
+ *  - Return the content of a wiki page
+ *  - If v is given, show the wiki page as it was at that version If both v and v2 
+ * are given, show a diff of the two
+ *  - pagethe name of an existing wiki page
+ *  - va wiki revision ID
+ *  - v2a wiki revision ID
+ **/
+fun OAuthClient.getRSubredditWikiPage(subreddit: String, page: String, v: String?, v2: String?) =
+        retry(3) { requestApi("/r/$subreddit/wiki/$page",
+                "page" to page, 
+                "v" to v, 
+                "v2" to v2).get().readEntity(String::class.java) }
+
+// Generated API end.
+
diff --git a/src/main/java/org/ethtrader/ticker/Conf.kt b/src/main/java/org/ethtrader/ticker/Conf.kt
new file mode 100644
index 0000000..957d787
--- /dev/null
+++ b/src/main/java/org/ethtrader/ticker/Conf.kt
@@ -0,0 +1,65 @@
+package org.ethtrader.ticker
+
+import com.typesafe.config.Config
+import com.typesafe.config.ConfigFactory
+import java.awt.Color
+import java.lang.Long
+import java.net.URL
+import kotlin.reflect.KFunction1
+
+class TickerEthConfig(getResourceUrl: (String) -> URL) {
+    init {
+        System.setProperty("java.awt.headless", "true")
+    }
+
+    private val conf = ConfigFactory.parseURL(getResourceUrl("/ticker.conf")).getConfig("ticker")
+    private val providerConf = conf.getConfig("providers")
+    private val dataPointConf = conf.getConfig("dataPoints")
+    private val tickerConf = conf.getConfig("tickers")
+
+    val reddit = RedditConf(conf)
+    val providers = providerConf.keys().map { it to ProviderConf(providerConf, it) }.toMap()
+    val dataPoints = dataPointConf.keys().map { it to dataPointConf.getStringList(it) }.toMap()
+    val tickers = tickerConf.keys().map { it to TickerConf(tickerConf, it) }.toMap()
+}
+
+class TickerConf(config: Config, name: String) {
+    private val tickerConf = config.getConfig(name)
+    val font = tickerConf.getString("font")
+    val fontHeight = tickerConf.getInt("fontHeight")
+    val color = tickerConf.getString("color").toColor()
+    val background = tickerConf.getString("background").toColor()
+    val backgroundHighlight = tickerConf.getString("backgroundHighlight").toColor()
+    val positiveColor = tickerConf.getString("positiveColor").toColor()
+    val negativeColor = tickerConf.getString("negativeColor").toColor()
+    val segments = tickerConf.getStringList("segments")
+    val top = tickerConf.getString("top")
+    val cssSelector = tickerConf.getString("cssSelector")
+}
+
+fun String.toColor(): Color = if (startsWith("#") && length == 9) java.lang.Long.decode(this).let {
+    Color(((it shr 24) and 0xFF).toInt(), ((it shr 16) and 0xFF).toInt(), ((it shr 8) and 0xFF).toInt(), (it and 0xFF).toInt())
+} else Color.decode(this)
+
+fun Config.keys(): Set<String> =
+        entrySet().map { it.key.split(".", limit = 2).first() }.toSet()
+
+class RedditConf(config: Config) {
+    private val redditConf = config.getConfig("reddit")
+    val frequencySeconds = redditConf.getLong("frequencySeconds")
+    val authUrl = redditConf.getString("authUrl")
+    val apiUrl = redditConf.getString("apiUrl")
+}
+
+class ProviderConf(config: Config, name: String) {
+    private val providerConf = config.getConfig(name)
+    private val fieldsConf = providerConf.getConfig("fields")
+    val url = providerConf.getString("url")
+    val fields: Map<String, String> = fieldsConf.keys().map { it to fieldsConf.getString(it) }.toMap()
+}
+
+fun Config.getStringOr(key: String, default: String?) = try {
+    getString(key).toString()
+} catch(e: Throwable) {
+    default
+}
diff --git a/src/main/java/org/ethtrader/ticker/DataReader.kt b/src/main/java/org/ethtrader/ticker/DataReader.kt
new file mode 100644
index 0000000..6dce6f3
--- /dev/null
+++ b/src/main/java/org/ethtrader/ticker/DataReader.kt
@@ -0,0 +1,87 @@
+package org.ethtrader.ticker
+
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.ObjectMapper
+import com.fasterxml.jackson.module.kotlin.registerKotlinModule
+import org.glassfish.jersey.client.ClientProperties
+import java.lang.System.clearProperty
+import java.lang.System.setProperty
+import java.math.BigDecimal
+import java.net.URL
+import java.security.SecureRandom
+import java.security.cert.X509Certificate
+import javax.net.ssl.SSLContext
+import javax.net.ssl.TrustManager
+import javax.net.ssl.X509TrustManager
+import javax.ws.rs.client.Client
+import javax.ws.rs.client.ClientBuilder
+
+class DataReader(providers: Map<String, ProviderConf>) {
+
+    private val client = ClientBuilder.newBuilder()
+            .property(ClientProperties.CONNECT_TIMEOUT, 10000)
+            .property(ClientProperties.READ_TIMEOUT, 10000)
+            .sslContext(sslContext())
+
+    private val objectMapper = ObjectMapper()
+            .registerKotlinModule()
+
+    private val providerFunctions = providers.map { provider ->
+        provider.key to { values: List<String> ->
+            try {
+                val response = readObject(provider.value.url.format(*values.toTypedArray()))
+                println("JSON Response form provider [${provider.key}], $values: $response")
+                println("Reading fields: ${provider.value.fields}")
+                response.parseFields(provider.value.fields)
+            } catch (e: Throwable) {
+                println("Unexpected exception: " + e.printStackTrace())
+                mapOf<String, BigDecimal>()
+            }
+        }
+    }.toMap()
+
+    fun read(dataPoints: Map<String, List<String>>): Map<String, Map<String, BigDecimal?>?> {
+        val data = dataPoints.map {
+            val function = providerFunctions.get(it.value.first())
+            it.key to if (function == null) null else function(it.value.drop(1))
+        }.toMap()
+        println("Data points retrieved:\n - ${data.map { it }.joinToString("\n - ")}")
+        return data
+    }
+
+    private fun JsonNode.parseFields(fields: Map<String, String>): Map<String, BigDecimal?> =
+            fields.map {
+                it.key to try {
+                    val text = at(it.value).asText()
+                    if (text.isNullOrEmpty()) BigDecimal.ZERO else BigDecimal(text)
+                } catch(t: Throwable) {
+                    null
+                }
+            }.toMap()
+
+    private fun readObject(url: String, attempts: Int = 3): JsonNode {
+        println("Fetching from URL: $url")
+        return retry(times = 10) {
+            Thread.sleep(1000)
+            val json = client.build().target(url).request().get(String::class.java)
+            objectMapper.readTree(json)
+        }
+    }
+
+    private fun sslContext(): SSLContext? {
+        val sslContext = SSLContext.getInstance("SSL")
+        sslContext.init(null, arrayOf(object : X509TrustManager {
+            override fun checkClientTrusted(p0: Array<out X509Certificate>?, p1: String?) = Unit
+            override fun checkServerTrusted(p0: Array<out X509Certificate>?, p1: String?) = Unit
+            override fun getAcceptedIssuers(): Array<out X509Certificate>? = null
+        }), SecureRandom())
+        return sslContext
+    }
+}
+
+fun <T> retry(times: Int, total: Int = times, action: () -> T): T = try {
+    Thread.sleep(total.toLong() - times)
+    action()
+} catch (e: Throwable) {
+    if (times > 0) retry(times - 1, total, action) else throw e
+}
\ No newline at end of file
diff --git a/src/main/java/org/ethtrader/ticker/Entry.kt b/src/main/java/org/ethtrader/ticker/Entry.kt
new file mode 100644
index 0000000..85d73c1
--- /dev/null
+++ b/src/main/java/org/ethtrader/ticker/Entry.kt
@@ -0,0 +1,67 @@
+package org.ethtrader.ticker
+
+import java.io.File
+import java.net.CookieHandler
+import java.net.CookieManager
+import java.net.CookiePolicy
+import java.net.URL
+import java.util.concurrent.TimeUnit
+
+fun main(args: Array<String>) {
+    try {
+        CookieHandler.setDefault(CookieManager(null, java.net.CookiePolicy.ACCEPT_ALL));
+
+        fun getResourceUrl(path: String): URL = URL(args[5] + path)
+
+        val outputDir = File("output")
+        outputDir.mkdirs()
+        val config = TickerEthConfig(::getResourceUrl)
+        val reader = DataReader(config.providers)
+
+        val tickerFactory = TickerFactory(outputDir, ::getResourceUrl)
+        val client = OAuthClient(config.reddit.apiUrl, AuthInfo(args[1], args[2], args[3], args[4]))
+        val reddit = Reddit(client, args[0])
+        val test = args.contains("--test")
+
+        while (true) {
+
+            val data = reader.read(config.dataPoints)
+            config.tickers.entries.forEach {
+                try {
+                    val (name, tickerConfig) = it
+                    val ticker = tickerFactory.produceTicker(name, data, tickerConfig)
+                    if (!test) reddit.uploadImage(name, ticker)
+                } catch (e: Exception) {
+                    println("ERROR: " + e.message)
+                    e.printStackTrace()
+                }
+            }
+
+            try {
+                val oldCss = reddit.getStylesheet()
+                File(outputDir, "old.css").writeTextAndLog(oldCss, "Wrote old css to %s")
+                val newCss = tickerFactory.getAndResetCss(oldCss)
+                File(outputDir, "new.css").writeTextAndLog(newCss, "Wrote new css to %s")
+
+                if (!test) reddit.uploadStylesheet(newCss)
+            } catch (e: Throwable) {
+                println("Error trying to update tickers")
+                e.printStackTrace()
+            }
+            println("Waiting ${config.reddit.frequencySeconds} seconds.")
+            Thread.sleep(TimeUnit.SECONDS.toMillis(config.reddit.frequencySeconds))
+            if (test) break;
+        }
+    } catch (e: Throwable) {
+        System.err.println("Usage: <<subreddit>> <<username>> <<password>> <<clientId>> <<secret>> <<resourceUrl>>")
+        System.err.println("clientId and secret can be administered here: https://www.reddit.com/prefs/apps/")
+        System.err.println("resourceUrl points to the configuration/resources to build the ticker.")
+        System.err.println("\n Error: ${e.message}")
+        e.printStackTrace()
+    }
+}
+
+fun File.writeTextAndLog(text: String, message: String) {
+    writeText(text)
+    println(message.format(absolutePath))
+}
diff --git a/src/main/java/org/ethtrader/ticker/OAuthClient.kt b/src/main/java/org/ethtrader/ticker/OAuthClient.kt
new file mode 100644
index 0000000..3291de3
--- /dev/null
+++ b/src/main/java/org/ethtrader/ticker/OAuthClient.kt
@@ -0,0 +1,75 @@
+package org.ethtrader.ticker
+
+import com.fasterxml.jackson.databind.DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES
+import com.fasterxml.jackson.databind.ObjectMapper
+import com.fasterxml.jackson.databind.PropertyNamingStrategy.SNAKE_CASE
+import com.fasterxml.jackson.jaxrs.json.JacksonJaxbJsonProvider
+import com.fasterxml.jackson.module.kotlin.readValue
+import com.fasterxml.jackson.module.kotlin.registerKotlinModule
+import org.glassfish.jersey.client.authentication.HttpAuthenticationFeature.basicBuilder
+import org.glassfish.jersey.media.multipart.MultiPartFeature
+import java.io.Serializable
+import java.time.Instant.now
+import javax.ws.rs.client.ClientBuilder.newBuilder
+import javax.ws.rs.client.Entity
+import javax.ws.rs.client.Invocation
+import javax.ws.rs.core.HttpHeaders.AUTHORIZATION
+import javax.ws.rs.core.HttpHeaders.USER_AGENT
+import javax.ws.rs.core.MediaType
+
+data class AuthInfo(val username: String, val password: String, val clientId: String, val secret: String) : Serializable
+data class AuthData(val accessToken: String?, val expiresIn: Int, val scope: String?, val tokenType: String?)
+
+class OAuthClient(private val apiUrl: String, private val authInfo: AuthInfo) {
+
+    private var authData: AuthData? = null
+    private var timeTokenAcquired = -1L
+
+    private val objectMapper = ObjectMapper()
+            .registerKotlinModule()
+            .setPropertyNamingStrategy(SNAKE_CASE)
+            .disable(FAIL_ON_UNKNOWN_PROPERTIES)
+
+    private val client = newBuilder()
+            .register(basicBuilder().credentials(authInfo.clientId, authInfo.secret).build())
+            .register(JacksonJaxbJsonProvider(objectMapper, emptyArray()))
+            .register(MultiPartFeature())
+            .build()
+
+    fun renewAccessToken() {
+        if (!newTokenNeeded()) return
+        val post = client
+                .target("https://www.reddit.com/api/v1/")
+                .queryParam("grant_type", "password")
+                .queryParam("username", authInfo.username)
+                .queryParam("password", authInfo.password)
+                .path("access_token")
+                .request()
+                .post(Entity.text(""))
+        authData = objectMapper.readValue(post.readEntity(String::class.java))
+        timeTokenAcquired = now().epochSecond
+    }
+
+    private fun newTokenNeeded(): Boolean {
+        val authData = authData
+        return authData == null || now().epochSecond >= timeTokenAcquired + authData.expiresIn - 180
+    }
+
+    fun requestApi(path: String, vararg urlParameters: Pair<String, Any?>): Invocation.Builder {
+        return request(apiUrl, path, urlParameters, MediaType.APPLICATION_JSON_TYPE)
+                .header(AUTHORIZATION, "bearer " + authData?.accessToken)
+    }
+
+    fun requestPlain(path: String, vararg urlParameters: Pair<String, Any?>): Invocation.Builder {
+        return request("https://www.reddit.com/", path, urlParameters, MediaType.WILDCARD_TYPE)
+    }
+
+    private fun request(baseUrl: String, path: String, urlParameters: Array<out Pair<String, Any?>>, mediaType: MediaType?): Invocation.Builder {
+        println("Calling $path, parameters: ${if (urlParameters.isEmpty()) "" else "\n - "}${urlParameters.filter { it.second != null }.joinToString("\n - ")}")
+        renewAccessToken()
+        return urlParameters.filter { it.second != null }.fold(client.target(baseUrl).path(path)) { q, it -> q.queryParam(it.first, it.second) }
+                .request()
+                .accept(mediaType)
+                .header(USER_AGENT, "kotlin:org.ethtrader:0.1 (by /u/etherboard)")
+    }
+}
diff --git a/src/main/java/org/ethtrader/ticker/Reddit.kt b/src/main/java/org/ethtrader/ticker/Reddit.kt
new file mode 100644
index 0000000..1326924
--- /dev/null
+++ b/src/main/java/org/ethtrader/ticker/Reddit.kt
@@ -0,0 +1,28 @@
+package org.ethtrader.ticker
+
+import org.jsoup.Jsoup
+import java.io.InputStream
+
+class Reddit(private val client: OAuthClient, val subRedditName: String) {
+
+    fun uploadImage(name: String, ticker: InputStream) {
+        val response = client.postRSubredditUpload_sr_img(subRedditName,
+                "file" to ticker,
+                "name" to name,
+                "upload_type" to "img")
+        println("Response: " + response)
+    }
+
+    fun uploadStylesheet(css: String) {
+        val response = client.postRSubredditSubreddit_stylesheet(subRedditName,
+                "stylesheet_contents" to css,
+                "op" to "save")
+        println("Response: " + response)
+    }
+
+    fun getStylesheet(): String = retry(3) {
+        val cssPage = client.requestPlain("/r/$subRedditName/about/stylesheet/").get(String::class.java)
+        val document = Jsoup.parse(cssPage)
+        document.select("pre.subreddit-stylesheet-source > code").text()
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/org/ethtrader/ticker/TickerFactory.kt b/src/main/java/org/ethtrader/ticker/TickerFactory.kt
new file mode 100644
index 0000000..917be85
--- /dev/null
+++ b/src/main/java/org/ethtrader/ticker/TickerFactory.kt
@@ -0,0 +1,172 @@
+package org.ethtrader.ticker
+
+import java.awt.*
+import java.awt.RenderingHints.VALUE_ANTIALIAS_ON
+import java.awt.image.BufferedImage
+import java.awt.image.BufferedImage.TYPE_INT_ARGB
+import java.io.*
+import java.math.BigDecimal
+import java.math.BigDecimal.ZERO
+import java.math.RoundingMode.HALF_DOWN
+import java.net.URL
+import java.util.Locale.ENGLISH
+import javax.imageio.ImageIO
+
+class TickerFactory(private val outputDir: File, private val loadResource: (String) -> URL) {
+
+    val apiStart = "/** Generated by ticker bot [start of section] */"
+    val apiEnd = "/** Generated by ticker bot [end of section] */"
+
+    private val css = StringBuilder()
+
+    init {
+        System.setProperty("java.awt.headless", "true")
+        resetCss()
+    }
+
+    fun produceTicker(name: String, data: Map<String, Map<String, BigDecimal?>?>, config: TickerConf): InputStream {
+
+        val font = Font(config.font, Font.BOLD, config.fontHeight)
+        val graphics: Graphics = BufferedImage(1, 1, TYPE_INT_ARGB).graphics.fluently { it.font = font }
+
+        val images = config.segments.map {
+            try {
+                if (it.startsWith("[[") && it.endsWith("]]")) {
+                    loadImage(config, it.substring(2, it.length - 2))
+                } else {
+                    produceTickerSegment(data, config, it, graphics.fontMetrics)
+                }
+            } catch (e: Exception) {
+                System.err.println(e.message)
+                e.printStackTrace()
+                null
+            }
+        }.filterNotNull()
+        val image = combineImages(images, config)
+        val file = File(outputDir, "$name.png")
+        ImageIO.write(image, "png", file)
+        println("Ticker [$name] saved to [${file.absolutePath}]")
+        addCss(name, config, image)
+        return getInputStream(image)
+    }
+
+    private fun loadImage(config: TickerConf, location: String): BufferedImage {
+        val image = ImageIO.read(loadResource(location.trimStart('!')))
+        val imageWithBackground = BufferedImage(image.width, image.height, TYPE_INT_ARGB)
+        val bold = location.startsWith("!")
+        (imageWithBackground.graphics as Graphics2D)
+                .fluently { it.color = if (bold) config.backgroundHighlight else config.background }
+                .fluently { it.fillRect(0, 0, image.width, image.height) }
+                .fluently { it.drawImage(image, 0, 0, null) }
+                .fluently { it.drawImage(image, 0, 0, null) }
+                .fluently { it.drawImage(image, 0, 0, null) }
+                .fluently { it.drawImage(image, 0, 0, null) }
+        return imageWithBackground
+    }
+
+    private fun addCss(name: String, conf: TickerConf, image: BufferedImage) {
+        val template = loadResource("/per-ticker.css").readText(Charsets.UTF_8)
+                .replace("\${ticker.name}", name)
+                .replace("\${ticker.width}", image.width.toString())
+                .replace("\${ticker.top}", conf.top)
+                .replace("\${css.selector}", conf.cssSelector)
+        css.append("$template\n\n")
+    }
+
+    private fun combineImages(images: List<BufferedImage>, tickerConf: TickerConf): BufferedImage {
+        var cumulative = 0
+        val image = BufferedImage(images.sumBy { it.width }, images.first().height, TYPE_INT_ARGB)
+        val graphics = image.graphics
+        images.forEach { image ->
+            graphics.drawImage(image, cumulative, 0, null)
+            cumulative += image.width
+        }
+        return image
+    }
+
+    private fun produceTickerSegment(data: Map<String, Map<String, BigDecimal?>?>, config: TickerConf, it: String, fontMetrics: FontMetrics): BufferedImage {
+        val segments = parseSegments(data, config, it, fontMetrics)
+        return render(config, segments, fontMetrics)
+    }
+
+    private fun parseSegments(data: Map<String, Map<String, BigDecimal?>?>, config: TickerConf, it: String, fontMetrics: FontMetrics): List<Triple<String, Color, Int>> {
+        return it.split(Regex("[\\{\\}]")).map { match ->
+            val tokens = match.trim('{', '}').split('|', '.')
+            if (tokens.size == 8) format(data, tokens, config) else match to config.color
+        }.map { Triple(it.first, it.second, fontMetrics.stringWidth(it.first)) }
+    }
+
+    private fun render(config: TickerConf, segments: List<Triple<String, Color, Int>>, fontMetrics: FontMetrics): BufferedImage {
+        val image = BufferedImage(segments.sumBy { it.third }, fontMetrics.height + 4, TYPE_INT_ARGB)
+        val graphics = image.graphics as Graphics2D
+        val bold = segments.first().first.startsWith("!")
+        graphics.fluently { it.setRenderingHint(RenderingHints.KEY_ANTIALIASING, VALUE_ANTIALIAS_ON) }
+                .fluently { it.color = if (bold) config.backgroundHighlight else config.background }
+
+        var x = 0
+        val weight = if (true) Font.BOLD else Font.PLAIN
+        segments.forEach { segment ->
+            graphics.fluently { it.color = if (bold) config.backgroundHighlight else config.background }
+                    .fluently { it.fillRect(x, 0, segment.third, image.height) }
+                    .fluently { it.color = segment.second }
+                    .fluently { it.font = Font(config.font, weight, config.fontHeight) }
+                    .fluently { it.drawString(segment.first.trimStart('!'), x, fontMetrics.ascent + 2) }
+            x += segment.third
+        }
+        return image
+    }
+
+    private fun format(data: Map<String, Map<String, BigDecimal?>?>, tokens: List<String>, config: TickerConf): Pair<String, Color> {
+        val (dataPointNames, valueName, prefix, suffix, precision, useColor, shorten, divisor) = tokens
+        return dataPointNames.split('^').map { dataPointName ->
+            val value = data[dataPointName]?.get(valueName)?.divide(BigDecimal(divisor.toString()))
+            if (value == null) {
+                null
+            } else {
+                val color = if (useColor == "Y") if (value.compareTo(ZERO) >= 0) config.positiveColor else config.negativeColor else config.color
+                val adjustedPrecision = value.setScale(precision.toInt(), HALF_DOWN)
+                val shortenedValue = if (shorten == "Y") shorten(adjustedPrecision, "", "k", "M", "B", "T") else String.format(ENGLISH, "%,.${precision}f", adjustedPrecision)
+
+                ("$prefix$shortenedValue$suffix") to color
+            }
+        }.filterNotNull().firstOrNull() ?: throw RuntimeException("ERROR - No value [$valueName] or no data point [$dataPointNames] in [$data]")
+    }
+
+    private val OneThousand = BigDecimal("1000")
+    private val TenThousand = BigDecimal("10000")
+
+    private fun shorten(value: BigDecimal, vararg denomiators: String): String {
+        return if (value < TenThousand) value.toPlainString() + denomiators.first()
+        else shorten(value / OneThousand, *denomiators.drop(1).toTypedArray())
+    }
+
+    private fun getInputStream(upper: BufferedImage): InputStream {
+        val byteArrayOutputStream = ByteArrayOutputStream()
+        ImageIO.write(upper, "png", byteArrayOutputStream)
+        return ByteArrayInputStream(byteArrayOutputStream.toByteArray())
+    }
+
+    fun <T> T.fluently(action: (T) -> Unit): T {
+        action(this)
+        return this
+    }
+
+    fun getAndResetCss(existing: String): String {
+        val existingLines = existing.lines()
+        val newLines = css.lines()
+        resetCss()
+        return (existingLines.takeWhile { !it.equals(apiStart) } +
+                "$apiStart\n\n" +
+                newLines +
+                if (existingLines.contains(apiEnd)) existingLines.dropWhile { !it.equals(apiEnd) } else listOf(apiEnd)).joinToString(System.lineSeparator())
+    }
+
+    private fun resetCss() {
+        css.setLength(0)
+        css.append(loadResource("/ticker.css").readText(Charsets.UTF_8)).append("\n\n")
+    }
+}
+
+operator fun <E> List<E>.component6(): Any = get(5)!!
+operator fun <E> List<E>.component7(): Any = get(6)!!
+operator fun <E> List<E>.component8(): Any = get(7)!!
diff --git a/src/main/resources/test.json b/src/main/resources/test.json
new file mode 100644
index 0000000..78414a6
--- /dev/null
+++ b/src/main/resources/test.json
@@ -0,0 +1,44 @@
+{
+  "symbol": "eth",
+  "position": "2",
+  "name": "Ethereum",
+  "market_cap": {
+    "usd": 984329687.973,
+    "eur": 882254699.3301998,
+    "cny": 6576649192.079028,
+    "gbp": 740383261.4026514,
+    "cad": 1278612766.1269119,
+    "rub": 64165323174.881805,
+    "hkd": 7633972832.393353,
+    "jpy": 102314377622.91515,
+    "aud": 1299426417.379101,
+    "btc": 1614129.70563
+  },
+  "price": {
+    "usd": 11.7671,
+    "eur": 10.546851729999998,
+    "cny": 78.6200900508,
+    "gbp": 8.850859607,
+    "cad": 15.285086352799999,
+    "rub": 767.0598413890999,
+    "hkd": 91.25979111839999,
+    "jpy": 1223.11002872,
+    "aud": 15.5339016823,
+    "btc": 0.019296
+  },
+  "supply": "83651000",
+  "volume": {
+    "usd": 9764720,
+    "eur": 8752118.536,
+    "cny": 65241492.44256,
+    "gbp": 7344729.4424,
+    "cad": 12684058.80896,
+    "rub": 636531054.75512,
+    "hkd": 75730325.01888,
+    "jpy": 1014976243.904,
+    "aud": 12890533.81336,
+    "btc": 16012.4
+  },
+  "change": "1.63",
+  "timestamp": "1473015486.242"
+}
diff --git a/src/test/java/com/ethtrader/ticker/RedditApiGeneration.kt b/src/test/java/com/ethtrader/ticker/RedditApiGeneration.kt
new file mode 100644
index 0000000..1d1daac
--- /dev/null
+++ b/src/test/java/com/ethtrader/ticker/RedditApiGeneration.kt
@@ -0,0 +1,147 @@
+package com.ethtrader.ticker
+
+import org.jsoup.Jsoup
+import org.jsoup.examples.HtmlToPlainText
+import org.jsoup.nodes.Element
+import org.jsoup.nodes.Node
+import org.jsoup.nodes.TextNode
+import org.junit.Test
+import java.io.BufferedWriter
+import java.io.File
+import java.util.*
+import kotlin.text.RegexOption.MULTILINE
+
+class RedditApiGeneration {
+
+    private val url = "https://www.reddit.com/dev/api"
+    private val apiStart = "// Generated API start."
+    private val apiEnd = "// Generated API end."
+    private val outputFile = File("src/main/java/${javaClass.`package`.name.replace(".", "/")}/Api.kt")
+
+    @Test fun generateApi() {
+        //                val document = Jsoup.parse(URL(url), TimeUnit.MINUTES.toMillis(1).toInt())
+        val document = Jsoup.parse(javaClass.getResourceAsStream("/api.html"), Charsets.UTF_8.name(), url)
+        val lines = outputFile.readLines()
+
+        val writer = outputFile.bufferedWriter()
+        try {
+            lines.takeWhile { !it.equals(apiStart) }.forEach { writer.write("$it\n") }
+            writer.write("$apiStart\n\n")
+            document.select("div.section.methods > div").forEach { parseEndpoint(writer, it) }
+            writer.write("\n$apiEnd\n\n")
+        } catch(throwable: Throwable) {
+            lines.dropWhile { !it.equals(apiEnd) }.forEach { writer.write("$it\n") }
+        } finally {
+            writer.close()
+        }
+    }
+
+    private val types = mapOf(
+            "comma-separated list" to "List<String>",
+            "comma-delimited list" to "List<String>",
+            "a positive integer" to "Int",
+            "number of" to "Int",
+            "expand subreddits" to "Boolean",
+            "true, false" to "Boolean"
+    ).withDefault { "String" }
+
+    private fun parseEndpoint(writer: BufferedWriter, endpointElement: Element) {
+        val queryParameters = parseQueryParameters(endpointElement)
+        val method = parseEndpointAndGetMethod(endpointElement, writer, "get", endpointElement.selectFirst("h3")?.childNodes(), queryParameters)
+        endpointElement.selectFirst("ul.uri-variants")?.childNodes()?.forEach {
+            parseEndpointAndGetMethod(endpointElement, writer, method, it.childNodes(), queryParameters)
+        }
+    }
+
+    private fun parseEndpointAndGetMethod(endpointElement: Element, writer: BufferedWriter, previousMetho: String, urlElements: List<Node>?, urlParams: Map<String, Param>): String {
+
+        val (method, pathParams, url) = parseUrl(previousMetho, urlElements)
+        val get = method == "get"
+
+        val urlParamsAndType = urlParams.filterNot { pathParams.contains(it.value.name) }.map { it.value.parameterName to it.value.type + "?" }
+        val pathParamsAndType = pathParams.map { it to (urlParams.get(it)?.type ?: "String") }
+
+        val urlParamsPart = if (get) urlParamsAndType.map { "${it.first}: ${it.second}" } else listOf("vararg urlParams: Pair<String, Any?>")
+
+        val methodParams = (pathParamsAndType.map { "${it.first}: ${it.second}" } + urlParamsPart).joinToString(", ")
+
+        val paramsString = if (!get || urlParams.isEmpty()) "" else urlParams.map { "\n                \"${it.key}\" to ${format(it.value)}" }.joinToString(", ")
+        val text = HtmlToPlainText().getPlainText(endpointElement).replace("\n\n", "\n - ").replace(Regex("\n - $", MULTILINE), "")
+
+        val requestMethod = when (method) {
+            "get" -> "get()"
+            "post" -> "post(urlParams.multipart())"
+            else -> "method(\"$method\")"
+        }
+
+        val name = method + url.replaceFirst("/api", "").replace("$", "").split("/", "[", "]").map { it.capitalize() }.joinToString ("")
+        val readResponse = if (url.startsWith("/api")) "getResponse()" else "readEntity(String::class.java)"
+
+        if (name.isNotEmpty()) {
+            if (get) {
+                writer.write("""
+/*
+ * ${text.lines().joinToString("\n * ")}
+ **/
+fun OAuthClient.$name($methodParams) =
+        retry(3) { requestApi("$url"${if (paramsString.isEmpty()) "" else ", " + paramsString}).$requestMethod.$readResponse }
+""")
+            } else {
+                writer.write("""
+/*
+ * ${text.lines().joinToString("\n * ")}
+ **/
+fun OAuthClient.$name($methodParams) =
+        retry(3) { requestApi("$url").$requestMethod.$readResponse }
+""")
+            }
+        }
+        return method
+    }
+
+    private fun parseUrl(originalMethod: String, urlNodes: List<Node>?): Triple<String, List<String>, String> {
+        var method = originalMethod
+        var queryParameters = listOf<String>()
+        var url = ""
+        urlNodes?.forEach {
+            when (it) {
+                is TextNode -> url += it.text().replace("[", "").replace("]", "")
+                is Element -> {
+                    it.useText("span.method") { method = it }
+                    it.useText("em.placeholder") { url += "$$it" }
+                    it.useText("em.placeholder") { queryParameters += it }
+                }
+            }
+        }
+        return Triple(method.toLowerCase(Locale.ENGLISH), queryParameters, url.replace("→ ", ""))
+    }
+
+    private fun parseQueryParameters(endpointElement: Element): Map<String, Param> {
+        val select = endpointElement.selectFirst("div.info")?.children()?.select("table.parameters > tbody > tr")
+        return select?.map { row -> row.selectFirst("td > p")?.parseParameter(row) }?.filterNotNull()?.toMap() ?: mapOf()
+    }
+
+    private fun Element.parseParameter(row: Element): Pair<String, Param> {
+        val text = text().split("(", ")").map { it.trim() }
+        val name = row.selectFirst("th")!!.text().split(" ").first()
+        val type = types.entries.firstOrNull { text.any { t -> t.contains(it.key) } }?.value ?: "String"
+        val parameterName = name.split('|', '_', '-').map { it.capitalize() }.joinToString("").decapitalize()
+        val optional = text.contains("default:") || text.contains("optional")
+        return name to Param(name, optional, type, parameterName)
+    }
+
+    private fun format(it: Param) = when (it.type) {
+        "List<String>" -> it.parameterName + ".csv()"
+        else -> it.parameterName
+    }
+
+    private fun Element.useText(selector: String, action: (String) -> Unit) {
+        val text = select(selector)?.text()?.trim()
+        if (text != null && text != "") action(text)
+    }
+
+    data class Param(val name: String, val optional: Boolean, val type: String, val parameterName: String)
+
+    fun Element.selectFirst(selector: String): Element? =
+            select(selector).first()
+}
diff --git a/src/test/resources/api.html b/src/test/resources/api.html
new file mode 100644
index 0000000..537b575
--- /dev/null
+++ b/src/test/resources/api.html
@@ -0,0 +1,1480 @@
+<!doctype html><html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><title>reddit.com: api documentation</title><meta name="keywords" content=" reddit, reddit.com, vote, comment, submit " /><meta name="description" content="reddit: the front page of the internet" /><meta name="referrer" content="origin"><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="alternate" media="only screen and (max-width: 640px)" href="https://m.reddit.com/dev/api" /><meta name="viewport" content="width=1024"><link rel='icon' href="//www.redditstatic.com/icon.png" sizes="256x256" type="image/png" /><link rel='shortcut icon' href="//www.redditstatic.com/favicon.ico" type="image/x-icon" /><link rel='apple-touch-icon-precomposed' href="//www.redditstatic.com/icon-touch.png" /><link rel="stylesheet" type="text/css" href="//www.redditstatic.com/reddit.yag1sITz2Iw.css" media="all"><!--[if gte IE 9]><!--><script type="text/javascript" src="//www.redditstatic.com/reddit-init.en.djoFVyulQfY.js"></script><!--<![endif]--><!--[if lt IE 9]><script type="text/javascript" src="//www.redditstatic.com/reddit-init-legacy.en.C2douxE3Olw.js"></script><![endif]--><script type="text/javascript" id="config">r.setup({"ajax_domain": "www.reddit.com", "post_site": "", "gold": false, "poisoning_report_mac": "18fdb7965fed73b042d354eb6f37c2ec68dbd7dd", "requires_eu_cookie_policy": true, "nsfw_media_acknowledged": false, "stats_domain": "https://stats.redditmedia.com", "feature_expando_events": true, "facebook_app_id": "322647334569188", "is_sponsor": false, "user_id": 46768955, "eventtracker_url": "//pixel.redditmedia.com/pixel/of_delight.png", "poisoning_canary": "6t", "logged": "etherboard", "over_18": true, "feature_ads_user_matching": false, "uitracker_url": "//pixel.redditmedia.com/pixel/of_discovery.png", "modhash": "m0p0h2grqcab8e4dbf9911f523e6301f2153a9f0938ac6110e", "send_logs": true, "listing_over_18": false, "https_endpoint": "https://www.reddit.com", "extension": null, "cur_site": "", "tracker_url": "//pixel.redditmedia.com/pixel/of_destiny.png?v=2P4hrifazsQj50S5VWJXTLIYptiFbWezP2L7WHWBP2KSrd3ICXkdKh%2BExFhPZ%2B%2BhFderYt8Fc5L25I27KVnrcRjllzBF2szD", "expando_preference": null, "debug": false, "has_subscribed": true, "server_time": 1457860487.0, "clicktracker_url": "//pixel.redditmedia.com/click", "pref_no_profanity": true, "cur_domain": "reddit.com", "feature_new_report_dialog": true, "events_collector_url": "https://events.redditmedia.com/v1", "https_forced": true, "user_in_timeout": false, "is_fake": true, "renderstyle": "html", "vote_hash": "Jqo7lSV1/58BI43oo7pTNMyCJ4GucF5d0ZaO/Ual9d9PQw7cVwajapHDp4O40u/lgrfj0BFuQWrWpwYC8xw77b5xp7/sPXbO6NAQl6Ef5ttb3OajcB18JVMJKkaTtcyRM2aRizo2XYb/WWEj74BI4UefRgw7W8k30SVu6WgrWgo=", "events_collector_secret": "thiiM0ahsieSiech1phithe6chahngoo8sah6aid\n", "adtracker_url": "//pixel.redditmedia.com/pixel/of_doom.png", "events_collector_key": "RedditFrontend1", "cache_policy": "loggedin_www_new", "store_visits": false, "anon_eventtracker_url": "//pixel.redditmedia.com/pixel/of_diversity.png", "new_window": false, "pref_beta": false, "eu_cookie_max_attempts": 3, "pageInfo": {"actionName": "apidocs.GET_docs", "verification": "328b6a67a020219d64dc64b13056d04201f7d0f2"}, "mweb_blacklist_expressions": ["^/prefs/?", "^/live/?", "/message/", "/wiki/?", "/m/", "^/subreddits/create", "^/gold", "^/advertising", "^/promoted", "^/rules", "^/buttons"], "media_domain": "www.redditmedia.com", "static_root": "//www.redditstatic.com", "feature_screenview_events": true, "cur_listing": "frontpage", "status_msg": {"fetching": "fetching title...", "loading": "loading...", "submitting": "submitting..."}, "stats_sample_rate": "5", "eu_cookie": "eu_cookie"})</script><style type="text/css">/* Custom css: use this block to insert special translation-dependent css in the page header */</style><script type="text/javascript">if (!window.DO_NOT_TRACK) { window.user_type = 'loggedin'; window.is_gold_page = 'False'.toLowerCase() === 'true'; }</script><script type="text/javascript">if (!window.DO_NOT_TRACK) { var _gaq = _gaq || []; _gaq.push( ['_require', 'inpage_linkid', '//www.google-analytics.com/plugins/ga/inpage_linkid.js'], ['_setAccount', 'UA-12131688-1'], ['_setDomainName', 'reddit.com'], ['_setCustomVar', 1, 'site', ' reddit.com', 3], ['_setCustomVar', 2, 'srpath', ' reddit.com-GET_docs', 3], ['_setCustomVar', 3, 'usertype', user_type, 2], ['_setCustomVar', 4, 'uitype', 'web', 3], ['_setCustomVar', 5, 'style_override', '', 2], ['_setSampleRate', '50'], ['_trackPageview'] ); (function() { var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); })(); }</script><script type="text/javascript">if (!window.DO_NOT_TRACK) { (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','_ga'); window._ga('create', 'UA-12131688-9', { 'name': 'goldTracker', 'cookieDomain': 'reddit.com', '1': ' reddit.com', '2': ' reddit.com-GET_docs', '3': window.user_type, '4': 'web', 'sampleRate': 100 }); if (window.is_gold_page) { window._ga('goldTracker.send', 'pageview'); } }</script></head><body class="loggedin show-controversial" ><script>if (!window.DO_NOT_TRACK) { var frame = document.createElement('iframe'); frame.style.display = 'none'; frame.referrer = 'no-referrer'; frame.id = 'gtm-jail'; frame.name = JSON.stringify({ subreddit: r.config.post_site, origin: location.origin, userMatching: r.config.feature_ads_user_matching, }); frame.src = '//' + "www.redditmedia.com" + '/gtm/jail'; document.body.appendChild(frame); }</script><div id="header" role="banner"><a tabindex="1" href="#content" id="jumpToContent">jump to content</a><div id="sr-header-area"><div class="width-clip"><div class="dropdown srdrop" onclick="open_menu(this)"><span class="selected title">my subreddits</span></div><div class="drop-choices srdrop"><a href="https://www.reddit.com/r/announcements/" class="choice" >announcements</a><a href="https://www.reddit.com/r/Art/" class="choice" >Art</a><a href="https://www.reddit.com/r/AskReddit/" class="choice" >AskReddit</a><a href="https://www.reddit.com/r/askscience/" class="choice" >askscience</a><a href="https://www.reddit.com/r/aww/" class="choice" >aww</a><a href="https://www.reddit.com/r/blog/" class="choice" >blog</a><a href="https://www.reddit.com/r/books/" class="choice" >books</a><a href="https://www.reddit.com/r/creepy/" class="choice" >creepy</a><a href="https://www.reddit.com/r/dataisbeautiful/" class="choice" >dataisbeautiful</a><a href="https://www.reddit.com/r/DIY/" class="choice" >DIY</a><a href="https://www.reddit.com/r/Documentaries/" class="choice" >Documentaries</a><a href="https://www.reddit.com/r/EarthPorn/" class="choice" >EarthPorn</a><a href="https://www.reddit.com/r/ethereum/" class="choice" >ethereum</a><a href="https://www.reddit.com/r/ethinvestor/" class="choice" >ethinvestor</a><a href="https://www.reddit.com/r/ethtrader/" class="choice" >ethtrader</a><a href="https://www.reddit.com/r/explainlikeimfive/" class="choice" >explainlikeimfive</a><a href="https://www.reddit.com/r/Fitness/" class="choice" >Fitness</a><a href="https://www.reddit.com/r/food/" class="choice" >food</a><a href="https://www.reddit.com/r/funny/" class="choice" >funny</a><a href="https://www.reddit.com/r/Futurology/" class="choice" >Futurology</a><a href="https://www.reddit.com/r/gadgets/" class="choice" >gadgets</a><a href="https://www.reddit.com/r/gaming/" class="choice" >gaming</a><a href="https://www.reddit.com/r/GetMotivated/" class="choice" >GetMotivated</a><a href="https://www.reddit.com/r/gifs/" class="choice" >gifs</a><a href="https://www.reddit.com/r/history/" class="choice" >history</a><a href="https://www.reddit.com/r/IAmA/" class="choice" >IAmA</a><a href="https://www.reddit.com/r/InternetIsBeautiful/" class="choice" >InternetIsBeautiful</a><a href="https://www.reddit.com/r/Jokes/" class="choice" >Jokes</a><a href="https://www.reddit.com/r/LifeProTips/" class="choice" >LifeProTips</a><a href="https://www.reddit.com/r/listentothis/" class="choice" >listentothis</a><a href="https://www.reddit.com/r/movies/" class="choice" >movies</a><a href="https://www.reddit.com/r/Music/" class="choice" >Music</a><a href="https://www.reddit.com/r/news/" class="choice" >news</a><a href="https://www.reddit.com/r/nosleep/" class="choice" >nosleep</a><a href="https://www.reddit.com/r/nottheonion/" class="choice" >nottheonion</a><a href="https://www.reddit.com/r/OldSchoolCool/" class="choice" >OldSchoolCool</a><a href="https://www.reddit.com/r/personalfinance/" class="choice" >personalfinance</a><a href="https://www.reddit.com/r/philosophy/" class="choice" >philosophy</a><a href="https://www.reddit.com/r/photoshopbattles/" class="choice" >photoshopbattles</a><a href="https://www.reddit.com/r/pics/" class="choice" >pics</a><a href="https://www.reddit.com/r/science/" class="choice" >science</a><a href="https://www.reddit.com/r/Showerthoughts/" class="choice" >Showerthoughts</a><a href="https://www.reddit.com/r/space/" class="choice" >space</a><a href="https://www.reddit.com/r/sports/" class="choice" >sports</a><a href="https://www.reddit.com/r/television/" class="choice" >television</a><a href="https://www.reddit.com/r/tifu/" class="choice" >tifu</a><a href="https://www.reddit.com/r/todayilearned/" class="choice" >todayilearned</a><a href="https://www.reddit.com/r/TwoXChromosomes/" class="choice" >TwoXChromosomes</a><a href="https://www.reddit.com/r/UpliftingNews/" class="choice" >UpliftingNews</a><a href="https://www.reddit.com/r/videos/" class="choice" >videos</a><a href="https://www.reddit.com/r/worldnews/" class="choice" >worldnews</a><a href="https://www.reddit.com/r/WritingPrompts/" class="choice" >WritingPrompts</a><a href="https://www.reddit.com/subreddits/" class="bottom-option choice" >edit subscriptions</a></div><div class="sr-list"><ul class="flat-list sr-bar hover" ><li class='selected'><a href="https://www.reddit.com/" class="choice" >front</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/all" class="choice" >all</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/random/" class="random choice" >random</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/mod" class="choice" >mod</a></li></ul><span class="separator">&nbsp;|&nbsp;</span><ul class="flat-list sr-bar hover" ><li ><a href="https://www.reddit.com/r/AskReddit/" class="choice" >AskReddit</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/funny/" class="choice" >funny</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/pics/" class="choice" >pics</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/videos/" class="choice" >videos</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/todayilearned/" class="choice" >todayilearned</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/news/" class="choice" >news</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/gifs/" class="choice" >gifs</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/worldnews/" class="choice" >worldnews</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/aww/" class="choice" >aww</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/movies/" class="choice" >movies</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/gaming/" class="choice" >gaming</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/Showerthoughts/" class="choice" >Showerthoughts</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/tifu/" class="choice" >tifu</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/explainlikeimfive/" class="choice" >explainlikeimfive</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/science/" class="choice" >science</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/nottheonion/" class="choice" >nottheonion</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/photoshopbattles/" class="choice" >photoshopbattles</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/Jokes/" class="choice" >Jokes</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/IAmA/" class="choice" >IAmA</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/television/" class="choice" >television</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/TwoXChromosomes/" class="choice" >TwoXChromosomes</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/Fitness/" class="choice" >Fitness</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/books/" class="choice" >books</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/Music/" class="choice" >Music</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/OldSchoolCool/" class="choice" >OldSchoolCool</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/food/" class="choice" >food</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/space/" class="choice" >space</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/LifeProTips/" class="choice" >LifeProTips</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/Documentaries/" class="choice" >Documentaries</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/dataisbeautiful/" class="choice" >dataisbeautiful</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/sports/" class="choice" >sports</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/askscience/" class="choice" >askscience</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/WritingPrompts/" class="choice" >WritingPrompts</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/Futurology/" class="choice" >Futurology</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/EarthPorn/" class="choice" >EarthPorn</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/InternetIsBeautiful/" class="choice" >InternetIsBeautiful</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/creepy/" class="choice" >creepy</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/Art/" class="choice" >Art</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/UpliftingNews/" class="choice" >UpliftingNews</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/personalfinance/" class="choice" >personalfinance</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/DIY/" class="choice" >DIY</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/history/" class="choice" >history</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/nosleep/" class="choice" >nosleep</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/gadgets/" class="choice" >gadgets</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/GetMotivated/" class="choice" >GetMotivated</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/ethtrader/" class="choice" >ethtrader</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/listentothis/" class="choice" >listentothis</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/ethereum/" class="choice" >ethereum</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/philosophy/" class="choice" >philosophy</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/announcements/" class="choice" >announcements</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/blog/" class="choice" >blog</a></li><li ><span class="separator">-</span><a href="https://www.reddit.com/r/ethinvestor/" class="choice" >ethinvestor</a></li></ul></div><a href="https://www.reddit.com/subreddits/" id="sr-more-link" >edit &raquo;</a></div></div><div id="header-bottom-left"><a href="/" id="header-img" class="default-header" title="">reddit.com</a>&nbsp;<span class="pagename selected">api documentation</span></div><div id="header-bottom-right"><span class="user"><a href="https://www.reddit.com/user/etherboard/" >etherboard</a>&nbsp;(<span class="userkarma" title="link karma">53</span>)</span><span class="separator">|</span><a title="no new mail" href="https://www.reddit.com/message/inbox/" class="nohavemail" id="mail" >messages</a><span class="separator">|</span><a title="no new mod mail" href="https://www.reddit.com/message/moderator/" data-event-action="pageview" data-event-detail="modmail" class="nohavemail access-required" id="modmail" >mod messages</a><span class="separator">|</span><ul class="flat-list hover" ><li ><a href="https://www.reddit.com/prefs/" class="pref-lang choice" >preferences</a></li></ul><span class="separator">|</span><form method="post" action="https://www.reddit.com/logout" class="logout hover" ><input type="hidden" name="uh" value="m0p0h2grqcab8e4dbf9911f523e6301f2153a9f0938ac6110e"/><input type="hidden" name="top" value="off"/><input type="hidden" name="dest" value="/dev/api"/><a href="javascript:void(0)" onclick="$(this).parent().submit()" >logout</a></form></div></div><a name="content"></a><div class="content api-help" role="main"><div class="sidebar"><div class="head"></div><div class="toc"><ul><li><strong>API methods</strong><span class="mode-selector"><a class="mode mode-current" href="/dev/api">by section</a><a class="mode " href="/dev/api/oauth">by oauth scope</a></span><ul><li><a href="#section_account" class="section">account</a><ul><li class="supports-oauth"><a href="#GET_api_v1_me">/api/v1/me</a></li><li class="supports-oauth"><a href="#GET_api_v1_me_blocked">/api/v1/me/blocked</a></li><li class="supports-oauth"><a href="#GET_api_v1_me_friends">/api/v1/me/friends</a></li><li class="supports-oauth"><a href="#GET_api_v1_me_karma">/api/v1/me/karma</a></li><li class="supports-oauth"><a href="#GET_api_v1_me_prefs">/api/v1/me/prefs</a></li><li class="supports-oauth"><a href="#GET_api_v1_me_trophies">/api/v1/me/trophies</a></li><li class="supports-oauth"><a href="#GET_prefs_blocked">/prefs/blocked</a></li><li class="supports-oauth"><a href="#GET_prefs_friends">/prefs/friends</a></li><li class="supports-oauth"><a href="#GET_prefs_{where}">/prefs/<em class="placeholder">where</em></a></li></ul></li><li><a href="#section_captcha" class="section">captcha</a><ul><li class="supports-oauth"><a href="#GET_api_needs_captcha">/api/needs_captcha</a></li><li class="supports-oauth"><a href="#POST_api_new_captcha">/api/new_captcha</a></li><li class="supports-oauth"><a href="#GET_captcha_{iden}">/captcha/<em class="placeholder">iden</em></a></li></ul></li><li><a href="#section_flair" class="section">flair</a><ul><li class="supports-oauth"><a href="#POST_api_clearflairtemplates">/api/clearflairtemplates</a></li><li class="supports-oauth"><a href="#POST_api_deleteflair">/api/deleteflair</a></li><li class="supports-oauth"><a href="#POST_api_deleteflairtemplate">/api/deleteflairtemplate</a></li><li class="supports-oauth"><a href="#POST_api_flair">/api/flair</a></li><li class="supports-oauth"><a href="#POST_api_flairconfig">/api/flairconfig</a></li><li class="supports-oauth"><a href="#POST_api_flaircsv">/api/flaircsv</a></li><li class="supports-oauth"><a href="#GET_api_flairlist">/api/flairlist</a></li><li class="supports-oauth"><a href="#POST_api_flairselector">/api/flairselector</a></li><li class="supports-oauth"><a href="#POST_api_flairtemplate">/api/flairtemplate</a></li><li class="supports-oauth"><a href="#POST_api_selectflair">/api/selectflair</a></li><li class="supports-oauth"><a href="#POST_api_setflairenabled">/api/setflairenabled</a></li></ul></li><li><a href="#section_gold" class="section">reddit gold</a><ul><li class="supports-oauth"><a href="#POST_api_v1_gold_gild_{fullname}">/api/v1/gold/gild/<em class="placeholder">fullname</em></a></li><li class="supports-oauth"><a href="#POST_api_v1_gold_give_{username}">/api/v1/gold/give/<em class="placeholder">username</em></a></li></ul></li><li><a href="#section_links_and_comments" class="section">links &amp; comments</a><ul><li class="supports-oauth"><a href="#POST_api_comment">/api/comment</a></li><li class="supports-oauth"><a href="#POST_api_del">/api/del</a></li><li class="supports-oauth"><a href="#POST_api_editusertext">/api/editusertext</a></li><li class="supports-oauth"><a href="#POST_api_hide">/api/hide</a></li><li class="supports-oauth"><a href="#GET_api_info">/api/info</a></li><li class="supports-oauth"><a href="#POST_api_lock">/api/lock</a></li><li class="supports-oauth"><a href="#POST_api_marknsfw">/api/marknsfw</a></li><li class="supports-oauth"><a href="#GET_api_morechildren">/api/morechildren</a></li><li class="supports-oauth"><a href="#POST_api_report">/api/report</a></li><li class="supports-oauth"><a href="#POST_api_save">/api/save</a></li><li class="supports-oauth"><a href="#GET_api_saved_categories">/api/saved_categories</a></li><li class="supports-oauth"><a href="#POST_api_sendreplies">/api/sendreplies</a></li><li class="supports-oauth"><a href="#POST_api_set_contest_mode">/api/set_contest_mode</a></li><li class="supports-oauth"><a href="#POST_api_set_subreddit_sticky">/api/set_subreddit_sticky</a></li><li class="supports-oauth"><a href="#POST_api_set_suggested_sort">/api/set_suggested_sort</a></li><li class="supports-oauth"><a href="#POST_api_store_visits">/api/store_visits</a></li><li class="supports-oauth"><a href="#POST_api_submit">/api/submit</a></li><li class="supports-oauth"><a href="#POST_api_unhide">/api/unhide</a></li><li class="supports-oauth"><a href="#POST_api_unlock">/api/unlock</a></li><li class="supports-oauth"><a href="#POST_api_unmarknsfw">/api/unmarknsfw</a></li><li class="supports-oauth"><a href="#POST_api_unsave">/api/unsave</a></li><li class="supports-oauth"><a href="#POST_api_vote">/api/vote</a></li></ul></li><li><a href="#section_listings" class="section">listings</a><ul><li class="supports-oauth"><a href="#GET_by_id_{names}">/by_id/<em class="placeholder">names</em></a></li><li class="supports-oauth"><a href="#GET_comments_{article}">/comments/<em class="placeholder">article</em></a></li><li class="supports-oauth"><a href="#GET_controversial">/controversial</a></li><li class="supports-oauth"><a href="#GET_duplicates_{article}">/duplicates/<em class="placeholder">article</em></a></li><li class="supports-oauth"><a href="#GET_hot">/hot</a></li><li class="supports-oauth"><a href="#GET_new">/new</a></li><li class="supports-oauth"><a href="#GET_random">/random</a></li><li class="supports-oauth"><a href="#GET_top">/top</a></li><li class="supports-oauth"><a href="#GET_{sort}">/<em class="placeholder">sort</em></a></li></ul></li><li><a href="#section_live" class="section">live threads</a><ul><li class="supports-oauth"><a href="#POST_api_live_create">/api/live/create</a></li><li class="supports-oauth"><a href="#POST_api_live_{thread}_accept_contributor_invite">/api/live/<em class="placeholder">thread</em>/accept_contributor_invite</a></li><li class="supports-oauth"><a href="#POST_api_live_{thread}_close_thread">/api/live/<em class="placeholder">thread</em>/close_thread</a></li><li class="supports-oauth"><a href="#POST_api_live_{thread}_delete_update">/api/live/<em class="placeholder">thread</em>/delete_update</a></li><li class="supports-oauth"><a href="#POST_api_live_{thread}_edit">/api/live/<em class="placeholder">thread</em>/edit</a></li><li class="supports-oauth"><a href="#POST_api_live_{thread}_invite_contributor">/api/live/<em class="placeholder">thread</em>/invite_contributor</a></li><li class="supports-oauth"><a href="#POST_api_live_{thread}_leave_contributor">/api/live/<em class="placeholder">thread</em>/leave_contributor</a></li><li class="supports-oauth"><a href="#POST_api_live_{thread}_report">/api/live/<em class="placeholder">thread</em>/report</a></li><li class="supports-oauth"><a href="#POST_api_live_{thread}_rm_contributor">/api/live/<em class="placeholder">thread</em>/rm_contributor</a></li><li class="supports-oauth"><a href="#POST_api_live_{thread}_rm_contributor_invite">/api/live/<em class="placeholder">thread</em>/rm_contributor_invite</a></li><li class="supports-oauth"><a href="#POST_api_live_{thread}_set_contributor_permissions">/api/live/<em class="placeholder">thread</em>/set_contributor_permissions</a></li><li class="supports-oauth"><a href="#POST_api_live_{thread}_strike_update">/api/live/<em class="placeholder">thread</em>/strike_update</a></li><li class="supports-oauth"><a href="#POST_api_live_{thread}_update">/api/live/<em class="placeholder">thread</em>/update</a></li><li class="supports-oauth"><a href="#GET_live_{thread}">/live/<em class="placeholder">thread</em></a></li><li class="supports-oauth"><a href="#GET_live_{thread}_about">/live/<em class="placeholder">thread</em>/about</a></li><li class="supports-oauth"><a href="#GET_live_{thread}_contributors">/live/<em class="placeholder">thread</em>/contributors</a></li><li class="supports-oauth"><a href="#GET_live_{thread}_discussions">/live/<em class="placeholder">thread</em>/discussions</a></li></ul></li><li><a href="#section_messages" class="section">private messages</a><ul><li class="supports-oauth"><a href="#POST_api_block">/api/block</a></li><li class=""><a href="#POST_api_collapse_message">/api/collapse_message</a></li><li class="supports-oauth"><a href="#POST_api_compose">/api/compose</a></li><li class="supports-oauth"><a href="#POST_api_read_all_messages">/api/read_all_messages</a></li><li class="supports-oauth"><a href="#POST_api_read_message">/api/read_message</a></li><li class="supports-oauth"><a href="#POST_api_unblock_subreddit">/api/unblock_subreddit</a></li><li class=""><a href="#POST_api_uncollapse_message">/api/uncollapse_message</a></li><li class="supports-oauth"><a href="#POST_api_unread_message">/api/unread_message</a></li><li class="supports-oauth"><a href="#GET_message_inbox">/message/inbox</a></li><li class="supports-oauth"><a href="#GET_message_sent">/message/sent</a></li><li class="supports-oauth"><a href="#GET_message_unread">/message/unread</a></li><li class="supports-oauth"><a href="#GET_message_{where}">/message/<em class="placeholder">where</em></a></li></ul></li><li><a href="#section_misc" class="section">misc</a><ul><li class="supports-oauth"><a href="#GET_api_v1_scopes">/api/v1/scopes</a></li></ul></li><li><a href="#section_moderation" class="section">moderation</a><ul><li class="supports-oauth"><a href="#GET_about_edited">/about/edited</a></li><li class="supports-oauth"><a href="#GET_about_log">/about/log</a></li><li class="supports-oauth"><a href="#GET_about_modqueue">/about/modqueue</a></li><li class="supports-oauth"><a href="#GET_about_reports">/about/reports</a></li><li class="supports-oauth"><a href="#GET_about_spam">/about/spam</a></li><li class="supports-oauth"><a href="#GET_about_unmoderated">/about/unmoderated</a></li><li class="supports-oauth"><a href="#GET_about_{location}">/about/<em class="placeholder">location</em></a></li><li class="supports-oauth"><a href="#POST_api_accept_moderator_invite">/api/accept_moderator_invite</a></li><li class="supports-oauth"><a href="#POST_api_approve">/api/approve</a></li><li class="supports-oauth"><a href="#POST_api_distinguish">/api/distinguish</a></li><li class="supports-oauth"><a href="#POST_api_ignore_reports">/api/ignore_reports</a></li><li class="supports-oauth"><a href="#POST_api_leavecontributor">/api/leavecontributor</a></li><li class="supports-oauth"><a href="#POST_api_leavemoderator">/api/leavemoderator</a></li><li class="supports-oauth"><a href="#POST_api_mute_message_author">/api/mute_message_author</a></li><li class="supports-oauth"><a href="#POST_api_remove">/api/remove</a></li><li class="supports-oauth"><a href="#POST_api_unignore_reports">/api/unignore_reports</a></li><li class="supports-oauth"><a href="#POST_api_unmute_message_author">/api/unmute_message_author</a></li><li class="supports-oauth"><a href="#GET_stylesheet">/stylesheet</a></li></ul></li><li><a href="#section_multis" class="section">multis</a><ul><li class="supports-oauth"><a href="#DELETE_api_filter_{filterpath}">/api/filter/<em class="placeholder">filterpath</em></a></li><li class="supports-oauth"><a href="#DELETE_api_filter_{filterpath}_r_{srname}">/api/filter/<em class="placeholder">filterpath</em>/r/<em class="placeholder">srname</em></a></li><li class="supports-oauth"><a href="#POST_api_multi_copy">/api/multi/copy</a></li><li class="supports-oauth"><a href="#GET_api_multi_mine">/api/multi/mine</a></li><li class="supports-oauth"><a href="#POST_api_multi_rename">/api/multi/rename</a></li><li class="supports-oauth"><a href="#GET_api_multi_user_{username}">/api/multi/user/<em class="placeholder">username</em></a></li><li class="supports-oauth"><a href="#DELETE_api_multi_{multipath}">/api/multi/<em class="placeholder">multipath</em></a></li><li class="supports-oauth"><a href="#GET_api_multi_{multipath}_description">/api/multi/<em class="placeholder">multipath</em>/description</a></li><li class="supports-oauth"><a href="#DELETE_api_multi_{multipath}_r_{srname}">/api/multi/<em class="placeholder">multipath</em>/r/<em class="placeholder">srname</em></a></li></ul></li><li><a href="#section_search" class="section">search</a><ul><li class="supports-oauth"><a href="#GET_search">/search</a></li></ul></li><li><a href="#section_subreddits" class="section">subreddits</a><ul><li class="supports-oauth"><a href="#GET_about_banned">/about/banned</a></li><li class="supports-oauth"><a href="#GET_about_contributors">/about/contributors</a></li><li class="supports-oauth"><a href="#GET_about_moderators">/about/moderators</a></li><li class="supports-oauth"><a href="#GET_about_muted">/about/muted</a></li><li class="supports-oauth"><a href="#GET_about_wikibanned">/about/wikibanned</a></li><li class="supports-oauth"><a href="#GET_about_wikicontributors">/about/wikicontributors</a></li><li class="supports-oauth"><a href="#GET_about_{where}">/about/<em class="placeholder">where</em></a></li><li class="supports-oauth"><a href="#POST_api_delete_sr_banner">/api/delete_sr_banner</a></li><li class="supports-oauth"><a href="#POST_api_delete_sr_header">/api/delete_sr_header</a></li><li class="supports-oauth"><a href="#POST_api_delete_sr_icon">/api/delete_sr_icon</a></li><li class="supports-oauth"><a href="#POST_api_delete_sr_img">/api/delete_sr_img</a></li><li class="supports-oauth"><a href="#GET_api_recommend_sr_{srnames}">/api/recommend/sr/<em class="placeholder">srnames</em></a></li><li class="supports-oauth"><a href="#POST_api_search_reddit_names">/api/search_reddit_names</a></li><li class="supports-oauth"><a href="#POST_api_site_admin">/api/site_admin</a></li><li class="supports-oauth"><a href="#GET_api_submit_text">/api/submit_text</a></li><li class="supports-oauth"><a href="#POST_api_subreddit_stylesheet">/api/subreddit_stylesheet</a></li><li class="supports-oauth"><a href="#GET_api_subreddits_by_topic">/api/subreddits_by_topic</a></li><li class="supports-oauth"><a href="#POST_api_subscribe">/api/subscribe</a></li><li class="supports-oauth"><a href="#POST_api_upload_sr_img">/api/upload_sr_img</a></li><li class="supports-oauth"><a href="#GET_r_{subreddit}_about">/r/<em class="placeholder">subreddit</em>/about</a></li><li class="supports-oauth"><a href="#GET_r_{subreddit}_about_edit">/r/<em class="placeholder">subreddit</em>/about/edit</a></li><li class="supports-oauth"><a href="#GET_rules">/rules</a></li><li class="supports-oauth"><a href="#GET_sidebar">/sidebar</a></li><li class="supports-oauth"><a href="#GET_sticky">/sticky</a></li><li class="supports-oauth"><a href="#GET_subreddits_default">/subreddits/default</a></li><li class="supports-oauth"><a href="#GET_subreddits_gold">/subreddits/gold</a></li><li class="supports-oauth"><a href="#GET_subreddits_mine_contributor">/subreddits/mine/contributor</a></li><li class="supports-oauth"><a href="#GET_subreddits_mine_moderator">/subreddits/mine/moderator</a></li><li class="supports-oauth"><a href="#GET_subreddits_mine_subscriber">/subreddits/mine/subscriber</a></li><li class="supports-oauth"><a href="#GET_subreddits_mine_{where}">/subreddits/mine/<em class="placeholder">where</em></a></li><li class="supports-oauth"><a href="#GET_subreddits_new">/subreddits/new</a></li><li class="supports-oauth"><a href="#GET_subreddits_popular">/subreddits/popular</a></li><li class="supports-oauth"><a href="#GET_subreddits_search">/subreddits/search</a></li><li class="supports-oauth"><a href="#GET_subreddits_{where}">/subreddits/<em class="placeholder">where</em></a></li></ul></li><li><a href="#section_users" class="section">users</a><ul><li class="supports-oauth"><a href="#POST_api_friend">/api/friend</a></li><li class="supports-oauth"><a href="#POST_api_setpermissions">/api/setpermissions</a></li><li class="supports-oauth"><a href="#POST_api_unfriend">/api/unfriend</a></li><li class=""><a href="#GET_api_username_available">/api/username_available</a></li><li class="supports-oauth"><a href="#DELETE_api_v1_me_friends_{username}">/api/v1/me/friends/<em class="placeholder">username</em></a></li><li class="supports-oauth"><a href="#GET_api_v1_user_{username}_trophies">/api/v1/user/<em class="placeholder">username</em>/trophies</a></li><li class="supports-oauth"><a href="#GET_user_{username}_about">/user/<em class="placeholder">username</em>/about</a></li><li class="supports-oauth"><a href="#GET_user_{username}_comments">/user/<em class="placeholder">username</em>/comments</a></li><li class="supports-oauth"><a href="#GET_user_{username}_downvoted">/user/<em class="placeholder">username</em>/downvoted</a></li><li class="supports-oauth"><a href="#GET_user_{username}_gilded">/user/<em class="placeholder">username</em>/gilded</a></li><li class="supports-oauth"><a href="#GET_user_{username}_hidden">/user/<em class="placeholder">username</em>/hidden</a></li><li class="supports-oauth"><a href="#GET_user_{username}_overview">/user/<em class="placeholder">username</em>/overview</a></li><li class="supports-oauth"><a href="#GET_user_{username}_saved">/user/<em class="placeholder">username</em>/saved</a></li><li class="supports-oauth"><a href="#GET_user_{username}_submitted">/user/<em class="placeholder">username</em>/submitted</a></li><li class="supports-oauth"><a href="#GET_user_{username}_upvoted">/user/<em class="placeholder">username</em>/upvoted</a></li><li class="supports-oauth"><a href="#GET_user_{username}_{where}">/user/<em class="placeholder">username</em>/<em class="placeholder">where</em></a></li></ul></li><li><a href="#section_wiki" class="section">wiki</a><ul><li class="supports-oauth"><a href="#POST_api_wiki_alloweditor_add">/api/wiki/alloweditor/add</a></li><li class="supports-oauth"><a href="#POST_api_wiki_alloweditor_del">/api/wiki/alloweditor/del</a></li><li class="supports-oauth"><a href="#POST_api_wiki_alloweditor_{act}">/api/wiki/alloweditor/<em class="placeholder">act</em></a></li><li class="supports-oauth"><a href="#POST_api_wiki_edit">/api/wiki/edit</a></li><li class="supports-oauth"><a href="#POST_api_wiki_hide">/api/wiki/hide</a></li><li class="supports-oauth"><a href="#POST_api_wiki_revert">/api/wiki/revert</a></li><li class="supports-oauth"><a href="#GET_wiki_discussions_{page}">/wiki/discussions/<em class="placeholder">page</em></a></li><li class="supports-oauth"><a href="#GET_wiki_pages">/wiki/pages</a></li><li class="supports-oauth"><a href="#GET_wiki_revisions">/wiki/revisions</a></li><li class="supports-oauth"><a href="#GET_wiki_revisions_{page}">/wiki/revisions/<em class="placeholder">page</em></a></li><li class="supports-oauth"><a href="#GET_wiki_settings_{page}">/wiki/settings/<em class="placeholder">page</em></a></li><li class="supports-oauth"><a href="#GET_wiki_{page}">/wiki/<em class="placeholder">page</em></a></li></ul></li></ul></li></ul></div><div class="feet"></div></div><div class="contents"><div class="section introduction"><p>This is automatically-generated documentation for the reddit API.</p><p>The reddit API and code are&#32;<a href="/code">open source</a>. Found a mistake or interested in helping us improve? Have a gander at&#32;<a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py">api.py</a>&#32;and send us a pull request.</p><p><strong>Please take care to respect our&#32;<a href="https://github.com/reddit/reddit/wiki/API">API access rules</a>.</strong></p></div><div class="section overview"><h2>overview</h2><h3 id="listings">listings</h3><div class="md"><p>Many endpoints on reddit use the same protocol for controlling pagination and
+filtering. These endpoints are called Listings and share five common
+parameters: <code>after</code> / <code>before</code>, <code>limit</code>, <code>count</code>, and <code>show</code>.</p>
+
+<p>Listings do not use page numbers because their content changes so frequently.
+Instead, they allow you to view slices of the underlying data. Listing JSON
+responses contain <code>after</code> and <code>before</code> fields which are equivalent to the
+&quot;next&quot; and &quot;prev&quot; buttons on the site and in combination with <code>count</code> can be
+used to page through the listing.</p>
+
+<p>The common parameters are as follows:</p>
+
+<ul>
+<li><code>after</code> / <code>before</code> - only one should be specified. these indicate the
+<a href="#fullnames">fullname</a> of an item in the listing to use as the anchor point of
+the slice.</li>
+<li><code>limit</code> - the maximum number of items to return in this slice of the listing.</li>
+<li><code>count</code> - the number of items already seen in this listing. on the html site,
+the builder uses this to determine when to give values for <code>before</code> and <code>after</code>
+in the response.</li>
+<li><code>show</code> - optional parameter; if <code>all</code> is passed, filters such as &quot;hide links
+that I have voted on&quot; will be disabled.</li>
+</ul>
+
+<p>To page through a listing, start by fetching the first page without specifying
+values for <code>after</code> and <code>count</code>. The response will contain an <code>after</code> value
+which you can pass in the next request. It is a good idea, but not required, to
+send an updated value for <code>count</code> which should be the number of items already
+fetched.</p>
+</div>
+<h3 id="modhashes">modhashes</h3><div class="md"><p>A modhash is a token that the reddit API requires to help prevent
+<a href="http://en.wikipedia.org/wiki/CSRF">CSRF</a>. Modhashes can be obtained via the
+<a href="#GET_api_me.json">/api/me.json</a> call or in response data of listing endpoints.</p>
+
+<p>The preferred way to send a modhash is to include an <code>X-Modhash</code> custom HTTP
+header with your requests.</p>
+
+<p>Modhashes are not required when authenticated with OAuth.</p>
+</div>
+<h3 id="fullnames">fullnames</h3><div class="md"><p>A fullname is a combination of a thing&#39;s type (e.g. <code>Link</code>) and its unique ID
+which forms a compact encoding of a globally unique ID on reddit.</p>
+
+<p>Fullnames start with the type prefix for the object&#39;s type, followed by the
+thing&#39;s unique ID in <a href="http://en.wikipedia.org/wiki/Base36">base 36</a>.  For
+example, <code>t3_15bfi0</code>.</p>
+</div>
+<table class="parameters"><caption>type prefixes</caption><tr><th scope="row">t1_</th><td>Comment</td></tr><tr><th scope="row">t2_</th><td>Account</td></tr><tr><th scope="row">t3_</th><td>Link</td></tr><tr><th scope="row">t4_</th><td>Message</td></tr><tr><th scope="row">t5_</th><td>Subreddit</td></tr><tr><th scope="row">t6_</th><td>Award</td></tr><tr><th scope="row">t8_</th><td>PromoCampaign</td></tr></table><h3 id="response_body_encoding">response body encoding</h3><div class="md"><p>For legacy reasons, all JSON response bodies currently have <code>&lt;</code>, <code>&gt;</code>, and <code>&amp;</code>
+replaced with <code>&amp;lt;</code>, <code>&amp;gt;</code>, and <code>&amp;amp;</code>, respectively. If you wish to opt out
+of this behaviour, add a <code>raw_json=1</code> parameter to your request.</p>
+</div>
+</div><div class="section methods"><h2 id="section_account">account</h2><div class="endpoint" id="GET_api_v1_me"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/apiv1/user.py#L57">view code</a><a href="#GET_api_v1_me">#</a></div><h3><span class="method">GET&nbsp;</span>/api/v1/me<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">identity</span></a></span></h3><div class="info"><div class="md"><p>Returns the identity of the user currently authenticated via OAuth.</p>
+</div>
+</div></div><div class="endpoint" id="GET_api_v1_me_karma"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/apiv1/user.py#L106">view code</a><a href="#GET_api_v1_me_karma">#</a></div><h3><span class="method">GET&nbsp;</span>/api/v1/me/karma<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">mysubreddits</span></a></span></h3><div class="info"><div class="md"><p>Return a breakdown of subreddit karma.</p>
+</div>
+</div></div><div class="endpoint" id="GET_api_v1_me_prefs"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/apiv1/user.py#L67">view code</a><a href="#GET_api_v1_me_prefs">#</a></div><h3><span class="method">GET&nbsp;</span>/api/v1/me/prefs<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">identity</span></a></span></h3><div class="info"><div class="md"><p>Return the preference settings of the logged in user</p>
+</div>
+<table class="parameters"><tr><th scope="row">fields</th><td><p>A comma-separated list of items from this set:</p>
+
+<p><code>threaded_messages</code><br/>
+<code>hide_downs</code><br/>
+<code>email_messages</code><br/>
+<code>show_link_flair</code><br/>
+<code>creddit_autorenew</code><br/>
+<code>show_trending</code><br/>
+<code>private_feeds</code><br/>
+<code>monitor_mentions</code><br/>
+<code>research</code><br/>
+<code>ignore_suggested_sort</code><br/>
+<code>media</code><br/>
+<code>clickgadget</code><br/>
+<code>use_global_defaults</code><br/>
+<code>label_nsfw</code><br/>
+<code>domain_details</code><br/>
+<code>show_stylesheets</code><br/>
+<code>highlight_controversial</code><br/>
+<code>no_profanity</code><br/>
+<code>default_theme_sr</code><br/>
+<code>lang</code><br/>
+<code>hide_ups</code><br/>
+<code>hide_from_robots</code><br/>
+<code>compress</code><br/>
+<code>store_visits</code><br/>
+<code>threaded_modmail</code><br/>
+<code>beta</code><br/>
+<code>other_theme</code><br/>
+<code>show_gold_expiration</code><br/>
+<code>over_18</code><br/>
+<code>enable_default_themes</code><br/>
+<code>show_promote</code><br/>
+<code>min_comment_score</code><br/>
+<code>public_votes</code><br/>
+<code>organic</code><br/>
+<code>collapse_read_messages</code><br/>
+<code>show_flair</code><br/>
+<code>mark_messages_read</code><br/>
+<code>hide_ads</code><br/>
+<code>min_link_score</code><br/>
+<code>newwindow</code><br/>
+<code>numsites</code><br/>
+<code>legacy_search</code><br/>
+<code>num_comments</code><br/>
+<code>highlight_new_comments</code><br/>
+<code>default_comment_sort</code><br/>
+<code>hide_locationbar</code></p>
+</td></tr></table></div></div><div class="endpoint" id="PATCH_api_v1_me_prefs"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/apiv1/user.py#L123">view code</a><a href="#PATCH_api_v1_me_prefs">#</a></div><h3><span class="method">PATCH&nbsp;</span>/api/v1/me/prefs<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">account</span></a></span></h3><div class="info"><table class="parameters"><tr class="json-model"><th>This endpoint expects JSON data of this format</th><td><pre><code>{
+  &quot;beta&quot;: boolean value,
+  &quot;clickgadget&quot;: boolean value,
+  &quot;collapse_read_messages&quot;: boolean value,
+  &quot;compress&quot;: boolean value,
+  &quot;creddit_autorenew&quot;: boolean value,
+  &quot;default_comment_sort&quot;: one of (`confidence`, `old`, `top`, `qa`, `controversial`, `new`),
+  &quot;domain_details&quot;: boolean value,
+  &quot;email_messages&quot;: boolean value,
+  &quot;enable_default_themes&quot;: boolean value,
+  &quot;hide_ads&quot;: boolean value,
+  &quot;hide_downs&quot;: boolean value,
+  &quot;hide_from_robots&quot;: boolean value,
+  &quot;hide_locationbar&quot;: boolean value,
+  &quot;hide_ups&quot;: boolean value,
+  &quot;highlight_controversial&quot;: boolean value,
+  &quot;highlight_new_comments&quot;: boolean value,
+  &quot;ignore_suggested_sort&quot;: boolean value,
+  &quot;label_nsfw&quot;: boolean value,
+  &quot;lang&quot;: a valid IETF language tag (underscore separated),
+  &quot;legacy_search&quot;: boolean value,
+  &quot;mark_messages_read&quot;: boolean value,
+  &quot;media&quot;: one of (`on`, `off`, `subreddit`),
+  &quot;min_comment_score&quot;: an integer between -100 and 100,
+  &quot;min_link_score&quot;: an integer between -100 and 100,
+  &quot;monitor_mentions&quot;: boolean value,
+  &quot;newwindow&quot;: boolean value,
+  &quot;no_profanity&quot;: boolean value,
+  &quot;num_comments&quot;: an integer between 1 and 500,
+  &quot;numsites&quot;: an integer between 1 and 100,
+  &quot;organic&quot;: boolean value,
+  &quot;other_theme&quot;: subreddit name,
+  &quot;over_18&quot;: boolean value,
+  &quot;private_feeds&quot;: boolean value,
+  &quot;public_votes&quot;: boolean value,
+  &quot;research&quot;: boolean value,
+  &quot;show_flair&quot;: boolean value,
+  &quot;show_gold_expiration&quot;: boolean value,
+  &quot;show_link_flair&quot;: boolean value,
+  &quot;show_promote&quot;: boolean value,
+  &quot;show_stylesheets&quot;: boolean value,
+  &quot;show_trending&quot;: boolean value,
+  &quot;store_visits&quot;: boolean value,
+  &quot;theme_selector&quot;: subreddit name,
+  &quot;threaded_messages&quot;: boolean value,
+  &quot;threaded_modmail&quot;: boolean value,
+  &quot;use_global_defaults&quot;: boolean value,
+}
+</code></pre>
+</td></tr></table></div></div><div class="endpoint" id="GET_api_v1_me_trophies"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/apiv1/user.py#L94">view code</a><a href="#GET_api_v1_me_trophies">#</a></div><h3><span class="method">GET&nbsp;</span>/api/v1/me/trophies<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">identity</span></a></span></h3><div class="info"><div class="md"><p>Return a list of trophies for the current user.</p>
+</div>
+</div></div><div class="endpoint" id="GET_prefs_{where}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1818">view code</a><a href="#GET_prefs_{where}">#</a></div><h3><span class="method">GET&nbsp;</span>/prefs/<em class="placeholder">where</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span><a href="https://www.reddit.com/wiki/rss"><span class="api-badge rss-support">rss support</span></a></h3><ul class="uri-variants"><li id="GET_prefs_friends">&rarr; /prefs/friends</li><li id="GET_prefs_blocked">&rarr; /prefs/blocked</li><li id="GET_api_v1_me_friends">&rarr; /api/v1/me/friends</li><li id="GET_api_v1_me_blocked">&rarr; /api/v1/me/blocked</li></ul><div class="info"><div class="md"><p><em>This endpoint is <a href="#listings">a listing</a>.</em></p>
+</div>
+<table class="parameters"><tr><th scope="row">after</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">before</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">count</th><td><p>a positive integer (default: 0)</p>
+</td></tr><tr><th scope="row">limit</th><td><p>the maximum number of items desired (default: 25, maximum: 100)</p>
+</td></tr><tr><th scope="row">show</th><td><p>(optional) the string <code>all</code></p>
+</td></tr><tr><th scope="row">sr_detail</th><td><p>(optional) expand subreddits</p>
+</td></tr></table></div></div><h2 id="section_captcha">captcha</h2><div class="endpoint" id="GET_api_needs_captcha"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L335">view code</a><a href="#GET_api_needs_captcha">#</a></div><h3><span class="method">GET&nbsp;</span>/api/needs_captcha<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">any</span></a></span></h3><div class="info"><div class="md"><p>Check whether CAPTCHAs are needed for API methods that define the
+&quot;captcha&quot; and &quot;iden&quot; parameters.</p>
+</div>
+</div></div><div class="endpoint" id="POST_api_new_captcha"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L145">view code</a><a href="#POST_api_new_captcha">#</a></div><h3><span class="method">POST&nbsp;</span>/api/new_captcha<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">any</span></a></span></h3><div class="info"><div class="md"><p>Responds with an <code>iden</code> of a new CAPTCHA.</p>
+
+<p>Use this endpoint if a user cannot read a given CAPTCHA,
+and wishes to receive a new CAPTCHA.</p>
+
+<p>To request the CAPTCHA image for an iden, use
+<a href="#GET_captcha_%7Biden%7D">/captcha/<code>iden</code></a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr></table></div></div><div class="endpoint" id="GET_captcha_{iden}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/captcha.py#L32">view code</a><a href="#GET_captcha_{iden}">#</a></div><h3><span class="method">GET&nbsp;</span>/captcha/<em class="placeholder">iden</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">any</span></a></span></h3><div class="info"><div class="md"><p>Request a CAPTCHA image given an <code>iden</code>.</p>
+
+<p>An iden is given as the <code>captcha</code> field with a <code>BAD_CAPTCHA</code>
+error, you should use this endpoint if you get a
+<code>BAD_CAPTCHA</code> error response.</p>
+
+<p>Responds with a 120x50 <code>image/png</code> which should be displayed
+to the user.</p>
+
+<p>The user&#39;s response to the CAPTCHA should be sent as <code>captcha</code>
+along with your request.</p>
+
+<p>To request a new CAPTCHA,
+use <a href="#POST_api_new_captcha">/api/new_captcha</a>.</p>
+</div>
+</div></div><h2 id="section_flair">flair</h2><div class="endpoint" id="POST_api_clearflairtemplates"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L4280">view code</a><a href="#POST_api_clearflairtemplates">#</a></div><h3><span class="method">POST&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/clearflairtemplates<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modflair</span></a></span></h3><div class="info"><table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">flair_type</th><td><p>one of (<code>USER_FLAIR</code>, <code>LINK_FLAIR</code>)</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_deleteflair"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L4022">view code</a><a href="#POST_api_deleteflair">#</a></div><h3><span class="method">POST&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/deleteflair<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modflair</span></a></span></h3><div class="info"><table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">name</th><td><p>a user by name</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_deleteflairtemplate"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L4261">view code</a><a href="#POST_api_deleteflairtemplate">#</a></div><h3><span class="method">POST&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/deleteflairtemplate<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modflair</span></a></span></h3><div class="info"><table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">flair_template_id</th><td></td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_flair"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3968">view code</a><a href="#POST_api_flair">#</a></div><h3><span class="method">POST&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/flair<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modflair</span></a></span></h3><div class="info"><table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">css_class</th><td><p>a valid subreddit image name</p>
+</td></tr><tr><th scope="row">link</th><td><p>a <a href="#fullname">fullname</a> of a link</p>
+</td></tr><tr><th scope="row">name</th><td><p>a user by name</p>
+</td></tr><tr><th scope="row">text</th><td><p>a string no longer than 64 characters</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_flairconfig"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L4127">view code</a><a href="#POST_api_flairconfig">#</a></div><h3><span class="method">POST&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/flairconfig<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modflair</span></a></span></h3><div class="info"><table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">flair_enabled</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">flair_position</th><td><p>one of (<code>left</code>, <code>right</code>)</p>
+</td></tr><tr><th scope="row">flair_self_assign_enabled</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">link_flair_position</th><td><p>one of (`<code>,</code>left<code>,</code>right`)</p>
+</td></tr><tr><th scope="row">link_flair_self_assign_enabled</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_flaircsv"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L4042">view code</a><a href="#POST_api_flaircsv">#</a></div><h3><span class="method">POST&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/flaircsv<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modflair</span></a></span></h3><div class="info"><div class="md"><p>Change the flair of multiple users in the same subreddit with a
+single API call.</p>
+
+<p>Requires a string &#39;flair_csv&#39; which has up to 100 lines of the form
+&#39;<code>user</code>,<code>flairtext</code>,<code>cssclass</code>&#39; (Lines beyond the 100th are ignored).</p>
+
+<p>If both <code>cssclass</code> and <code>flairtext</code> are the empty string for a given
+<code>user</code>, instead clears that user&#39;s flair.</p>
+
+<p>Returns an array of objects indicating if each flair setting was 
+applied, or a reason for the failure.</p>
+</div>
+<table class="parameters"><tr><th scope="row">flair_csv</th><td><p>comma-seperated flair information</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="GET_api_flairlist"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L4169">view code</a><a href="#GET_api_flairlist">#</a></div><h3><span class="method">GET&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/flairlist<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modflair</span></a></span></h3><div class="info"><div class="md"><p><em>This endpoint is <a href="#listings">a listing</a>.</em></p>
+</div>
+<table class="parameters"><tr><th scope="row">after</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">before</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">count</th><td><p>a positive integer (default: 0)</p>
+</td></tr><tr><th scope="row">limit</th><td><p>the maximum number of items desired (default: 25, maximum: 1000)</p>
+</td></tr><tr><th scope="row">name</th><td><p>a user by name</p>
+</td></tr><tr><th scope="row">show</th><td><p>(optional) the string <code>all</code></p>
+</td></tr><tr><th scope="row">sr_detail</th><td><p>(optional) expand subreddits</p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_flairselector"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L4295">view code</a><a href="#POST_api_flairselector">#</a></div><h3><span class="method">POST&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/flairselector<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">flair</span></a></span></h3><div class="info"><div class="md"><p>Return information about a users&#39;s flair options.</p>
+
+<p>If <code>link</code> is given, return link flair options.
+Otherwise, return user flair options for this subreddit.</p>
+
+<p>The logged in user&#39;s flair is also returned.
+Subreddit moderators may give a user by <code>name</code> to instead
+retrieve that user&#39;s flair.</p>
+</div>
+<table class="parameters"><tr><th scope="row">link</th><td><p>a <a href="#fullname">fullname</a> of a link</p>
+</td></tr><tr><th scope="row">name</th><td><p>a user by name</p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_flairtemplate"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L4187">view code</a><a href="#POST_api_flairtemplate">#</a></div><h3><span class="method">POST&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/flairtemplate<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modflair</span></a></span></h3><div class="info"><table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">css_class</th><td><p>a valid subreddit image name</p>
+</td></tr><tr><th scope="row">flair_template_id</th><td></td></tr><tr><th scope="row">flair_type</th><td><p>one of (<code>USER_FLAIR</code>, <code>LINK_FLAIR</code>)</p>
+</td></tr><tr><th scope="row">text</th><td><p>a string no longer than 64 characters</p>
+</td></tr><tr><th scope="row">text_editable</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_selectflair"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L4341">view code</a><a href="#POST_api_selectflair">#</a></div><h3><span class="method">POST&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/selectflair<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">flair</span></a></span></h3><div class="info"><table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">flair_template_id</th><td></td></tr><tr><th scope="row">link</th><td><p>a <a href="#fullname">fullname</a> of a link</p>
+</td></tr><tr><th scope="row">name</th><td><p>a user by name</p>
+</td></tr><tr><th scope="row">text</th><td><p>a string no longer than 64 characters</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_setflairenabled"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L4117">view code</a><a href="#POST_api_setflairenabled">#</a></div><h3><span class="method">POST&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/setflairenabled<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">flair</span></a></span></h3><div class="info"><table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">flair_enabled</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><h2 id="section_gold">reddit gold</h2><div class="endpoint" id="POST_api_v1_gold_gild_{fullname}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/apiv1/gold.py#L77">view code</a><a href="#POST_api_v1_gold_gild_{fullname}">#</a></div><h3><span class="method">POST&nbsp;</span>/api/v1/gold/gild/<em class="placeholder">fullname</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">creddits</span></a></span></h3><div class="info"><table class="parameters"><tr><th scope="row">fullname</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_v1_gold_give_{username}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/apiv1/gold.py#L102">view code</a><a href="#POST_api_v1_gold_give_{username}">#</a></div><h3><span class="method">POST&nbsp;</span>/api/v1/gold/give/<em class="placeholder">username</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">creddits</span></a></span></h3><div class="info"><table class="parameters"><tr><th scope="row">months</th><td><p>an integer between 1 and 36</p>
+</td></tr><tr><th scope="row">username</th><td><p>A valid, existing reddit username</p>
+</td></tr></table></div></div><h2 id="section_links_and_comments">links &amp; comments</h2><div class="endpoint" id="POST_api_comment"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L2060">view code</a><a href="#POST_api_comment">#</a></div><h3><span class="method">POST&nbsp;</span>/api/comment<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">any</span></a></span></h3><div class="info"><div class="md"><p>Submit a new comment or reply to a message.</p>
+
+<p><code>parent</code> is the fullname of the thing being replied to. Its value
+changes the kind of object created by this request:</p>
+
+<ul>
+<li>the fullname of a Link: a top-level comment in that Link&#39;s thread. (requires <code>submit</code> scope)</li>
+<li>the fullname of a Comment: a comment reply to that comment. (requires <code>submit</code> scope)</li>
+<li>the fullname of a Message: a message reply to that message. (requires <code>privatemessages</code> scope)</li>
+</ul>
+
+<p><code>text</code> should be the raw markdown body of the comment or message.</p>
+
+<p>To start a new message thread, use <a href="#POST_api_compose">/api/compose</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">text</th><td><p>raw markdown text</p>
+</td></tr><tr><th scope="row">thing_id</th><td><p><a href="#fullnames">fullname</a> of parent thing</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_del"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1491">view code</a><a href="#POST_api_del">#</a></div><h3><span class="method">POST&nbsp;</span>/api/del<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">edit</span></a></span></h3><div class="info"><div class="md"><p>Delete a Link or Comment.</p>
+</div>
+<table class="parameters"><tr><th scope="row">id</th><td><p><a href="#fullnames">fullname</a> of a thing created by the user</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_editusertext"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1975">view code</a><a href="#POST_api_editusertext">#</a></div><h3><span class="method">POST&nbsp;</span>/api/editusertext<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">edit</span></a></span></h3><div class="info"><div class="md"><p>Edit the body text of a comment or self-post.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">text</th><td><p>raw markdown text</p>
+</td></tr><tr><th scope="row">thing_id</th><td><p><a href="#fullnames">fullname</a> of a thing created by the user</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_hide"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3472">view code</a><a href="#POST_api_hide">#</a></div><h3><span class="method">POST&nbsp;</span>/api/hide<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">report</span></a></span></h3><div class="info"><div class="md"><p>Hide a link.</p>
+
+<p>This removes it from the user&#39;s default view of subreddit listings.</p>
+
+<p>See also: <a href="#POST_api_unhide">/api/unhide</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">id</th><td><p>A comma-separated list of link <a href="#fullnames">fullnames</a></p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="GET_api_info"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L173">view code</a><a href="#GET_api_info">#</a></div><h3><span class="method">GET&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/info<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span></h3><div class="info"><div class="md"><p>Return a listing of things specified by their fullnames.</p>
+
+<p>Only Links, Comments, and Subreddits are allowed.</p>
+</div>
+<table class="parameters"><tr><th scope="row">id</th><td><p>A comma-separated list of thing <a href="#fullnames">fullnames</a></p>
+</td></tr><tr><th scope="row">url</th><td><p>a valid URL</p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_lock"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1522">view code</a><a href="#POST_api_lock">#</a></div><h3><span class="method">POST&nbsp;</span>/api/lock<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modposts</span></a></span></h3><div class="info"><div class="md"><p>Lock a link.</p>
+
+<p>Prevents a post from receiving new comments.</p>
+
+<p>See also: <a href="#POST_api_unlock">/api/unlock</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">id</th><td><p><a href="#fullnames">fullname</a> of a link</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_marknsfw"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1568">view code</a><a href="#POST_api_marknsfw">#</a></div><h3><span class="method">POST&nbsp;</span>/api/marknsfw<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modposts</span></a></span></h3><div class="info"><div class="md"><p>Mark a link NSFW.</p>
+
+<p>See also: <a href="#POST_api_unmarknsfw">/api/unmarknsfw</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">id</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="GET_api_morechildren"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3535">view code</a><a href="#GET_api_morechildren">#</a></div><h3><span class="method">GET&nbsp;</span>/api/morechildren<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span></h3><div class="info"><div class="md"><p>Retrieve additional comments omitted from a base comment tree.</p>
+
+<p>When a comment tree is rendered, the most relevant comments are
+selected for display first. Remaining comments are stubbed out with
+&quot;MoreComments&quot; links. This API call is used to retrieve the additional
+comments represented by those stubs, up to 20 at a time.</p>
+
+<p>The two core parameters required are <code>link</code> and <code>children</code>.  <code>link</code> is
+the fullname of the link whose comments are being fetched. <code>children</code>
+is a comma-delimited list of comment ID36s that need to be fetched.</p>
+
+<p>If <code>id</code> is passed, it should be the ID of the MoreComments object this
+call is replacing. This is needed only for the HTML UI&#39;s purposes and
+is optional otherwise.</p>
+
+<p><strong>NOTE:</strong> you may only make one request at a time to this API endpoint.
+Higher concurrency will result in an error being returned.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">children</th><td><p>a comma-delimited list of comment ID36s</p>
+</td></tr><tr><th scope="row">id</th><td><p>(optional) id of the associated MoreChildren object</p>
+</td></tr><tr><th scope="row">link_id</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">sort</th><td><p>one of (<code>confidence</code>, <code>top</code>, <code>new</code>, <code>controversial</code>, <code>old</code>, <code>random</code>, <code>qa</code>)</p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_report"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1749">view code</a><a href="#POST_api_report">#</a></div><h3><span class="method">POST&nbsp;</span>/api/report<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">report</span></a></span></h3><div class="info"><div class="md"><p>Report a link, comment or message.</p>
+
+<p>Reporting a thing brings it to the attention of the subreddit&#39;s
+moderators. Reporting a message sends it to a system for admin review.</p>
+
+<p>For links and comments, the thing is implicitly hidden as well (see
+<a href="#POST_api_hide">/api/hide</a> for details).</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">other_reason</th><td><p>a string no longer than 100 characters</p>
+</td></tr><tr><th scope="row">reason</th><td><p>a string no longer than 100 characters</p>
+</td></tr><tr><th scope="row">site_reason</th><td><p>a string no longer than 100 characters</p>
+</td></tr><tr><th scope="row">thing_id</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_save"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3340">view code</a><a href="#POST_api_save">#</a></div><h3><span class="method">POST&nbsp;</span>/api/save<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">save</span></a></span></h3><div class="info"><div class="md"><p>Save a link or comment.</p>
+
+<p>Saved things are kept in the user&#39;s saved listing for later perusal.</p>
+
+<p>See also: <a href="#POST_api_unsave">/api/unsave</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">category</th><td><p>a category name</p>
+</td></tr><tr><th scope="row">id</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="GET_api_saved_categories"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3323">view code</a><a href="#GET_api_saved_categories">#</a></div><h3><span class="method">GET&nbsp;</span>/api/saved_categories<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">save</span></a></span></h3><div class="info"><div class="md"><p>Get a list of categories in which things are currently saved.</p>
+
+<p>See also: <a href="#POST_api_save">/api/save</a>.</p>
+</div>
+</div></div><div class="endpoint" id="POST_api_sendreplies"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1619">view code</a><a href="#POST_api_sendreplies">#</a></div><h3><span class="method">POST&nbsp;</span>/api/sendreplies<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">edit</span></a></span></h3><div class="info"><div class="md"><p>Enable or disable inbox replies for a link or comment.</p>
+
+<p><code>state</code> is a boolean that indicates whether you are enabling or
+disabling inbox replies - true to enable, false to disable.</p>
+</div>
+<table class="parameters"><tr><th scope="row">id</th><td><p><a href="#fullnames">fullname</a> of a thing created by the user</p>
+</td></tr><tr><th scope="row">state</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_set_contest_mode"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1680">view code</a><a href="#POST_api_set_contest_mode">#</a></div><h3><span class="method">POST&nbsp;</span>/api/set_contest_mode<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modposts</span></a></span></h3><div class="info"><div class="md"><p>Set or unset &quot;contest mode&quot; for a link&#39;s comments.</p>
+
+<p><code>state</code> is a boolean that indicates whether you are enabling or
+disabling contest mode - true to enable, false to disable.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">id</th><td></td></tr><tr><th scope="row">state</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_set_subreddit_sticky"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1706">view code</a><a href="#POST_api_set_subreddit_sticky">#</a></div><h3><span class="method">POST&nbsp;</span>/api/set_subreddit_sticky<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modposts</span></a></span></h3><div class="info"><div class="md"><p>Set or unset a Link as the sticky in its subreddit.</p>
+
+<p><code>state</code> is a boolean that indicates whether to sticky or unsticky
+this post - true to sticky, false to unsticky.</p>
+
+<p>The <code>num</code> argument is optional, and only used when stickying a post.
+It allows specifying a particular &quot;slot&quot; to sticky the post into, and
+if there is already a post stickied in that slot it will be replaced.
+If there is no post in the specified slot to replace, or <code>num</code> is None,
+the bottom-most slot will be used.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">id</th><td></td></tr><tr><th scope="row">num</th><td><p>an integer between 1 and 2</p>
+</td></tr><tr><th scope="row">state</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_set_suggested_sort"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1654">view code</a><a href="#POST_api_set_suggested_sort">#</a></div><h3><span class="method">POST&nbsp;</span>/api/set_suggested_sort<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modposts</span></a></span></h3><div class="info"><div class="md"><p>Set a suggested sort for a link.</p>
+
+<p>Suggested sorts are useful to display comments in a certain preferred way
+for posts. For example, casual conversation may be better sorted by new
+by default, or AMAs may be sorted by Q&amp;A. A sort of an empty string
+clears the default sort.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">id</th><td></td></tr><tr><th scope="row">sort</th><td><p>one of (<code>confidence</code>, <code>top</code>, <code>new</code>, <code>controversial</code>, <code>old</code>, <code>random</code>, <code>qa</code>, <code>blank</code>)</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_store_visits"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L5090">view code</a><a href="#POST_api_store_visits">#</a></div><h3><span class="method">POST&nbsp;</span>/api/store_visits<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">save</span></a></span></h3><div class="info"><div class="md"><p><em>Requires a subscription to <a href="/gold/about">reddit gold</a></em></p>
+</div>
+<table class="parameters"><tr><th scope="row">links</th><td><p>A comma-separated list of link <a href="#fullnames">fullnames</a></p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_submit"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L438">view code</a><a href="#POST_api_submit">#</a></div><h3><span class="method">POST&nbsp;</span>/api/submit<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">submit</span></a></span></h3><div class="info"><div class="md"><p>Submit a link to a subreddit.</p>
+
+<p>Submit will create a link or self-post in the subreddit <code>sr</code> with the
+title <code>title</code>. If <code>kind</code> is <code>&quot;link&quot;</code>, then <code>url</code> is expected to be a
+valid URL to link to. Otherwise, <code>text</code>, if present, will be the
+body of the self-post.</p>
+
+<p>If a link with the same URL has already been submitted to the specified
+subreddit an error will be returned unless <code>resubmit</code> is true.
+<code>extension</code> is used for determining which view-type (e.g. <code>json</code>,
+<code>compact</code> etc.) to use for the redirect that is generated if the
+<code>resubmit</code> error occurs.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">captcha</th><td><p>the user&#39;s response to the CAPTCHA challenge</p>
+</td></tr><tr><th scope="row">extension</th><td><p>extension used for redirects</p>
+</td></tr><tr><th scope="row">iden</th><td><p>the identifier of the CAPTCHA challenge</p>
+</td></tr><tr><th scope="row">kind</th><td><p>one of (<code>link</code>, <code>self</code>)</p>
+</td></tr><tr><th scope="row">resubmit</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">sendreplies</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">sr</th><td><p>name of a subreddit</p>
+</td></tr><tr><th scope="row">text</th><td><p>raw markdown text</p>
+</td></tr><tr><th scope="row">title</th><td><p>title of the submission. up to 300 characters long</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr><tr><th scope="row">url</th><td><p>a valid URL</p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_unhide"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3490">view code</a><a href="#POST_api_unhide">#</a></div><h3><span class="method">POST&nbsp;</span>/api/unhide<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">report</span></a></span></h3><div class="info"><div class="md"><p>Unhide a link.</p>
+
+<p>See also: <a href="#POST_api_hide">/api/hide</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">id</th><td><p>A comma-separated list of link <a href="#fullnames">fullnames</a></p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_unlock"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1545">view code</a><a href="#POST_api_unlock">#</a></div><h3><span class="method">POST&nbsp;</span>/api/unlock<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modposts</span></a></span></h3><div class="info"><div class="md"><p>Unlock a link.</p>
+
+<p>Allow a post to receive new comments.</p>
+
+<p>See also: <a href="#POST_api_lock">/api/lock</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">id</th><td><p><a href="#fullnames">fullname</a> of a link</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_unmarknsfw"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1589">view code</a><a href="#POST_api_unmarknsfw">#</a></div><h3><span class="method">POST&nbsp;</span>/api/unmarknsfw<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modposts</span></a></span></h3><div class="info"><div class="md"><p>Remove the NSFW marking from a link.</p>
+
+<p>See also: <a href="#POST_api_marknsfw">/api/marknsfw</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">id</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_unsave"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3367">view code</a><a href="#POST_api_unsave">#</a></div><h3><span class="method">POST&nbsp;</span>/api/unsave<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">save</span></a></span></h3><div class="info"><div class="md"><p>Unsave a link or comment.</p>
+
+<p>This removes the thing from the user&#39;s saved listings as well.</p>
+
+<p>See also: <a href="#POST_api_save">/api/save</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">id</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_vote"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L2308">view code</a><a href="#POST_api_vote">#</a></div><h3><span class="method">POST&nbsp;</span>/api/vote<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">vote</span></a></span></h3><div class="info"><div class="md"><p>Cast a vote on a thing.</p>
+
+<p><code>id</code> should be the fullname of the Link or Comment to vote on.</p>
+
+<p><code>dir</code> indicates the direction of the vote. Voting <code>1</code> is an upvote,
+<code>-1</code> is a downvote, and <code>0</code> is equivalent to &quot;un-voting&quot; by clicking
+again on a highlighted arrow.</p>
+
+<p><strong>Note: votes must be cast by humans.</strong> That is, API clients proxying a
+human&#39;s action one-for-one are OK, but bots deciding how to vote on
+content or amplifying a human&#39;s vote are not. See <a href="/rules">the reddit
+rules</a> for more details on what constitutes vote cheating.</p>
+</div>
+<table class="parameters"><tr><th scope="row">dir</th><td><p>vote direction. one of (1, 0, -1)</p>
+</td></tr><tr><th scope="row">id</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">rank</th><td><p>an integer greater than 1</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><h2 id="section_listings">listings</h2><div class="endpoint" id="GET_by_id_{names}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L715">view code</a><a href="#GET_by_id_{names}">#</a></div><h3><span class="method">GET&nbsp;</span>/by_id/<em class="placeholder">names</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span></h3><div class="info"><div class="md"><p>Get a listing of links by fullname.</p>
+
+<p><code>names</code> is a list of fullnames for links separated by commas or spaces.</p>
+</div>
+<table class="parameters"><tr><th scope="row">names</th><td><p>A comma-separated list of link <a href="#fullnames">fullnames</a></p>
+</td></tr></table></div></div><div class="endpoint" id="GET_comments_{article}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L214">view code</a><a href="#GET_comments_{article}">#</a></div><h3><span class="method">GET&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/comments/<em class="placeholder">article</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span><a href="https://www.reddit.com/wiki/rss"><span class="api-badge rss-support">rss support</span></a></h3><div class="info"><div class="md"><p>Get the comment tree for a given Link <code>article</code>.</p>
+
+<p>If supplied, <code>comment</code> is the ID36 of a comment in the comment tree for
+<code>article</code>. This comment will be the (highlighted) focal point of the
+returned view and <code>context</code> will be the number of parents shown.</p>
+
+<p><code>depth</code> is the maximum depth of subtrees in the thread.</p>
+
+<p><code>limit</code> is the maximum number of comments to return.</p>
+
+<p>See also: <a href="#GET_api_morechildren">/api/morechildren</a> and
+<a href="#POST_api_comment">/api/comment</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">article</th><td><p>ID36 of a link</p>
+</td></tr><tr><th scope="row">comment</th><td><p>(optional) ID36 of a comment</p>
+</td></tr><tr><th scope="row">context</th><td><p>an integer between 0 and 8</p>
+</td></tr><tr><th scope="row">depth</th><td><p>(optional) an integer</p>
+</td></tr><tr><th scope="row">limit</th><td><p>(optional) an integer</p>
+</td></tr><tr><th scope="row">showedits</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">showmore</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">sort</th><td><p>one of (<code>confidence</code>, <code>top</code>, <code>new</code>, <code>controversial</code>, <code>old</code>, <code>random</code>, <code>qa</code>)</p>
+</td></tr><tr><th scope="row">sr_detail</th><td><p>(optional) expand subreddits</p>
+</td></tr></table></div></div><div class="endpoint" id="GET_duplicates_{article}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L1004">view code</a><a href="#GET_duplicates_{article}">#</a></div><h3><span class="method">GET&nbsp;</span>/duplicates/<em class="placeholder">article</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span><a href="https://www.reddit.com/wiki/rss"><span class="api-badge rss-support">rss support</span></a></h3><div class="info"><div class="md"><p>Return a list of other submissions of the same URL</p>
+
+<p><em>This endpoint is <a href="#listings">a listing</a>.</em></p>
+</div>
+<table class="parameters"><tr><th scope="row">after</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">article</th><td><p>The base 36 ID of a Link</p>
+</td></tr><tr><th scope="row">before</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">count</th><td><p>a positive integer (default: 0)</p>
+</td></tr><tr><th scope="row">limit</th><td><p>the maximum number of items desired (default: 25, maximum: 100)</p>
+</td></tr><tr><th scope="row">show</th><td><p>(optional) the string <code>all</code></p>
+</td></tr><tr><th scope="row">sr_detail</th><td><p>(optional) expand subreddits</p>
+</td></tr></table></div></div><div class="endpoint" id="GET_hot"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L543">view code</a><a href="#GET_hot">#</a></div><h3><span class="method">GET&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/hot<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span><a href="https://www.reddit.com/wiki/rss"><span class="api-badge rss-support">rss support</span></a></h3><div class="info"><div class="md"><p><em>This endpoint is <a href="#listings">a listing</a>.</em></p>
+</div>
+<table class="parameters"><tr class="base-param"><th scope="row">after</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr class="base-param"><th scope="row">before</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr class="base-param"><th scope="row">count</th><td><p>a positive integer (default: 0)</p>
+</td></tr><tr class="base-param"><th scope="row">limit</th><td><p>the maximum number of items desired (default: 25, maximum: 100)</p>
+</td></tr><tr class="base-param"><th scope="row">show</th><td><p>(optional) the string <code>all</code></p>
+</td></tr><tr class="base-param"><th scope="row">sr_detail</th><td><p>(optional) expand subreddits</p>
+</td></tr></table></div></div><div class="endpoint" id="GET_new"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L572">view code</a><a href="#GET_new">#</a></div><h3><span class="method">GET&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/new<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span><a href="https://www.reddit.com/wiki/rss"><span class="api-badge rss-support">rss support</span></a></h3><div class="info"><div class="md"><p><em>This endpoint is <a href="#listings">a listing</a>.</em></p>
+</div>
+<table class="parameters"><tr class="base-param"><th scope="row">after</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr class="base-param"><th scope="row">before</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr class="base-param"><th scope="row">count</th><td><p>a positive integer (default: 0)</p>
+</td></tr><tr class="base-param"><th scope="row">limit</th><td><p>the maximum number of items desired (default: 25, maximum: 100)</p>
+</td></tr><tr class="base-param"><th scope="row">show</th><td><p>(optional) the string <code>all</code></p>
+</td></tr><tr class="base-param"><th scope="row">sr_detail</th><td><p>(optional) expand subreddits</p>
+</td></tr></table></div></div><div class="endpoint" id="GET_random"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L128">view code</a><a href="#GET_random">#</a></div><h3><span class="method">GET&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/random<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span></h3><div class="info"><div class="md"><p>The Serendipity button</p>
+</div>
+</div></div><div class="endpoint" id="GET_{sort}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L625">view code</a><a href="#GET_{sort}">#</a></div><h3><span class="method">GET&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/<em class="placeholder">sort</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span><a href="https://www.reddit.com/wiki/rss"><span class="api-badge rss-support">rss support</span></a></h3><ul class="uri-variants"><li id="GET_top">&rarr; [/r/<em class="placeholder">subreddit</em>]/top</li><li id="GET_controversial">&rarr; [/r/<em class="placeholder">subreddit</em>]/controversial</li></ul><div class="info"><div class="md"><p><em>This endpoint is <a href="#listings">a listing</a>.</em></p>
+</div>
+<table class="parameters"><tr><th scope="row">t</th><td><p>one of (<code>hour</code>, <code>day</code>, <code>week</code>, <code>month</code>, <code>year</code>, <code>all</code>)</p>
+</td></tr><tr class="base-param"><th scope="row">after</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr class="base-param"><th scope="row">before</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr class="base-param"><th scope="row">count</th><td><p>a positive integer (default: 0)</p>
+</td></tr><tr class="base-param"><th scope="row">limit</th><td><p>the maximum number of items desired (default: 25, maximum: 100)</p>
+</td></tr><tr class="base-param"><th scope="row">show</th><td><p>(optional) the string <code>all</code></p>
+</td></tr><tr class="base-param"><th scope="row">sr_detail</th><td><p>(optional) expand subreddits</p>
+</td></tr></table></div></div><h2 id="section_live">live threads</h2><div class="description"><div class="md"><p>Real-time updates on reddit.</p>
+
+<p>In addition to the standard reddit API, WebSockets play a huge role in reddit
+live. Receiving push notification of changes to the thread via websockets is
+much better than polling the thread repeatedly.</p>
+
+<p>To connect to the websocket server, fetch
+<a href="#GET_live_%7Bthread%7D_about.json">/live/<em>thread</em>/about.json</a> and get the
+<code>websocket_url</code> field.  The websocket URL expires after a period of time; if it
+does, fetch a new one from that endpoint.</p>
+
+<p>Once connected to the socket, a variety of messages can come in. All messages
+will be in text frames containing a JSON object with two keys: <code>type</code> and
+<code>payload</code>. Live threads can send messages with many <code>type</code>s:</p>
+
+<ul>
+<li><code>update</code> - a new update has been posted in the thread. the <code>payload</code> contains
+the JSON representation of the update.</li>
+<li><code>activity</code> - periodic update of the viewer counts for the thread.</li>
+<li><code>settings</code> - the thread&#39;s settings have changed. the <code>payload</code> is an object
+with each key being a property of the thread (as in <code>about.json</code>) and its new
+value.</li>
+<li><code>delete</code> - an update has been deleted (removed from the thread).
+the <code>payload</code> is the ID of the deleted update.</li>
+<li><code>strike</code> - an update has been stricken (marked incorrect and crossed out).
+the <code>payload</code> is the ID of the stricken update.</li>
+<li><code>embeds_ready</code> - a previously posted update has been parsed and embedded
+media is available for it now. the <code>payload</code> contains a <code>liveupdate_id</code> and
+list of <code>embeds</code> to add to it.</li>
+<li><code>complete</code> - the thread has been marked complete. no further updates will
+be sent.</li>
+</ul>
+
+<p>See <a href="/r/live">/r/live</a> for more information.</p>
+</div>
+</div><div class="endpoint" id="POST_api_live_create"><div class="links"><a href="https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L1015">view code</a><a href="#POST_api_live_create">#</a></div><h3><span class="method">POST&nbsp;</span>/api/live/create<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">submit</span></a></span></h3><div class="info"><div class="md"><p>Create a new live thread.</p>
+
+<p>Once created, the initial settings can be modified with
+<a href="#POST_api_live_%7Bthread%7D_edit">/api/live/<em>thread</em>/edit</a> and new updates
+can be posted with
+<a href="#POST_api_live_%7Bthread%7D_update">/api/live/<em>thread</em>/update</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">description</th><td><p>raw markdown text</p>
+</td></tr><tr><th scope="row">nsfw</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">resources</th><td><p>raw markdown text</p>
+</td></tr><tr><th scope="row">title</th><td><p>a string no longer than 120 characters</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_live_{thread}_accept_contributor_invite"><div class="links"><a href="https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L620">view code</a><a href="#POST_api_live_{thread}_accept_contributor_invite">#</a></div><h3><span class="method">POST&nbsp;</span>/api/live/<em class="placeholder">thread</em>/accept_contributor_invite<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">livemanage</span></a></span></h3><div class="info"><div class="md"><p>Accept a pending invitation to contribute to the thread.</p>
+
+<p>See also: <a href="#POST_api_live_%7Bthread%7D_leave_contributor">/api/live/<em>thread</em>/leave_contributor</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_live_{thread}_close_thread"><div class="links"><a href="https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L828">view code</a><a href="#POST_api_live_{thread}_close_thread">#</a></div><h3><span class="method">POST&nbsp;</span>/api/live/<em class="placeholder">thread</em>/close_thread<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">livemanage</span></a></span></h3><div class="info"><div class="md"><p>Permanently close the thread, disallowing future updates.</p>
+
+<p>Requires the <code>close</code> permission for this thread.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_live_{thread}_delete_update"><div class="links"><a href="https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L770">view code</a><a href="#POST_api_live_{thread}_delete_update">#</a></div><h3><span class="method">POST&nbsp;</span>/api/live/<em class="placeholder">thread</em>/delete_update<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">edit</span></a></span></h3><div class="info"><div class="md"><p>Delete an update from the thread.</p>
+
+<p>Requires that specified update must have been authored by the user or
+that you have the <code>edit</code> permission for this thread.</p>
+
+<p>See also: <a href="#POST_api_live_%7Bthread%7D_update">/api/live/<em>thread</em>/update</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">id</th><td><p>the ID of a single update. e.g. <code>LiveUpdate_ff87068e-a126-11e3-9f93-12313b0b3603</code></p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_live_{thread}_edit"><div class="links"><a href="https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L427">view code</a><a href="#POST_api_live_{thread}_edit">#</a></div><h3><span class="method">POST&nbsp;</span>/api/live/<em class="placeholder">thread</em>/edit<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">livemanage</span></a></span></h3><div class="info"><div class="md"><p>Configure the thread.</p>
+
+<p>Requires the <code>settings</code> permission for this thread.</p>
+
+<p>See also: <a href="#GET_live_%7Bthread%7D_about.json">/live/<em>thread</em>/about.json</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">description</th><td><p>raw markdown text</p>
+</td></tr><tr><th scope="row">nsfw</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">resources</th><td><p>raw markdown text</p>
+</td></tr><tr><th scope="row">title</th><td><p>a string no longer than 120 characters</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_live_{thread}_invite_contributor"><div class="links"><a href="https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L517">view code</a><a href="#POST_api_live_{thread}_invite_contributor">#</a></div><h3><span class="method">POST&nbsp;</span>/api/live/<em class="placeholder">thread</em>/invite_contributor<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">livemanage</span></a></span></h3><div class="info"><div class="md"><p>Invite another user to contribute to the thread.</p>
+
+<p>Requires the <code>manage</code> permission for this thread.  If the recipient
+accepts the invite, they will be granted the permissions specified.</p>
+
+<p>See also: <a href="#POST_api_live_%7Bthread%7D_accept_contributor_invite">/api/live/<em>thread</em>/accept_contributor_invite</a>, and
+<a href="#POST_api_live_%7Bthread%7D_rm_contributor_invite">/api/live/<em>thread</em>/rm_contributor_invite</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">name</th><td><p>the name of an existing user</p>
+</td></tr><tr><th scope="row">permissions</th><td><p>permission description e.g. <code>+update,+edit,-manage</code></p>
+</td></tr><tr><th scope="row">type</th><td><p>one of (<code>liveupdate_contributor_invite</code>, <code>liveupdate_contributor</code>)</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_live_{thread}_leave_contributor"><div class="links"><a href="https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L580">view code</a><a href="#POST_api_live_{thread}_leave_contributor">#</a></div><h3><span class="method">POST&nbsp;</span>/api/live/<em class="placeholder">thread</em>/leave_contributor<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">livemanage</span></a></span></h3><div class="info"><div class="md"><p>Abdicate contributorship of the thread.</p>
+
+<p>See also: <a href="#POST_api_live_%7Bthread%7D_accept_contributor_invite">/api/live/<em>thread</em>/accept_contributor_invite</a>, and
+<a href="#POST_api_live_%7Bthread%7D_invite_contributor">/api/live/<em>thread</em>/invite_contributor</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_live_{thread}_report"><div class="links"><a href="https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L851">view code</a><a href="#POST_api_live_{thread}_report">#</a></div><h3><span class="method">POST&nbsp;</span>/api/live/<em class="placeholder">thread</em>/report<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">report</span></a></span></h3><div class="info"><div class="md"><p>Report the thread for violating the rules of reddit.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">type</th><td><p>one of (<code>spam</code>, <code>vote-manipulation</code>, <code>personal-information</code>, <code>sexualizing-minors</code>, <code>site-breaking</code>)</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_live_{thread}_rm_contributor"><div class="links"><a href="https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L702">view code</a><a href="#POST_api_live_{thread}_rm_contributor">#</a></div><h3><span class="method">POST&nbsp;</span>/api/live/<em class="placeholder">thread</em>/rm_contributor<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">livemanage</span></a></span></h3><div class="info"><div class="md"><p>Revoke another user&#39;s contributorship.</p>
+
+<p>Requires the <code>manage</code> permission for this thread.</p>
+
+<p>See also: <a href="#POST_api_live_%7Bthread%7D_invite_contributor">/api/live/<em>thread</em>/invite_contributor</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">id</th><td><p><a href="#fullnames">fullname</a> of a account</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_live_{thread}_rm_contributor_invite"><div class="links"><a href="https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L599">view code</a><a href="#POST_api_live_{thread}_rm_contributor_invite">#</a></div><h3><span class="method">POST&nbsp;</span>/api/live/<em class="placeholder">thread</em>/rm_contributor_invite<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">livemanage</span></a></span></h3><div class="info"><div class="md"><p>Revoke an outstanding contributor invite.</p>
+
+<p>Requires the <code>manage</code> permission for this thread.</p>
+
+<p>See also: <a href="#POST_api_live_%7Bthread%7D_invite_contributor">/api/live/<em>thread</em>/invite_contributor</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">id</th><td><p><a href="#fullnames">fullname</a> of a account</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_live_{thread}_set_contributor_permissions"><div class="links"><a href="https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L649">view code</a><a href="#POST_api_live_{thread}_set_contributor_permissions">#</a></div><h3><span class="method">POST&nbsp;</span>/api/live/<em class="placeholder">thread</em>/set_contributor_permissions<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">livemanage</span></a></span></h3><div class="info"><div class="md"><p>Change a contributor or contributor invite&#39;s permissions.</p>
+
+<p>Requires the <code>manage</code> permission for this thread.</p>
+
+<p>See also: <a href="#POST_api_live_%7Bthread%7D_invite_contributor">/api/live/<em>thread</em>/invite_contributor</a> and
+<a href="#POST_api_live_%7Bthread%7D_rm_contributor">/api/live/<em>thread</em>/rm_contributor</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">name</th><td><p>the name of an existing user</p>
+</td></tr><tr><th scope="row">permissions</th><td><p>permission description e.g. <code>+update,+edit,-manage</code></p>
+</td></tr><tr><th scope="row">type</th><td><p>one of (<code>liveupdate_contributor_invite</code>, <code>liveupdate_contributor</code>)</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_live_{thread}_strike_update"><div class="links"><a href="https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L799">view code</a><a href="#POST_api_live_{thread}_strike_update">#</a></div><h3><span class="method">POST&nbsp;</span>/api/live/<em class="placeholder">thread</em>/strike_update<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">edit</span></a></span></h3><div class="info"><div class="md"><p>Strike (mark incorrect and cross out) the content of an update.</p>
+
+<p>Requires that specified update must have been authored by the user or
+that you have the <code>edit</code> permission for this thread.</p>
+
+<p>See also: <a href="#POST_api_live_%7Bthread%7D_update">/api/live/<em>thread</em>/update</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">id</th><td><p>the ID of a single update. e.g. <code>LiveUpdate_ff87068e-a126-11e3-9f93-12313b0b3603</code></p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_live_{thread}_update"><div class="links"><a href="https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L722">view code</a><a href="#POST_api_live_{thread}_update">#</a></div><h3><span class="method">POST&nbsp;</span>/api/live/<em class="placeholder">thread</em>/update<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">submit</span></a></span></h3><div class="info"><div class="md"><p>Post an update to the thread.</p>
+
+<p>Requires the <code>update</code> permission for this thread.</p>
+
+<p>See also: <a href="#POST_api_live_%7Bthread%7D_strike_update">/api/live/<em>thread</em>/strike_update</a>, and
+<a href="#POST_api_live_%7Bthread%7D_delete_update">/api/live/<em>thread</em>/delete_update</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">body</th><td><p>raw markdown text</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="GET_live_{thread}"><div class="links"><a href="https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L259">view code</a><a href="#GET_live_{thread}">#</a></div><h3><span class="method">GET&nbsp;</span>/live/<em class="placeholder">thread</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span><a href="https://www.reddit.com/wiki/rss"><span class="api-badge rss-support">rss support</span></a></h3><div class="info"><div class="md"><p>Get a list of updates posted in this thread.</p>
+
+<p>See also: <a href="#POST_api_live_%7Bthread%7D_update">/api/live/<em>thread</em>/update</a>.</p>
+
+<p><em>This endpoint is <a href="#listings">a listing</a>.</em></p>
+</div>
+<table class="parameters"><tr><th scope="row">after</th><td><p>the ID of a single update. e.g. <code>LiveUpdate_ff87068e-a126-11e3-9f93-12313b0b3603</code></p>
+</td></tr><tr><th scope="row">before</th><td><p>the ID of a single update. e.g. <code>LiveUpdate_ff87068e-a126-11e3-9f93-12313b0b3603</code></p>
+</td></tr><tr><th scope="row">count</th><td><p>a positive integer (default: 0)</p>
+</td></tr><tr><th scope="row">is_embed</th><td><p>(internal use only)</p>
+</td></tr><tr><th scope="row">limit</th><td><p>the maximum number of items desired (default: 25, maximum: 100)</p>
+</td></tr><tr><th scope="row">stylesr</th><td><p>subreddit name</p>
+</td></tr></table></div></div><div class="endpoint" id="GET_live_{thread}_about"><div class="links"><a href="https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L382">view code</a><a href="#GET_live_{thread}_about">#</a></div><h3><span class="method">GET&nbsp;</span>/live/<em class="placeholder">thread</em>/about<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span></h3><div class="info"><div class="md"><p>Get some basic information about the live thread.</p>
+
+<p>See also: <a href="#POST_api_live_%7Bthread%7D_edit">/api/live/<em>thread</em>/edit</a>.</p>
+</div>
+</div></div><div class="endpoint" id="GET_live_{thread}_contributors"><div class="links"><a href="https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L472">view code</a><a href="#GET_live_{thread}_contributors">#</a></div><h3><span class="method">GET&nbsp;</span>/live/<em class="placeholder">thread</em>/contributors<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span></h3><div class="info"><div class="md"><p>Get a list of users that contribute to this thread.</p>
+
+<p>See also: <a href="#POST_api_live_%7Bthread%7D_invite_contributor">/api/live/<em>thread</em>/invite_contributor</a>, and
+<a href="#POST_api_live_%7Bthread%7D_rm_contributor">/api/live/<em>thread</em>/rm_contributor</a>.</p>
+</div>
+</div></div><div class="endpoint" id="GET_live_{thread}_discussions"><div class="links"><a href="https://github.com/reddit/reddit-plugin-liveupdate/blob/master/reddit_liveupdate/controllers.py#L398">view code</a><a href="#GET_live_{thread}_discussions">#</a></div><h3><span class="method">GET&nbsp;</span>/live/<em class="placeholder">thread</em>/discussions<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span><a href="https://www.reddit.com/wiki/rss"><span class="api-badge rss-support">rss support</span></a></h3><div class="info"><div class="md"><p>Get a list of reddit submissions linking to this thread.</p>
+
+<p><em>This endpoint is <a href="#listings">a listing</a>.</em></p>
+</div>
+<table class="parameters"><tr><th scope="row">after</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">before</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">count</th><td><p>a positive integer (default: 0)</p>
+</td></tr><tr><th scope="row">limit</th><td><p>the maximum number of items desired (default: 25, maximum: 100)</p>
+</td></tr><tr><th scope="row">show</th><td><p>(optional) the string <code>all</code></p>
+</td></tr><tr><th scope="row">sr_detail</th><td><p>(optional) expand subreddits</p>
+</td></tr></table></div></div><h2 id="section_messages">private messages</h2><div class="endpoint" id="POST_api_block"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1842">view code</a><a href="#POST_api_block">#</a></div><h3><span class="method">POST&nbsp;</span>/api/block<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">privatemessages</span></a></span></h3><div class="info"><div class="md"><p>For blocking via inbox.</p>
+</div>
+<table class="parameters"><tr><th scope="row">id</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_collapse_message"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3403">view code</a><a href="#POST_api_collapse_message">#</a></div><h3><span class="method">POST&nbsp;</span>/api/collapse_message</h3><div class="info"><div class="md"><p>Collapse a message</p>
+
+<p>See also: <a href="#POST_uncollapse_message">/api/uncollapse_message</a></p>
+</div>
+<table class="parameters"><tr><th scope="row">id</th><td><p>A comma-separated list of thing <a href="#fullnames">fullnames</a></p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_compose"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L345">view code</a><a href="#POST_api_compose">#</a></div><h3><span class="method">POST&nbsp;</span>/api/compose<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">privatemessages</span></a></span></h3><div class="info"><div class="md"><p>Handles message composition under /message/compose.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">captcha</th><td><p>the user&#39;s response to the CAPTCHA challenge</p>
+</td></tr><tr><th scope="row">from_sr</th><td><p>subreddit name</p>
+</td></tr><tr><th scope="row">iden</th><td><p>the identifier of the CAPTCHA challenge</p>
+</td></tr><tr><th scope="row">subject</th><td><p>a string no longer than 100 characters</p>
+</td></tr><tr><th scope="row">text</th><td><p>raw markdown text</p>
+</td></tr><tr><th scope="row">to</th><td><p>the name of an existing user</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_read_all_messages"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3455">view code</a><a href="#POST_api_read_all_messages">#</a></div><h3><span class="method">POST&nbsp;</span>/api/read_all_messages<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">privatemessages</span></a></span></h3><div class="info"><div class="md"><p>Queue up marking all messages for a user as read.</p>
+
+<p>This may take some time, and returns 202 to acknowledge acceptance of
+the request.</p>
+</div>
+<table class="parameters"><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_read_message"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3441">view code</a><a href="#POST_api_read_message">#</a></div><h3><span class="method">POST&nbsp;</span>/api/read_message<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">privatemessages</span></a></span></h3><div class="info"><table class="parameters"><tr><th scope="row">id</th><td><p>A comma-separated list of thing <a href="#fullnames">fullnames</a></p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_unblock_subreddit"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1881">view code</a><a href="#POST_api_unblock_subreddit">#</a></div><h3><span class="method">POST&nbsp;</span>/api/unblock_subreddit<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">privatemessages</span></a></span></h3><div class="info"><table class="parameters"><tr><th scope="row">id</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_uncollapse_message"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3415">view code</a><a href="#POST_api_uncollapse_message">#</a></div><h3><span class="method">POST&nbsp;</span>/api/uncollapse_message</h3><div class="info"><div class="md"><p>Uncollapse a message</p>
+
+<p>See also: <a href="#POST_collapse_message">/api/collapse_message</a></p>
+</div>
+<table class="parameters"><tr><th scope="row">id</th><td><p>A comma-separated list of thing <a href="#fullnames">fullnames</a></p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_unread_message"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3427">view code</a><a href="#POST_api_unread_message">#</a></div><h3><span class="method">POST&nbsp;</span>/api/unread_message<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">privatemessages</span></a></span></h3><div class="info"><table class="parameters"><tr><th scope="row">id</th><td><p>A comma-separated list of thing <a href="#fullnames">fullnames</a></p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="GET_message_{where}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1299">view code</a><a href="#GET_message_{where}">#</a></div><h3><span class="method">GET&nbsp;</span>/message/<em class="placeholder">where</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">privatemessages</span></a></span><a href="https://www.reddit.com/wiki/rss"><span class="api-badge rss-support">rss support</span></a></h3><ul class="uri-variants"><li id="GET_message_inbox">&rarr; /message/inbox</li><li id="GET_message_unread">&rarr; /message/unread</li><li id="GET_message_sent">&rarr; /message/sent</li></ul><div class="info"><div class="md"><p><em>This endpoint is <a href="#listings">a listing</a>.</em></p>
+</div>
+<table class="parameters"><tr><th scope="row">mark</th><td><p>one of (<code>true</code>, <code>false</code>)</p>
+</td></tr><tr><th scope="row">mid</th><td></td></tr><tr class="base-param"><th scope="row">after</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr class="base-param"><th scope="row">before</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr class="base-param"><th scope="row">count</th><td><p>a positive integer (default: 0)</p>
+</td></tr><tr class="base-param"><th scope="row">limit</th><td><p>the maximum number of items desired (default: 25, maximum: 100)</p>
+</td></tr><tr class="base-param"><th scope="row">show</th><td><p>(optional) the string <code>all</code></p>
+</td></tr><tr class="base-param"><th scope="row">sr_detail</th><td><p>(optional) expand subreddits</p>
+</td></tr></table></div></div><h2 id="section_misc">misc</h2><div class="endpoint" id="GET_api_v1_scopes"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/apiv1/scopes.py#L34">view code</a><a href="#GET_api_v1_scopes">#</a></div><h3><span class="method">GET&nbsp;</span>/api/v1/scopes<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">any</span></a></span></h3><div class="info"><div class="md"><p>Retrieve descriptions of reddit&#39;s OAuth2 scopes.</p>
+
+<p>If no scopes are given, information on all scopes are returned.</p>
+
+<p>Invalid scope(s) will result in a 400 error with body that indicates
+the invalid scope(s).</p>
+</div>
+<table class="parameters"><tr><th scope="row">scopes</th><td><p>(optional) An OAuth2 scope string</p>
+</td></tr></table></div></div><h2 id="section_moderation">moderation</h2><div class="endpoint" id="GET_about_log"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L593">view code</a><a href="#GET_about_log">#</a></div><h3><span class="method">GET&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/about/log<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modlog</span></a></span><a href="https://www.reddit.com/wiki/rss"><span class="api-badge rss-support">rss support</span></a></h3><div class="info"><div class="md"><p>Get a list of recent moderation actions.</p>
+
+<p>Moderator actions taken within a subreddit are logged. This listing is
+a view of that log with various filters to aid in analyzing the
+information.</p>
+
+<p>The optional <code>mod</code> parameter can be a comma-delimited list of moderator
+names to restrict the results to, or the string <code>a</code> to restrict the
+results to admin actions taken within the subreddit.</p>
+
+<p>The <code>type</code> parameter is optional and if sent limits the log entries
+returned to only those of the type specified.</p>
+
+<p><em>This endpoint is <a href="#listings">a listing</a>.</em></p>
+</div>
+<table class="parameters"><tr><th scope="row">after</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">before</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">count</th><td><p>a positive integer (default: 0)</p>
+</td></tr><tr><th scope="row">limit</th><td><p>the maximum number of items desired (default: 25, maximum: 500)</p>
+</td></tr><tr><th scope="row">mod</th><td><p>(optional) a moderator filter</p>
+</td></tr><tr><th scope="row">show</th><td><p>(optional) the string <code>all</code></p>
+</td></tr><tr><th scope="row">sr_detail</th><td><p>(optional) expand subreddits</p>
+</td></tr><tr><th scope="row">type</th><td><p>one of (<code>banuser</code>, <code>unbanuser</code>, <code>removelink</code>, <code>approvelink</code>, <code>removecomment</code>, <code>approvecomment</code>, <code>addmoderator</code>, <code>invitemoderator</code>, <code>uninvitemoderator</code>, <code>acceptmoderatorinvite</code>, <code>removemoderator</code>, <code>addcontributor</code>, <code>removecontributor</code>, <code>editsettings</code>, <code>editflair</code>, <code>distinguish</code>, <code>marknsfw</code>, <code>wikibanned</code>, <code>wikicontributor</code>, <code>wikiunbanned</code>, <code>wikipagelisted</code>, <code>removewikicontributor</code>, <code>wikirevise</code>, <code>wikipermlevel</code>, <code>ignorereports</code>, <code>unignorereports</code>, <code>setpermissions</code>, <code>setsuggestedsort</code>, <code>sticky</code>, <code>unsticky</code>, <code>setcontestmode</code>, <code>unsetcontestmode</code>, <code>lock</code>, <code>unlock</code>, <code>muteuser</code>, <code>unmuteuser</code>, <code>createrule</code>, <code>editrule</code>, <code>deleterule</code>)</p>
+</td></tr></table></div></div><div class="endpoint" id="GET_about_{location}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L818">view code</a><a href="#GET_about_{location}">#</a></div><h3><span class="method">GET&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/about/<em class="placeholder">location</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span></h3><ul class="uri-variants"><li id="GET_about_reports">&rarr; [/r/<em class="placeholder">subreddit</em>]/about/reports</li><li id="GET_about_spam">&rarr; [/r/<em class="placeholder">subreddit</em>]/about/spam</li><li id="GET_about_modqueue">&rarr; [/r/<em class="placeholder">subreddit</em>]/about/modqueue</li><li id="GET_about_unmoderated">&rarr; [/r/<em class="placeholder">subreddit</em>]/about/unmoderated</li><li id="GET_about_edited">&rarr; [/r/<em class="placeholder">subreddit</em>]/about/edited</li></ul><div class="info"><div class="md"><p>Return a listing of posts relevant to moderators.</p>
+
+<ul>
+<li>reports: Things that have been reported.</li>
+<li>spam: Things that have been marked as spam or otherwise removed.</li>
+<li>modqueue: Things requiring moderator review, such as reported things
+and items caught by the spam filter.</li>
+<li>unmoderated: Things that have yet to be approved/removed by a mod.</li>
+<li>edited: Things that have been edited recently.</li>
+</ul>
+
+<p>Requires the &quot;posts&quot; moderator permission for the subreddit.</p>
+
+<p><em>This endpoint is <a href="#listings">a listing</a>.</em></p>
+</div>
+<table class="parameters"><tr><th scope="row">after</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">before</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">count</th><td><p>a positive integer (default: 0)</p>
+</td></tr><tr><th scope="row">limit</th><td><p>the maximum number of items desired (default: 25, maximum: 100)</p>
+</td></tr><tr><th scope="row">location</th><td></td></tr><tr><th scope="row">only</th><td><p>one of (<code>links</code>, <code>comments</code>)</p>
+</td></tr><tr><th scope="row">show</th><td><p>(optional) the string <code>all</code></p>
+</td></tr><tr><th scope="row">sr_detail</th><td><p>(optional) expand subreddits</p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_accept_moderator_invite"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1317">view code</a><a href="#POST_api_accept_moderator_invite">#</a></div><h3><span class="method">POST&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/accept_moderator_invite<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modself</span></a></span></h3><div class="info"><div class="md"><p>Accept an invite to moderate the specified subreddit.</p>
+
+<p>The authenticated user must have been invited to moderate the subreddit
+by one of its current moderators.</p>
+
+<p>See also: <a href="#POST_api_friend">/api/friend</a> and
+<a href="#GET_subreddits_mine_%7Bwhere%7D">/subreddits/mine</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_approve"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3096">view code</a><a href="#POST_api_approve">#</a></div><h3><span class="method">POST&nbsp;</span>/api/approve<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modposts</span></a></span></h3><div class="info"><div class="md"><p>Approve a link or comment.</p>
+
+<p>If the thing was removed, it will be re-inserted into appropriate
+listings. Any reports on the approved thing will be discarded.</p>
+
+<p>See also: <a href="#POST_api_remove">/api/remove</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">id</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_distinguish"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3192">view code</a><a href="#POST_api_distinguish">#</a></div><h3><span class="method">POST&nbsp;</span>/api/distinguish<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modposts</span></a></span></h3><div class="info"><div class="md"><p>Distinguish a thing&#39;s author with a sigil.</p>
+
+<p>This can be useful to draw attention to and confirm the identity of the
+user in the context of a link or comment of theirs. The options for
+distinguish are as follows:</p>
+
+<ul>
+<li><code>yes</code> - add a moderator distinguish (<code>[M]</code>). only if the user is a
+      moderator of the subreddit the thing is in.</li>
+<li><code>no</code> - remove any distinguishes.</li>
+<li><code>admin</code> - add an admin distinguish (<code>[A]</code>). admin accounts only.</li>
+<li><code>special</code> - add a user-specific distinguish. depends on user.</li>
+</ul>
+
+<p>The first time a top-level comment is moderator distinguished, the
+author of the link the comment is in reply to will get a notification
+in their inbox.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">how</th><td><p>one of (<code>yes</code>, <code>no</code>, <code>admin</code>, <code>special</code>)</p>
+</td></tr><tr><th scope="row">id</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_ignore_reports"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3140">view code</a><a href="#POST_api_ignore_reports">#</a></div><h3><span class="method">POST&nbsp;</span>/api/ignore_reports<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modposts</span></a></span></h3><div class="info"><div class="md"><p>Prevent future reports on a thing from causing notifications.</p>
+
+<p>Any reports made about a thing after this flag is set on it will not
+cause notifications or make the thing show up in the various moderation
+listings.</p>
+
+<p>See also: <a href="#POST_api_unignore_reports">/api/unignore_reports</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">id</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_leavecontributor"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L812">view code</a><a href="#POST_api_leavecontributor">#</a></div><h3><span class="method">POST&nbsp;</span>/api/leavecontributor<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modself</span></a></span></h3><div class="info"><div class="md"><p>Abdicate approved submitter status in a subreddit.</p>
+
+<p>See also: <a href="#POST_api_friend">/api/friend</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">id</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_leavemoderator"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L796">view code</a><a href="#POST_api_leavemoderator">#</a></div><h3><span class="method">POST&nbsp;</span>/api/leavemoderator<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modself</span></a></span></h3><div class="info"><div class="md"><p>Abdicate moderator status in a subreddit.</p>
+
+<p>See also: <a href="#POST_api_friend">/api/friend</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">id</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_mute_message_author"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1901">view code</a><a href="#POST_api_mute_message_author">#</a></div><h3><span class="method">POST&nbsp;</span>/api/mute_message_author<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modcontributors</span></a></span></h3><div class="info"><div class="md"><p>For muting user via modmail.</p>
+</div>
+<table class="parameters"><tr><th scope="row">id</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_remove"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3034">view code</a><a href="#POST_api_remove">#</a></div><h3><span class="method">POST&nbsp;</span>/api/remove<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modposts</span></a></span></h3><div class="info"><div class="md"><p>Remove a link, comment, or modmail message.</p>
+
+<p>If the thing is a link, it will be removed from all subreddit listings.
+If the thing is a comment, it will be redacted and removed from all
+subreddit comment listings.</p>
+
+<p>See also: <a href="#POST_api_approve">/api/approve</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">id</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">spam</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_unignore_reports"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3168">view code</a><a href="#POST_api_unignore_reports">#</a></div><h3><span class="method">POST&nbsp;</span>/api/unignore_reports<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modposts</span></a></span></h3><div class="info"><div class="md"><p>Allow future reports on a thing to cause notifications.</p>
+
+<p>See also: <a href="#POST_api_ignore_reports">/api/ignore_reports</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">id</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_unmute_message_author"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1945">view code</a><a href="#POST_api_unmute_message_author">#</a></div><h3><span class="method">POST&nbsp;</span>/api/unmute_message_author<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modcontributors</span></a></span></h3><div class="info"><div class="md"><p>For unmuting user via modmail.</p>
+</div>
+<table class="parameters"><tr><th scope="row">id</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="GET_stylesheet"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L556">view code</a><a href="#GET_stylesheet">#</a></div><h3><span class="method">GET&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/stylesheet<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modconfig</span></a></span></h3><div class="info"><div class="md"><p>Redirect to the subreddit&#39;s stylesheet if one exists.</p>
+
+<p>See also: <a href="#POST_api_subreddit_stylesheet">/api/subreddit_stylesheet</a>.</p>
+</div>
+</div></div><h2 id="section_multis">multis</h2><div class="endpoint" id="POST_api_multi_copy"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L285">view code</a><a href="#POST_api_multi_copy">#</a></div><h3><span class="method">POST&nbsp;</span>/api/multi/copy<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">subscribe</span></a></span></h3><div class="info"><div class="md"><p>Copy a multi.</p>
+
+<p>Responds with 409 Conflict if the target already exists.</p>
+
+<p>A &quot;copied from ...&quot; line will automatically be appended to the
+description.</p>
+</div>
+<table class="parameters"><tr><th scope="row">display_name</th><td><p>a string no longer than 50 characters</p>
+</td></tr><tr><th scope="row">from</th><td><p>multireddit url path</p>
+</td></tr><tr><th scope="row">to</th><td><p>destination multireddit url path</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="GET_api_multi_mine"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L115">view code</a><a href="#GET_api_multi_mine">#</a></div><h3><span class="method">GET&nbsp;</span>/api/multi/mine<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span></h3><div class="info"><div class="md"><p>Fetch a list of multis belonging to the current user.</p>
+</div>
+<table class="parameters"><tr><th scope="row">expand_srs</th><td><p>boolean value</p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_multi_rename"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L334">view code</a><a href="#POST_api_multi_rename">#</a></div><h3><span class="method">POST&nbsp;</span>/api/multi/rename<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">subscribe</span></a></span></h3><div class="info"><div class="md"><p>Rename a multi.</p>
+</div>
+<table class="parameters"><tr><th scope="row">display_name</th><td><p>a string no longer than 50 characters</p>
+</td></tr><tr><th scope="row">from</th><td><p>multireddit url path</p>
+</td></tr><tr><th scope="row">to</th><td><p>destination multireddit url path</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="GET_api_multi_user_{username}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L104">view code</a><a href="#GET_api_multi_user_{username}">#</a></div><h3><span class="method">GET&nbsp;</span>/api/multi/user/<em class="placeholder">username</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span></h3><div class="info"><div class="md"><p>Fetch a list of public multis belonging to <code>username</code></p>
+</div>
+<table class="parameters"><tr><th scope="row">expand_srs</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">username</th><td><p>A valid, existing reddit username</p>
+</td></tr></table></div></div><div class="endpoint" id="DELETE_api_multi_{multipath}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L255">view code</a><a href="#DELETE_api_multi_{multipath}">#</a></div><h3><span class="method">DELETE&nbsp;</span>/api/multi/<em class="placeholder">multipath</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">subscribe</span></a></span></h3><ul class="uri-variants"><li id="DELETE_api_filter_{filterpath}">&rarr; /api/filter/<em class="placeholder">filterpath</em></li></ul><div class="info"><div class="md"><p>Delete a multi.</p>
+</div>
+<table class="parameters"><tr><th scope="row">multipath</th><td><p>multireddit url path</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr><tr class="base-param"><th scope="row">expand_srs</th><td><p>boolean value</p>
+</td></tr></table></div></div><div class="endpoint" id="GET_api_multi_{multipath}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L127">view code</a><a href="#GET_api_multi_{multipath}">#</a></div><h3><span class="method">GET&nbsp;</span>/api/multi/<em class="placeholder">multipath</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span></h3><ul class="uri-variants"><li id="GET_api_filter_{filterpath}">&rarr; /api/filter/<em class="placeholder">filterpath</em></li></ul><div class="info"><div class="md"><p>Fetch a multi&#39;s data and subreddit list by name.</p>
+</div>
+<table class="parameters"><tr><th scope="row">expand_srs</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">multipath</th><td><p>multireddit url path</p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_multi_{multipath}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L199">view code</a><a href="#POST_api_multi_{multipath}">#</a></div><h3><span class="method">POST&nbsp;</span>/api/multi/<em class="placeholder">multipath</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">subscribe</span></a></span></h3><ul class="uri-variants"><li id="POST_api_filter_{filterpath}">&rarr; /api/filter/<em class="placeholder">filterpath</em></li></ul><div class="info"><div class="md"><p>Create a multi. Responds with 409 Conflict if it already exists.</p>
+</div>
+<table class="parameters"><tr><th scope="row">model</th><td><p>json data:</p>
+
+<pre><code>{
+  &quot;description_md&quot;: raw markdown text,
+  &quot;display_name&quot;: a string no longer than 50 characters,
+  &quot;icon_name&quot;: 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`),
+  &quot;key_color&quot;: a 6-digit rgb hex color, e.g. `#AABBCC`,
+  &quot;subreddits&quot;: [
+    {
+      &quot;name&quot;: subreddit name,
+    },
+    ...
+  ],
+  &quot;visibility&quot;: one of (`private`, `public`, `hidden`),
+  &quot;weighting_scheme&quot;: one of (`classic`, `fresh`),
+}
+</code></pre>
+</td></tr><tr><th scope="row">multipath</th><td><p>multireddit url path</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr><tr class="base-param"><th scope="row">expand_srs</th><td><p>boolean value</p>
+</td></tr></table></div></div><div class="endpoint" id="PUT_api_multi_{multipath}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L233">view code</a><a href="#PUT_api_multi_{multipath}">#</a></div><h3><span class="method">PUT&nbsp;</span>/api/multi/<em class="placeholder">multipath</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">subscribe</span></a></span></h3><ul class="uri-variants"><li id="PUT_api_filter_{filterpath}">&rarr; /api/filter/<em class="placeholder">filterpath</em></li></ul><div class="info"><div class="md"><p>Create or update a multi.</p>
+</div>
+<table class="parameters"><tr><th scope="row">model</th><td><p>json data:</p>
+
+<pre><code>{
+  &quot;description_md&quot;: raw markdown text,
+  &quot;display_name&quot;: a string no longer than 50 characters,
+  &quot;icon_name&quot;: 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`),
+  &quot;key_color&quot;: a 6-digit rgb hex color, e.g. `#AABBCC`,
+  &quot;subreddits&quot;: [
+    {
+      &quot;name&quot;: subreddit name,
+    },
+    ...
+  ],
+  &quot;visibility&quot;: one of (`private`, `public`, `hidden`),
+  &quot;weighting_scheme&quot;: one of (`classic`, `fresh`),
+}
+</code></pre>
+</td></tr><tr><th scope="row">multipath</th><td><p>multireddit url path</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr><tr class="base-param"><th scope="row">expand_srs</th><td><p>boolean value</p>
+</td></tr></table></div></div><div class="endpoint" id="GET_api_multi_{multipath}_description"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L427">view code</a><a href="#GET_api_multi_{multipath}_description">#</a></div><h3><span class="method">GET&nbsp;</span>/api/multi/<em class="placeholder">multipath</em>/description<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span></h3><div class="info"><div class="md"><p>Get a multi&#39;s description.</p>
+</div>
+<table class="parameters"><tr><th scope="row">multipath</th><td><p>multireddit url path</p>
+</td></tr></table></div></div><div class="endpoint" id="PUT_api_multi_{multipath}_description"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L440">view code</a><a href="#PUT_api_multi_{multipath}_description">#</a></div><h3><span class="method">PUT&nbsp;</span>/api/multi/<em class="placeholder">multipath</em>/description<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span></h3><div class="info"><div class="md"><p>Change a multi&#39;s markdown description.</p>
+</div>
+<table class="parameters"><tr><th scope="row">model</th><td><p>json data:</p>
+
+<pre><code>{
+  &quot;body_md&quot;: raw markdown text,
+}
+</code></pre>
+</td></tr><tr><th scope="row">multipath</th><td><p>multireddit url path</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="DELETE_api_multi_{multipath}_r_{srname}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L410">view code</a><a href="#DELETE_api_multi_{multipath}_r_{srname}">#</a></div><h3><span class="method">DELETE&nbsp;</span>/api/multi/<em class="placeholder">multipath</em>/r/<em class="placeholder">srname</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">subscribe</span></a></span></h3><ul class="uri-variants"><li id="DELETE_api_filter_{filterpath}_r_{srname}">&rarr; /api/filter/<em class="placeholder">filterpath</em>/r/<em class="placeholder">srname</em></li></ul><div class="info"><div class="md"><p>Remove a subreddit from a multi.</p>
+</div>
+<table class="parameters"><tr><th scope="row">multipath</th><td><p>multireddit url path</p>
+</td></tr><tr><th scope="row">srname</th><td><p>subreddit name</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="GET_api_multi_{multipath}_r_{srname}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L371">view code</a><a href="#GET_api_multi_{multipath}_r_{srname}">#</a></div><h3><span class="method">GET&nbsp;</span>/api/multi/<em class="placeholder">multipath</em>/r/<em class="placeholder">srname</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span></h3><ul class="uri-variants"><li id="GET_api_filter_{filterpath}_r_{srname}">&rarr; /api/filter/<em class="placeholder">filterpath</em>/r/<em class="placeholder">srname</em></li></ul><div class="info"><div class="md"><p>Get data about a subreddit in a multi.</p>
+</div>
+<table class="parameters"><tr><th scope="row">multipath</th><td><p>multireddit url path</p>
+</td></tr><tr><th scope="row">srname</th><td><p>subreddit name</p>
+</td></tr></table></div></div><div class="endpoint" id="PUT_api_multi_{multipath}_r_{srname}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/multi.py#L386">view code</a><a href="#PUT_api_multi_{multipath}_r_{srname}">#</a></div><h3><span class="method">PUT&nbsp;</span>/api/multi/<em class="placeholder">multipath</em>/r/<em class="placeholder">srname</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">subscribe</span></a></span></h3><ul class="uri-variants"><li id="PUT_api_filter_{filterpath}_r_{srname}">&rarr; /api/filter/<em class="placeholder">filterpath</em>/r/<em class="placeholder">srname</em></li></ul><div class="info"><div class="md"><p>Add a subreddit to a multi.</p>
+</div>
+<table class="parameters"><tr><th scope="row">model</th><td><p>json data:</p>
+
+<pre><code>{
+  &quot;name&quot;: subreddit name,
+}
+</code></pre>
+</td></tr><tr><th scope="row">multipath</th><td><p>multireddit url path</p>
+</td></tr><tr><th scope="row">srname</th><td><p>subreddit name</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><h2 id="section_search">search</h2><div class="endpoint" id="GET_search"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L1092">view code</a><a href="#GET_search">#</a></div><h3><span class="method">GET&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/search<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span><a href="https://www.reddit.com/wiki/rss"><span class="api-badge rss-support">rss support</span></a></h3><div class="info"><div class="md"><p>Search links page.</p>
+
+<p><em>This endpoint is <a href="#listings">a listing</a>.</em></p>
+</div>
+<table class="parameters"><tr><th scope="row">after</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">before</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">count</th><td><p>a positive integer (default: 0)</p>
+</td></tr><tr><th scope="row">include_facets</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">limit</th><td><p>the maximum number of items desired (default: 25, maximum: 100)</p>
+</td></tr><tr><th scope="row">q</th><td><p>a string no longer than 512 characters</p>
+</td></tr><tr><th scope="row">restrict_sr</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">show</th><td><p>(optional) the string <code>all</code></p>
+</td></tr><tr><th scope="row">sort</th><td><p>one of (<code>relevance</code>, <code>hot</code>, <code>top</code>, <code>new</code>, <code>comments</code>)</p>
+</td></tr><tr><th scope="row">sr_detail</th><td><p>(optional) expand subreddits</p>
+</td></tr><tr><th scope="row">syntax</th><td><p>one of (<code>cloudsearch</code>, <code>lucene</code>, <code>plain</code>)</p>
+</td></tr><tr><th scope="row">t</th><td><p>one of (<code>hour</code>, <code>day</code>, <code>week</code>, <code>month</code>, <code>year</code>, <code>all</code>)</p>
+</td></tr><tr><th scope="row">type</th><td><p>(optional) comma-delimited list of result types (<code>sr</code>, <code>link</code>)</p>
+</td></tr></table></div></div><h2 id="section_subreddits">subreddits</h2><div class="endpoint" id="GET_about_{where}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1855">view code</a><a href="#GET_about_{where}">#</a></div><h3><span class="method">GET&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/about/<em class="placeholder">where</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span><a href="https://www.reddit.com/wiki/rss"><span class="api-badge rss-support">rss support</span></a></h3><ul class="uri-variants"><li id="GET_about_banned">&rarr; [/r/<em class="placeholder">subreddit</em>]/about/banned</li><li id="GET_about_muted">&rarr; [/r/<em class="placeholder">subreddit</em>]/about/muted</li><li id="GET_about_wikibanned">&rarr; [/r/<em class="placeholder">subreddit</em>]/about/wikibanned</li><li id="GET_about_contributors">&rarr; [/r/<em class="placeholder">subreddit</em>]/about/contributors</li><li id="GET_about_wikicontributors">&rarr; [/r/<em class="placeholder">subreddit</em>]/about/wikicontributors</li><li id="GET_about_moderators">&rarr; [/r/<em class="placeholder">subreddit</em>]/about/moderators</li></ul><div class="info"><div class="md"><p><em>This endpoint is <a href="#listings">a listing</a>.</em></p>
+</div>
+<table class="parameters"><tr><th scope="row">after</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">before</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">count</th><td><p>a positive integer (default: 0)</p>
+</td></tr><tr><th scope="row">limit</th><td><p>the maximum number of items desired (default: 25, maximum: 100)</p>
+</td></tr><tr><th scope="row">show</th><td><p>(optional) the string <code>all</code></p>
+</td></tr><tr><th scope="row">sr_detail</th><td><p>(optional) expand subreddits</p>
+</td></tr><tr><th scope="row">user</th><td><p>A valid, existing reddit username</p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_delete_sr_banner"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L2539">view code</a><a href="#POST_api_delete_sr_banner">#</a></div><h3><span class="method">POST&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/delete_sr_banner<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modconfig</span></a></span></h3><div class="info"><div class="md"><p>Remove the subreddit&#39;s custom mobile banner.</p>
+
+<p>See also: <a href="#POST_api_upload_sr_img">/api/upload_sr_img</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_delete_sr_header"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L2479">view code</a><a href="#POST_api_delete_sr_header">#</a></div><h3><span class="method">POST&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/delete_sr_header<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modconfig</span></a></span></h3><div class="info"><div class="md"><p>Remove the subreddit&#39;s custom header image.</p>
+
+<p>The sitewide-default header image will be shown again after this call.</p>
+
+<p>See also: <a href="#POST_api_upload_sr_img">/api/upload_sr_img</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_delete_sr_icon"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L2512">view code</a><a href="#POST_api_delete_sr_icon">#</a></div><h3><span class="method">POST&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/delete_sr_icon<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modconfig</span></a></span></h3><div class="info"><div class="md"><p>Remove the subreddit&#39;s custom mobile icon.</p>
+
+<p>See also: <a href="#POST_api_upload_sr_img">/api/upload_sr_img</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_delete_sr_img"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L2447">view code</a><a href="#POST_api_delete_sr_img">#</a></div><h3><span class="method">POST&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/delete_sr_img<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modconfig</span></a></span></h3><div class="info"><div class="md"><p>Remove an image from the subreddit&#39;s custom image set.</p>
+
+<p>The image will no longer count against the subreddit&#39;s image limit.
+However, the actual image data may still be accessible for an
+unspecified amount of time. If the image is currently referenced by the
+subreddit&#39;s stylesheet, that stylesheet will no longer validate and
+won&#39;t be editable until the image reference is removed.</p>
+
+<p>See also: <a href="#POST_api_upload_sr_img">/api/upload_sr_img</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">img_name</th><td><p>a valid subreddit image name</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="GET_api_recommend_sr_{srnames}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L5046">view code</a><a href="#GET_api_recommend_sr_{srnames}">#</a></div><h3><span class="method">GET&nbsp;</span>/api/recommend/sr/<em class="placeholder">srnames</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span></h3><div class="info"><div class="md"><p>Return subreddits recommended for the given subreddit(s).</p>
+
+<p>Gets a list of subreddits recommended for <code>srnames</code>, filtering out any
+that appear in the optional <code>omit</code> param.</p>
+</div>
+<table class="parameters"><tr><th scope="row">omit</th><td><p>comma-delimited list of subreddit names</p>
+</td></tr><tr><th scope="row">srnames</th><td><p>comma-delimited list of subreddit names</p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_search_reddit_names"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L4592">view code</a><a href="#POST_api_search_reddit_names">#</a></div><h3><span class="method">POST&nbsp;</span>/api/search_reddit_names<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span></h3><div class="info"><div class="md"><p>List subreddit names that begin with a query string.</p>
+
+<p>Subreddits whose names begin with <code>query</code> will be returned. If
+<code>include_over_18</code> is false, subreddits with over-18 content
+restrictions will be filtered from the results.</p>
+
+<p>If <code>exact</code> is true, only an exact match will be returned.</p>
+</div>
+<table class="parameters"><tr><th scope="row">exact</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">include_over_18</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">query</th><td><p>a string up to 50 characters long, consisting of printable characters.</p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_site_admin"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L2710">view code</a><a href="#POST_api_site_admin">#</a></div><h3><span class="method">POST&nbsp;</span>/api/site_admin<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modconfig</span></a></span></h3><div class="info"><div class="md"><p>Create or configure a subreddit.</p>
+
+<p>If <code>sr</code> is specified, the request will attempt to modify the specified
+subreddit. If not, a subreddit with name <code>name</code> will be created.</p>
+
+<p>This endpoint expects <em>all</em> values to be supplied on every request.  If
+modifying a subset of options, it may be useful to get the current
+settings from <a href="#GET_r_%7Bsubreddit%7D_about_edit.json">/about/edit.json</a>
+first.</p>
+
+<p>For backwards compatibility, <code>description</code> is the sidebar text and
+<code>public_description</code> is the publicly visible subreddit description.</p>
+
+<p>Most of the parameters for this endpoint are identical to options
+visible in the user interface and their meanings are best explained
+there.</p>
+
+<p>See also: <a href="#GET_r_%7Bsubreddit%7D_about_edit.json">/about/edit.json</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">allow_top</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">captcha</th><td><p>the user&#39;s response to the CAPTCHA challenge</p>
+</td></tr><tr><th scope="row">collapse_deleted_comments</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">comment_score_hide_mins</th><td><p>an integer between 0 and 1440 (default: 0)</p>
+</td></tr><tr><th scope="row">description</th><td><p>raw markdown text</p>
+</td></tr><tr><th scope="row">exclude_banned_modqueue</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">header-title</th><td><p>a string no longer than 500 characters</p>
+</td></tr><tr><th scope="row">hide_ads</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">iden</th><td><p>the identifier of the CAPTCHA challenge</p>
+</td></tr><tr><th scope="row">lang</th><td><p>a valid IETF language tag (underscore separated)</p>
+</td></tr><tr><th scope="row">link_type</th><td><p>one of (<code>any</code>, <code>link</code>, <code>self</code>)</p>
+</td></tr><tr><th scope="row">name</th><td><p>subreddit name</p>
+</td></tr><tr><th scope="row">over_18</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">public_description</th><td><p>raw markdown text</p>
+</td></tr><tr><th scope="row">public_traffic</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">show_media</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">spam_comments</th><td><p>one of (<code>low</code>, <code>high</code>, <code>all</code>)</p>
+</td></tr><tr><th scope="row">spam_links</th><td><p>one of (<code>low</code>, <code>high</code>, <code>all</code>)</p>
+</td></tr><tr><th scope="row">spam_selfposts</th><td><p>one of (<code>low</code>, <code>high</code>, <code>all</code>)</p>
+</td></tr><tr><th scope="row">sr</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">submit_link_label</th><td><p>a string no longer than 60 characters</p>
+</td></tr><tr><th scope="row">submit_text</th><td><p>raw markdown text</p>
+</td></tr><tr><th scope="row">submit_text_label</th><td><p>a string no longer than 60 characters</p>
+</td></tr><tr><th scope="row">suggested_comment_sort</th><td><p>one of (<code>confidence</code>, <code>top</code>, <code>new</code>, <code>controversial</code>, <code>old</code>, <code>random</code>, <code>qa</code>)</p>
+</td></tr><tr><th scope="row">title</th><td><p>a string no longer than 100 characters</p>
+</td></tr><tr><th scope="row">type</th><td><p>one of (<code>gold_restricted</code>, <code>archived</code>, <code>restricted</code>, <code>gold_only</code>, <code>employees_only</code>, <code>private</code>, <code>public</code>)</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr><tr><th scope="row">wiki_edit_age</th><td><p>an integer greater than 0 (default: 0)</p>
+</td></tr><tr><th scope="row">wiki_edit_karma</th><td><p>an integer greater than 0 (default: 0)</p>
+</td></tr><tr><th scope="row">wikimode</th><td><p>one of (<code>disabled</code>, <code>modonly</code>, <code>anyone</code>)</p>
+</td></tr></table></div></div><div class="endpoint" id="GET_api_submit_text"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L417">view code</a><a href="#GET_api_submit_text">#</a></div><h3><span class="method">GET&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/submit_text<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">submit</span></a></span></h3><div class="info"><div class="md"><p>Get the submission text for the subreddit.</p>
+
+<p>This text is set by the subreddit moderators and intended to be
+displayed on the submission form.</p>
+
+<p>See also: <a href="#POST_api_site_admin">/api/site_admin</a>.</p>
+</div>
+</div></div><div class="endpoint" id="POST_api_subreddit_stylesheet"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L2364">view code</a><a href="#POST_api_subreddit_stylesheet">#</a></div><h3><span class="method">POST&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/subreddit_stylesheet<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modconfig</span></a></span></h3><div class="info"><div class="md"><p>Update a subreddit&#39;s stylesheet.</p>
+
+<p><code>op</code> should be <code>save</code> to update the contents of the stylesheet.</p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">op</th><td><p>one of (<code>save</code>, <code>preview</code>)</p>
+</td></tr><tr><th scope="row">reason</th><td><p>a string up to 256 characters long, consisting of printable characters.</p>
+</td></tr><tr><th scope="row">stylesheet_contents</th><td><p>the new stylesheet content</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="GET_api_subreddits_by_topic"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L4738">view code</a><a href="#GET_api_subreddits_by_topic">#</a></div><h3><span class="method">GET&nbsp;</span>/api/subreddits_by_topic<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span></h3><div class="info"><div class="md"><p>Return a list of subreddits that are relevant to a search query.</p>
+</div>
+<table class="parameters"><tr><th scope="row">query</th><td><p>a string no longer than 50 characters</p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_subscribe"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L3774">view code</a><a href="#POST_api_subscribe">#</a></div><h3><span class="method">POST&nbsp;</span>/api/subscribe<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">subscribe</span></a></span></h3><div class="info"><div class="md"><p>Subscribe to or unsubscribe from a subreddit.</p>
+
+<p>To subscribe, <code>action</code> should be <code>sub</code>. To unsubscribe, <code>action</code> should
+be <code>unsub</code>. The user must have access to the subreddit to be able to
+subscribe to it.</p>
+
+<p>See also: <a href="#GET_subreddits_mine_%7Bwhere%7D">/subreddits/mine/</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">action</th><td><p>one of (<code>sub</code>, <code>unsub</code>)</p>
+</td></tr><tr><th scope="row">sr</th><td><p>the name of a subreddit</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_upload_sr_img"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L2577">view code</a><a href="#POST_api_upload_sr_img">#</a></div><h3><span class="method">POST&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/upload_sr_img<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modconfig</span></a></span></h3><div class="info"><div class="md"><p>Add or replace a subreddit image, custom header logo, custom mobile
+icon, or custom mobile banner.</p>
+
+<ul>
+<li>If the <code>upload_type</code> value is <code>img</code>, an image for use in the
+subreddit stylesheet is uploaded with the name specified in <code>name</code>.</li>
+<li>If the <code>upload_type</code> value is <code>header</code> then the image uploaded will
+be the subreddit&#39;s new logo and <code>name</code> will be ignored.</li>
+<li>If the <code>upload_type</code> value is <code>icon</code> then the image uploaded will be
+the subreddit&#39;s new mobile icon and <code>name</code> will be ignored.</li>
+<li>If the <code>upload_type</code> value is <code>banner</code> then the image uploaded will
+be the subreddit&#39;s new mobile banner and <code>name</code> will be ignored.</li>
+</ul>
+
+<p>For backwards compatibility, if <code>upload_type</code> is not specified, the
+<code>header</code> field will be used instead:</p>
+
+<ul>
+<li>If the <code>header</code> field has value <code>0</code>, then <code>upload_type</code> is <code>img</code>.</li>
+<li>If the <code>header</code> field has value <code>1</code>, then <code>upload_type</code> is <code>header</code>.</li>
+</ul>
+
+<p>The <code>img_type</code> field specifies whether to store the uploaded image as a
+PNG or JPEG.</p>
+
+<p>Subreddits have a limited number of images that can be in use at any
+given time. If no image with the specified name already exists, one of
+the slots will be consumed.</p>
+
+<p>If an image with the specified name already exists, it will be
+replaced.  This does not affect the stylesheet immediately, but will
+take effect the next time the stylesheet is saved.</p>
+
+<p>See also: <a href="#POST_api_delete_sr_img">/api/delete_sr_img</a>,
+<a href="#POST_api_delete_sr_header">/api/delete_sr_header</a>,
+<a href="#POST_api_delete_sr_icon">/api/delete_sr_icon</a>, and
+<a href="#POST_api_delete_sr_banner">/api/delete_sr_banner</a>.</p>
+</div>
+<table class="parameters"><tr><th scope="row">file</th><td><p>file upload with maximum size of 500 KiB</p>
+</td></tr><tr><th scope="row">formid</th><td><p>(optional) can be ignored</p>
+</td></tr><tr><th scope="row">header</th><td><p>an integer between 0 and 1</p>
+</td></tr><tr><th scope="row">img_type</th><td><p>one of <code>png</code> or <code>jpg</code> (default: <code>png</code>)</p>
+</td></tr><tr><th scope="row">name</th><td><p>a valid subreddit image name</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr><tr><th scope="row">upload_type</th><td><p>one of (<code>img</code>, <code>header</code>, <code>icon</code>, <code>banner</code>)</p>
+</td></tr></table></div></div><div class="endpoint" id="GET_r_{subreddit}_about"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L919">view code</a><a href="#GET_r_{subreddit}_about">#</a></div><h3><span class="method">GET&nbsp;</span>/r/<em class="placeholder">subreddit</em>/about<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span></h3><div class="info"><div class="md"><p>Return information about the subreddit.</p>
+
+<p>Data includes the subscriber count, description, and header image.</p>
+</div>
+</div></div><div class="endpoint" id="GET_r_{subreddit}_about_edit"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L897">view code</a><a href="#GET_r_{subreddit}_about_edit">#</a></div><h3><span class="method">GET&nbsp;</span>/r/<em class="placeholder">subreddit</em>/about/edit<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modconfig</span></a></span></h3><div class="info"><div class="md"><p>Get the current settings of a subreddit.</p>
+
+<p>In the API, this returns the current settings of the subreddit as used
+by <a href="#POST_api_site_admin">/api/site_admin</a>.  On the HTML site, it will
+display a form for editing the subreddit.</p>
+</div>
+<table class="parameters"><tr><th scope="row">created</th><td><p>one of (<code>true</code>, <code>false</code>)</p>
+</td></tr><tr><th scope="row">location</th><td></td></tr></table></div></div><div class="endpoint" id="GET_rules"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L938">view code</a><a href="#GET_rules">#</a></div><h3><span class="method">GET&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/rules<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span></h3><div class="info"><div class="md"><p>Get the rules for the current subreddit</p>
+</div>
+</div></div><div class="endpoint" id="GET_sidebar"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L931">view code</a><a href="#GET_sidebar">#</a></div><h3><span class="method">GET&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/sidebar<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span></h3><div class="info"><div class="md"><p>Get the sidebar for the current subreddit</p>
+</div>
+</div></div><div class="endpoint" id="GET_sticky"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/lib/validator/validator.py#L200">view code</a><a href="#GET_sticky">#</a></div><h3><span class="method">GET&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/sticky<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span></h3><div class="info"><div class="md"><p>Redirect to one of the posts stickied in the current subreddit</p>
+
+<p>The &quot;num&quot; argument can be used to select a specific sticky, and will
+default to 1 (the top sticky) if not specified.
+Will 404 if there is not currently a sticky post in this subreddit.</p>
+</div>
+<table class="parameters"><tr><th scope="row">num</th><td><p>an integer between 1 and 2 (default: 1)</p>
+</td></tr></table></div></div><div class="endpoint" id="GET_subreddits_mine_{where}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1626">view code</a><a href="#GET_subreddits_mine_{where}">#</a></div><h3><span class="method">GET&nbsp;</span>/subreddits/mine/<em class="placeholder">where</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">mysubreddits</span></a></span><a href="https://www.reddit.com/wiki/rss"><span class="api-badge rss-support">rss support</span></a></h3><ul class="uri-variants"><li id="GET_subreddits_mine_subscriber">&rarr; /subreddits/mine/subscriber</li><li id="GET_subreddits_mine_contributor">&rarr; /subreddits/mine/contributor</li><li id="GET_subreddits_mine_moderator">&rarr; /subreddits/mine/moderator</li></ul><div class="info"><div class="md"><p>Get subreddits the user has a relationship with.</p>
+
+<p>The <code>where</code> parameter chooses which subreddits are returned as follows:</p>
+
+<ul>
+<li><code>subscriber</code> - subreddits the user is subscribed to</li>
+<li><code>contributor</code> - subreddits the user is an approved submitter in</li>
+<li><code>moderator</code> - subreddits the user is a moderator of</li>
+</ul>
+
+<p>See also: <a href="#POST_api_subscribe">/api/subscribe</a>,
+<a href="#POST_api_friend">/api/friend</a>, and
+<a href="#POST_api_accept_moderator_invite">/api/accept_moderator_invite</a>.</p>
+
+<p><em>This endpoint is <a href="#listings">a listing</a>.</em></p>
+</div>
+<table class="parameters"><tr class="base-param"><th scope="row">after</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr class="base-param"><th scope="row">before</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr class="base-param"><th scope="row">count</th><td><p>a positive integer (default: 0)</p>
+</td></tr><tr class="base-param"><th scope="row">limit</th><td><p>the maximum number of items desired (default: 25, maximum: 100)</p>
+</td></tr><tr class="base-param"><th scope="row">show</th><td><p>(optional) the string <code>all</code></p>
+</td></tr><tr class="base-param"><th scope="row">sr_detail</th><td><p>(optional) expand subreddits</p>
+</td></tr></table></div></div><div class="endpoint" id="GET_subreddits_search"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/front.py#L1034">view code</a><a href="#GET_subreddits_search">#</a></div><h3><span class="method">GET&nbsp;</span>/subreddits/search<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span><a href="https://www.reddit.com/wiki/rss"><span class="api-badge rss-support">rss support</span></a></h3><div class="info"><div class="md"><p>Search subreddits by title and description.</p>
+
+<p><em>This endpoint is <a href="#listings">a listing</a>.</em></p>
+</div>
+<table class="parameters"><tr><th scope="row">after</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">before</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">count</th><td><p>a positive integer (default: 0)</p>
+</td></tr><tr><th scope="row">limit</th><td><p>the maximum number of items desired (default: 25, maximum: 100)</p>
+</td></tr><tr><th scope="row">q</th><td><p>a search query</p>
+</td></tr><tr><th scope="row">show</th><td><p>(optional) the string <code>all</code></p>
+</td></tr><tr><th scope="row">sort</th><td><p>one of (<code>relevance</code>, <code>activity</code>)</p>
+</td></tr><tr><th scope="row">sr_detail</th><td><p>(optional) expand subreddits</p>
+</td></tr></table></div></div><div class="endpoint" id="GET_subreddits_{where}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1507">view code</a><a href="#GET_subreddits_{where}">#</a></div><h3><span class="method">GET&nbsp;</span>/subreddits/<em class="placeholder">where</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span><a href="https://www.reddit.com/wiki/rss"><span class="api-badge rss-support">rss support</span></a></h3><ul class="uri-variants"><li id="GET_subreddits_popular">&rarr; /subreddits/popular</li><li id="GET_subreddits_new">&rarr; /subreddits/new</li><li id="GET_subreddits_gold">&rarr; /subreddits/gold</li><li id="GET_subreddits_default">&rarr; /subreddits/default</li></ul><div class="info"><div class="md"><p>Get all subreddits.</p>
+
+<p>The <code>where</code> parameter chooses the order in which the subreddits are
+displayed.  <code>popular</code> sorts on the activity of the subreddit and the
+position of the subreddits can shift around. <code>new</code> sorts the subreddits
+based on their creation date, newest first.</p>
+
+<p><em>This endpoint is <a href="#listings">a listing</a>.</em></p>
+</div>
+<table class="parameters"><tr class="base-param"><th scope="row">after</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr class="base-param"><th scope="row">before</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr class="base-param"><th scope="row">count</th><td><p>a positive integer (default: 0)</p>
+</td></tr><tr class="base-param"><th scope="row">limit</th><td><p>the maximum number of items desired (default: 25, maximum: 100)</p>
+</td></tr><tr class="base-param"><th scope="row">show</th><td><p>(optional) the string <code>all</code></p>
+</td></tr><tr class="base-param"><th scope="row">sr_detail</th><td><p>(optional) expand subreddits</p>
+</td></tr></table></div></div><h2 id="section_users">users</h2><div class="endpoint" id="POST_api_friend"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L1020">view code</a><a href="#POST_api_friend">#</a></div><h3><span class="method">POST&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/friend<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">any</span></a></span></h3><div class="info"><div class="md"><p>Create a relationship between a user and another user or subreddit</p>
+
+<p>OAuth2 use requires appropriate scope based
+on the &#39;type&#39; of the relationship:</p>
+
+<ul>
+<li>moderator: Use &quot;moderator_invite&quot;</li>
+<li>moderator_invite: <code>modothers</code></li>
+<li>contributor: <code>modcontributors</code></li>
+<li>banned: <code>modcontributors</code></li>
+<li>muted: <code>modcontributors</code></li>
+<li>wikibanned: <code>modcontributors</code> and <code>modwiki</code></li>
+<li>wikicontributor: <code>modcontributors</code> and <code>modwiki</code></li>
+<li>friend: Use <a href="#PUT_api_v1_me_friends_%7Busername%7D">/api/v1/me/friends/{username}</a></li>
+<li>enemy: Use <a href="#POST_api_block">/api/block</a></li>
+</ul>
+
+<p>Complement to <a href="#POST_api_unfriend">POST_unfriend</a></p>
+</div>
+<table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">ban_message</th><td><p>raw markdown text</p>
+</td></tr><tr><th scope="row">ban_reason</th><td><p>a string no longer than 100 characters</p>
+</td></tr><tr><th scope="row">container</th><td></td></tr><tr><th scope="row">duration</th><td><p>an integer between 1 and 999</p>
+</td></tr><tr><th scope="row">name</th><td><p>the name of an existing user</p>
+</td></tr><tr><th scope="row">note</th><td><p>a string no longer than 300 characters</p>
+</td></tr><tr><th scope="row">permissions</th><td></td></tr><tr><th scope="row">type</th><td><p>one of (<code>friend</code>, <code>moderator</code>, <code>moderator_invite</code>, <code>contributor</code>, <code>banned</code>, <code>muted</code>, <code>wikibanned</code>, <code>wikicontributor</code>)</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_setpermissions"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L974">view code</a><a href="#POST_api_setpermissions">#</a></div><h3><span class="method">POST&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/setpermissions<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modothers</span></a></span></h3><div class="info"><table class="parameters"><tr><th scope="row">api_type</th><td><p>the string <code>json</code></p>
+</td></tr><tr><th scope="row">name</th><td><p>the name of an existing user</p>
+</td></tr><tr><th scope="row">permissions</th><td></td></tr><tr><th scope="row">type</th><td></td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_unfriend"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L868">view code</a><a href="#POST_api_unfriend">#</a></div><h3><span class="method">POST&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/unfriend<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">any</span></a></span></h3><div class="info"><div class="md"><p>Remove a relationship between a user and another user or subreddit</p>
+
+<p>The user can either be passed in by name (nuser)
+or by <a href="#fullnames">fullname</a> (iuser).  If type is friend or enemy,
+&#39;container&#39; MUST be the current user&#39;s fullname;
+for other types, the subreddit must be set
+via URL (e.g., <a href="/r/funny/api/unfriend">/r/funny/api/unfriend</a>)</p>
+
+<p>OAuth2 use requires appropriate scope based
+on the &#39;type&#39; of the relationship:</p>
+
+<ul>
+<li>moderator: <code>modothers</code></li>
+<li>moderator_invite: <code>modothers</code></li>
+<li>contributor: <code>modcontributors</code></li>
+<li>banned: <code>modcontributors</code></li>
+<li>muted: <code>modcontributors</code></li>
+<li>wikibanned: <code>modcontributors</code> and <code>modwiki</code></li>
+<li>wikicontributor: <code>modcontributors</code> and <code>modwiki</code></li>
+<li>friend: Use <a href="#DELETE_api_v1_me_friends_%7Busername%7D">/api/v1/me/friends/{username}</a></li>
+<li>enemy: <code>privatemessages</code></li>
+</ul>
+
+<p>Complement to <a href="#POST_api_friend">POST_friend</a></p>
+</div>
+<table class="parameters"><tr><th scope="row">container</th><td></td></tr><tr><th scope="row">id</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">name</th><td><p>the name of an existing user</p>
+</td></tr><tr><th scope="row">type</th><td><p>one of (<code>friend</code>, <code>enemy</code>, <code>moderator</code>, <code>moderator_invite</code>, <code>contributor</code>, <code>banned</code>, <code>muted</code>, <code>wikibanned</code>, <code>wikicontributor</code>)</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="GET_api_username_available"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/api.py#L238">view code</a><a href="#GET_api_username_available">#</a></div><h3><span class="method">GET&nbsp;</span>/api/username_available</h3><div class="info"><div class="md"><p>Check whether a username is available for registration.</p>
+</div>
+<table class="parameters"><tr><th scope="row">user</th><td><p>a valid, unused, username</p>
+</td></tr></table></div></div><div class="endpoint" id="DELETE_api_v1_me_friends_{username}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/apiv1/user.py#L202">view code</a><a href="#DELETE_api_v1_me_friends_{username}">#</a></div><h3><span class="method">DELETE&nbsp;</span>/api/v1/me/friends/<em class="placeholder">username</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">subscribe</span></a></span></h3><div class="info"><div class="md"><p>Stop being friends with a user.</p>
+</div>
+<table class="parameters"><tr><th scope="row">id</th><td><p>A valid, existing reddit username</p>
+</td></tr></table></div></div><div class="endpoint" id="GET_api_v1_me_friends_{username}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/apiv1/user.py#L191">view code</a><a href="#GET_api_v1_me_friends_{username}">#</a></div><h3><span class="method">GET&nbsp;</span>/api/v1/me/friends/<em class="placeholder">username</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">mysubreddits</span></a></span></h3><div class="info"><div class="md"><p>Get information about a specific &#39;friend&#39;, such as notes.</p>
+</div>
+<table class="parameters"><tr><th scope="row">id</th><td><p>A valid, existing reddit username</p>
+</td></tr></table></div></div><div class="endpoint" id="PUT_api_v1_me_friends_{username}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/apiv1/user.py#L146">view code</a><a href="#PUT_api_v1_me_friends_{username}">#</a></div><h3><span class="method">PUT&nbsp;</span>/api/v1/me/friends/<em class="placeholder">username</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">subscribe</span></a></span></h3><div class="info"><div class="md"><p>Create or update a &quot;friend&quot; relationship.</p>
+
+<p>This operation is idempotent. It can be used to add a new
+friend, or update an existing friend (e.g., add/change the
+note on that friend)</p>
+</div>
+<table class="parameters"><tr class="json-model"><th>This endpoint expects JSON data of this format</th><td><pre><code>{
+  &quot;name&quot;: A valid, existing reddit username,
+  &quot;note&quot;: a string no longer than 300 characters,
+}
+</code></pre>
+</td></tr></table></div></div><div class="endpoint" id="GET_api_v1_user_{username}_trophies"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/apiv1/user.py#L82">view code</a><a href="#GET_api_v1_user_{username}_trophies">#</a></div><h3><span class="method">GET&nbsp;</span>/api/v1/user/<em class="placeholder">username</em>/trophies<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span></h3><div class="info"><div class="md"><p>Return a list of trophies for the a given user.</p>
+</div>
+<table class="parameters"><tr><th scope="row">id</th><td><p>A valid, existing reddit username</p>
+</td></tr></table></div></div><div class="endpoint" id="GET_user_{username}_about"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L1015">view code</a><a href="#GET_user_{username}_about">#</a></div><h3><span class="method">GET&nbsp;</span>/user/<em class="placeholder">username</em>/about<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">read</span></a></span></h3><div class="info"><div class="md"><p>Return information about the user, including karma and gold status.</p>
+</div>
+<table class="parameters"><tr><th scope="row">username</th><td><p>the name of an existing user</p>
+</td></tr></table></div></div><div class="endpoint" id="GET_user_{username}_{where}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/listingcontroller.py#L890">view code</a><a href="#GET_user_{username}_{where}">#</a></div><h3><span class="method">GET&nbsp;</span>/user/<em class="placeholder">username</em>/<em class="placeholder">where</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">history</span></a></span><a href="https://www.reddit.com/wiki/rss"><span class="api-badge rss-support">rss support</span></a></h3><ul class="uri-variants"><li id="GET_user_{username}_overview">&rarr; /user/<em class="placeholder">username</em>/overview</li><li id="GET_user_{username}_submitted">&rarr; /user/<em class="placeholder">username</em>/submitted</li><li id="GET_user_{username}_comments">&rarr; /user/<em class="placeholder">username</em>/comments</li><li id="GET_user_{username}_upvoted">&rarr; /user/<em class="placeholder">username</em>/upvoted</li><li id="GET_user_{username}_downvoted">&rarr; /user/<em class="placeholder">username</em>/downvoted</li><li id="GET_user_{username}_hidden">&rarr; /user/<em class="placeholder">username</em>/hidden</li><li id="GET_user_{username}_saved">&rarr; /user/<em class="placeholder">username</em>/saved</li><li id="GET_user_{username}_gilded">&rarr; /user/<em class="placeholder">username</em>/gilded</li></ul><div class="info"><div class="md"><p><em>This endpoint is <a href="#listings">a listing</a>.</em></p>
+</div>
+<table class="parameters"><tr><th scope="row">show</th><td><p>one of (<code>given</code>)</p>
+</td></tr><tr><th scope="row">sort</th><td><p>one of (<code>hot</code>, <code>new</code>, <code>top</code>, <code>controversial</code>)</p>
+</td></tr><tr><th scope="row">t</th><td><p>one of (<code>hour</code>, <code>day</code>, <code>week</code>, <code>month</code>, <code>year</code>, <code>all</code>)</p>
+</td></tr><tr><th scope="row">username</th><td><p>the name of an existing user</p>
+</td></tr><tr class="base-param"><th scope="row">after</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr class="base-param"><th scope="row">before</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr class="base-param"><th scope="row">count</th><td><p>a positive integer (default: 0)</p>
+</td></tr><tr class="base-param"><th scope="row">limit</th><td><p>the maximum number of items desired (default: 25, maximum: 100)</p>
+</td></tr><tr class="base-param"><th scope="row">sr_detail</th><td><p>(optional) expand subreddits</p>
+</td></tr></table></div></div><h2 id="section_wiki">wiki</h2><div class="endpoint" id="POST_api_wiki_alloweditor_{act}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/wiki.py#L452">view code</a><a href="#POST_api_wiki_alloweditor_{act}">#</a></div><h3><span class="method">POST&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/wiki/alloweditor/<em class="placeholder">act</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modwiki</span></a></span></h3><ul class="uri-variants"><li id="POST_api_wiki_alloweditor_del">&rarr; [/r/<em class="placeholder">subreddit</em>]/api/wiki/alloweditor/del</li><li id="POST_api_wiki_alloweditor_add">&rarr; [/r/<em class="placeholder">subreddit</em>]/api/wiki/alloweditor/add</li></ul><div class="info"><div class="md"><p>Allow/deny <code>username</code> to edit this wiki <code>page</code></p>
+</div>
+<table class="parameters"><tr><th scope="row">act</th><td><p>one of (<code>del</code>, <code>add</code>)</p>
+</td></tr><tr><th scope="row">page</th><td><p>the name of an existing wiki page</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr><tr><th scope="row">username</th><td><p>the name of an existing user</p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_wiki_edit"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/wiki.py#L376">view code</a><a href="#POST_api_wiki_edit">#</a></div><h3><span class="method">POST&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/wiki/edit<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">wikiedit</span></a></span></h3><div class="info"><div class="md"><p>Edit a wiki <code>page</code></p>
+</div>
+<table class="parameters"><tr><th scope="row">content</th><td></td></tr><tr><th scope="row">page</th><td><p>the name of an existing page or a new page to create</p>
+</td></tr><tr><th scope="row">previous</th><td><p>the starting point revision for this edit</p>
+</td></tr><tr><th scope="row">reason</th><td><p>a string up to 256 characters long, consisting of printable characters.</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_wiki_hide"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/wiki.py#L493">view code</a><a href="#POST_api_wiki_hide">#</a></div><h3><span class="method">POST&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/wiki/hide<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modwiki</span></a></span></h3><div class="info"><div class="md"><p>Toggle the public visibility of a wiki page revision</p>
+</div>
+<table class="parameters"><tr><th scope="row">page</th><td><p>the name of an existing wiki page</p>
+</td></tr><tr><th scope="row">revision</th><td><p>a wiki revision ID</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="POST_api_wiki_revert"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/wiki.py#L508">view code</a><a href="#POST_api_wiki_revert">#</a></div><h3><span class="method">POST&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/api/wiki/revert<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modwiki</span></a></span></h3><div class="info"><div class="md"><p>Revert a wiki <code>page</code> to <code>revision</code></p>
+</div>
+<table class="parameters"><tr><th scope="row">page</th><td><p>the name of an existing wiki page</p>
+</td></tr><tr><th scope="row">revision</th><td><p>a wiki revision ID</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="GET_wiki_discussions_{page}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/lib/validator/validator.py#L200">view code</a><a href="#GET_wiki_discussions_{page}">#</a></div><h3><span class="method">GET&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/wiki/discussions/<em class="placeholder">page</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">wikiread</span></a></span></h3><div class="info"><div class="md"><p>Retrieve a list of discussions about this wiki <code>page</code></p>
+
+<p><em>This endpoint is <a href="#listings">a listing</a>.</em></p>
+</div>
+<table class="parameters"><tr><th scope="row">after</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">before</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">count</th><td><p>a positive integer (default: 0)</p>
+</td></tr><tr><th scope="row">limit</th><td><p>the maximum number of items desired (default: 25, maximum: 100)</p>
+</td></tr><tr><th scope="row">page</th><td><p>the name of an existing wiki page</p>
+</td></tr><tr><th scope="row">show</th><td><p>(optional) the string <code>all</code></p>
+</td></tr><tr><th scope="row">sr_detail</th><td><p>(optional) expand subreddits</p>
+</td></tr></table></div></div><div class="endpoint" id="GET_wiki_pages"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/controllers/wiki.py#L258">view code</a><a href="#GET_wiki_pages">#</a></div><h3><span class="method">GET&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/wiki/pages<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">wikiread</span></a></span></h3><div class="info"><div class="md"><p>Retrieve a list of wiki pages in this subreddit</p>
+</div>
+</div></div><div class="endpoint" id="GET_wiki_revisions"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/lib/validator/validator.py#L200">view code</a><a href="#GET_wiki_revisions">#</a></div><h3><span class="method">GET&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/wiki/revisions<span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">wikiread</span></a></span></h3><div class="info"><div class="md"><p>Retrieve a list of recently changed wiki pages in this subreddit</p>
+</div>
+<table class="parameters"><tr><th scope="row">after</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">before</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">count</th><td><p>a positive integer (default: 0)</p>
+</td></tr><tr><th scope="row">limit</th><td><p>the maximum number of items desired (default: 25, maximum: 100)</p>
+</td></tr><tr><th scope="row">show</th><td><p>(optional) the string <code>all</code></p>
+</td></tr><tr><th scope="row">sr_detail</th><td><p>(optional) expand subreddits</p>
+</td></tr></table></div></div><div class="endpoint" id="GET_wiki_revisions_{page}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/lib/validator/validator.py#L200">view code</a><a href="#GET_wiki_revisions_{page}">#</a></div><h3><span class="method">GET&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/wiki/revisions/<em class="placeholder">page</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">wikiread</span></a></span></h3><div class="info"><div class="md"><p>Retrieve a list of revisions of this wiki <code>page</code></p>
+
+<p><em>This endpoint is <a href="#listings">a listing</a>.</em></p>
+</div>
+<table class="parameters"><tr><th scope="row">after</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">before</th><td><p><a href="#fullnames">fullname</a> of a thing</p>
+</td></tr><tr><th scope="row">count</th><td><p>a positive integer (default: 0)</p>
+</td></tr><tr><th scope="row">limit</th><td><p>the maximum number of items desired (default: 25, maximum: 100)</p>
+</td></tr><tr><th scope="row">page</th><td><p>the name of an existing wiki page</p>
+</td></tr><tr><th scope="row">show</th><td><p>(optional) the string <code>all</code></p>
+</td></tr><tr><th scope="row">sr_detail</th><td><p>(optional) expand subreddits</p>
+</td></tr></table></div></div><div class="endpoint" id="GET_wiki_settings_{page}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/lib/validator/validator.py#L200">view code</a><a href="#GET_wiki_settings_{page}">#</a></div><h3><span class="method">GET&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/wiki/settings/<em class="placeholder">page</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modwiki</span></a></span></h3><div class="info"><div class="md"><p>Retrieve the current permission settings for <code>page</code></p>
+</div>
+<table class="parameters"><tr><th scope="row">page</th><td><p>the name of an existing wiki page</p>
+</td></tr></table></div></div><div class="endpoint" id="POST_wiki_settings_{page}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/lib/validator/validator.py#L200">view code</a><a href="#POST_wiki_settings_{page}">#</a></div><h3><span class="method">POST&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/wiki/settings/<em class="placeholder">page</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">modwiki</span></a></span></h3><div class="info"><div class="md"><p>Update the permissions and visibility of wiki <code>page</code></p>
+</div>
+<table class="parameters"><tr><th scope="row">listed</th><td><p>boolean value</p>
+</td></tr><tr><th scope="row">page</th><td><p>the name of an existing wiki page</p>
+</td></tr><tr><th scope="row">permlevel</th><td><p>an integer</p>
+</td></tr><tr><th scope="row">uh / X-Modhash header</th><td><p>a <a href="#modhashes">modhash</a></p>
+</td></tr></table></div></div><div class="endpoint" id="GET_wiki_{page}"><div class="links"><a href="https://github.com/reddit/reddit/blob/master/r2/r2/lib/validator/validator.py#L200">view code</a><a href="#GET_wiki_{page}">#</a></div><h3><span class="method">GET&nbsp;</span>[/r/<em class="placeholder">subreddit</em>]/wiki/<em class="placeholder">page</em><span class="oauth-scope-list"><a href="https://github.com/reddit/reddit/wiki/OAuth2"><span class="api-badge oauth-scope">wikiread</span></a></span></h3><div class="info"><div class="md"><p>Return the content of a wiki page</p>
+
+<p>If <code>v</code> is given, show the wiki page as it was at that version
+If both <code>v</code> and <code>v2</code> are given, show a diff of the two</p>
+</div>
+<table class="parameters"><tr><th scope="row">page</th><td><p>the name of an existing wiki page</p>
+</td></tr><tr><th scope="row">v</th><td><p>a wiki revision ID</p>
+</td></tr><tr><th scope="row">v2</th><td><p>a wiki revision ID</p>
+</td></tr></table></div></div></div></div><script id="subreddit-rules-report-template" type="text/template"><form id="report-action-form" class="subreddit-report-form rounded"><input type="hidden" name="thing_id" value="<%- fullname %>"><a href="/r/<%- sr_name %>/about/rules" class="action-icon action-icon-info c-hide-text may-blank" title="View the community rules">View the community rules</a><div class="reason-prompt report-header">What rule does this break?</div><ol class="report-reason-list"><li class="report-reason-item report-reason-reddit"<label><input type="radio" class="site-reason-radio" name="reason" value="site_reason_selected"><div class="report-reason-display"><select name="site_reason"><option value="Spam">Reddit rule: Spam</option><option value="Personal and confidential information">Reddit rule: Personal and confidential information</option><option value="Threatening, harassing, or inciting violence">Reddit rule: Threatening, harassing, or inciting violence</option></select></div></label></li><li class="report-reason-item report-reason-other"><label><input type="radio" name="reason" value="other"><div class="report-reason-display"><div>Other (max 100 characters):</div><input type="text" class="c-form-control" name="other_reason" value="" maxlength="100" disabled><span class="error TOO_LONG field-other_reason" style="display:none"></span></div></label></li><div class="report-header">Reports go to community moderators anonymously</div></ol><div class="c-submit-group"><button type="button" class="btn c-btn c-btn-secondary report-cancel">cancel</button>&#32;<button type="submit" class="btn c-btn c-btn-primary submit-action-thing" disabled>report</button></div><span class="status" style="display: none"></span></form></script><script id="subreddit-default-report-template" type="text/template"><form id="report-action-form" class="subreddit-report-form rounded"><input type="hidden" name="thing_id" value="<%- fullname %>"><a href="/help/contentpolicy" class="action-icon action-icon-info c-hide-text may-blank" title="View the community rules">View the community rules</a><div class="reason-prompt report-header">What rule does this break?</div><ol class="report-reason-list"><li class="report-reason-item"><label><input type="radio" name="reason" value="Spam"><div class="report-reason-display">Spam</div></label></li><li class="report-reason-item"><label><input type="radio" name="reason" value="Personal and confidential information"><div class="report-reason-display">Personal and confidential information</div></label></li><li class="report-reason-item"><label><input type="radio" name="reason" value="Threatening, harassing, or inciting violence"><div class="report-reason-display">Threatening, harassing, or inciting violence</div></label></li><li class="report-reason-item report-reason-other"><label><input type="radio" name="reason" value="other"><div class="report-reason-display"><div>Other (max 100 characters):</div><input type="text" class="c-form-control" name="other_reason" value="" maxlength="100" disabled><span class="error TOO_LONG field-other_reason" style="display:none"></span></div></label></li></ol><div class="report-header">Reports go to community moderators anonymously</div><div class="c-submit-group"><button type="button" class="btn c-btn c-btn-secondary report-cancel">cancel</button>&#32;<button type="submit" class="btn c-btn c-btn-primary submit-action-thing" disabled>report</button></div><span class="status" style="display: none"></span></form></script><script id="reddit-report-template" type="text/template"><form id="report-action-form" class="subreddit-report-form rounded"><input type="hidden" name="thing_id" value="<%- fullname %>"><a href="/help/contentpolicy" class="action-icon action-icon-info c-hide-text may-blank" title="View the community rules">View the community rules</a><div class="reason-prompt report-header">What rule does this break?</div><ol class="report-reason-list"><li class="report-reason-item"><label><input type="radio" name="reason" value="Spam"><div class="report-reason-display">Spam</div></label></li><li class="report-reason-item"><label><input type="radio" name="reason" value="Personal and confidential information"><div class="report-reason-display">Personal and confidential information</div></label></li><li class="report-reason-item"><label><input type="radio" name="reason" value="Threatening, harassing, or inciting violence"><div class="report-reason-display">Threatening, harassing, or inciting violence</div></label></li><li class="report-reason-item report-reason-other"><label><input type="radio" name="reason" value="other"><div class="report-reason-display"><div>Other (max 100 characters):</div><input type="text" class="c-form-control" name="other_reason" value="" maxlength="100" disabled><span class="error TOO_LONG field-other_reason" style="display:none"></span></div></label></li></ol><div class="report-header">Reports go to Reddit admins</div><div class="c-submit-group"><button type="button" class="btn c-btn c-btn-secondary report-cancel">cancel</button>&#32;<button type="submit" class="btn c-btn c-btn-primary submit-action-thing" disabled>report</button></div><span class="status" style="display: none"></span></form></script><script id="report-reason-template" type="text/template"><li class="report-reason-item"><label><input type="radio" name="reason" value="<%- short_name %>"><div class="report-reason-display"><%- short_name %></div></label></li></script><script id="archived-popup" type="text/template"><div class="interstitial"><img class="interstitial-image" src="//www.redditstatic.com/interstitial-image-archived.png" alt="archived" height="150" width="150"><div class="interstitial-message md-container"><div class="md"><h3>This is an archived post. You won't be able to vote or comment.</h3><p>Posts&#32;are&#32;automatically&#32;archived&#32;after&#32;6&#32;months.</p></div></div><div class="buttons"><a href="/" class="c-btn c-btn-primary">Got It</a></div></div></script></div><div class="footer-parent"><div by-zero class="footer rounded"><div class="col"><ul class="flat-vert hover" ><li class="flat-vert title">about</li><li ><a href="https://www.reddit.com/blog/" class="choice" >blog</a></li><li ><span class="separator"></span><a href="https://www.reddit.com/about/" class="choice" >about</a></li><li ><span class="separator"></span><a href="https://www.reddit.com/about/values/" class="choice" >values</a></li><li ><span class="separator"></span><a href="https://www.reddit.com/about/team/" class="choice" >team</a></li><li ><span class="separator"></span><a href="https://www.reddit.com/code/" class="choice" >source code</a></li><li ><span class="separator"></span><a href="https://www.reddit.com/advertising/" class="choice" >advertise</a></li><li ><span class="separator"></span><a href="https://www.reddit.com/jobs/" class="choice" >jobs</a></li></ul></div><div class="col"><ul class="flat-vert hover" ><li class="flat-vert title">help</li><li ><a href="https://www.reddit.com/rules/" class="choice" >site rules</a></li><li ><span class="separator"></span><a href="https://reddit.zendesk.com" class="choice" >FAQ</a></li><li ><span class="separator"></span><a href="https://www.reddit.com/wiki/" class="choice" >wiki</a></li><li ><span class="separator"></span><a href="https://www.reddit.com/wiki/reddiquette/" class="choice" >reddiquette</a></li><li ><span class="separator"></span><a href="https://www.reddit.com/wiki/transparency/" class="choice" >transparency</a></li><li ><span class="separator"></span><a href="https://www.reddit.com/contact/" class="choice" >contact us</a></li></ul></div><div class="col"><ul class="flat-vert hover" ><li class="flat-vert title">apps &amp; tools</li><li ><a href="http://alienblue.org" class="choice" >Alien Blue iOS app</a></li><li ><span class="separator"></span><a href="https://m.reddit.com" class="choice" >mobile beta</a></li><li ><span class="separator"></span><a href="https://www.reddit.com/buttons/" class="choice" >buttons</a></li></ul></div><div class="col"><ul class="flat-vert hover" ><li class="flat-vert title">&lt;3</li><li ><a href="https://www.reddit.com/gold/about/" class="buygold choice" >reddit gold</a></li><li ><span class="separator"></span><a href="http://redditgifts.com" class="choice" >redditgifts</a></li></ul></div></div><p class="bottommenu">Use of this site constitutes acceptance of our&#32;<a href="https://www.reddit.com/help/useragreement" >User Agreement</a>&#32;and&#32;<a href="https://www.reddit.com/help/privacypolicy" class="updated" >Privacy Policy (updated)</a>. &copy; 2016 reddit inc. All rights reserved.</p><p class="bottommenu">REDDIT and the ALIEN Logo are registered trademarks of reddit inc.</p></div><img id="hsts_pixel" src="//reddit.com/static/pixel.png"><p class="debuginfo"><span class="icon">&pi;</span>&nbsp;<span class="content">Rendered by PID 17912 on&#32; app-27 &#32;at 2016-03-13 09:14:47.363234+00:00 running 04ece11 country code: GB.</span></p><script type="text/javascript" src="//www.redditstatic.com/reddit.en.xnYOOvMmFMc.js"></script></body></html>
\ No newline at end of file