Skip to main content
Disqus logo
  • Category: social media accounts
  • Auth: OAUTH2
  • Composio-managed OAuth available? No
  • Tools: 148
  • Triggers: 0
  • Slug: DISQUS
  • Version: 20261101_00

Tools

Slug: DISQUS_ADD_BLACKLIST_ENTRYAdds an entry to the blacklist. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

array
IP addresses in CIDR notation to add. Provide at least one blacklist selector.
array
User IDs to add. Provide at least one blacklist selector.
array
Words to add, each with a maximum length of 200. Provide at least one blacklist selector.
array
RFC 5322 email addresses to add. Provide at least one blacklist selector.
string
required
Looks up a forum by ID (aka short name)
string
Maximum length of 50
array
Domain names to add. Provide at least one of domain, word, ip, user, or email.
string
Provider parameter shadowBan; the official endpoint page does not further describe its accepted shape.
string
Deprecated. Apply blacklist retroactively to existing posts, marking them killed
string
Unix timestamp (or ISO datetime standard)
array
Disqus usernames to add instead of user IDs. Provide at least one blacklist selector.
string ("1" | "2")
Action to apply retroactively to existing posts. Leave blank to apply no action Valid values are: 1: KILL 2: SPAM

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 remains capability/account dependent.

Input Parameters

string
User ID to add as a moderator.
string
required
Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.
string
Provider parameter canEdit; the official endpoint page does not further describe its accepted shape.
string
Disqus username to add instead of a user ID.
string
Provider parameter canAdminister; the official endpoint page does not further describe its accepted shape.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
User ID to add as an admin.
string
required
Looks up an organization by ID You must be an admin on the selected organization.
string
Disqus username to add instead of a user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_ADD_WHITELIST_ENTRYAdds one or more entries to a forum’s whitelist by email or user. Availability remains capability/account dependent.

Input Parameters

array
User IDs to add. Provide at least one selector.
array
RFC 5322 email addresses to add. Provide at least one of email or user.
string
required
Looks up a forum by ID (aka short name)
string
Maximum length of 50
array
Disqus usernames to add instead of user IDs. Provide at least one selector.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 capability/account dependent.

Input Parameters

array
required
Looks up a post by ID You must be a moderator on the selected post’s forum.
string
Bypass the new user premoderation for the author(s) of the post(s).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_APPROVE_THREADApproves a specified moderated thread by ID, identifier, or link. Identifier and link lookups require the forum; you must be a moderator on the thread’s forum.

Input Parameters

string
Looks up a forum by ID (aka short name)
string
Thread ID to approve.
Thread URL to approve; requires forum.
string
Thread identifier to approve; requires forum.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_AWARD_BADGEUsed to award badges to users manually. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
User ID to receive the badge.
string
required
Looks up a manual badge by ID
string
required
Looks up a forum by ID (aka short name)
string
Disqus username to receive the badge instead of a user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a post by ID You must be a moderator on the selected post’s forum.
string
Maximum length of 50
string
Ban the ip address associated with the post
string
Ban the user who authored the post if one exists
string
Ban the email address associated with the post
string
Provider parameter shadowBan; the official endpoint page does not further describe its accepted shape.
string
Unix timestamp (or ISO datetime standard)
string ("1" | "2")
Action to apply retroactively to existing posts. Leave blank to apply no action Valid values are: 1: KILL 2: SPAM

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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, 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.

Input Parameters

array
required
JSON-encoded list of row dictionaries. Each row has identifier, integer action, and forum keys; documented optional keys are user, thread, post, targetUser, ipAddress, dateAdded, extra_data, and rule. The provider does not define the scalar types of every key.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 capability/account dependent.

Input Parameters

string
Disqus username Minimum length of 3 Maximum length of 30

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_CLOSE_THREADSCloses one or more threads selected by ID, identifier, or URL. You must be a moderator on the threads’ forum; identifier selection requires a forum, and URL selection requires one if the account lacks the Pro API Access addon.

Input Parameters

string
Looks up a forum by ID (aka short name)
array
Thread IDs to close.
Thread URLs to close. Forum is required by Disqus only when the account lacks the Pro API Access addon.
array
Thread identifiers to close; requires forum.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 capability/account dependent.

Input Parameters

string
required
Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.
string
required
Maximum length of 50
string
Provider parameter default; the official endpoint page does not further describe its accepted shape.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_CREATE_FORUMCreates a new forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
required
Forum name. The official endpoint page requires this field but does not define its accepted type or constraints.
array
Choices: followsForum, forumCanDisableAds, forumForumCategory, counters, forumDaysAlive, forumFeatures, forumIntegration, forumNewPolicy, forumPermissions
string
Provider parameter orgID; the official endpoint page does not further describe its accepted shape.
string
URL (defined by RFC 3986)
string ("Tech" | "Living" | "Style" | "Business" | "Entertainment" | "Celebrity" | "Sports" | "Culture" | "Games" | "News")
Choices: Tech, Living, Style, Business, Entertainment, Celebrity, Sports, Culture, Games, News
string
Translation Language
string
Provider parameter guidelines; the official endpoint page does not further describe its accepted shape.
string
required
Forum short name. The official endpoint page requires this field but does not define its accepted type or constraints.
string
Maximum length of 300
string
Provider parameter adultContent; the official endpoint page does not further describe its accepted shape.
string
Looks up a forum category by ID
URL (defined by RFC 3986)
string
Provider parameter commentPolicyText; the official endpoint page does not further describe its accepted shape.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 remains capability/account dependent.

Input Parameters

string
required
Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.
string
required
Domain Name

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 scope did not confer that staff role.

Input Parameters

string
IP address (defined by RFC 5322)
string
Looks up a post by ID
string
Actor user ID.
string
required
Looks up a forum by ID (aka short name)
string ("1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13" | "14" | "15" | "16" | "17")
required
Valid values are: 1: ApprovePost 2: UnapprovePost 3: SpamPost 4: UnspamPost 5: RestorePost 6: RemovePost 7: HighlightPost 8: UnhighlightPost 9: AddBlacklist 10: RemoveBlacklist 11: MarkAsPendingPost 12: AddWhitelist 13: RemoveWhitelist 14: AddModerator 15: RemoveModerator 16: UpdateThreadCreator 17: ApprovePostNewUser
string
Looks up a thread by ID
string
Unix timestamp (or ISO datetime standard)
string
Optional target user ID.
string
Actor’s Disqus username instead of a user ID.
string
Optional target user’s Disqus username instead of an ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 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.

Input Parameters

string
Unix timestamp (or ISO datetime standard)
string ("unapproved" | "approved" | "spam" | "killed")
Choices: unapproved, approved, spam, killed
string
Looks up a post by ID
number
Minimum value of 1 Maximum value of 5
string
Looks up a thread by ID
string
required
Content of the new post. The official endpoint page requires message but does not define its accepted type or format.
string
IP address override. Uses server-side application-secret authentication and requires moderator permission.
string
Age declaration flag. Use 1 or 0; boolean true/false are sent as 1/0. Omit to leave unspecified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_CREATE_THREADCreates a new thread. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
URL (defined by RFC 3986) Maximum length of 500
string
Unix timestamp (or ISO datetime standard)
string
Alpha-numeric slug Maximum length of 200
string
required
Looks up a forum by ID (aka short name)
string
required
Title of the new thread. The official endpoint page requires title but does not define its accepted type or constraints.
string
Provider parameter message; the official endpoint page does not further describe its accepted shape.
string
Looks up a category by ID
string
Maximum length of 300

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 tier; availability remains capability/account dependent.

Input Parameters

array
required
URL (defined by RFC 3986)
string
required
Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
required
Looks up an action history row by ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_DELETE_SSO_USERDeletes 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.

Input Parameters

string
required
Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.
string
required
SSO user identifier whose account and comment history will be deleted. The official endpoint page does not define the identifier’s scalar type.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.
array
required
List of custom reaction image IDs to delete. The official endpoint page does not define the scalar type of each ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a forum by ID (aka short name)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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. The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
If true, export all optouts collected so far. If false, export all emails since the last partial export
string
required
Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 billing tier; availability remains capability/account dependent.

Input Parameters

string
If true, export all emails collected so far. If false, export all emails since the last partial export
string
required
Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_EXPORT_FORUMStart an export for the specified forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a forum by ID (aka short name)
string
Choices: xml

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
required
Looks up an organization by ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_FOLLOW_FORUMFollow a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a forum by ID (aka short name)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_FOLLOW_USERFollow a user. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
User ID to follow.
string
Disqus username to follow instead of a user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 capability/account dependent.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

integer
Whole number of days. Defaults to 30; maximum 30. Zero is supported.
string
Provider parameter application; the official endpoint page does not further describe its accepted shape.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_GET_CATEGORYReturns category details. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a category by ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 capability/account dependent.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 response limit. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_GET_FORUMReturns forum details. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a forum by ID (aka short name)
array
Choices: followsForum, forumCanDisableAds, forumForumCategory, counters, forumDaysAlive, forumFeatures, forumIntegration, forumNewPolicy, forumPermissions
You may specify relations to include with your response. Choices: author

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
required
Looks up a forum by ID (aka short name)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_GET_FORUM_CATEGORYReturns forum category details. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a forum category by ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 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.

Input Parameters

string
required
Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_GET_IMPORTReturn details for an import group. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a forum by ID (aka short name)
string
required
Import group to retrieve. The official endpoint page requires group but does not define its accepted type or identifier format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 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.

Input Parameters

string
required
Looks up an organization by ID You must be an admin on the selected organization.
number
Maximum value of 100

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 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.

Input Parameters

string
required
Looks up an organization by ID You must be an admin on the selected organization.
string ("comments" | "polls")
Choices: comments, polls
string
Provider parameter includeInactive; the official endpoint page does not further describe its accepted shape.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
Provider parameter thread; the official endpoint page does not further describe its accepted shape.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
required
Looks up a forum by ID (aka short name)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
required
Looks up a forum by ID (aka short name)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_GET_POSTReturns information about a post. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a post by ID
You may specify relations to include with your response. Choices: forum, thread

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 tier; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a post by ID
number
Minimum value of 1 Maximum value of 10
string ("asc" | "desc" | "popular")
Choices: asc, desc, popular
You may specify relations to include with your response. Choices: forum, thread

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_GET_THREADReturns thread details. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
Looks up a forum by ID (aka short name)
array
Choices: topics
string
Looks up a thread by ID You may pass us the ‘ident’ or ‘link’ query types instead of an ID by including ‘forum’.
You may specify relations to include with your response. Choices: forum, author, category
Looks up a thread by URL; forum is required.
string
Looks up a thread by identifier; forum is required.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
required
Looks up a thread by ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 capability/account dependent.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 required when the account lacks the Pro API Access addon where the relevant parameter description says so.

Input Parameters

string
Looks up a forum by ID (aka short name)
array
Choices: topics
array
Looks up a thread by ID 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.
You may specify relations to include with your response. Choices: forum, author, category
Filters by thread URLs. Forum is required only when the account lacks the Pro API Access addon.
array
Looks up threads by identifiers; forum is required.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_GET_USERReturns details of a user. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
Looks up a user by ID You may look up a user by username using the ‘username’ query type.
array
Choices: userFlaggedUser, thirdPartyAccounts
string
Looks up a user by Disqus username instead of user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
Looks up a user by ID You may look up a user by username using the ‘username’ query type.
number
Awarded badges per page. Defaults to 25; maximum 100.
string ("asc" | "desc")
Choices: asc, desc
string
Unix timestamp (or ISO datetime standard)
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.
string
Looks up a user by Disqus username instead of user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 tier; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_LIST_BLACKLIST_ENTRIESReturns one page of blacklist entries. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

array
Choices: domain, word, ip, user, thread_slug, email
array
required
Looks up a forum by ID (aka short name)
number
Blacklist entries per page. Defaults to 50; maximum 100.
string ("asc" | "desc")
Choices: asc, desc
string
Provider parameter query; the official endpoint page does not further describe its accepted shape.
string
Unix timestamp (or ISO datetime standard)
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.
You may specify relations to include with your response. Choices: forum
string
Provider parameter since_id; the official endpoint page does not further describe its accepted shape.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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/account dependent.

Input Parameters

array
required
Looks up a forum by ID (aka short name)
number
Categories per page. Defaults to 25; maximum 100.
string ("asc" | "desc")
Choices: asc, desc
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.
string
Provider parameter since_id; the official endpoint page does not further describe its accepted shape.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 dependent.

Input Parameters

string
required
Looks up a forum by ID (aka short name)
integer
Categories per page. Defaults to 25; maximum 100.
string ("asc" | "desc")
Choices: asc, desc
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.
string
Provider parameter since_id; the official endpoint page does not further describe its accepted shape.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

number
Posts per page. Defaults to 25; maximum 100.
string ("asc" | "desc")
Choices: asc, desc
string
Provider parameter query; the official endpoint page does not further describe its accepted shape.
string
Unix timestamp (or ISO datetime standard)
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.
array
Valid values are: 1: Is_Anonymous 2: Has_Link 3: Has_Low_Rep_Author 4: Has_Bad_Word 5: Is_Flagged 6: No_Issue 7: Is_Toxic 8: Modified_By_Rule 9: Shadow_Banned 10: Has_Media 11: Is_At_Flag_Limit 12: Shadow_Banned_Global 13: Is_New_User_Needs_Approval 14: Is_Sexual 15: Is_Hate 16: Is_Bullying 17: Is_Violence 18: Is_Promotion
array
Choices: unapproved, approved, spam, deleted, flagged, highlighted
You may specify relations to include with your response. Choices: forum, thread
string
required
Looks up a category by ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

number
Threads per page. Defaults to 25; maximum 100.
string ("asc" | "desc")
Choices: asc, desc
string
Unix timestamp (or ISO datetime standard)
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.
You may specify relations to include with your response. Choices: forum, author
string
required
Looks up a category by ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 capability/account dependent.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_LIST_FORUM_CATEGORIESReturns a list of forum categories Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
required
Looks up a forum by ID (aka short name)
integer
Followers per page. Defaults to 25; maximum 100.
string ("asc" | "desc")
Choices: asc, desc
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.
string
Provider parameter since_id; the official endpoint page does not further describe its accepted shape.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
required
Looks up a forum by ID (aka short name)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_LIST_FORUM_POSTSReturns one page of posts within a forum, defaulting to approved posts. Other post statuses can be selected; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a forum by ID (aka short name)
integer
Posts per page. Defaults to 25; maximum 100.
string ("asc" | "desc")
Choices: asc, desc
string
Provider parameter query; the official endpoint page does not further describe its accepted shape.
string
Unix timestamp (or ISO datetime standard)
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.
array
Valid values are: 1: Is_Anonymous 2: Has_Link 3: Has_Low_Rep_Author 4: Has_Bad_Word 5: Is_Flagged 6: No_Issue 7: Is_Toxic 8: Modified_By_Rule 9: Shadow_Banned 10: Has_Media 11: Is_At_Flag_Limit 12: Shadow_Banned_Global 13: Is_New_User_Needs_Approval 14: Is_Sexual 15: Is_Hate 16: Is_Bullying 17: Is_Violence 18: Is_Promotion
array
Choices: unapproved, approved, spam, deleted, flagged, highlighted
You may specify relations to include with your response. Choices: thread

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_LIST_FORUM_THREADSReturns one page of threads within a specified forum, sorted by creation date. Availability may depend on account capabilities.

Input Parameters

string
Unix timestamp (or ISO datetime standard)
string
required
Looks up a forum by ID (aka short name)
integer
Threads per page. Defaults to 25; maximum 100.
string ("asc" | "desc")
Choices: asc, desc
string
Unix timestamp (or ISO datetime standard)
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.
array
Looks up a thread by ID 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.
array
Choices: open, closed, killed
You may specify relations to include with your response. Choices: forum, author
Filters by thread URLs. Forum is required only when the account lacks the Pro API Access addon.
array
Filters by thread identifiers in the selected forum.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
Looks up a user by ID You may look up a user by username using the ‘username’ query type.
string
required
Looks up a forum by ID (aka short name)
string
Moderation history entries per page. Defaults to 20; the official endpoint page does not document bounds.
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.
string
Looks up a user by Disqus username instead of user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

array
Looks up a forum by ID (aka short name)
number
Threads per page. Defaults to 25; maximum 100.
array
Looks up a user by ID You may look up a user by username using the ‘username’ query type.
array
Choices: open, closed, killed
You may specify relations to include with your response. Choices: forum, author, category
array
Looks up a category by ID
array
Filters by Disqus usernames instead of user IDs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
required
Looks up a forum by ID (aka short name)
string
Provider parameter cursor; the official endpoint page does not further describe its accepted shape. Pass cursor.next only when cursor.hasNext is true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

integer
Forums to return. Defaults to 5; maximum 100.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

number
Users to return. Defaults to 5; maximum 100.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
required
Looks up a forum by ID (aka short name)
integer
Users per page. Defaults to 25; maximum 100.
string
Choices: desc
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
required
Looks up a forum by ID (aka short name)
integer
Users per page. Defaults to 25; maximum 100.
string
Choices: desc
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 tier; availability remains capability/account dependent.

Input Parameters

string
required
Looks up an organization by ID You must be an admin on the selected organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 dependent.

Input Parameters

integer
Whole number of pages to return. Defaults to 20; minimum 1; maximum 50.
string ("7d" | "30" | "2d" | "1d" | "7" | "1h" | "30d")
Choices: 7d, 30, 2d, 1d, 7, 1h, 30d
number
Continuation cursor, with a maximum value of 50. Pass the previous response’s cursor.next only when cursor.hasNext is true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a post by ID You must be a moderator on the selected post’s forum.
string
Moderation history entries per page. Defaults to 20; the official endpoint page does not document bounds.
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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; availability remains capability/account dependent.

Input Parameters

array
required
Looks up a post by ID You must be a moderator on the selected post’s forum.
string
Provider parameter numberPerPost; the official endpoint page does not further describe its accepted shape.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
Unix timestamp (or ISO datetime standard)
array
Forums to include. By default, returns posts from all forums you moderate. Pass :all to retrieve posts from all forums.
number
Posts per page. Defaults to 25; maximum 100.
string ("asc" | "desc")
Creation-date order. Defaults to desc. Choices: asc, desc
string
Provider parameter query; the official endpoint page does not further describe its accepted shape.
string
Unix timestamp (or ISO datetime standard)
string
Unix timestamp (or ISO datetime standard)
string
Continuation cursor. Omit for the first page; pass the previous response’s cursor.next only when cursor.hasNext is true.
string
Deprecated numeric page offset. Defaults to 0; use cursor for pagination.
array
Looks up a thread by ID
array
Valid values are: 1: Is_Anonymous 2: Has_Link 3: Has_Low_Rep_Author 4: Has_Bad_Word 5: Is_Flagged 6: No_Issue 7: Is_Toxic 8: Modified_By_Rule 9: Shadow_Banned 10: Has_Media 11: Is_At_Flag_Limit 12: Shadow_Banned_Global 13: Is_New_User_Needs_Approval 14: Is_Sexual 15: Is_Hate 16: Is_Bullying 17: Is_Violence 18: Is_Promotion
array
Post states to include. Defaults to approved. Choices: unapproved, approved, spam, deleted, flagged, highlighted
You may specify relations to include with your response. Choices: forum, thread
array
Looks up a category by ID
string
Only edited (1) or only unedited (0); omit for no filter.
string ("date" | "priority")
Sort strategy. Defaults to date. Choices: date, priority

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_LIST_RANDOM_PAGESReturns a random list of category objects with page data of HotThreads for forums in each category. Availability remains capability/account dependent.

Input Parameters

integer
Whole number of random pages to return. Defaults to 20; minimum 1; maximum 50.
string ("7d" | "30" | "2d" | "1d" | "7" | "1h" | "30d")
Choices: 7d, 30, 2d, 1d, 7, 1h, 30d

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 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.

Input Parameters

string
Looks up an organization by ID You must be an admin on the selected organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
Looks up a forum by ID (aka short name)
number
Posts per page. Defaults to 25; maximum 100.
string ("asc" | "desc")
Choices: asc, desc
string
Provider parameter query; the official endpoint page does not further describe its accepted shape.
string
Unix timestamp (or ISO datetime standard)
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.
string
Looks up a thread by ID You may pass us the ‘ident’ or ‘link’ query types instead of an ID by including ‘forum’.
array
Valid values are: 1: Is_Anonymous 2: Has_Link 3: Has_Low_Rep_Author 4: Has_Bad_Word 5: Is_Flagged 6: No_Issue 7: Is_Toxic 8: Modified_By_Rule 9: Shadow_Banned 10: Has_Media 11: Is_At_Flag_Limit 12: Shadow_Banned_Global 13: Is_New_User_Needs_Approval 14: Is_Sexual 15: Is_Hate 16: Is_Bullying 17: Is_Violence 18: Is_Promotion
array
Choices: unapproved, approved, spam, deleted, flagged, highlighted
You may specify relations to include with your response. Choices: forum, thread
Looks up a thread by URL; forum is required.
string
Looks up a thread by identifier; forum is required.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a thread by ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 when the account lacks the Pro API Access addon where the relevant parameter description says so.

Input Parameters

array
Looks up a forum by ID (aka short name)
number
Threads per page. Defaults to 25; maximum 100.
string ("asc" | "desc")
Choices: asc, desc
string
Unix timestamp (or ISO datetime standard)
array
Choices: topics
array
Looks up a user by ID You may look up a user by username using the ‘username’ query type.
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.
array
Looks up a thread by ID 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.
array
Choices: open, closed, killed
You may specify relations to include with your response. Choices: forum, author, category
array
Looks up a category by ID
Filters by thread URLs. Forum is required only when the account lacks the Pro API Access addon.
array
Filters by thread identifiers; forum is required.
array
Filters by Disqus usernames instead of user IDs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
Looks up a user by ID You may look up a user by username using the ‘username’ query type.
number
Forums per page. Defaults to 25; maximum 100.
string ("asc" | "desc")
Choices: asc, desc
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.
string
Provider parameter since_id; the official endpoint page does not further describe its accepted shape.
string
Looks up a user by Disqus username instead of user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
Looks up a user by ID You may look up a user by username using the ‘username’ query type.
number
Activity entries per page. Defaults to 25; maximum 100.
string
Provider parameter query; the official endpoint page does not further describe its accepted shape.
string
Unix timestamp (or ISO datetime standard)
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.
array
Choices: user, replies, following
You may specify relations to include with your response. Choices: forum, thread
string
Looks up an anonymous user by unique hash
string
Looks up a user by Disqus username instead of user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
Looks up a user by ID You may look up a user by username using the ‘username’ query type.
number
Followers per page. Defaults to 25; maximum 100.
string ("asc" | "desc")
Choices: asc, desc
array
Choices: userFlaggedUser, thirdPartyAccounts
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.
string
Provider parameter since_id; the official endpoint page does not further describe its accepted shape.
string
Looks up a user by Disqus username instead of user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
Looks up a user by ID You may look up a user by username using the ‘username’ query type.
number
Followed users per page. Defaults to 25; maximum 100.
string ("asc" | "desc")
Choices: asc, desc
array
Choices: userFlaggedUser, thirdPartyAccounts
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.
string
Provider parameter since_id; the official endpoint page does not further describe its accepted shape.
string
Looks up a user by Disqus username instead of user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
Looks up a user by ID You may look up a user by username using the ‘username’ query type.
number
Followed channels per page. Defaults to 25; maximum 100.
string ("asc" | "desc")
Choices: asc, desc
array
Choices: followsForum, forumCanDisableAds, forumForumCategory, counters, forumDaysAlive, forumFeatures, forumIntegration, forumNewPolicy, forumPermissions, channel_categories
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.
string
Provider parameter since_id; the official endpoint page does not further describe its accepted shape.
string
Whether to exclude Channels that the user owns from the results
string
Looks up a user by Disqus username instead of user ID.
string
Whether to exclude channels that the user moderates from the results
string
Whether to include Channels where the user follows the primary forum

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
Looks up a user by ID You may look up a user by username using the ‘username’ query type.
number
Followed forums per page. Defaults to 25; maximum 100.
string ("asc" | "desc")
Choices: asc, desc
array
Choices: followsForum, forumCanDisableAds, forumForumCategory, counters, forumDaysAlive, forumFeatures, forumIntegration, forumNewPolicy, forumPermissions
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.
string
Provider parameter since_id; the official endpoint page does not further describe its accepted shape.
string
Looks up a user by Disqus username instead of user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
Looks up a user by ID You may look up a user by username using the ‘username’ query type.
number
Owned forums per page. Defaults to 25; maximum 100.
string ("asc" | "desc")
Choices: asc, desc
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.
string
Provider parameter since_id; the official endpoint page does not further describe its accepted shape.
string
Looks up a user by Disqus username instead of user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
Looks up a user by ID You may look up a user by username using the ‘username’ query type.
number
Moderated channels per page. Defaults to 25; maximum 100.
string ("asc" | "desc")
Choices: asc, desc
array
Choices: followsForum, forumCanDisableAds, forumForumCategory, counters, forumDaysAlive, forumFeatures, forumIntegration, forumNewPolicy, forumPermissions, channel_categories
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.
string
Provider parameter since_id; the official endpoint page does not further describe its accepted shape.
string
Whether to exclude Channels that the user owns from the results
string
Looks up a user by Disqus username instead of user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
Looks up a user by ID You may look up a user by username using the ‘username’ query type.
number
Active forums per page. Defaults to 25; maximum 100.
string
Looks up a user by Disqus username instead of user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
Looks up a user by ID You may look up a user by username using the ‘username’ query type.
number
Owned channels per page. Defaults to 25; maximum 100.
string ("asc" | "desc")
Choices: asc, desc
array
Choices: followsForum, forumCanDisableAds, forumForumCategory, counters, forumDaysAlive, forumFeatures, forumIntegration, forumNewPolicy, forumPermissions, channel_categories
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.
string
Provider parameter since_id; the official endpoint page does not further describe its accepted shape.
string
Looks up a user by Disqus username instead of user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
Looks up a user by ID You may look up a user by username using the ‘username’ query type.
number
Posts per page. Defaults to 25; maximum 100.
string ("asc" | "desc")
Choices: asc, desc
string
Unix timestamp (or ISO datetime standard)
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.
array
Valid values are: 1: Is_Anonymous 2: Has_Link 3: Has_Low_Rep_Author 4: Has_Bad_Word 5: Is_Flagged 6: No_Issue 7: Is_Toxic 8: Modified_By_Rule 9: Shadow_Banned 10: Has_Media 11: Is_At_Flag_Limit 12: Shadow_Banned_Global 13: Is_New_User_Needs_Approval 14: Is_Sexual 15: Is_Hate 16: Is_Bullying 17: Is_Violence 18: Is_Promotion
array
Choices: unapproved, approved, spam, deleted, flagged, highlighted
You may specify relations to include with your response. Choices: forum, thread
string
Looks up a user by Disqus username instead of user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_LIST_USERS_WHO_VOTED_ON_THREADReturns users who voted on a thread, with a vote filter defaulting to 1. When authenticated, it can prioritize followed users and fill remaining slots with other users.

Input Parameters

string ("-1" | "0" | "1")
Choices: -1, 0, 1
number
Users to return. Defaults to 10; maximum 100.
string
required
Looks up a thread by ID
string
Prioritize followed users who voted on this thread (must be authenticated)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_LIST_WHITELIST_ENTRIESReturns one page of whitelist entries. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

array
Choices: email, user
array
required
Looks up a forum by ID (aka short name)
number
Whitelist entries per page. Defaults to 25; maximum 100.
string ("asc" | "desc")
Choices: asc, desc
string
Provider parameter query; the official endpoint page does not further describe its accepted shape.
string
Unix timestamp (or ISO datetime standard)
string
Continuation cursor. Pass the previous response’s cursor.next only when cursor.hasNext is true.
You may specify relations to include with your response. Choices: forum
string
Provider parameter since_id; the official endpoint page does not further describe its accepted shape.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 remains capability/account dependent.

Input Parameters

array
required
Looks up a post by ID You must be a moderator on the selected post’s forum.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 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.

Input Parameters

string
Looks up a forum by ID (aka short name)
array
Thread IDs to open.
Thread URLs to open. Forum is required by Disqus only when the account lacks the Pro API Access addon.
array
Thread identifiers to open; requires forum.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_REMOVE_BADGEUsed to remove badges from users. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
User ID whose badge is removed.
string
required
Looks up a badge by ID
string
required
Looks up a forum by ID (aka short name)
string
Disqus username whose badge is removed instead of a user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_REMOVE_BLACKLIST_ENTRYRemoves an entry from the blacklist. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

array
IP addresses in CIDR notation to remove. Provide at least one blacklist selector.
array
User IDs to remove. Provide at least one blacklist selector.
array
Words to remove, each with a maximum length of 200. Provide at least one blacklist selector.
array
RFC 5322 email addresses to remove. Provide at least one blacklist selector.
string
required
Looks up a forum by ID (aka short name)
array
Domain names to remove. Provide at least one blacklist selector.
array
Blacklist entry IDs to remove. Provide at least one blacklist selector.
array
Disqus usernames to remove instead of user IDs. Provide at least one blacklist selector.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_REMOVE_FORUM_MODERATORRemoves a moderator from a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
User ID for the moderator lookup. Required with forum when moderator is omitted.
string
Forum ID (short name) for the moderator lookup. Required with user when moderator is omitted.
string
Moderator ID to remove. Use this alone, or omit it and provide both forum and user.
string
Disqus username for the moderator lookup instead of a user ID. Required with forum.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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; availability remains capability/account dependent.

Input Parameters

string
Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.
string
Trusted-domain record ID to remove.
string
Trusted domain name to remove instead of an ID; requires forum.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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; availability remains capability/account dependent.

Input Parameters

string
User ID to remove as an admin.
string
required
Looks up an organization by ID You must be an admin on the selected organization.
string
Disqus username to remove instead of a user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_REMOVE_POSTSDeletes the requested post(s). Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

array
required
Looks up a post by ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_REMOVE_THREADSRemoves threads selected by IDs, identifiers, or URLs. Identifiers require a forum, URL lookups may require a forum depending on account access, and you must be a moderator on the selected threads’ forum.

Input Parameters

string
Looks up a forum by ID (aka short name)
array
Thread IDs to remove.
Thread URLs to remove. Forum is required by Disqus only when the account lacks the Pro API Access addon.
array
Thread identifiers to remove; requires forum.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
Follower user ID to remove.
string
Follower’s Disqus username to remove instead of a user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_REMOVE_WHITELIST_ENTRYRemoves one or more entries from a forum’s whitelist by entry ID, user, or email. Availability remains capability/account dependent.

Input Parameters

array
Whitelist entry IDs to remove. Provide at least one of id, user, or email.
array
User IDs to remove. Provide at least one selector.
array
RFC 5322 email addresses to remove. Provide at least one of id, user, or email.
string
required
Looks up a forum by ID (aka short name)
array
Disqus usernames to remove instead of user IDs. Provide at least one selector.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 IDs will be created. All other existing badges for the forum will be deleted. 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.

Input Parameters

string
required
Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.
array
required
Non-empty array of badge objects. Objects with IDs are updated, objects without IDs are created, and all other existing forum badges are deleted; the official page does not define badge object fields.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_REPORT_POSTReports a post (flagging). Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a post by ID
string ("0" | "1" | "2" | "3" | "4" | "5" | "6")
Valid values are: 0: HARASSMENT 1: SPAM 2: INAPPROPRIATE_CONTENT 3: THREAT 4: IMPERSONATION 5: PRIVATE_INFORMATION 6: DISAGREE

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
User ID to report.
string ("0" | "1" | "2" | "3" | "4" | "5" | "6")
required
Valid values are: 0: HARASSMENT 1: SPAM 2: INAPPROPRIATE_CONTENT 3: THREAT 4: IMPERSONATION 5: PRIVATE_INFORMATION 6: DISAGREE
string
Disqus username to report instead of a user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_RESTORE_POSTSUndeletes the requested post(s). Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

array
required
Looks up a post by ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 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.

Input Parameters

string
Looks up a forum by ID (aka short name)
array
Thread IDs to restore.
Thread URLs to restore. Forum is required by Disqus only when the account lacks the Pro API Access addon.
array
Thread identifiers to restore; requires forum.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.
string
Maximum length of 60
object
required
Thread-reaction configuration object to JSON-encode in the form field. The official endpoint page does not define its keys.
string
Provider parameter applyRetroactively; the official endpoint page does not further describe its accepted shape.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_SET_ORGANIZATION_ROLESet a user’s organization role using moderator and admin settings. You must be an admin on the selected organization.

Input Parameters

string
User ID whose role is changed.
string
Provider parameter isAdmin; the official endpoint page does not further describe its accepted shape.
string
Provider parameter isModerator; the official endpoint page does not further describe its accepted shape.
string
required
Looks up an organization by ID You must be an admin on the selected organization.
string
Disqus username whose role is changed instead of a user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.
string
Provider parameter disable; the official endpoint page does not further describe its accepted shape.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 the selected thread’s forum. The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
Provider parameter enable; the official endpoint page does not further describe its accepted shape.
string
required
Looks up a thread by ID You must be a moderator on the selected thread’s forum.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_SPAM_THREADMarks a thread as spam, identified by ID or by identifier or link with a forum. The caller must be a moderator on the thread’s forum.

Input Parameters

string
Looks up a forum by ID (aka short name)
string
Thread ID to mark as spam.
Thread URL to mark as spam; requires forum.
string
Thread identifier to mark as spam; requires forum.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
required
Email value to subscribe anonymously to AET. The official endpoint page does not define its accepted type or format.
string
required
Looks up a forum by ID (aka short name)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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. 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.

Input Parameters

string
Looks up a PricingOption by name
string
Optional user ID associated with the subscription.
string
Looks up a coupon by its Stripe ID
string
required
Looks up an organization by ID You must be an admin on the selected organization.
string
Optional Disqus username associated with the subscription instead of a user ID.
string
Looks up an ActivationCode

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_SUBSCRIBE_THREADSubscribe the authenticated user to a thread. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a thread by ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a forum by ID (aka short name)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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; availability remains capability/account dependent.

Input Parameters

array
required
Looks up a post by ID You must be a moderator on the selected post’s forum.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
User ID whose badge visibility is toggled.
string
required
Looks up a badge by ID
string
Disqus username whose badge visibility is toggled instead of a user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_UNFOLLOW_FORUMUnfollow a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a forum by ID (aka short name)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_UNFOLLOW_USERUnfollow a user. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
User ID to unfollow.
string
Disqus username to unfollow instead of a user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 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.

Input Parameters

string
Provider parameter immediately; the official endpoint page does not further describe its accepted shape.
string
required
Looks up an organization by ID You must be an admin on the selected organization.
string ("comments" | "polls")
Choices: comments, polls

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_UNSUBSCRIBE_THREADUnsubscribe the authenticated user from a thread. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a thread by ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 capability/account dependent.

Input Parameters

string
Provider parameter name; the official endpoint page does not further describe its accepted shape.
string ("1" | "2" | "4")
Valid values are: 1: OLDEST 2: NEWEST 4: HOT
string
required
Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.
array
Choices: followsForum, forumCanDisableAds, forumForumCategory, counters, forumDaysAlive, forumFeatures, forumIntegration, forumNewPolicy, forumPermissions
string
URL (defined by RFC 3986)
string ("Tech" | "Living" | "Style" | "Business" | "Entertainment" | "Celebrity" | "Sports" | "Culture" | "Games" | "News")
Choices: Tech, Living, Style, Business, Entertainment, Celebrity, Sports, Culture, Games, News
string ("auto" | "serif" | "sans-serif")
Choices: auto, serif, sans-serif
string
Provider parameter guidelines; the official endpoint page does not further describe its accepted shape.
Maximum length of 7
string
Provider parameter customFont; the official endpoint page does not further describe its accepted shape.
string
Maximum length of 300
string ("0" | "1" | "2" | "3")
Valid values are: 0: DETAILED 1: DOWNVOTE_LIMITED 2: DOWNVOTE_DISABLED 3: DISABLED
string ("auto" | "dark" | "light")
Choices: auto, dark, light
string
Provider parameter shouldError; the official endpoint page does not further describe its accepted shape.
string
Maximum length of 255
string
Provider parameter adultContent; the official endpoint page does not further describe its accepted shape.
string
Provider parameter badgesEnabled; the official endpoint page does not further describe its accepted shape.
string
Provider parameter flagThreshold; the official endpoint page does not further describe its accepted shape.
string
Looks up a forum category by ID
string
Provider parameter allowAnonPost; the official endpoint page does not further describe its accepted shape.
Provider parameter unapproveLinks; the official endpoint page does not further describe its accepted shape.
string
Provider parameter aetBannerTitle; the official endpoint page does not further describe its accepted shape.
string
Provider parameter aiPollsEnabled; the official endpoint page does not further describe its accepted shape.
string
Provider parameter flaggingEnabled; the official endpoint page does not further describe its accepted shape.
Maximum length of 50
integer
Maximum value of 10000
string
Provider parameter installCompleted; the official endpoint page does not further describe its accepted shape.
string
Provider parameter aetBannerEnabled; the official endpoint page does not further describe its accepted shape.
Maximum length of 50
string
Provider parameter gifPickerEnabled; the official endpoint page does not further describe its accepted shape.
string
Provider parameter mediaembedEnabled; the official endpoint page does not further describe its accepted shape.
string
Provider parameter validateAllPosts; the official endpoint page does not further describe its accepted shape.
URL (defined by RFC 3986)
string
Provider parameter commentPolicyText; the official endpoint page does not further describe its accepted shape.
string
Provider parameter behindClickEnabled; the official endpoint page does not further describe its accepted shape.
string
Provider parameter disableSocialShare; the official endpoint page does not further describe its accepted shape.
string
Maximum length of 50
string
Translation Language
integer
Minimum value of 1 Maximum value of 50
string
Provider parameter aetBannerDescription; the official endpoint page does not further describe its accepted shape.
Maximum length of 50
string
Provider parameter flaggingNotifications; the official endpoint page does not further describe its accepted shape.
string
Provider parameter threadRatingsEnabled; the official endpoint page does not further describe its accepted shape.
string
Provider parameter aetBannerConfirmation; the official endpoint page does not further describe its accepted shape.
string
Provider parameter disableDisqusBranding; the official endpoint page does not further describe its accepted shape.
string
Provider parameter adsPositionTopEnabled; the official endpoint page does not further describe its accepted shape.
integer
Minimum value of 1 Maximum value of 99
Provider parameter linkAffiliationEnabled; the official endpoint page does not further describe its accepted shape.
string
Provider parameter adsPositionPollEnabled; the official endpoint page does not further describe its accepted shape.
string
Provider parameter organicDiscoveryEnabled; the official endpoint page does not further describe its accepted shape.
string
Provider parameter adsPositionBottomEnabled; the official endpoint page does not further describe its accepted shape.
string
Provider parameter contextualAiPollsEnabled; the official endpoint page does not further describe its accepted shape.
string
Provider parameter unapproveNewUsersEnabled; the official endpoint page does not further describe its accepted shape.
string
Provider parameter disableThirdPartyTrackers; the official endpoint page does not further describe its accepted shape.
string
Provider parameter adsPositionInthreadEnabled; the official endpoint page does not further describe its accepted shape.
string
Maximum length of 45
string
Provider parameter disableDisqusBrandingOnPolls; the official endpoint page does not further describe its accepted shape.
string
Maximum length of 45
string
Provider parameter adsPositionRecommendationsEnabled; the official endpoint page does not further describe its accepted shape.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.
string
Provider parameter titleCSS; the official endpoint page does not further describe its accepted shape.
string
Provider parameter buttonCSS; the official endpoint page does not further describe its accepted shape.
string
Provider parameter titleText; the official endpoint page does not further describe its accepted shape.
string
Provider parameter buttonText; the official endpoint page does not further describe its accepted shape.
string
Provider parameter titleEnabled; the official endpoint page does not further describe its accepted shape.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.
object
required
Image file to crop and save as the forum default avatar.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.
object
required
Image file to upload as the forum favicon.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
IP address (defined by RFC 5322)
string
required
Looks up an action history row by ID
string
Looks up a post by ID
string
Optional actor user ID.
string
Looks up a forum by ID (aka short name)
string ("1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13" | "14" | "15" | "16" | "17")
Valid values are: 1: ApprovePost 2: UnapprovePost 3: SpamPost 4: UnspamPost 5: RestorePost 6: RemovePost 7: HighlightPost 8: UnhighlightPost 9: AddBlacklist 10: RemoveBlacklist 11: MarkAsPendingPost 12: AddWhitelist 13: RemoveWhitelist 14: AddModerator 15: RemoveModerator 16: UpdateThreadCreator 17: ApprovePostNewUser
string
Looks up a thread by ID
string
Unix timestamp (or ISO datetime standard)
string
Optional target user ID.
string
Optional actor’s Disqus username instead of a user ID.
string
Optional target user’s Disqus username instead of an ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 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.

Input Parameters

string
Provider parameter city; the official endpoint page does not further describe its accepted shape.
string
Provider parameter state; the official endpoint page does not further describe its accepted shape.
string
Provider parameter street; the official endpoint page does not further describe its accepted shape.
string
Provider parameter taxId; the official endpoint page does not further describe its accepted shape.
string
Provider parameter country; the official endpoint page does not further describe its accepted shape.
string
Provider parameter zipCode; the official endpoint page does not further describe its accepted shape.
string
Provider parameter companyName; the official endpoint page does not further describe its accepted shape.
string
required
Looks up an organization by ID You must be an admin on the selected organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 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.

Input Parameters

string
required
Payment token used to update the organization billing information. The official endpoint page does not define the token’s type or format.
string
required
Looks up an organization by ID You must be an admin on the selected organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
required
You must be the author of the post or a moderator on the applicable forum.
number
Minimum value of 1 Maximum value of 5
string
required
Replacement post content. The official endpoint page requires message but does not define its accepted type or format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_UPDATE_SSO_USER_PROFILEUpdates SSO user profile attributes. url: The URL that will be displayed on the user profile profile_url: The URL that will be used to link to the user profile Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
URL (defined by RFC 3986)
string
Provider parameter name; the official endpoint page does not further describe its accepted shape.
string
Email address (defined by RFC 5322)
string
Looks up a forum by ID (aka short name)
string
URL (defined by RFC 3986)
string
Provider parameter user_id; the official endpoint page does not further describe its accepted shape.
string
URL (defined by RFC 3986)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 look up a user by username using the ‘username’ query type. The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
URL (defined by RFC 3986) Maximum length of 500
string
Alpha-numeric slug Maximum length of 200
string
Looks up a forum by ID (aka short name)
string
Maximum length of 200
string
User ID for the new thread author; requires moderator access.
string
required
You must be the author of the post or a moderator on the applicable forum.
string
Provider parameter message; the official endpoint page does not further describe its accepted shape.
string
Looks up a category by ID
string
To update a specific identifier, provide ‘old_identifier’. If no identifier exists, a new one is created. Maximum length of 300
string
Only valid if ‘identifier’ is provided. See ‘identifier’ for more information. Maximum length of 300
string
Disqus username for the new thread author instead of a user ID; requires moderator access.
string
Provider parameter validateAllPosts; the official endpoint page does not further describe its accepted shape.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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.

Input Parameters

string
Whether this topic can appear in the list of trending topics
string
required
Can be either the topic identifier or current display name
string
Allows the display name of a topic to be modified. This is mostly to allow capitalization/punctuation to be corrected. The new name must resolve to the same slug as the old name

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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/account dependent.

Input Parameters

string
URL (defined by RFC 3986) Maximum length of 200
string
Minimum length of 2 Maximum length of 30
string
Provider parameter about; the official endpoint page does not further describe its accepted shape.
string
Maximum length of 255

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.
string
adsPositionTopEnabled flag. Use 1 or 0; boolean true/false are sent as 1/0. Omit to leave unspecified.
string
adsPositionBottomEnabled flag. Use 1 or 0; boolean true/false are sent as 1/0. Omit to leave unspecified.
string
adsPositionInthreadEnabled flag. Use 1 or 0; boolean true/false are sent as 1/0. Omit to leave unspecified.
string
adsPositionRecommendationsEnabled flag. Use 1 or 0; boolean true/false are sent as 1/0. Omit to leave unspecified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_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 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.

Input Parameters

string
required
Looks up a coupon by its Stripe ID
string
required
Looks up an organization by ID You must be an admin on the selected organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_VOTE_POSTRegister a vote on a post. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a post by ID
string ("-1" | "0" | "1")
required
Choices: -1, 0, 1

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_VOTE_THREADRegister a vote on a thread. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string ("-1" | "0" | "1")
required
Choices: -1, 0, 1
string
Looks up a forum by ID (aka short name)
string
Thread ID to vote on.
Thread URL to vote on; requires forum.
string
Thread identifier to vote on; requires forum.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISQUS_VOTE_THREAD_REACTIONUsed to vote on a reaction. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Input Parameters

string
required
Looks up a thread by ID
string
required
Looks up a reaction by ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not