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 link flair
Return list of available link flair for the current subreddit. Will not return flair if the user cannot set their own link flair and they are not a moderator that can set flair.
GET [/r/{subreddit}]/api/link_flair - Read
List link flair (v2)
Return list of available link flair for the current subreddit. Will not return flair if the user cannot set their own link flair and they are not a moderator that can set flair.
GET [/r/{subreddit}]/api/link_flair_v2 - 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
No operations match.
Get started
- Open Space settings → Connections and search for Reddit.
- Connect your account and add the connection to the Space.
- 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.