Skip to content
Changelog

Report a bug

Reddit integration: operations for AI agents

Reddit connects to Type.com as an integration. This page lists the 200 operations documented for Claude and Codex in Type.com: 80 read, 86 write, 34 destructive.

About Reddit

Reddit is a social news platform with user-driven communities (subreddits), offering content sharing, discussions, and viral marketing opportunities for brands

Categories: Marketing & Social

How to connect Reddit to Type.com

Connect
Access token
Access
Organization connection: one shared account for the workspace.
MCP
Selected social-publishing operations are not available through Type’s MCP server. Other operations remain available through MCP, subject to your connection’s permissions. These MCP restrictions do not apply within Type.

To add the connection, follow the steps in Space connections.

Documented operations

200 operations. Your connection's permissions determine which operations are available. API references describe the vendor surface; they do not expand your connection's credentials or access.

200 operations listed.

Account

  • Read

    Get my identity

    Returns the identity of the user.

    GET /api/v1/me

  • Read

    Get my karma breakdown

    Return a breakdown of subreddit karma.

    GET /api/v1/me/karma

  • Read

    Get my preferences

    Return the preference settings of the logged in user.

    GET /api/v1/me/prefs

  • Read

    Get my trophies

    Return a list of trophies for the current user.

    GET /api/v1/me/trophies

  • Read

    List friends, blocked users or messaging preferences

    Lists the logged-in user's friends, blocked users, trusted users or messaging settings, depending on the path chosen.

    GET /prefs/{where}

  • Write

    Update my preferences

    Changes the logged-in user's preference settings.

    PATCH /api/v1/me/prefs

Announcements

  • Read

    List announcements

    Returns announcements from Reddit for the logged-in user, or only unread ones.

    GET /api/announcements/v1

  • Write

    Hide announcements

    Accepts a list of announcement fullnames (ann_) and marks them hidden if they belong to the authenticated user.

    POST /api/announcements/v1/hide

  • Write

    Mark announcements read

    Accepts a list of announcement fullnames (ann_) and marks them read if they belong to the authenticated user.

    POST /api/announcements/v1/read

  • Write

    Mark all announcements read

    Marks all unread announcements as read for the authenticated user.

    POST /api/announcements/v1/read_all

Captcha

  • Read

    Check if CAPTCHA is needed

    Check whether ReCAPTCHAs are needed for API methods.

    GET /api/needs_captcha

Emoji

  • Read

    List subreddit emojis

    Lists all emojis available in a subreddit, including Reddit's built-in snoomojis.

    GET /api/v1/{subreddit}/emojis/all

  • Write

    Add subreddit emoji

    Adds a new custom emoji to a subreddit after its image has been uploaded.

    POST /api/v1/{subreddit}/emoji.json

  • Write

    Get emoji upload lease

    Returns a temporary upload location for a new emoji image.

    POST /api/v1/{subreddit}/emoji_asset_upload_s3.json

  • Write

    Set custom emoji size

    Set custom emoji size. Omitting width or height will disable custom emoji sizing.

    POST /api/v1/{subreddit}/emoji_custom_size

  • Destructive

    Delete subreddit emoji

    Deletes a custom emoji from a subreddit.

    DELETE /api/v1/{subreddit}/emoji/{emoji_name}

Flair

  • Read

    List user flair

    Lists the users in a subreddit and the flair assigned to each.

    GET [/r/{subreddit}]/api/flairlist

  • Read

    Get flair options

    Returns the flair choices available to a user or for a post.

    POST [/r/{subreddit}]/api/flairselector

  • Read

    List user flair options

    Return list of available user flair for the current subreddit. Will not return flair if flair is disabled on the subreddit, the user cannot set their own flair, or they are not a moderator that can set flair.

    GET [/r/{subreddit}]/api/user_flair

  • Read

    List user flair options (v2)

    Return list of available user flair for the current subreddit. If user is not a mod of the subreddit, this endpoint filters out mod_only templates.

    GET [/r/{subreddit}]/api/user_flair_v2

  • Write

    Set user or post flair

    Sets the flair text and style on a user or post in a subreddit.

    POST [/r/{subreddit}]/api/flair

  • Write

    Reorder flair templates

    Update the order of flair templates in the specified subreddit. Order should contain every single flair id for that flair type; omitting any id will result in a loss of data.

    PATCH [/r/{subreddit}]/api/flair_template_order

  • Write

    Configure subreddit flair

    Changes a subreddit's flair settings, such as whether flair is enabled and where it is shown.

    POST [/r/{subreddit}]/api/flairconfig

  • Write

    Bulk set user flair

    Changes the flair of many users in a subreddit at once from CSV data.

    POST [/r/{subreddit}]/api/flaircsv

  • Write

    Select flair

    Chooses a flair template for yourself or for a post.

    POST [/r/{subreddit}]/api/selectflair

  • Write

    Toggle own flair visibility

    Turns display of your own flair in a subreddit on or off.

    POST [/r/{subreddit}]/api/setflairenabled

  • Destructive

    Clear flair templates

    Deletes all user or link flair templates in a subreddit.

    POST [/r/{subreddit}]/api/clearflairtemplates

  • Destructive

    Delete user flair

    Removes a user's flair in a subreddit.

    POST [/r/{subreddit}]/api/deleteflair

  • Destructive

    Delete flair template

    Deletes one flair template from a subreddit.

    POST [/r/{subreddit}]/api/deleteflairtemplate

  • Destructive

    Create or update flair template

    Creates a flair template, or overwrites an existing one.

    POST [/r/{subreddit}]/api/flairtemplate

  • Destructive

    Create or update flair template (v2)

    Creates a flair template, or overwrites an existing one, using the newer format.

    POST [/r/{subreddit}]/api/flairtemplate_v2

Links & comments

  • Read

    Get things by ID

    Return a listing of things specified by their fullnames. Only Links, Comments, and Subreddits are allowed.

    GET [/r/{subreddit}]/api/info

  • Read

    Load more comments

    Retrieve additional comments omitted from a base comment tree. When a comment tree is rendered, the most relevant comments are selected for display first.

    GET /api/morechildren

  • Read

    List saved categories

    Get a list of categories in which things are currently saved.

    GET /api/saved_categories

  • Write

    Post comment or reply

    Submit a new comment or reply to a message. parent is the fullname of the thing being replied to.

    POST /api/comment

  • Write

    Edit comment or post text

    Edit the body text of a comment or self-post.

    POST /api/editusertext

  • Write

    Follow or unfollow post

    Follow or unfollow a post. To follow, follow should be True.

    POST /api/follow_post

  • Write

    Hide post

    Hide a link. This removes it from the user's default view of subreddit listings.

    POST /api/hide

  • Write

    Lock post or comment

    Lock a link or comment. Prevents a post or new child comments from receiving new comments.

    POST /api/lock

  • Write

    Mark post NSFW

    Mark a link NSFW.

    POST /api/marknsfw

  • Write

    Report post, comment or message

    Report a link, comment or message. Reporting a thing brings it to the attention of the subreddit's moderators.

    POST /api/report

  • Write

    Save post or comment

    Save a link or comment. Saved things are kept in the user's saved listing for later perusal.

    POST /api/save

  • Write

    Toggle inbox replies

    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.

    POST /api/sendreplies

  • Write

    Set contest mode

    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.

    POST /api/set_contest_mode

  • Write

    Sticky or unsticky post

    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.

    POST /api/set_subreddit_sticky

  • Write

    Set suggested comment sort

    Set a suggested sort for a link. Suggested sorts are useful to display comments in a certain preferred way for posts.

    POST /api/set_suggested_sort

  • Write

    Mark post as spoiler

    Marks a post as containing spoilers.

    POST /api/spoiler

  • Write

    Store post visits

    Records that the user visited posts; requires Reddit Premium.

    POST /api/store_visits

  • Write

    Submit post

    Submit a link to a subreddit. Submit will create a link or self-post in the subreddit sr with the title title.

    POST /api/submit

  • Write

    Unhide post

    Unhide a link.

    POST /api/unhide

  • Write

    Unlock post or comment

    Unlock a link or comment. Allow a post or comment to receive new comments.

    POST /api/unlock

  • Write

    Remove NSFW mark

    Remove the NSFW marking from a link.

    POST /api/unmarknsfw

  • Write

    Remove spoiler mark

    Removes the spoiler marking from a post.

    POST /api/unspoiler

  • Write

    Vote

    Upvotes, downvotes or clears a vote on a post or comment.

    POST /api/vote

  • Destructive

    Unsave post or comment

    Unsave a link or comment. This removes the thing from the user's saved listings as well.

    POST /api/unsave

Listings

  • Read

    List best posts

    Returns the 'best' listing of posts for the user's front page.

    GET /best

  • Read

    Get posts by ID

    Get a listing of links by fullname. names is a list of fullnames for links separated by commas or spaces.

    GET /by_id/{names}

  • Read

    Get comment tree

    Get the comment tree for a given Link article. If supplied, comment is the ID36 of a comment in the comment tree for article.

    GET [/r/{subreddit}]/comments/{article}

  • Read

    List duplicate posts

    Return a list of other submissions of the same URL.

    GET /duplicates/{article}

  • Read

    List hot posts

    Returns the hot listing of posts, site-wide or for a subreddit.

    GET [/r/{subreddit}]/hot

  • Read

    List new posts

    Returns the newest posts, site-wide or for a subreddit.

    GET [/r/{subreddit}]/new

  • Read

    List rising posts

    Returns rising posts, site-wide or for a subreddit.

    GET [/r/{subreddit}]/rising

  • Read

    List top or controversial posts

    Returns top or controversial posts for a time period, site-wide or for a subreddit.

    GET [/r/{subreddit}]/{sort}

Live threads

  • Read

    Get live threads by ID

    Get a listing of live events by id.

    GET /api/live/by_id/{names}

  • Read

    Get featured live thread

    Get some basic information about the currently featured live thread. Returns an empty 204 response for api requests if no thread is currently featured.

    GET /api/live/happening_now

  • Read

    List live thread updates

    Get a list of updates posted in this thread.

    GET /live/{thread}

  • Read

    Get live thread details

    Get some basic information about the live thread.

    GET /live/{thread}/about

  • Read

    List live thread contributors

    Get a list of users that contribute to this thread.

    GET /live/{thread}/contributors

  • Read

    List live thread discussions

    Get a list of reddit submissions linking to this thread.

    GET /live/{thread}/discussions

  • Read

    Get live thread update

    Get details about a specific update in a live thread.

    GET /live/{thread}/updates/{update_id}

  • Write

    Create live thread

    Create a new live thread. Once created, the initial settings can be modified with /api/live/thread/edit and new updates can be posted with /api/live/thread/update.

    POST /api/live/create

  • Write

    Accept live thread contributor invite

    Accept a pending invitation to contribute to the thread.

    POST /api/live/{thread}/accept_contributor_invite

  • Write

    Edit live thread settings

    Configure the thread. Requires the settings permission for this thread.

    POST /api/live/{thread}/edit

  • Write

    Hide live thread discussion

    Hide a linked comment thread from the discussions sidebar and listing. Requires the discussions permission for this thread.

    POST /api/live/{thread}/hide_discussion

  • Write

    Invite live thread contributor

    Invite another user to contribute to the thread. Requires the manage permission for this thread.

    POST /api/live/{thread}/invite_contributor

  • Write

    Report live thread

    Report the thread for violating the rules of reddit.

    POST /api/live/{thread}/report

  • Write

    Set live thread contributor permissions

    Change a contributor or contributor invite's permissions. Requires the manage permission for this thread.

    POST /api/live/{thread}/set_contributor_permissions

  • Write

    Strike live thread update

    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 the edit permission for this thread.

    POST /api/live/{thread}/strike_update

  • Write

    Unhide live thread discussion

    Unhide a linked comment thread from the discussions sidebar and listing.. Requires the discussions permission for this thread.

    POST /api/live/{thread}/unhide_discussion

  • Write

    Post live thread update

    Post an update to the thread. Requires the update permission for this thread.

    POST /api/live/{thread}/update

  • Destructive

    Close live thread

    Permanently close the thread, disallowing future updates. Requires the close permission for this thread.

    POST /api/live/{thread}/close_thread

  • Destructive

    Delete live thread update

    Delete an update from the thread. Requires that specified update must have been authored by the user or that you have the edit permission for this thread.

    POST /api/live/{thread}/delete_update

  • Destructive

    Leave live thread as contributor

    Abdicate contributorship of the thread.

    POST /api/live/{thread}/leave_contributor

  • Destructive

    Remove live thread contributor

    Revoke another user's contributorship. Requires the manage permission for this thread.

    POST /api/live/{thread}/rm_contributor

  • Destructive

    Revoke live thread contributor invite

    Revoke an outstanding contributor invite. Requires the manage permission for this thread.

    POST /api/live/{thread}/rm_contributor_invite

Private messages

  • Read

    List messages

    Lists the user's inbox, unread or sent private messages.

    GET /message/{where}

  • Write

    Send private message

    Handles message composition under /message/compose.

    POST /api/compose

  • Write

    Mark all messages read

    Queue up marking all messages for a user as read. This may take some time, and returns 202 to acknowledge acceptance of the request.

    POST /api/read_all_messages

  • Write

    Mark messages read

    Marks one or more private messages as read.

    POST /api/read_message

  • Destructive

    Delete message

    Delete messages from the recipient's view of their inbox.

    POST /api/del_msg

Misc

  • Read

    List OAuth scopes

    Retrieve descriptions of reddit's OAuth2 scopes. If no scopes are given, information on all scopes are returned.

    GET /api/v1/scopes

Moderation

  • Read

    Get moderation log

    Get a list of recent moderation actions. Moderator actions taken within a subreddit are logged.

    GET [/r/{subreddit}]/about/log

  • Read

    List moderation queue

    Lists posts and comments that moderators need to look at: reports, spam, mod queue, unmoderated or edited items.

    GET [/r/{subreddit}]/about/{location}

  • Read

    Get subreddit stylesheet

    Redirect to the subreddit's stylesheet if one exists.

    GET [/r/{subreddit}]/stylesheet

  • Write

    Accept moderator invite

    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.

    POST [/r/{subreddit}]/api/accept_moderator_invite

  • Write

    Approve post or comment

    Approve a link or comment. If the thing was removed, it will be re-inserted into appropriate listings.

    POST /api/approve

  • Write

    Distinguish post or comment

    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.

    POST /api/distinguish

  • Write

    Ignore reports

    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.

    POST /api/ignore_reports

  • Write

    Show collapsed comment

    Mark a comment that it should not be collapsed because of crowd control. The comment could still be collapsed for other reasons.

    POST /api/show_comment

  • Write

    Snooze reports

    Prevent future reports on a thing from causing notifications. For users who reported this thing (post, comment, etc) with the given report reason, reports from those users in the next 7 days will not be escalated to moderators.

    POST /api/snooze_reports

  • Write

    Unignore reports

    Allow future reports on a thing to cause notifications.

    POST /api/unignore_reports

  • Write

    Unsnooze reports

    For users whose reports were snoozed (see /api/snooze_reports), to go back to escalating future reports from those users.

    POST /api/unsnooze_reports

  • Write

    Update crowd control level

    Change the post's crowd control level.

    POST /api/update_crowd_control_level

  • Destructive

    Leave as approved user

    Abdicate approved user status in a subreddit.

    POST /api/leavecontributor

  • Destructive

    Leave as moderator

    Abdicate moderator status in a subreddit.

    POST /api/leavemoderator

  • Destructive

    Remove post, comment or modmail

    Remove a link, comment, or modmail message. If the thing is a link, it will be removed from all subreddit listings.

    POST /api/remove

Modmail

  • Read

    List modmail conversations

    Get conversations for a logged in user or subreddits.

    GET /api/mod/conversations

  • Read

    Get modmail conversation

    Returns all messages, mod actions and conversation metadata for a given conversation id.

    GET /api/mod/conversations/{conversation_id}

  • Read

    List modmail subreddits

    Returns a list of srs that the user moderates with mail permission.

    GET /api/mod/conversations/subreddits

  • Read

    Get modmail unread count

    Endpoint to retrieve the unread conversation count by conversation state.

    GET /api/mod/conversations/unread/count

  • Write

    Bulk mark modmail read

    Marks all conversations read for a particular conversation state within the passed list of subreddits.

    POST /api/mod/bulk_read

  • Write

    Create modmail conversation

    Creates a new conversation for a particular SR. This endpoint will create a ModmailConversation object as well as the first ModmailMessage within the ModmailConversation object.

    POST /api/mod/conversations

  • Write

    Reply to modmail conversation

    Creates a new message for a particular conversation.

    POST /api/mod/conversations/{conversation_id}

  • Write

    Approve modmail user

    Approve the non mod user associated with a particular conversation.

    POST /api/mod/conversations/{conversation_id}/approve

  • Write

    Archive modmail conversation

    Marks a conversation as archived.

    POST /api/mod/conversations/{conversation_id}/archive

  • Write

    Disapprove modmail user

    Disapprove the non mod user associated with a particular conversation.

    POST /api/mod/conversations/{conversation_id}/disapprove

  • Write

    Highlight modmail conversation

    Marks a conversation as highlighted.

    POST /api/mod/conversations/{conversation_id}/highlight

  • Write

    Mute modmail user

    Mutes the non mod user associated with a particular conversation.

    POST /api/mod/conversations/{conversation_id}/mute

  • Write

    Temporarily ban modmail user

    Temporary ban (switch from permanent to temporary ban) the non mod user associated with a particular conversation.

    POST /api/mod/conversations/{conversation_id}/temp_ban

  • Write

    Unarchive modmail conversation

    Marks conversation as unarchived.

    POST /api/mod/conversations/{conversation_id}/unarchive

  • Write

    Unban modmail user

    Unban the non mod user associated with a particular conversation.

    POST /api/mod/conversations/{conversation_id}/unban

  • Write

    Unmute modmail user

    Unmutes the non mod user associated with a particular conversation.

    POST /api/mod/conversations/{conversation_id}/unmute

  • Write

    Mark modmail conversations read

    Marks a conversations as read for the user.

    POST /api/mod/conversations/read

  • Write

    Mark modmail conversations unread

    Marks conversations as unread for the user.

    POST /api/mod/conversations/unread

  • Destructive

    Remove modmail highlight

    Removes a highlight from a conversation.

    DELETE /api/mod/conversations/{conversation_id}/highlight

Mod notes

  • Read

    List mod notes

    Get mod notes for a specific user in a given subreddit.

    GET /api/mod/notes

  • Read

    Get recent mod notes

    Fetch the most recent notes written by a moderator Both parameters should be comma separated lists of equal lengths.

    GET /api/mod/notes/recent

  • Write

    Create mod note

    Create a mod user note where type=NOTE.

    POST /api/mod/notes

  • Destructive

    Delete mod note

    Delete a mod user note where type=NOTE. Parameters should be passed as query parameters.

    DELETE /api/mod/notes

Multireddits

  • Read

    List my multireddits

    Fetch a list of multis belonging to the current user.

    GET /api/multi/mine

  • Read

    List user's multireddits

    Fetch a list of public multis belonging to username.

    GET /api/multi/user/{username}

  • Read

    Get multireddit

    Fetch a multi's data and subreddit list by name.

    GET /api/multi/{multipath}

  • Read

    Get multireddit description

    Get a multi's description.

    GET /api/multi/{multipath}/description

  • Read

    Get subreddit in multireddit

    Get data about a subreddit in a multi.

    GET /api/multi/{multipath}/r/{srname}

  • Write

    Copy multireddit

    Copy a multi. Responds with 409 Conflict if the target already exists.

    POST /api/multi/copy

  • Write

    Create multireddit

    Create a multi. Responds with 409 Conflict if it already exists.

    POST /api/multi/{multipath}

  • Write

    Add subreddit to multireddit

    Add a subreddit to a multi.

    PUT /api/multi/{multipath}/r/{srname}

  • Destructive

    Delete multireddit

    Delete a multi.

    DELETE /api/multi/{multipath}

  • Destructive

    Create or update multireddit

    Create or update a multi.

    PUT /api/multi/{multipath}

  • Destructive

    Update multireddit description

    Change a multi's markdown description.

    PUT /api/multi/{multipath}/description

  • Destructive

    Remove subreddit from multireddit

    Remove a subreddit from a multi.

    DELETE /api/multi/{multipath}/r/{srname}

Search

  • Read

    Search posts

    Search links page.

    GET [/r/{subreddit}]/search

Subreddits

  • Read

    List subreddit user relationships

    Lists a subreddit's banned, muted, wiki-banned, approved, wiki-contributor or moderator users.

    GET [/r/{subreddit}]/about/{where}

  • Read

    Search subreddit names

    List subreddit names that begin with a query string. Subreddits whose names begin with query will be returned.

    GET /api/search_reddit_names

  • Read

    Search subreddit names (POST)

    List subreddit names that begin with a query string. Subreddits whose names begin with query will be returned.

    POST /api/search_reddit_names

  • Read

    Search subreddits

    List subreddits that begin with a query string. Subreddits whose names begin with query will be returned.

    POST /api/search_subreddits

  • Read

    Get submission text

    Get the submission text for the subreddit. This text is set by the subreddit moderators and intended to be displayed on the submission form.

    GET [/r/{subreddit}]/api/submit_text

  • Read

    Autocomplete subreddits

    Return a list of subreddits and data for subreddits whose names start with 'query'. Uses typeahead endpoint to recieve the list of subreddits names.

    GET /api/subreddit_autocomplete

  • Read

    Autocomplete subreddits (v2)

    Returns subreddits whose names start with the typed text, using the newer format.

    GET /api/subreddit_autocomplete_v2

  • Read

    Get post requirements

    Fetch moderator-designated requirements to post to the subreddit. Moderators may enable certain restrictions, such as minimum title length, when making a submission to their subreddit.

    GET /api/v1/{subreddit}/post_requirements

  • Read

    Get subreddit details

    Return information about the subreddit. Data includes the subscriber count, description, and header image.

    GET /r/{subreddit}/about

  • Read

    Get subreddit settings

    Get the current settings of a subreddit. In the API, this returns the current settings of the subreddit as used by /api/site_admin.

    GET /r/{subreddit}/about/edit

  • Read

    Get subreddit rules

    Get the rules for the current subreddit.

    GET /r/{subreddit}/about/rules

  • Read

    Get subreddit traffic

    Returns traffic statistics (page views and uniques) for a subreddit.

    GET /r/{subreddit}/about/traffic

  • Read

    Get subreddit sidebar

    Get the sidebar for the current subreddit.

    GET [/r/{subreddit}]/sidebar

  • Read

    Get stickied post

    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.

    GET [/r/{subreddit}]/sticky

  • Read

    List my subreddits

    Lists subreddits the user subscribes to, contributes to or moderates.

    GET /subreddits/mine/{where}

  • Read

    Search subreddits by title

    Search subreddits by title and description.

    GET /subreddits/search

  • Read

    List subreddits

    Lists popular, new, gold-only or default subreddits.

    GET /subreddits/{where}

  • Read

    Search user profiles

    Search user profiles by title and description.

    GET /users/search

  • Read

    List user profiles

    Lists popular or new user profile subreddits.

    GET /users/{where}

  • Write

    Subscribe or unsubscribe

    Subscribe to or unsubscribe from a subreddit. To subscribe, action should be sub.

    POST /api/subscribe

  • Destructive

    Delete subreddit banner

    Remove the subreddit's custom mobile banner.

    POST [/r/{subreddit}]/api/delete_sr_banner

  • Destructive

    Delete subreddit header

    Remove the subreddit's custom header image. The sitewide-default header image will be shown again after this call.

    POST [/r/{subreddit}]/api/delete_sr_header

  • Destructive

    Delete subreddit icon

    Remove the subreddit's custom mobile icon.

    POST [/r/{subreddit}]/api/delete_sr_icon

  • Destructive

    Delete subreddit image

    Remove an image from the subreddit's custom image set. The image will no longer count against the subreddit's image limit.

    POST [/r/{subreddit}]/api/delete_sr_img

  • Destructive

    Create or configure subreddit

    Create or configure a subreddit. If sr is specified, the request will attempt to modify the specified subreddit.

    POST /api/site_admin

  • Destructive

    Update subreddit stylesheet

    Update a subreddit's stylesheet. op should be save to update the contents of the stylesheet.

    POST [/r/{subreddit}]/api/subreddit_stylesheet

  • Destructive

    Upload subreddit image

    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 in name.

    POST [/r/{subreddit}]/api/upload_sr_img

Users

  • Read

    Get users by account ID

    Returns basic data for users from a list of account fullnames.

    GET /api/user_data_by_account_ids

  • Read

    Check username availability

    Check whether a username is available for registration.

    GET /api/username_available

  • Read

    Get user trophies

    Return a list of trophies for the a given user.

    GET /api/v1/user/{username}/trophies

  • Read

    Get user details

    Return information about the user, including karma and gold status.

    GET /user/{username}/about

  • Read

    List user activity

    Lists a user's overview, posts, comments, upvoted, downvoted, hidden, saved or gilded items.

    GET /user/{username}/{where}

  • Write

    Block user

    For blocking a user. Only accessible to approved OAuth applications.

    POST /api/block_user

  • Write

    Add user relationship

    Adds a user to a subreddit role such as moderator, approved user, banned or muted, or adds a friend.

    POST [/r/{subreddit}]/api/friend

  • Write

    Report user

    Report a user. Reporting a user brings it to the attention of a Reddit admin.

    POST /api/report_user

  • Write

    Set moderator permissions

    Changes the permissions of a moderator or moderator invite in a subreddit.

    POST [/r/{subreddit}]/api/setpermissions

  • Write

    Add or update friend

    Create or update a "friend" relationship. This operation is idempotent.

    PUT /api/v1/me/friends/{username}

  • Destructive

    Remove user relationship

    Remove a relationship between a user and another user or subreddit The user can either be passed in by name (nuser) or by fullname (iuser).

    POST [/r/{subreddit}]/api/unfriend

  • Destructive

    Remove friend

    Stop being friends with a user.

    DELETE /api/v1/me/friends/{username}

Widgets

  • Read

    List widgets

    Return all widgets for the given subreddit.

    GET [/r/{subreddit}]/api/widgets

  • Write

    Add widget

    Add and return a widget to the specified subreddit Accepts a JSON payload representing the widget data to be saved. Valid payloads differ in shape based on the "kind" attribute passed on the root object, which must be a valid widget kind.

    POST [/r/{subreddit}]/api/widget

  • Write

    Get widget image upload lease

    Acquire and return an upload lease to s3 temp bucket. The return value of this function is a json object containing credentials for uploading assets to S3 bucket, S3 url for upload request and the key to use for uploading.

    POST [/r/{subreddit}]/api/widget_image_upload_s3

  • Write

    Reorder widgets

    Update the order of widget_ids in the specified subreddit.

    PATCH [/r/{subreddit}]/api/widget_order/{section}

  • Destructive

    Delete widget

    Delete a widget from the specified subreddit (if it exists).

    DELETE [/r/{subreddit}]/api/widget/{widget_id}

  • Destructive

    Update widget

    Update and return the data of a widget. Accepts a JSON payload representing the widget data to be saved.

    PUT [/r/{subreddit}]/api/widget/{widget_id}

Wiki

  • Read

    List wiki page discussions

    Retrieve a list of discussions about this wiki page.

    GET [/r/{subreddit}]/wiki/discussions/{page}

  • Read

    List wiki pages

    Retrieve a list of wiki pages in this subreddit.

    GET [/r/{subreddit}]/wiki/pages

  • Read

    List recent wiki revisions

    Retrieve a list of recently changed wiki pages in this subreddit.

    GET [/r/{subreddit}]/wiki/revisions

  • Read

    List wiki page revisions

    Retrieve a list of revisions of this wiki page.

    GET [/r/{subreddit}]/wiki/revisions/{page}

  • Read

    Get wiki page settings

    Retrieve the current permission settings for page.

    GET [/r/{subreddit}]/wiki/settings/{page}

  • Read

    Get wiki page

    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.

    GET [/r/{subreddit}]/wiki/{page}

  • Write

    Allow or deny wiki editor

    Adds or removes a user's permission to edit a wiki page.

    POST [/r/{subreddit}]/api/wiki/alloweditor/{act}

  • Write

    Edit wiki page

    Edit a wiki page.

    POST [/r/{subreddit}]/api/wiki/edit

  • Write

    Toggle wiki revision visibility

    Toggle the public visibility of a wiki page revision.

    POST [/r/{subreddit}]/api/wiki/hide

  • Write

    Update wiki page settings

    Update the permissions and visibility of wiki page.

    POST [/r/{subreddit}]/wiki/settings/{page}

  • Destructive

    Revert wiki page

    Revert a wiki page to revision.

    POST [/r/{subreddit}]/api/wiki/revert

Get started

  1. Open Space settings → Connections and search for Reddit.
  2. Connect your account and add the connection to the Space.
  3. Ask for what you need in any thread in that Space.

See How connections work for access and permissions, or browse all integrations.

Reference date: October 28, 2026. Reddit API docs.