Disqus logo

Disqus

Disqus is a discussion and community platform for managing forums, threads, posts, users, moderation, and organization settings.

148 actions Integration catalog
Request access
Connect Disqus once you're in Boring.
01 · WHAT THE AGENT CAN DO

Actions

Every capability is a discrete, logged action the agent calls by name — scoped to what you authorize and recorded in the run trace.

Add Blacklist EntryDISQUS_ADD_BLACKLIST_ENTRY
Adds an entry to the blacklist. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
Add Forum ModeratorDISQUS_ADD_FORUM_MODERATOR
Adds 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 remains capability/account dependent.
Add Organization AdminDISQUS_ADD_ORGANIZATION_ADMIN
Adds 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 not identify a billing tier; availability remains capability/account dependent.
Add Whitelist EntryDISQUS_ADD_WHITELIST_ENTRY
Adds an entry to the whitelist. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
Approve PostsDISQUS_APPROVE_POSTS
Approves 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 capability/account dependent.
Approve ThreadDISQUS_APPROVE_THREAD
Approve 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 including 'forum'. The official action page does not identify a billing tier; availability remains capability/account dependent.
Award BadgeDISQUS_AWARD_BADGE
Used to award badges to users manually. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
Backfill Blacklist CountersDISQUS_BACKFILL_BLACKLIST_COUNTERS
Triggers 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 ForumDISQUS_BAN_POST_AUTHOR_FROM_FORUM
Ban 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 official action page does not identify a billing tier; availability remains capability/account dependent.
Bulk Create Internal Forum Action HistoryDISQUS_BULK_CREATE_INTERNAL_FORUM_ACTION_HISTORY
Creates 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, and blacklist or whitelist metadata. Caveats: The billing tier is undocumented. This endpoint requires a DISQUS-internal administrator role; OAuth admin scope does not confer that staff role.
Check And Update UsernameDISQUS_CHECK_AND_UPDATE_USERNAME
Updates 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 capability/account dependent.
Close ThreadsDISQUS_CLOSE_THREADS
Closes 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 the 'link' query type to filter by URL. You must pass the 'forum' if you do not have the Pro API Access addon. The official action page does not identify a billing tier; availability remains capability/account dependent. A forum selector is required when the account lacks the Pro API Access addon where the relevant parameter description says so.
Create CategoryDISQUS_CREATE_CATEGORY
Creates 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 capability/account dependent.
Create ForumDISQUS_CREATE_FORUM
Creates a new forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
Create Forum Trusted DomainDISQUS_CREATE_FORUM_TRUSTED_DOMAIN
Adds 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 remains capability/account dependent.
Create Internal Forum Action HistoryDISQUS_CREATE_INTERNAL_FORUM_ACTION_HISTORY
Creates 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 scope did not confer that staff role.
Create PostDISQUS_CREATE_POST
Creates 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 uses server-side application-secret authentication and requires moderator permission. The state and date fields also require moderator permission; state skips pre-approval validation. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
Create ThreadDISQUS_CREATE_THREAD
Creates a new thread. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
Create Thread Reaction ImagesDISQUS_CREATE_THREAD_REACTION_IMAGES
Used 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 tier; availability remains capability/account dependent.
Delete Internal Forum Action HistoryDISQUS_DELETE_INTERNAL_FORUM_ACTION_HISTORY
Deletes 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 Sso UserDISQUS_DELETE_SSO_USER
Deletes an SSO user account and their comment history. This performs a full GDPR-style deletion: the user account is deactivated and all associated posts are removed. 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 capability/account dependent.
Delete Thread Reaction ImagesDISQUS_DELETE_THREAD_REACTION_IMAGES
Used 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; availability remains capability/account dependent.
Disable Forum AdsDISQUS_DISABLE_FORUM_ADS
Disable 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; availability remains capability/account dependent.
Dismiss Aet BannerDISQUS_DISMISS_AET_BANNER
Records 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. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
Export Aet OptoutsDISQUS_EXPORT_AET_OPTOUTS
Export 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. The official action page does not identify a billing tier; availability remains capability/account dependent.
Export Aet SubscribersDISQUS_EXPORT_AET_SUBSCRIBERS
Export 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 billing tier; availability remains capability/account dependent.
Export ForumDISQUS_EXPORT_FORUM
Start 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 LogDISQUS_EXPORT_ORGANIZATION_AUDIT_LOG
Export the audit log for the specified organization. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
Follow ForumDISQUS_FOLLOW_FORUM
Follow a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
Follow UserDISQUS_FOLLOW_USER
Follow a user. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
Generate Interesting Forum ContentDISQUS_GENERATE_INTERESTING_FORUM_CONTENT
Internal 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 capability/account dependent.
Get Application UsageDISQUS_GET_APPLICATION_USAGE
Returns 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 CategoryDISQUS_GET_CATEGORY
Returns category details. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
Get Customer Pulse MetadataDISQUS_GET_CUSTOMER_PULSE_METADATA
Returns 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 capability/account dependent.
Get Customer Pulse SegmentDISQUS_GET_CUSTOMER_PULSE_SEGMENT
Returns 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 response limit. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
Get ForumDISQUS_GET_FORUM
Returns forum details. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
Get Forum Behind Click SettingDISQUS_GET_FORUM_BEHIND_CLICK_SETTING
Returns forum custom behind-a-click settings Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
Get Forum CategoryDISQUS_GET_FORUM_CATEGORY
Returns forum category details. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
Get Forum Reaction ConfigDISQUS_GET_FORUM_REACTION_CONFIG
Used 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 short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent.
Get ImportDISQUS_GET_IMPORT
Return details for an import group. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
Get Organization Billing InformationDISQUS_GET_ORGANIZATION_BILLING_INFORMATION
Returns 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 an organization by ID You must be an admin on the selected organization. The official action page does not identify a billing tier; availability remains capability/account dependent. This SaaS/billing action may require organization billing capability even though the page does not name a paid tier.
Get Organization Current PlanDISQUS_GET_ORGANIZATION_CURRENT_PLAN
Return 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 billing tier; availability remains capability/account dependent. This SaaS/billing action may require organization billing capability even though the page does not name a paid tier.
Get Page By ThreadDISQUS_GET_PAGE_BY_THREAD
Returns a page by thread id. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
Get Pending Aet ExportDISQUS_GET_PENDING_AET_EXPORT
Returns 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 ExportDISQUS_GET_PENDING_AET_OPTOUT_EXPORT
Returns 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 PostDISQUS_GET_POST
Returns information about a post. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
Get Post ContextDISQUS_GET_POST_CONTEXT
Returns 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 tier; availability remains capability/account dependent.
Get ThreadDISQUS_GET_THREAD
Returns thread details. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
Get Thread Ratings SummaryDISQUS_GET_THREAD_RATINGS_SUMMARY
Returns 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 ImagesDISQUS_GET_THREAD_REACTION_DEFAULT_IMAGES
Returns 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 capability/account dependent.
Get Threads By IdsDISQUS_GET_THREADS_BY_IDS
Returns 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 required when the account lacks the Pro API Access addon where the relevant parameter description says so.
Get UserDISQUS_GET_USER
Returns details of a user. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
List Awarded BadgesDISQUS_LIST_AWARDED_BADGES
Returns 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 BadgesDISQUS_LIST_BADGES
Used 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 tier; availability remains capability/account dependent.
List Blacklist EntriesDISQUS_LIST_BLACKLIST_ENTRIES
Returns one page of blacklist entries. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.
List CategoriesDISQUS_LIST_CATEGORIES
Returns 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/account dependent.
List Categories In ForumDISQUS_LIST_CATEGORIES_IN_FORUM
Returns 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 dependent.
List Category PostsDISQUS_LIST_CATEGORY_POSTS
Returns 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 ThreadsDISQUS_LIST_CATEGORY_THREADS
Returns 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 FaviconsDISQUS_LIST_CLASSIFIED_FORUMS_NEEDING_FAVICONS
Gets 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 capability/account dependent.
Showing the first 60 of 148 actions.