Disqus for AI agents
Agents read Disqus at once. Changes and sends are held for a person's approval by default.
About Disqus
Disqus is a discussion and community platform for managing forums, threads, posts, users, moderation, and organization settings.
What an agent can do in Disqus
Every Disqus action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in Disqus without asking first. 71 actions.
- Get Application UsageReturns the API usage per day for this application. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Get CategoryReturns category details. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Get Customer Pulse MetadataReturns Customer Pulse metadata available to the authenticated application; this endpoint takes no input. Caveats: The official action page does not identify a billing tier; availability remains capab
- Get Customer Pulse SegmentReturns a bounded Customer Pulse segment snapshot available to the authenticated application; this endpoint takes no input and may truncate deeply nested segment values to stay within the tool respons
- Get ForumReturns forum details. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Get Forum Behind Click SettingReturns forum custom behind-a-click settings Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Get Forum CategoryReturns forum category details. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Get Forum Reaction ConfigUsed to load any configured reactions for the forum, and all active images belong to that forum. Also returns whether thread reactions are enabled for the forum. Caveats: Looks up a forum by ID (aka s
- Get ImportReturn details for an import group. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Get Organization Billing InformationReturns billing information related to an organization. This is in a dictionary with keys: `paymentInfo` (optional): `invoiceHistory`: Historical invoices that were successfully paid Caveats: Looks up
- Get Organization Current PlanReturn the current SaaS plan for an organization and product. Caveats: Looks up an organization by ID You must be an admin on the selected organization. The official action page does not identify a bi
- Get Page By ThreadReturns a page by thread id. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
Show all 71
- Get Pending Aet ExportReturns pending AET subscriber-export status for a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Get Pending Aet Optout ExportReturns pending AET opt-out-export status for a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Get PostReturns information about a post. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Get Post ContextReturns the hierarchical tree of a post (all parents). asc - oldest first desc - newest first popular - highest upvote rating over time. Caveats: The official action page does not identify a billing t
- Get ThreadReturns thread details. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Get Thread Ratings SummaryReturns average and total ratings for a thread. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Get Thread Reaction Default ImagesReturns the metadata of the default reactions. This way they can display for forums that don't use reactions. Caveats: The official action page does not identify a billing tier; availability remains c
- Get Threads By IdsReturns an unsorted set of threads given a list of ids. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. A forum selector is requi
- Get UserReturns details of a user. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List Awarded BadgesReturns one page of awarded badges for the user. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List BadgesUsed to load any configured badges for the forum. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing t
- List Blacklist EntriesReturns one page of blacklist entries. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List CategoriesReturns one page of categories from the categories/list endpoint across the supplied forum IDs. Caveats: The official action page does not identify a billing tier; availability remains capability/acco
- List Categories In ForumReturns one page of categories from the forums/listCategories endpoint for one forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account depend
- List Category PostsReturns one page of posts within a category. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List Category ThreadsReturns one page of threads within a category, sorted by creation date. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List Classified Forums Needing FaviconsGets forums that are classified in tempest (primarily means has a high quality score and is in english) Caveats: The official action page does not identify a billing tier; availability remains capabil
- List Forum CategoriesReturns a list of forum categories Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List Forum FollowersReturns one page of users following a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List Forum ModeratorsReturns a list of all moderators on a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List Forum PostsReturns one page of posts within a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List Forum ThreadsReturns one page of threads within a forum, sorted by creation date. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. A forum sele
- List Forum Trusted DomainsReturns a list of forum trusted domains Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; avail
- List Forum User Moderation HistoryReturns one page of moderation history for a given user on a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List Hot ThreadsReturns a list of threads sorted by hotness (date and likes). Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List ImportsReturn one page of imports for a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List Interesting ForumsReturn forums selected by the interesting-forums action. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List Interesting UsersReturns a list of interesting users. This is not personalized to the user making the request. The selection of users is pulled randomly from a list of ~100 interesting users Caveats: The official acti
- List Most Active Forum UsersReturns one page of users active within a forum, ordered by most comments made. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List Most Liked Forum UsersReturns one page of users active within a forum, ordered by most likes received. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List Organization RolesList all users with elevated roles in an organization. Caveats: Looks up an organization by ID You must be an admin on the selected organization. The official action page does not identify a billing t
- List PagesReturns one page of category objects with hot-thread page data for forums in each category. Caveats: The official action page does not identify a billing tier; availability remains capability/account
- List Popular PostsReturns one page of posts ordered by recent likes. Pagination defaults to limit 25 and offset 0. Caveats: This beta endpoint is subject to change. The official action page does not identify a billing
- List Popular ThreadsReturns a list of threads sorted by number of posts made since ``interval``. If you are using both ``category`` and ``forum`` parameters, the forum of the category must match that as the parameter val
- List Post Moderation HistoryReturns one page of moderation history for a given post. Caveats: Looks up a post by ID You must be a moderator on the selected post's forum. The official action page does not identify a billing tier;
- List Post ReportersReturn users who reported the specified moderated posts. Caveats: Looks up a post by ID You must be a moderator on the selected post's forum. The official action page does not identify a billing tier;
- List PostsReturns one page of posts ordered by creation date. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List Random PagesReturns a random list of category objects with page data of HotThreads for forums in that given category. Caveats: The official action page does not identify a billing tier; availability remains capab
- List Saas PackagesReturn SaaS packages available to the specified organization. Caveats: Looks up an organization by ID You must be an admin on the selected organization. The official action page does not identify a bi
- List Thread PostsReturns one page of posts within a thread. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List Thread ReactionsUsed to load the configured reactions for a thread. Also returns which reactions, if any, are selected by the user, as well as the eligibility of the thread for thread-reactions. Caveats: The official
- List ThreadsReturns one page of threads sorted by creation date. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. A forum selector is required
- List Trending ThreadsReturns a list of trending threads. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List User Active ForumsReturns one page of forums a user has been active on. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List User ActivityReturns one page of activity made by the user. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List User FollowersReturns one page of users following a user. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List User FollowingReturns one page of users a user is following. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List User Following ChannelsReturns one page of channels a user is following. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List User Following ForumsReturns one page of forums a user is following. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List User ForumsReturns one page of forums a user owns. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List User Moderated ChannelsReturns one page of channels that the user moderates. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List User Most Active ForumsReturns forums a user has recently been active on, sorted by the user's activity. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List User Owned ChannelsReturns one page of channels that the user owns. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List User PostsReturns one page of posts made by the user. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- List Users Who Voted On ThreadReturns a list of users that voted on this thread. If prioritize_followed is True and the user is authenticated, attempts to return users that the authenticated user follows. If there aren't enough fo
- List Whitelist EntriesReturns one page of whitelist entries. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Suggest PostsReturn Apothecary suggestions for the specified posts. Caveats: Looks up a post by ID You must be a moderator on the selected post's forum. The official action page does not identify a billing tier; a
- Validate Forum SettingsValidate the documented settings for a moderator-managed forum. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identi
- Validate Organization CouponLooks up a coupon string and validates against redeem_by and max_redemptions using CouponValidator. Returns serialized Coupon object or error message. Caveats: Looks up an organization by ID You must
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 75 actions.
- Add Blacklist EntryAdds an entry to the blacklist. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Add Forum ModeratorAdds a moderator to a forum. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability rem
- Add Organization AdminAdds an admin to an organization. Updates permissions of existing admins too. Caveats: Looks up an organization by ID You must be an admin on the selected organization. The official action page does n
- Add Whitelist EntryAdds an entry to the whitelist. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Approve PostsApproves the requested post(s). Caveats: Looks up a post by ID You must be a moderator on the selected post's forum. The official action page does not identify a billing tier; availability remains cap
- Approve ThreadApprove the specified moderated threads. Caveats: Looks up a thread by ID You must be a moderator on the selected thread's forum. You may pass us the 'ident' or 'link' query types instead of an ID by
- Award BadgeUsed to award badges to users manually. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Backfill Blacklist CountersTriggers Disqus's parameterless blacklist-counter backfill endpoint. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Ban Post Author From ForumBan the author of a post using the selected user, email, IP, shadow-ban, and retroactive-action options. Caveats: Looks up a post by ID You must be a moderator on the selected post's forum. The offici
- Bulk Create Internal Forum Action HistoryCreates many ActionHistory rows for backfilling from a JSON-encoded list of row dictionaries. Each row can identify the source row and carry action, forum, actor, target, thread, post, IP, date, rule,
- Check And Update UsernameUpdates username for the user, fails if username does not meet requirements, or is taken by another user. Caveats: The official action page does not identify a billing tier; availability remains capab
- Close ThreadsCloses a thread. Caveats: Looks up a thread by ID You must be a moderator on the selected thread's forum. You may pass us the 'ident' query type instead of an ID by including 'forum'. You may pass us
Show all 75
- Create CategoryCreates a new category. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains
- Create ForumCreates a new forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Create Forum Trusted DomainAdds a trusted domain to a forum Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability
- Create Internal Forum Action HistoryCreates an ActionHistory row for backfilling. Caveats: The billing tier is undocumented. This endpoint requires a DISQUS-internal administrator role; the live OAuth account reached it, but OAuth admin
- Create PostCreates a new post as the authenticated OAuth user. Anonymous author fields are intentionally unavailable because Disqus forbids author_* parameters for authenticated callers. An ip_address override u
- Create ThreadCreates a new thread. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Create Thread Reaction ImagesUsed to save custom reactions that an admin creates Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing
- Delete Internal Forum Action HistoryDeletes an ActionHistory row for backfilling. Caveats: The billing tier is undocumented. This endpoint requires a DISQUS-internal administrator role; OAuth admin scope does not confer that staff role.
- Delete Thread Reaction ImagesUsed to delete custom reactions of a forum Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; av
- Disable Forum AdsDisable advertising for the specified forum. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier;
- Dismiss Aet BannerRecords the authenticated user's dismissal of the AET banner for a forum, changing that user's banner state. If the user has already accepted or dismissed it, Disqus returns HTTP 400 with error code 2
- Export Aet OptoutsExport opt-out records collected for a forum, either all records or those since the last partial export. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.
- Export Aet SubscribersExport subscribed users in either csv or json format. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billi
- Export ForumStart an export for the specified forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Export Organization Audit LogExport the audit log for the specified organization. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Follow ForumFollow a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Follow UserFollow a user. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Generate Interesting Forum ContentInternal only endpoint that causes the interesting content (forums) to be generated, but not returned. Caveats: The official action page does not identify a billing tier; availability remains capabili
- Mark Posts As SpamMarks the requested post(s) as spam. Caveats: Looks up a post by ID You must be a moderator on the selected post's forum. The official action page does not identify a billing tier; availability remain
- Open ThreadsOpens a thread. Caveats: Looks up a thread by ID You must be a moderator on the selected thread's forum. You may pass us the 'ident' query type instead of an ID by including 'forum'. You may pass us t
- Remove BadgeUsed to remove badges from users. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Remove Blacklist EntryRemoves an entry from the blacklist. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Remove Forum Default AvatarSwitches a forum to use the regular default avatar instead of a custom one Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does
- Remove Forum ModeratorRemoves a moderator from a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Remove Forum Trusted DomainRemoves a trusted domain from a forum Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availab
- Remove Organization AdminRemoves an admin from an organization. Caveats: Looks up an organization by ID You must be an admin on the selected organization. The official action page does not identify a billing tier; availabilit
- Remove PostsDeletes the requested post(s). Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Remove ThreadsRemoves a thread. Caveats: Looks up a thread by ID You must be a moderator on the selected thread's forum. You may pass us the 'ident' query type instead of an ID by including 'forum'. You may pass us
- Remove User FollowerRemove a user from set of followers. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Remove Whitelist EntryRemoves an entry from the whitelist. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Replace Forum BadgesUsed to update the configured badges for a forum. Badges are passed in as an array of badge objects, some of which have IDs. Badges that have IDs will be updated in the database while badges without I
- Report PostReports a post (flagging). Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Report UserReport the specified user for the selected reason. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Restore PostsUndeletes the requested post(s). Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Restore ThreadsCalls Disqus's restore endpoint for the requested threads; the provider describes the effect as opening a thread. Caveats: Looks up a thread by ID You must be a moderator on the selected thread's foru
- Save Forum Thread Reaction TemplateUsed to save a new configuration for thread reactions for a forum. Also enables threads reactions for the forum. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selecte
- Set Organization RoleAdd a user with an arbitrary role to an organization. Caveats: Looks up an organization by ID You must be an admin on the selected organization. The official action page does not identify a billing ti
- Set Thread Reactions For ForumEnables thread reactions for a forum, or disables them when requested. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not
- Set Thread Reactions For ThreadDisables thread reactions for a thread, or enables them when requested. This is primarily a per-thread override of the forum configuration. Caveats: Looks up a thread by ID You must be a moderator on
- Spam ThreadMark the specified moderated threads as spam. Caveats: Looks up a thread by ID You must be a moderator on the selected thread's forum. You may pass us the 'ident' or 'link' query types instead of an I
- Subscribe Anonymous User To AetAllows an anonymous user to subscribe to AET banner for a forum. If the user has already accepted before, a 400 will be returned with 2 as the error code. Caveats: The official action page does not id
- Subscribe Organization To SaasSubscribe an organization to the specified SaaS pricing option, optionally using a coupon or activation code. Caveats: Looks up an organization by ID You must be an admin on the selected organization.
- Subscribe ThreadSubscribe the authenticated user to a thread. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Subscribe To AetAllows an authenticated user to subscribe to AET for a forum. If the user has already accepted/dismissed before, a 400 will be returned with 2 as the error code. Caveats: The official action page does
- Toggle Badge Award VisibilityUsed to toggle the hidden status of a badge award across Disqus for a user Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Unfollow ForumUnfollow a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Unfollow UserUnfollow a user. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Unsubscribe Organization From SaasUnsubscribe an organization from a SaaS product, immediately or at the documented default time. Caveats: Looks up an organization by ID You must be an admin on the selected organization. The official
- Unsubscribe ThreadUnsubscribe the authenticated user from a thread. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Update ForumUpdates forum details. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains c
- Update Forum Behind Click SettingSets the forum custom behind-a-click settings Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier;
- Update Forum Default AvatarAutomatically crops avatar to the largest centered square and saves as the forum's default avatar. Returns the updated 92px avatar url. Caveats: Looks up a forum by ID (aka short name) You must be a m
- Update Forum FaviconUpdate the favicon for the specified forum. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; a
- Update Internal Forum Action HistoryUpdates an ActionHistory row for backfilling. Caveats: The billing tier is undocumented. This endpoint requires a DISQUS-internal administrator role; OAuth admin scope does not confer that staff role.
- Update Organization Invoice InformationUpdate information that appears in invoices we send to customers for stripe charges. Caveats: Looks up an organization by ID You must be an admin on the selected organization. The official action page
- Update Organization Payment InformationUpdate an organization's payment information using the supplied payment token. Caveats: Looks up an organization by ID You must be an admin on the selected organization. The official action page does
- Update PostUpdates information on a post. Star ratings update can also be passed on post update Caveats: You must be the author of the post or a moderator on the applicable forum. The official action page does n
- Update ThreadUpdates information on a thread. Caveats: You must be the author of the post or a moderator on the applicable forum. You must be a moderator on the applicable forum to change a thread author. You may
- Update TopicUpdate the specified topic using the documented topic fields. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Update User ProfileUpdates user profile. All fields are optional, but any field not present will be updated as blank. Caveats: The official action page does not identify a billing tier; availability remains capability/a
- Vote PostRegister a vote on a post. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Vote ThreadRegister a vote on a thread. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
- Vote Thread ReactionUsed to vote on a reaction. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
Changes wait in Needs you
Changes and sends in Disqus are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
Disqus questions
Can an agent change data in Disqus on its own?
Not by default. Changes and sends in Disqus are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in Disqus?
This connector lists 71 read actions. Reads run at once, without waiting for approval.
How does Disqus connect?
It connects with OAuth 2.0. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.