--- canonical_url: "https://docs.composio.dev/toolkits/disqus" markdown_url: "https://docs.composio.dev/toolkits/disqus.md" product: "platform" version: null last_updated: null --- # Disqus Disqus is a discussion and community platform for managing forums, threads, posts, users, moderation, and organization settings. - **Category:** social media accounts - **Auth:** OAUTH2 - **Composio-managed OAuth available?** No - **Tools:** 148 - **Triggers:** 0 - **Slug:** `DISQUS` - **Version:** 00000000_00 ## Tools ### Add Blacklist Entry **Slug:** `DISQUS_ADD_BLACKLIST_ENTRY` Adds an entry to the blacklist. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `ip` | array | No | IP addresses in CIDR notation to add. Provide at least one blacklist selector. | | `user` | array | No | User IDs to add. Provide at least one blacklist selector. | | `word` | array | No | Words to add, each with a maximum length of 200. Provide at least one blacklist selector. | | `email` | array | No | RFC 5322 email addresses to add. Provide at least one blacklist selector. | | `forum` | string | Yes | Looks up a forum by ID (aka short name) | | `notes` | string | No | Maximum length of 50 | | `domain` | array | No | Domain names to add. Provide at least one of domain, word, ip, user, or email. | | `shadow_ban` | string | No | Provider parameter `shadowBan`; the official endpoint page does not further describe its accepted shape. | | `retroactive` | string | No | Deprecated. Apply blacklist retroactively to existing posts, marking them killed | | `date_expires` | string | No | Unix timestamp (or ISO datetime standard) | | `user_usernames` | array | No | Disqus usernames to add instead of user IDs. Provide at least one blacklist selector. | | `retroactive_action` | string ("1" | "2") | No | Action to apply retroactively to existing posts. Leave blank to apply no action Valid values are: 1: KILL 2: SPAM | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add Forum Moderator **Slug:** `DISQUS_ADD_FORUM_MODERATOR` Adds a moderator to a forum. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user` | string | No | User ID to add as a moderator. | | `forum` | string | Yes | Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. | | `can_edit` | string | No | Provider parameter `canEdit`; the official endpoint page does not further describe its accepted shape. | | `user_username` | string | No | Disqus username to add instead of a user ID. | | `can_administer` | string | No | Provider parameter `canAdminister`; the official endpoint page does not further describe its accepted shape. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add Organization Admin **Slug:** `DISQUS_ADD_ORGANIZATION_ADMIN` Adds an admin to an organization. Updates permissions of existing admins too. Caveats: Looks up an organization by ID You must be an admin on the selected organization. The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user` | string | No | User ID to add as an admin. | | `organization` | string | Yes | Looks up an organization by ID You must be an admin on the selected organization. | | `user_username` | string | No | Disqus username to add instead of a user ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Add Whitelist Entry **Slug:** `DISQUS_ADD_WHITELIST_ENTRY` Adds an entry to the whitelist. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user` | array | No | User IDs to add. Provide at least one selector. | | `email` | array | No | RFC 5322 email addresses to add. Provide at least one of email or user. | | `forum` | string | Yes | Looks up a forum by ID (aka short name) | | `notes` | string | No | Maximum length of 50 | | `user_usernames` | array | No | Disqus usernames to add instead of user IDs. Provide at least one selector. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Approve Posts **Slug:** `DISQUS_APPROVE_POSTS` Approves the requested post(s). Caveats: Looks up a post by ID You must be a moderator on the selected post's forum. The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `post` | array | Yes | Looks up a post by ID You must be a moderator on the selected post's forum. | | `new_user_premod_bypass` | string | No | Bypass the new user premoderation for the author(s) of the post(s). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Approve Thread **Slug:** `DISQUS_APPROVE_THREAD` Approve the specified moderated threads. Caveats: Looks up a thread by ID You must be a moderator on the selected thread's forum. You may pass us the 'ident' or 'link' query types instead of an ID by including 'forum'. The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | No | Looks up a forum by ID (aka short name) | | `thread` | string | No | Thread ID to approve. | | `thread_link` | string | No | Thread URL to approve; requires forum. | | `thread_ident` | string | No | Thread identifier to approve; requires forum. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Award Badge **Slug:** `DISQUS_AWARD_BADGE` Used to award badges to users manually. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user` | string | No | User ID to receive the badge. | | `badge` | string | Yes | Looks up a manual badge by ID | | `forum` | string | Yes | Looks up a forum by ID (aka short name) | | `user_username` | string | No | Disqus username to receive the badge instead of a user ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Backfill Blacklist Counters **Slug:** `DISQUS_BACKFILL_BLACKLIST_COUNTERS` Triggers Disqus's parameterless blacklist-counter backfill endpoint. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Ban Post Author From Forum **Slug:** `DISQUS_BAN_POST_AUTHOR_FROM_FORUM` Ban the author of a post using the selected user, email, IP, shadow-ban, and retroactive-action options. Caveats: Looks up a post by ID You must be a moderator on the selected post's forum. The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `post` | string | Yes | Looks up a post by ID You must be a moderator on the selected post's forum. | | `notes` | string | No | Maximum length of 50 | | `ban_ip` | string | No | Ban the ip address associated with the post | | `ban_user` | string | No | Ban the user who authored the post if one exists | | `ban_email` | string | No | Ban the email address associated with the post | | `shadow_ban` | string | No | Provider parameter `shadowBan`; the official endpoint page does not further describe its accepted shape. | | `date_expires` | string | No | Unix timestamp (or ISO datetime standard) | | `retroactive_action` | string ("1" | "2") | No | Action to apply retroactively to existing posts. Leave blank to apply no action Valid values are: 1: KILL 2: SPAM | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Bulk Create Internal Forum Action History **Slug:** `DISQUS_BULK_CREATE_INTERNAL_FORUM_ACTION_HISTORY` Creates many ActionHistory rows for backfilling from a JSON-encoded list of row dictionaries. Each row can identify the source row and carry action, forum, actor, target, thread, post, IP, date, rule, and blacklist or whitelist metadata. Caveats: The billing tier is undocumented. This endpoint requires a DISQUS-internal administrator role; OAuth admin scope does not confer that staff role. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `action_history_items` | array | Yes | 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Check And Update Username **Slug:** `DISQUS_CHECK_AND_UPDATE_USERNAME` Updates username for the user, fails if username does not meet requirements, or is taken by another user. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `username` | string | No | Disqus username Minimum length of 3 Maximum length of 30 | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Close Threads **Slug:** `DISQUS_CLOSE_THREADS` Closes a thread. Caveats: Looks up a thread by ID You must be a moderator on the selected thread's forum. You may pass us the 'ident' query type instead of an ID by including 'forum'. You may pass us the 'link' query type to filter by URL. You must pass the 'forum' if you do not have the Pro API Access addon. The official action page does not identify a billing tier; availability remains capability/account dependent. A forum selector is required when the account lacks the Pro API Access addon where the relevant parameter description says so. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | No | Looks up a forum by ID (aka short name) | | `thread` | array | No | Thread IDs to close. | | `thread_link` | array | No | Thread URLs to close. Forum is required by Disqus only when the account lacks the Pro API Access addon. | | `thread_ident` | array | No | Thread identifiers to close; requires forum. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Category **Slug:** `DISQUS_CREATE_CATEGORY` Creates a new category. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. | | `title` | string | Yes | Maximum length of 50 | | `default` | string | No | Provider parameter `default`; the official endpoint page does not further describe its accepted shape. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Forum **Slug:** `DISQUS_CREATE_FORUM` Creates a new forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | Forum name. The official endpoint page requires this field but does not define its accepted type or constraints. | | `attach` | array | No | Choices: followsForum, forumCanDisableAds, forumForumCategory, counters, forumDaysAlive, forumFeatures, forumIntegration, forumNewPolicy, forumPermissions | | `org_id` | string | No | Provider parameter `orgID`; the official endpoint page does not further describe its accepted shape. | | `website` | string | No | URL (defined by RFC 3986) | | `category` | string ("Tech" | "Living" | "Style" | "Business" | "Entertainment" | "Celebrity" | "Sports" | "Culture" | "Games" | "News") | No | Choices: Tech, Living, Style, Business, Entertainment, Celebrity, Sports, Culture, Games, News | | `language` | string | No | Translation Language | | `guidelines` | string | No | Provider parameter `guidelines`; the official endpoint page does not further describe its accepted shape. | | `short_name` | string | Yes | Forum short name. The official endpoint page requires this field but does not define its accepted type or constraints. | | `description` | string | No | Maximum length of 300 | | `adult_content` | string | No | Provider parameter `adultContent`; the official endpoint page does not further describe its accepted shape. | | `forum_category` | string | No | Looks up a forum category by ID | | `comment_policy_link` | string | No | URL (defined by RFC 3986) | | `comment_policy_text` | string | No | Provider parameter `commentPolicyText`; the official endpoint page does not further describe its accepted shape. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Forum Trusted Domain **Slug:** `DISQUS_CREATE_FORUM_TRUSTED_DOMAIN` Adds a trusted domain to a forum Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. | | `domain_name` | string | Yes | Domain Name | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Internal Forum Action History **Slug:** `DISQUS_CREATE_INTERNAL_FORUM_ACTION_HISTORY` Creates an ActionHistory row for backfilling. Caveats: The billing tier is undocumented. This endpoint requires a DISQUS-internal administrator role; the live OAuth account reached it, but OAuth admin scope did not confer that staff role. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `ip` | string | No | IP address (defined by RFC 5322) | | `post` | string | No | Looks up a post by ID | | `user` | string | No | Actor user ID. | | `forum` | string | Yes | Looks up a forum by ID (aka short name) | | `action` | string ("1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13" | "14" | "15" | "16" | "17") | Yes | 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 | | `thread` | string | No | Looks up a thread by ID | | `date_added` | string | No | Unix timestamp (or ISO datetime standard) | | `target_user` | string | No | Optional target user ID. | | `user_username` | string | No | Actor's Disqus username instead of a user ID. | | `target_user_username` | string | No | Optional target user's Disqus username instead of an ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Post **Slug:** `DISQUS_CREATE_POST` Creates a new post as the authenticated OAuth user. Anonymous author fields are intentionally unavailable because Disqus forbids author_* parameters for authenticated callers. An ip_address override uses server-side application-secret authentication and requires moderator permission. The state and date fields also require moderator permission; state skips pre-approval validation. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `date` | string | No | Unix timestamp (or ISO datetime standard) | | `state` | string ("unapproved" | "approved" | "spam" | "killed") | No | Choices: unapproved, approved, spam, killed | | `parent` | string | No | Looks up a post by ID | | `rating` | number | No | Minimum value of 1 Maximum value of 5 | | `thread` | string | No | Looks up a thread by ID | | `message` | string | Yes | Content of the new post. The official endpoint page requires message but does not define its accepted type or format. | | `ip_address` | string | No | IP address override. Uses server-side application-secret authentication and requires moderator permission. | | `age_declaration` | string | No | Age declaration flag. Use 1 or 0; boolean true/false are sent as 1/0. Omit to leave unspecified. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Thread **Slug:** `DISQUS_CREATE_THREAD` Creates a new thread. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `url` | string | No | URL (defined by RFC 3986) Maximum length of 500 | | `date` | string | No | Unix timestamp (or ISO datetime standard) | | `slug` | string | No | Alpha-numeric slug Maximum length of 200 | | `forum` | string | Yes | Looks up a forum by ID (aka short name) | | `title` | string | Yes | Title of the new thread. The official endpoint page requires title but does not define its accepted type or constraints. | | `message` | string | No | Provider parameter `message`; the official endpoint page does not further describe its accepted shape. | | `category` | string | No | Looks up a category by ID | | `identifier` | string | No | Maximum length of 300 | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Thread Reaction Images **Slug:** `DISQUS_CREATE_THREAD_REACTION_IMAGES` Used to save custom reactions that an admin creates Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `urls` | array | Yes | URL (defined by RFC 3986) | | `forum` | string | Yes | Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Internal Forum Action History **Slug:** `DISQUS_DELETE_INTERNAL_FORUM_ACTION_HISTORY` Deletes an ActionHistory row for backfilling. Caveats: The billing tier is undocumented. This endpoint requires a DISQUS-internal administrator role; OAuth admin scope does not confer that staff role. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `log` | string | Yes | Looks up an action history row by ID | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Sso User **Slug:** `DISQUS_DELETE_SSO_USER` Deletes an SSO user account and their comment history. This performs a full GDPR-style deletion: the user account is deactivated and all associated posts are removed. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. | | `user_id` | string | Yes | SSO user identifier whose account and comment history will be deleted. The official endpoint page does not define the identifier's scalar type. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Thread Reaction Images **Slug:** `DISQUS_DELETE_THREAD_REACTION_IMAGES` Used to delete custom reactions of a forum Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. | | `image_ids` | array | Yes | List of custom reaction image IDs to delete. The official endpoint page does not define the scalar type of each ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Disable Forum Ads **Slug:** `DISQUS_DISABLE_FORUM_ADS` Disable advertising for the specified forum. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Dismiss Aet Banner **Slug:** `DISQUS_DISMISS_AET_BANNER` Records the authenticated user's dismissal of the AET banner for a forum, changing that user's banner state. If the user has already accepted or dismissed it, Disqus returns HTTP 400 with error code 2. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Export Aet Optouts **Slug:** `DISQUS_EXPORT_AET_OPTOUTS` Export opt-out records collected for a forum, either all records or those since the last partial export. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `full` | string | No | If true, export all optouts collected so far. If false, export all emails since the last partial export | | `forum` | string | Yes | Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Export Aet Subscribers **Slug:** `DISQUS_EXPORT_AET_SUBSCRIBERS` Export subscribed users in either csv or json format. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `full` | string | No | If true, export all emails collected so far. If false, export all emails since the last partial export | | `forum` | string | Yes | Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Export Forum **Slug:** `DISQUS_EXPORT_FORUM` Start an export for the specified forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) | | `format` | string | No | Choices: xml | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Export Organization Audit Log **Slug:** `DISQUS_EXPORT_ORGANIZATION_AUDIT_LOG` Export the audit log for the specified organization. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization` | string | Yes | Looks up an organization by ID | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Follow Forum **Slug:** `DISQUS_FOLLOW_FORUM` Follow a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `target` | string | Yes | Looks up a forum by ID (aka short name) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Follow User **Slug:** `DISQUS_FOLLOW_USER` Follow a user. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `target` | string | No | User ID to follow. | | `target_username` | string | No | Disqus username to follow instead of a user ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Generate Interesting Forum Content **Slug:** `DISQUS_GENERATE_INTERESTING_FORUM_CONTENT` Internal only endpoint that causes the interesting content (forums) to be generated, but not returned. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Application Usage **Slug:** `DISQUS_GET_APPLICATION_USAGE` Returns the API usage per day for this application. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `days` | integer | No | Whole number of days. Defaults to 30; maximum 30. Zero is supported. | | `application` | string | No | Provider parameter `application`; the official endpoint page does not further describe its accepted shape. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Category **Slug:** `DISQUS_GET_CATEGORY` Returns category details. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `category` | string | Yes | Looks up a category by ID | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Customer Pulse Metadata **Slug:** `DISQUS_GET_CUSTOMER_PULSE_METADATA` Returns Customer Pulse metadata available to the authenticated application; this endpoint takes no input. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Customer Pulse Segment **Slug:** `DISQUS_GET_CUSTOMER_PULSE_SEGMENT` Returns a bounded Customer Pulse segment snapshot available to the authenticated application; this endpoint takes no input and may truncate deeply nested segment values to stay within the tool response limit. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Forum **Slug:** `DISQUS_GET_FORUM` Returns forum details. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) | | `attach` | array | No | Choices: followsForum, forumCanDisableAds, forumForumCategory, counters, forumDaysAlive, forumFeatures, forumIntegration, forumNewPolicy, forumPermissions | | `related` | array | No | You may specify relations to include with your response. Choices: author | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Forum Behind Click Setting **Slug:** `DISQUS_GET_FORUM_BEHIND_CLICK_SETTING` Returns forum custom behind-a-click settings Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Forum Category **Slug:** `DISQUS_GET_FORUM_CATEGORY` Returns forum category details. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum_category` | string | Yes | Looks up a forum category by ID | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Forum Reaction Config **Slug:** `DISQUS_GET_FORUM_REACTION_CONFIG` Used to load any configured reactions for the forum, and all active images belong to that forum. Also returns whether thread reactions are enabled for the forum. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Import **Slug:** `DISQUS_GET_IMPORT` Return details for an import group. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) | | `group` | string | Yes | Import group to retrieve. The official endpoint page requires group but does not define its accepted type or identifier format. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Organization Billing Information **Slug:** `DISQUS_GET_ORGANIZATION_BILLING_INFORMATION` Returns billing information related to an organization. This is in a dictionary with keys: `paymentInfo` (optional): `invoiceHistory`: Historical invoices that were successfully paid Caveats: Looks up an organization by ID You must be an admin on the selected organization. The official action page does not identify a billing tier; availability remains capability/account dependent. This SaaS/billing action may require organization billing capability even though the page does not name a paid tier. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization` | string | Yes | Looks up an organization by ID You must be an admin on the selected organization. | | `history_limit` | number | No | Maximum value of 100 | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Organization Current Plan **Slug:** `DISQUS_GET_ORGANIZATION_CURRENT_PLAN` Return the current SaaS plan for an organization and product. Caveats: Looks up an organization by ID You must be an admin on the selected organization. The official action page does not identify a billing tier; availability remains capability/account dependent. This SaaS/billing action may require organization billing capability even though the page does not name a paid tier. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization` | string | Yes | Looks up an organization by ID You must be an admin on the selected organization. | | `product_name` | string ("comments" | "polls") | No | Choices: comments, polls | | `include_inactive` | string | No | Provider parameter `includeInactive`; the official endpoint page does not further describe its accepted shape. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Page By Thread **Slug:** `DISQUS_GET_PAGE_BY_THREAD` Returns a page by thread id. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `thread` | string | No | Provider parameter `thread`; the official endpoint page does not further describe its accepted shape. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Pending Aet Export **Slug:** `DISQUS_GET_PENDING_AET_EXPORT` Returns pending AET subscriber-export status for a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Pending Aet Optout Export **Slug:** `DISQUS_GET_PENDING_AET_OPTOUT_EXPORT` Returns pending AET opt-out-export status for a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Post **Slug:** `DISQUS_GET_POST` Returns information about a post. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `post` | string | Yes | Looks up a post by ID | | `related` | array | No | You may specify relations to include with your response. Choices: forum, thread | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Post Context **Slug:** `DISQUS_GET_POST_CONTEXT` Returns the hierarchical tree of a post (all parents). asc - oldest first desc - newest first popular - highest upvote rating over time. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `post` | string | Yes | Looks up a post by ID | | `depth` | number | No | Minimum value of 1 Maximum value of 10 | | `order` | string ("asc" | "desc" | "popular") | No | Choices: asc, desc, popular | | `related` | array | No | You may specify relations to include with your response. Choices: forum, thread | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Thread **Slug:** `DISQUS_GET_THREAD` Returns thread details. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | No | Looks up a forum by ID (aka short name) | | `attach` | array | No | Choices: topics | | `thread` | string | No | Looks up a thread by ID You may pass us the 'ident' or 'link' query types instead of an ID by including 'forum'. | | `related` | array | No | You may specify relations to include with your response. Choices: forum, author, category | | `thread_link` | string | No | Looks up a thread by URL; forum is required. | | `thread_ident` | string | No | Looks up a thread by identifier; forum is required. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Thread Ratings Summary **Slug:** `DISQUS_GET_THREAD_RATINGS_SUMMARY` Returns average and total ratings for a thread. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `thread` | string | Yes | Looks up a thread by ID | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Thread Reaction Default Images **Slug:** `DISQUS_GET_THREAD_REACTION_DEFAULT_IMAGES` Returns the metadata of the default reactions. This way they can display for forums that don't use reactions. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Threads By Ids **Slug:** `DISQUS_GET_THREADS_BY_IDS` Returns an unsorted set of threads given a list of ids. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. A forum selector is required when the account lacks the Pro API Access addon where the relevant parameter description says so. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | No | Looks up a forum by ID (aka short name) | | `attach` | array | No | Choices: topics | | `thread` | array | No | 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. | | `related` | array | No | You may specify relations to include with your response. Choices: forum, author, category | | `thread_link` | array | No | Filters by thread URLs. Forum is required only when the account lacks the Pro API Access addon. | | `thread_ident` | array | No | Looks up threads by identifiers; forum is required. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get User **Slug:** `DISQUS_GET_USER` Returns details of a user. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user` | string | No | Looks up a user by ID You may look up a user by username using the 'username' query type. | | `attach` | array | No | Choices: userFlaggedUser, thirdPartyAccounts | | `user_username` | string | No | Looks up a user by Disqus username instead of user ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Awarded Badges **Slug:** `DISQUS_LIST_AWARDED_BADGES` Returns one page of awarded badges for the user. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user` | string | No | Looks up a user by ID You may look up a user by username using the 'username' query type. | | `limit` | number | No | Awarded badges per page. Defaults to 25; maximum 100. | | `order` | string ("asc" | "desc") | No | Choices: asc, desc | | `since` | string | No | Unix timestamp (or ISO datetime standard) | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | | `user_username` | string | No | Looks up a user by Disqus username instead of user ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Badges **Slug:** `DISQUS_LIST_BADGES` Used to load any configured badges for the forum. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Blacklist Entries **Slug:** `DISQUS_LIST_BLACKLIST_ENTRIES` Returns one page of blacklist entries. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `type` | array | No | Choices: domain, word, ip, user, thread_slug, email | | `forum` | array | Yes | Looks up a forum by ID (aka short name) | | `limit` | number | No | Blacklist entries per page. Defaults to 50; maximum 100. | | `order` | string ("asc" | "desc") | No | Choices: asc, desc | | `query` | string | No | Provider parameter `query`; the official endpoint page does not further describe its accepted shape. | | `since` | string | No | Unix timestamp (or ISO datetime standard) | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | | `related` | array | No | You may specify relations to include with your response. Choices: forum | | `since_id` | string | No | Provider parameter `since_id`; the official endpoint page does not further describe its accepted shape. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Categories **Slug:** `DISQUS_LIST_CATEGORIES` Returns one page of categories from the categories/list endpoint across the supplied forum IDs. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | array | Yes | Looks up a forum by ID (aka short name) | | `limit` | number | No | Categories per page. Defaults to 25; maximum 100. | | `order` | string ("asc" | "desc") | No | Choices: asc, desc | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | | `since_id` | string | No | Provider parameter `since_id`; the official endpoint page does not further describe its accepted shape. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Categories In Forum **Slug:** `DISQUS_LIST_CATEGORIES_IN_FORUM` Returns one page of categories from the forums/listCategories endpoint for one forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) | | `limit` | integer | No | Categories per page. Defaults to 25; maximum 100. | | `order` | string ("asc" | "desc") | No | Choices: asc, desc | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | | `since_id` | string | No | Provider parameter `since_id`; the official endpoint page does not further describe its accepted shape. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Category Posts **Slug:** `DISQUS_LIST_CATEGORY_POSTS` Returns one page of posts within a category. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | number | No | Posts per page. Defaults to 25; maximum 100. | | `order` | string ("asc" | "desc") | No | Choices: asc, desc | | `query` | string | No | Provider parameter `query`; the official endpoint page does not further describe its accepted shape. | | `since` | string | No | Unix timestamp (or ISO datetime standard) | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | | `filters` | array | No | 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 | | `include` | array | No | Choices: unapproved, approved, spam, deleted, flagged, highlighted | | `related` | array | No | You may specify relations to include with your response. Choices: forum, thread | | `category` | string | Yes | Looks up a category by ID | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Category Threads **Slug:** `DISQUS_LIST_CATEGORY_THREADS` Returns one page of threads within a category, sorted by creation date. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | number | No | Threads per page. Defaults to 25; maximum 100. | | `order` | string ("asc" | "desc") | No | Choices: asc, desc | | `since` | string | No | Unix timestamp (or ISO datetime standard) | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | | `related` | array | No | You may specify relations to include with your response. Choices: forum, author | | `category` | string | Yes | Looks up a category by ID | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Classified Forums Needing Favicons **Slug:** `DISQUS_LIST_CLASSIFIED_FORUMS_NEEDING_FAVICONS` Gets forums that are classified in tempest (primarily means has a high quality score and is in english) Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Forum Categories **Slug:** `DISQUS_LIST_FORUM_CATEGORIES` Returns a list of forum categories Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Forum Followers **Slug:** `DISQUS_LIST_FORUM_FOLLOWERS` Returns 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) | | `limit` | integer | No | Followers per page. Defaults to 25; maximum 100. | | `order` | string ("asc" | "desc") | No | Choices: asc, desc | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | | `since_id` | string | No | Provider parameter `since_id`; the official endpoint page does not further describe its accepted shape. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Forum Moderators **Slug:** `DISQUS_LIST_FORUM_MODERATORS` Returns 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Forum Posts **Slug:** `DISQUS_LIST_FORUM_POSTS` Returns one page of posts within a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) | | `limit` | integer | No | Posts per page. Defaults to 25; maximum 100. | | `order` | string ("asc" | "desc") | No | Choices: asc, desc | | `query` | string | No | Provider parameter `query`; the official endpoint page does not further describe its accepted shape. | | `since` | string | No | Unix timestamp (or ISO datetime standard) | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | | `filters` | array | No | 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 | | `include` | array | No | Choices: unapproved, approved, spam, deleted, flagged, highlighted | | `related` | array | No | You may specify relations to include with your response. Choices: thread | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Forum Threads **Slug:** `DISQUS_LIST_FORUM_THREADS` Returns one page of threads within a forum, sorted by creation date. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. A forum selector is required when the account lacks the Pro API Access addon where the relevant parameter description says so. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `after` | string | No | Unix timestamp (or ISO datetime standard) | | `forum` | string | Yes | Looks up a forum by ID (aka short name) | | `limit` | integer | No | Threads per page. Defaults to 25; maximum 100. | | `order` | string ("asc" | "desc") | No | Choices: asc, desc | | `since` | string | No | Unix timestamp (or ISO datetime standard) | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | | `thread` | array | No | 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. | | `include` | array | No | Choices: open, closed, killed | | `related` | array | No | You may specify relations to include with your response. Choices: forum, author | | `thread_link` | array | No | Filters by thread URLs. Forum is required only when the account lacks the Pro API Access addon. | | `thread_ident` | array | No | Filters by thread identifiers in the selected forum. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Forum Trusted Domains **Slug:** `DISQUS_LIST_FORUM_TRUSTED_DOMAINS` Returns 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Forum User Moderation History **Slug:** `DISQUS_LIST_FORUM_USER_MODERATION_HISTORY` Returns 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user` | string | No | Looks up a user by ID You may look up a user by username using the 'username' query type. | | `forum` | string | Yes | Looks up a forum by ID (aka short name) | | `limit` | string | No | Moderation history entries per page. Defaults to 20; the official endpoint page does not document bounds. | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | | `user_username` | string | No | Looks up a user by Disqus username instead of user ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Hot Threads **Slug:** `DISQUS_LIST_HOT_THREADS` Returns 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | array | No | Looks up a forum by ID (aka short name) | | `limit` | number | No | Threads per page. Defaults to 25; maximum 100. | | `author` | array | No | Looks up a user by ID You may look up a user by username using the 'username' query type. | | `include` | array | No | Choices: open, closed, killed | | `related` | array | No | You may specify relations to include with your response. Choices: forum, author, category | | `category` | array | No | Looks up a category by ID | | `author_username` | array | No | Filters by Disqus usernames instead of user IDs. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Imports **Slug:** `DISQUS_LIST_IMPORTS` Return 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) | | `cursor` | string | No | Provider parameter `cursor`; the official endpoint page does not further describe its accepted shape. Pass cursor.next only when cursor.hasNext is true. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Interesting Forums **Slug:** `DISQUS_LIST_INTERESTING_FORUMS` Return 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Forums to return. Defaults to 5; maximum 100. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Interesting Users **Slug:** `DISQUS_LIST_INTERESTING_USERS` Returns 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | number | No | Users to return. Defaults to 5; maximum 100. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Most Active Forum Users **Slug:** `DISQUS_LIST_MOST_ACTIVE_FORUM_USERS` Returns 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) | | `limit` | integer | No | Users per page. Defaults to 25; maximum 100. | | `order` | string | No | Choices: desc | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Most Liked Forum Users **Slug:** `DISQUS_LIST_MOST_LIKED_FORUM_USERS` Returns 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) | | `limit` | integer | No | Users per page. Defaults to 25; maximum 100. | | `order` | string | No | Choices: desc | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Organization Roles **Slug:** `DISQUS_LIST_ORGANIZATION_ROLES` List 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization` | string | Yes | Looks up an organization by ID You must be an admin on the selected organization. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Pages **Slug:** `DISQUS_LIST_PAGES` Returns 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Whole number of pages to return. Defaults to 20; minimum 1; maximum 50. | | `range` | string ("7d" | "30" | "2d" | "1d" | "7" | "1h" | "30d") | No | Choices: 7d, 30, 2d, 1d, 7, 1h, 30d | | `cursor` | number | No | Continuation cursor, with a maximum value of 50. Pass the previous response's cursor.next only when cursor.hasNext is true. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Popular Posts **Slug:** `DISQUS_LIST_POPULAR_POSTS` Returns one page of posts ordered by recent likes. Pagination defaults to limit 25 and offset 0. Caveats: This beta endpoint is subject to change. The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | array | No | Forums to include. By default, returns posts from all forums you moderate. Pass :all to retrieve posts from all forums. | | `limit` | number | No | Posts per page. Defaults to 25; maximum 100. | | `order` | string ("popular" | "best") | No | Popularity ranking. Defaults to popular. Choices: popular, best | | `query` | string | No | Provider parameter `query`; the official endpoint page does not further describe its accepted shape. | | `offset` | string | No | Numeric page offset. Defaults to 0. | | `thread` | array | No | Looks up a thread by ID | | `include` | array | No | Post states to include. Defaults to approved. Choices: unapproved, approved, spam, deleted, flagged, highlighted | | `related` | array | No | You may specify relations to include with your response. Choices: forum, thread | | `category` | string | No | Provider parameter `category`; the official endpoint page does not further describe its accepted shape. | | `interval` | string ("30s" | "1h" | "6h" | "12h" | "1d" | "3d" | "7d" | "30d" | "60d" | "90d") | No | Popularity interval. Defaults to 7d. Choices: 30s, 1h, 6h, 12h, 1d, 3d, 7d, 30d, 60d, 90d | | `organization` | string | No | Looks up an organization by ID | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Popular Threads **Slug:** `DISQUS_LIST_POPULAR_THREADS` Returns a list of threads sorted by number of posts made since ``interval``. If you are using both ``category`` and ``forum`` parameters, the forum of the category must match that as the parameter value for ``forum``. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | No | Looks up a forum by ID (aka short name) | | `limit` | number | No | Threads per page. Defaults to 25; maximum 100. | | `related` | array | No | You may specify relations to include with your response. Choices: forum, author, category | | `category` | string | No | Looks up a category by ID | | `interval` | string ("1h" | "6h" | "12h" | "1d" | "3d" | "7d" | "30d" | "90d") | No | Choices: 1h, 6h, 12h, 1d, 3d, 7d, 30d, 90d | | `with_top_post` | string | No | Provider parameter `with_top_post`; the official endpoint page does not further describe its accepted shape. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Post Moderation History **Slug:** `DISQUS_LIST_POST_MODERATION_HISTORY` Returns 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `post` | string | Yes | Looks up a post by ID You must be a moderator on the selected post's forum. | | `limit` | string | No | Moderation history entries per page. Defaults to 20; the official endpoint page does not document bounds. | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Post Reporters **Slug:** `DISQUS_LIST_POST_REPORTERS` Return 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `posts` | array | Yes | Looks up a post by ID You must be a moderator on the selected post's forum. | | `number_per_post` | string | No | Provider parameter `numberPerPost`; the official endpoint page does not further describe its accepted shape. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Posts **Slug:** `DISQUS_LIST_POSTS` Returns 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `end` | string | No | Unix timestamp (or ISO datetime standard) | | `forum` | array | No | Forums to include. By default, returns posts from all forums you moderate. Pass :all to retrieve posts from all forums. | | `limit` | number | No | Posts per page. Defaults to 25; maximum 100. | | `order` | string ("asc" | "desc") | No | Creation-date order. Defaults to desc. Choices: asc, desc | | `query` | string | No | Provider parameter `query`; the official endpoint page does not further describe its accepted shape. | | `since` | string | No | Unix timestamp (or ISO datetime standard) | | `start` | string | No | Unix timestamp (or ISO datetime standard) | | `cursor` | string | No | Continuation cursor. Omit for the first page; pass the previous response's cursor.next only when cursor.hasNext is true. | | `offset` | string | No | Deprecated numeric page offset. Defaults to 0; use cursor for pagination. | | `thread` | array | No | Looks up a thread by ID | | `filters` | array | No | 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 | | `include` | array | No | Post states to include. Defaults to approved. Choices: unapproved, approved, spam, deleted, flagged, highlighted | | `related` | array | No | You may specify relations to include with your response. Choices: forum, thread | | `category` | array | No | Looks up a category by ID | | `is_edited` | string | No | Only edited (1) or only unedited (0); omit for no filter. | | `sort_type` | string ("date" | "priority") | No | Sort strategy. Defaults to date. Choices: date, priority | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Random Pages **Slug:** `DISQUS_LIST_RANDOM_PAGES` Returns a random list of category objects with page data of HotThreads for forums in that given category. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `count` | integer | No | Whole number of random pages to return. Defaults to 20; minimum 1; maximum 50. | | `range` | string ("7d" | "30" | "2d" | "1d" | "7" | "1h" | "30d") | No | Choices: 7d, 30, 2d, 1d, 7, 1h, 30d | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Saas Packages **Slug:** `DISQUS_LIST_SAAS_PACKAGES` Return 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization` | string | No | Looks up an organization by ID You must be an admin on the selected organization. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Thread Posts **Slug:** `DISQUS_LIST_THREAD_POSTS` Returns 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | No | Looks up a forum by ID (aka short name) | | `limit` | number | No | Posts per page. Defaults to 25; maximum 100. | | `order` | string ("asc" | "desc") | No | Choices: asc, desc | | `query` | string | No | Provider parameter `query`; the official endpoint page does not further describe its accepted shape. | | `since` | string | No | Unix timestamp (or ISO datetime standard) | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | | `thread` | string | No | Looks up a thread by ID You may pass us the 'ident' or 'link' query types instead of an ID by including 'forum'. | | `filters` | array | No | 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 | | `include` | array | No | Choices: unapproved, approved, spam, deleted, flagged, highlighted | | `related` | array | No | You may specify relations to include with your response. Choices: forum, thread | | `thread_link` | string | No | Looks up a thread by URL; forum is required. | | `thread_ident` | string | No | Looks up a thread by identifier; forum is required. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Thread Reactions **Slug:** `DISQUS_LIST_THREAD_REACTIONS` Used 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `thread` | string | Yes | Looks up a thread by ID | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Threads **Slug:** `DISQUS_LIST_THREADS` Returns 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | array | No | Looks up a forum by ID (aka short name) | | `limit` | number | No | Threads per page. Defaults to 25; maximum 100. | | `order` | string ("asc" | "desc") | No | Choices: asc, desc | | `since` | string | No | Unix timestamp (or ISO datetime standard) | | `attach` | array | No | Choices: topics | | `author` | array | No | Looks up a user by ID You may look up a user by username using the 'username' query type. | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | | `thread` | array | No | 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. | | `include` | array | No | Choices: open, closed, killed | | `related` | array | No | You may specify relations to include with your response. Choices: forum, author, category | | `category` | array | No | Looks up a category by ID | | `thread_link` | array | No | Filters by thread URLs. Forum is required only when the account lacks the Pro API Access addon. | | `thread_ident` | array | No | Filters by thread identifiers; forum is required. | | `author_username` | array | No | Filters by Disqus usernames instead of user IDs. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Trending Threads **Slug:** `DISQUS_LIST_TRENDING_THREADS` Returns a list of trending threads. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | array | No | Looks up a forum by ID (aka short name) | | `limit` | number | No | Threads to return. Defaults to 10; maximum 10. | | `related` | array | No | You may specify relations to include with your response. Choices: forum, author, category | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List User Active Forums **Slug:** `DISQUS_LIST_USER_ACTIVE_FORUMS` Returns 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user` | string | No | Looks up a user by ID You may look up a user by username using the 'username' query type. | | `limit` | number | No | Forums per page. Defaults to 25; maximum 100. | | `order` | string ("asc" | "desc") | No | Choices: asc, desc | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | | `since_id` | string | No | Provider parameter `since_id`; the official endpoint page does not further describe its accepted shape. | | `user_username` | string | No | Looks up a user by Disqus username instead of user ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List User Activity **Slug:** `DISQUS_LIST_USER_ACTIVITY` Returns 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user` | string | No | Looks up a user by ID You may look up a user by username using the 'username' query type. | | `limit` | number | No | Activity entries per page. Defaults to 25; maximum 100. | | `query` | string | No | Provider parameter `query`; the official endpoint page does not further describe its accepted shape. | | `since` | string | No | Unix timestamp (or ISO datetime standard) | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | | `include` | array | No | Choices: user, replies, following | | `related` | array | No | You may specify relations to include with your response. Choices: forum, thread | | `anon_user` | string | No | Looks up an anonymous user by unique hash | | `user_username` | string | No | Looks up a user by Disqus username instead of user ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List User Followers **Slug:** `DISQUS_LIST_USER_FOLLOWERS` Returns 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user` | string | No | Looks up a user by ID You may look up a user by username using the 'username' query type. | | `limit` | number | No | Followers per page. Defaults to 25; maximum 100. | | `order` | string ("asc" | "desc") | No | Choices: asc, desc | | `attach` | array | No | Choices: userFlaggedUser, thirdPartyAccounts | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | | `since_id` | string | No | Provider parameter `since_id`; the official endpoint page does not further describe its accepted shape. | | `user_username` | string | No | Looks up a user by Disqus username instead of user ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List User Following **Slug:** `DISQUS_LIST_USER_FOLLOWING` Returns 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user` | string | No | Looks up a user by ID You may look up a user by username using the 'username' query type. | | `limit` | number | No | Followed users per page. Defaults to 25; maximum 100. | | `order` | string ("asc" | "desc") | No | Choices: asc, desc | | `attach` | array | No | Choices: userFlaggedUser, thirdPartyAccounts | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | | `since_id` | string | No | Provider parameter `since_id`; the official endpoint page does not further describe its accepted shape. | | `user_username` | string | No | Looks up a user by Disqus username instead of user ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List User Following Channels **Slug:** `DISQUS_LIST_USER_FOLLOWING_CHANNELS` Returns 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user` | string | No | Looks up a user by ID You may look up a user by username using the 'username' query type. | | `limit` | number | No | Followed channels per page. Defaults to 25; maximum 100. | | `order` | string ("asc" | "desc") | No | Choices: asc, desc | | `attach` | array | No | Choices: followsForum, forumCanDisableAds, forumForumCategory, counters, forumDaysAlive, forumFeatures, forumIntegration, forumNewPolicy, forumPermissions, channel_categories | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | | `since_id` | string | No | Provider parameter `since_id`; the official endpoint page does not further describe its accepted shape. | | `exclude_owned` | string | No | Whether to exclude Channels that the user owns from the results | | `user_username` | string | No | Looks up a user by Disqus username instead of user ID. | | `exclude_moderated` | string | No | Whether to exclude channels that the user moderates from the results | | `include_followed_primary_forums` | string | No | Whether to include Channels where the user follows the primary forum | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List User Following Forums **Slug:** `DISQUS_LIST_USER_FOLLOWING_FORUMS` Returns 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user` | string | No | Looks up a user by ID You may look up a user by username using the 'username' query type. | | `limit` | number | No | Followed forums per page. Defaults to 25; maximum 100. | | `order` | string ("asc" | "desc") | No | Choices: asc, desc | | `attach` | array | No | Choices: followsForum, forumCanDisableAds, forumForumCategory, counters, forumDaysAlive, forumFeatures, forumIntegration, forumNewPolicy, forumPermissions | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | | `since_id` | string | No | Provider parameter `since_id`; the official endpoint page does not further describe its accepted shape. | | `user_username` | string | No | Looks up a user by Disqus username instead of user ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List User Forums **Slug:** `DISQUS_LIST_USER_FORUMS` Returns 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user` | string | No | Looks up a user by ID You may look up a user by username using the 'username' query type. | | `limit` | number | No | Owned forums per page. Defaults to 25; maximum 100. | | `order` | string ("asc" | "desc") | No | Choices: asc, desc | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | | `since_id` | string | No | Provider parameter `since_id`; the official endpoint page does not further describe its accepted shape. | | `user_username` | string | No | Looks up a user by Disqus username instead of user ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List User Moderated Channels **Slug:** `DISQUS_LIST_USER_MODERATED_CHANNELS` Returns 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user` | string | No | Looks up a user by ID You may look up a user by username using the 'username' query type. | | `limit` | number | No | Moderated channels per page. Defaults to 25; maximum 100. | | `order` | string ("asc" | "desc") | No | Choices: asc, desc | | `attach` | array | No | Choices: followsForum, forumCanDisableAds, forumForumCategory, counters, forumDaysAlive, forumFeatures, forumIntegration, forumNewPolicy, forumPermissions, channel_categories | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | | `since_id` | string | No | Provider parameter `since_id`; the official endpoint page does not further describe its accepted shape. | | `exclude_owned` | string | No | Whether to exclude Channels that the user owns from the results | | `user_username` | string | No | Looks up a user by Disqus username instead of user ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List User Most Active Forums **Slug:** `DISQUS_LIST_USER_MOST_ACTIVE_FORUMS` Returns 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user` | string | No | Looks up a user by ID You may look up a user by username using the 'username' query type. | | `limit` | number | No | Active forums per page. Defaults to 25; maximum 100. | | `user_username` | string | No | Looks up a user by Disqus username instead of user ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List User Owned Channels **Slug:** `DISQUS_LIST_USER_OWNED_CHANNELS` Returns 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user` | string | No | Looks up a user by ID You may look up a user by username using the 'username' query type. | | `limit` | number | No | Owned channels per page. Defaults to 25; maximum 100. | | `order` | string ("asc" | "desc") | No | Choices: asc, desc | | `attach` | array | No | Choices: followsForum, forumCanDisableAds, forumForumCategory, counters, forumDaysAlive, forumFeatures, forumIntegration, forumNewPolicy, forumPermissions, channel_categories | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | | `since_id` | string | No | Provider parameter `since_id`; the official endpoint page does not further describe its accepted shape. | | `user_username` | string | No | Looks up a user by Disqus username instead of user ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List User Posts **Slug:** `DISQUS_LIST_USER_POSTS` Returns 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user` | string | No | Looks up a user by ID You may look up a user by username using the 'username' query type. | | `limit` | number | No | Posts per page. Defaults to 25; maximum 100. | | `order` | string ("asc" | "desc") | No | Choices: asc, desc | | `since` | string | No | Unix timestamp (or ISO datetime standard) | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | | `filters` | array | No | 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 | | `include` | array | No | Choices: unapproved, approved, spam, deleted, flagged, highlighted | | `related` | array | No | You may specify relations to include with your response. Choices: forum, thread | | `user_username` | string | No | Looks up a user by Disqus username instead of user ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Users Who Voted On Thread **Slug:** `DISQUS_LIST_USERS_WHO_VOTED_ON_THREAD` Returns a list of users that voted on this thread. If prioritize_followed is True and the user is authenticated, attempts to return users that the authenticated user follows. If there aren't enough followed users to reach the limit, pads the rest of the list with not followed users. Caveats: Prioritize followed users who voted on this thread (must be authenticated) The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `vote` | string ("-1" | "0" | "1") | No | Choices: -1, 0, 1 | | `limit` | number | No | Users to return. Defaults to 10; maximum 100. | | `thread` | string | Yes | Looks up a thread by ID | | `prioritize_followed` | string | No | Prioritize followed users who voted on this thread (must be authenticated) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Whitelist Entries **Slug:** `DISQUS_LIST_WHITELIST_ENTRIES` Returns one page of whitelist entries. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `type` | array | No | Choices: email, user | | `forum` | array | Yes | Looks up a forum by ID (aka short name) | | `limit` | number | No | Whitelist entries per page. Defaults to 25; maximum 100. | | `order` | string ("asc" | "desc") | No | Choices: asc, desc | | `query` | string | No | Provider parameter `query`; the official endpoint page does not further describe its accepted shape. | | `since` | string | No | Unix timestamp (or ISO datetime standard) | | `cursor` | string | No | Continuation cursor. Pass the previous response's cursor.next only when cursor.hasNext is true. | | `related` | array | No | You may specify relations to include with your response. Choices: forum | | `since_id` | string | No | Provider parameter `since_id`; the official endpoint page does not further describe its accepted shape. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Mark Posts As Spam **Slug:** `DISQUS_MARK_POSTS_AS_SPAM` Marks 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `post` | array | Yes | Looks up a post by ID You must be a moderator on the selected post's forum. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Open Threads **Slug:** `DISQUS_OPEN_THREADS` Opens 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | No | Looks up a forum by ID (aka short name) | | `thread` | array | No | Thread IDs to open. | | `thread_link` | array | No | Thread URLs to open. Forum is required by Disqus only when the account lacks the Pro API Access addon. | | `thread_ident` | array | No | Thread identifiers to open; requires forum. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Remove Badge **Slug:** `DISQUS_REMOVE_BADGE` Used to remove badges from users. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user` | string | No | User ID whose badge is removed. | | `badge` | string | Yes | Looks up a badge by ID | | `forum` | string | Yes | Looks up a forum by ID (aka short name) | | `user_username` | string | No | Disqus username whose badge is removed instead of a user ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Remove Blacklist Entry **Slug:** `DISQUS_REMOVE_BLACKLIST_ENTRY` Removes an entry from the blacklist. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `ip` | array | No | IP addresses in CIDR notation to remove. Provide at least one blacklist selector. | | `user` | array | No | User IDs to remove. Provide at least one blacklist selector. | | `word` | array | No | Words to remove, each with a maximum length of 200. Provide at least one blacklist selector. | | `email` | array | No | RFC 5322 email addresses to remove. Provide at least one blacklist selector. | | `forum` | string | Yes | Looks up a forum by ID (aka short name) | | `domain` | array | No | Domain names to remove. Provide at least one blacklist selector. | | `blacklist` | array | No | Blacklist entry IDs to remove. Provide at least one blacklist selector. | | `user_usernames` | array | No | Disqus usernames to remove instead of user IDs. Provide at least one blacklist selector. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Remove Forum Default Avatar **Slug:** `DISQUS_REMOVE_FORUM_DEFAULT_AVATAR` Switches 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Remove Forum Moderator **Slug:** `DISQUS_REMOVE_FORUM_MODERATOR` Removes a moderator from a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user` | string | No | User ID for the moderator lookup. Required with forum when moderator is omitted. | | `forum` | string | No | Forum ID (short name) for the moderator lookup. Required with user when moderator is omitted. | | `moderator` | string | No | Moderator ID to remove. Use this alone, or omit it and provide both forum and user. | | `user_username` | string | No | Disqus username for the moderator lookup instead of a user ID. Required with forum. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Remove Forum Trusted Domain **Slug:** `DISQUS_REMOVE_FORUM_TRUSTED_DOMAIN` Removes 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | No | Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. | | `domain` | string | No | Trusted-domain record ID to remove. | | `domain_name` | string | No | Trusted domain name to remove instead of an ID; requires forum. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Remove Organization Admin **Slug:** `DISQUS_REMOVE_ORGANIZATION_ADMIN` Removes 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user` | string | No | User ID to remove as an admin. | | `organization` | string | Yes | Looks up an organization by ID You must be an admin on the selected organization. | | `user_username` | string | No | Disqus username to remove instead of a user ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Remove Posts **Slug:** `DISQUS_REMOVE_POSTS` Deletes the requested post(s). Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `post` | array | Yes | Looks up a post by ID | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Remove Threads **Slug:** `DISQUS_REMOVE_THREADS` Removes 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | No | Looks up a forum by ID (aka short name) | | `thread` | array | No | Thread IDs to remove. | | `thread_link` | array | No | Thread URLs to remove. Forum is required by Disqus only when the account lacks the Pro API Access addon. | | `thread_ident` | array | No | Thread identifiers to remove; requires forum. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Remove User Follower **Slug:** `DISQUS_REMOVE_USER_FOLLOWER` Remove a user from set of followers. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `follower` | string | No | Follower user ID to remove. | | `follower_username` | string | No | Follower's Disqus username to remove instead of a user ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Remove Whitelist Entry **Slug:** `DISQUS_REMOVE_WHITELIST_ENTRY` Removes an entry from the whitelist. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | array | No | Whitelist entry IDs to remove. Provide at least one of id, user, or email. | | `user` | array | No | User IDs to remove. Provide at least one selector. | | `email` | array | No | RFC 5322 email addresses to remove. Provide at least one of id, user, or email. | | `forum` | string | Yes | Looks up a forum by ID (aka short name) | | `user_usernames` | array | No | Disqus usernames to remove instead of user IDs. Provide at least one selector. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Replace Forum Badges **Slug:** `DISQUS_REPLACE_FORUM_BADGES` Used 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. | | `badges` | array | Yes | 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Report Post **Slug:** `DISQUS_REPORT_POST` Reports a post (flagging). Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `post` | string | Yes | Looks up a post by ID | | `reason` | string ("0" | "1" | "2" | "3" | "4" | "5" | "6") | No | Valid values are: 0: HARASSMENT 1: SPAM 2: INAPPROPRIATE_CONTENT 3: THREAT 4: IMPERSONATION 5: PRIVATE_INFORMATION 6: DISAGREE | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Report User **Slug:** `DISQUS_REPORT_USER` Report 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user` | string | No | User ID to report. | | `reason` | string ("0" | "1" | "2" | "3" | "4" | "5" | "6") | Yes | Valid values are: 0: HARASSMENT 1: SPAM 2: INAPPROPRIATE_CONTENT 3: THREAT 4: IMPERSONATION 5: PRIVATE_INFORMATION 6: DISAGREE | | `user_username` | string | No | Disqus username to report instead of a user ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Restore Posts **Slug:** `DISQUS_RESTORE_POSTS` Undeletes the requested post(s). Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `post` | array | Yes | Looks up a post by ID | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Restore Threads **Slug:** `DISQUS_RESTORE_THREADS` Calls 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | No | Looks up a forum by ID (aka short name) | | `thread` | array | No | Thread IDs to restore. | | `thread_link` | array | No | Thread URLs to restore. Forum is required by Disqus only when the account lacks the Pro API Access addon. | | `thread_ident` | array | No | Thread identifiers to restore; requires forum. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Save Forum Thread Reaction Template **Slug:** `DISQUS_SAVE_FORUM_THREAD_REACTION_TEMPLATE` Used 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. | | `prompt` | string | No | Maximum length of 60 | | `reactions_data` | object | Yes | Thread-reaction configuration object to JSON-encode in the form field. The official endpoint page does not define its keys. | | `apply_retroactively` | string | No | Provider parameter `applyRetroactively`; the official endpoint page does not further describe its accepted shape. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Set Organization Role **Slug:** `DISQUS_SET_ORGANIZATION_ROLE` Add a user with an arbitrary role to an organization. Caveats: Looks up an organization by ID You must be an admin on the selected organization. The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user` | string | No | User ID whose role is changed. | | `is_admin` | string | No | Provider parameter `isAdmin`; the official endpoint page does not further describe its accepted shape. | | `is_moderator` | string | No | Provider parameter `isModerator`; the official endpoint page does not further describe its accepted shape. | | `organization` | string | Yes | Looks up an organization by ID You must be an admin on the selected organization. | | `user_username` | string | No | Disqus username whose role is changed instead of a user ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Set Thread Reactions For Forum **Slug:** `DISQUS_SET_THREAD_REACTIONS_FOR_FORUM` Enables 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. | | `disable` | string | No | Provider parameter `disable`; the official endpoint page does not further describe its accepted shape. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Set Thread Reactions For Thread **Slug:** `DISQUS_SET_THREAD_REACTIONS_FOR_THREAD` Disables 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `enable` | string | No | Provider parameter `enable`; the official endpoint page does not further describe its accepted shape. | | `thread` | string | Yes | Looks up a thread by ID You must be a moderator on the selected thread's forum. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Spam Thread **Slug:** `DISQUS_SPAM_THREAD` Mark the specified moderated threads as spam. Caveats: Looks up a thread by ID You must be a moderator on the selected thread's forum. You may pass us the 'ident' or 'link' query types instead of an ID by including 'forum'. The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | No | Looks up a forum by ID (aka short name) | | `thread` | string | No | Thread ID to mark as spam. | | `thread_link` | string | No | Thread URL to mark as spam; requires forum. | | `thread_ident` | string | No | Thread identifier to mark as spam; requires forum. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Subscribe Anonymous User To Aet **Slug:** `DISQUS_SUBSCRIBE_ANONYMOUS_USER_TO_AET` Allows 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `email` | string | Yes | Email value to subscribe anonymously to AET. The official endpoint page does not define its accepted type or format. | | `forum` | string | Yes | Looks up a forum by ID (aka short name) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Subscribe Organization To Saas **Slug:** `DISQUS_SUBSCRIBE_ORGANIZATION_TO_SAAS` Subscribe 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `plan` | string | No | Looks up a PricingOption by name | | `user` | string | No | Optional user ID associated with the subscription. | | `coupon` | string | No | Looks up a coupon by its Stripe ID | | `organization` | string | Yes | Looks up an organization by ID You must be an admin on the selected organization. | | `user_username` | string | No | Optional Disqus username associated with the subscription instead of a user ID. | | `activation_code` | string | No | Looks up an ActivationCode | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Subscribe Thread **Slug:** `DISQUS_SUBSCRIBE_THREAD` Subscribe the authenticated user to a thread. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `thread` | string | Yes | Looks up a thread by ID | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Subscribe To Aet **Slug:** `DISQUS_SUBSCRIBE_TO_AET` Allows 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Suggest Posts **Slug:** `DISQUS_SUGGEST_POSTS` Return 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `posts` | array | Yes | Looks up a post by ID You must be a moderator on the selected post's forum. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Toggle Badge Award Visibility **Slug:** `DISQUS_TOGGLE_BADGE_AWARD_VISIBILITY` Used 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `user` | string | No | User ID whose badge visibility is toggled. | | `badge` | string | Yes | Looks up a badge by ID | | `user_username` | string | No | Disqus username whose badge visibility is toggled instead of a user ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Unfollow Forum **Slug:** `DISQUS_UNFOLLOW_FORUM` Unfollow a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `target` | string | Yes | Looks up a forum by ID (aka short name) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Unfollow User **Slug:** `DISQUS_UNFOLLOW_USER` Unfollow a user. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `target` | string | No | User ID to unfollow. | | `target_username` | string | No | Disqus username to unfollow instead of a user ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Unsubscribe Organization From Saas **Slug:** `DISQUS_UNSUBSCRIBE_ORGANIZATION_FROM_SAAS` Unsubscribe 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `immediately` | string | No | Provider parameter `immediately`; the official endpoint page does not further describe its accepted shape. | | `organization` | string | Yes | Looks up an organization by ID You must be an admin on the selected organization. | | `product_name` | string ("comments" | "polls") | No | Choices: comments, polls | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Unsubscribe Thread **Slug:** `DISQUS_UNSUBSCRIBE_THREAD` Unsubscribe the authenticated user from a thread. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `thread` | string | Yes | Looks up a thread by ID | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Forum **Slug:** `DISQUS_UPDATE_FORUM` Updates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | No | Provider parameter `name`; the official endpoint page does not further describe its accepted shape. | | `sort` | string ("1" | "2" | "4") | No | Valid values are: 1: OLDEST 2: NEWEST 4: HOT | | `forum` | string | Yes | Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. | | `attach` | array | No | Choices: followsForum, forumCanDisableAds, forumForumCategory, counters, forumDaysAlive, forumFeatures, forumIntegration, forumNewPolicy, forumPermissions | | `website` | string | No | URL (defined by RFC 3986) | | `category` | string ("Tech" | "Living" | "Style" | "Business" | "Entertainment" | "Celebrity" | "Sports" | "Culture" | "Games" | "News") | No | Choices: Tech, Living, Style, Business, Entertainment, Celebrity, Sports, Culture, Games, News | | `typeface` | string ("auto" | "serif" | "sans-serif") | No | Choices: auto, serif, sans-serif | | `guidelines` | string | No | Provider parameter `guidelines`; the official endpoint page does not further describe its accepted shape. | | `link_color` | string | No | Maximum length of 7 | | `custom_font` | string | No | Provider parameter `customFont`; the official endpoint page does not further describe its accepted shape. | | `description` | string | No | Maximum length of 300 | | `voting_type` | string ("0" | "1" | "2" | "3") | No | Valid values are: 0: DETAILED 1: DOWNVOTE_LIMITED 2: DOWNVOTE_DISABLED 3: DISABLED | | `color_scheme` | string ("auto" | "dark" | "light") | No | Choices: auto, dark, light | | `should_error` | string | No | Provider parameter `shouldError`; the official endpoint page does not further describe its accepted shape. | | `twitter_name` | string | No | Maximum length of 255 | | `adult_content` | string | No | Provider parameter `adultContent`; the official endpoint page does not further describe its accepted shape. | | `badges_enabled` | string | No | Provider parameter `badgesEnabled`; the official endpoint page does not further describe its accepted shape. | | `flag_threshold` | string | No | Provider parameter `flagThreshold`; the official endpoint page does not further describe its accepted shape. | | `forum_category` | string | No | Looks up a forum category by ID | | `allow_anon_post` | string | No | Provider parameter `allowAnonPost`; the official endpoint page does not further describe its accepted shape. | | `unapprove_links` | string | No | Provider parameter `unapproveLinks`; the official endpoint page does not further describe its accepted shape. | | `aet_banner_title` | string | No | Provider parameter `aetBannerTitle`; the official endpoint page does not further describe its accepted shape. | | `ai_polls_enabled` | string | No | Provider parameter `aiPollsEnabled`; the official endpoint page does not further describe its accepted shape. | | `flagging_enabled` | string | No | Provider parameter `flaggingEnabled`; the official endpoint page does not further describe its accepted shape. | | `comments_link_one` | string | No | Maximum length of 50 | | `days_thread_alive` | integer | No | Maximum value of 10000 | | `install_completed` | string | No | Provider parameter `installCompleted`; the official endpoint page does not further describe its accepted shape. | | `aet_banner_enabled` | string | No | Provider parameter `aetBannerEnabled`; the official endpoint page does not further describe its accepted shape. | | `comments_link_zero` | string | No | Maximum length of 50 | | `gif_picker_enabled` | string | No | Provider parameter `gifPickerEnabled`; the official endpoint page does not further describe its accepted shape. | | `mediaembed_enabled` | string | No | Provider parameter `mediaembedEnabled`; the official endpoint page does not further describe its accepted shape. | | `validate_all_posts` | string | No | Provider parameter `validateAllPosts`; the official endpoint page does not further describe its accepted shape. | | `comment_policy_link` | string | No | URL (defined by RFC 3986) | | `comment_policy_text` | string | No | Provider parameter `commentPolicyText`; the official endpoint page does not further describe its accepted shape. | | `behind_click_enabled` | string | No | Provider parameter `behindClickEnabled`; the official endpoint page does not further describe its accepted shape. | | `disable_social_share` | string | No | Provider parameter `disableSocialShare`; the official endpoint page does not further describe its accepted shape. | | `moderator_badge_text` | string | No | Maximum length of 50 | | `translation_language` | string | No | Translation Language | | `initial_comment_count` | integer | No | Minimum value of 1 Maximum value of 50 | | `aet_banner_description` | string | No | Provider parameter `aetBannerDescription`; the official endpoint page does not further describe its accepted shape. | | `comments_link_multiple` | string | No | Maximum length of 50 | | `flagging_notifications` | string | No | Provider parameter `flaggingNotifications`; the official endpoint page does not further describe its accepted shape. | | `thread_ratings_enabled` | string | No | Provider parameter `threadRatingsEnabled`; the official endpoint page does not further describe its accepted shape. | | `aet_banner_confirmation` | string | No | Provider parameter `aetBannerConfirmation`; the official endpoint page does not further describe its accepted shape. | | `disable_disqus_branding` | string | No | Provider parameter `disableDisqusBranding`; the official endpoint page does not further describe its accepted shape. | | `ads_position_top_enabled` | string | No | Provider parameter `adsPositionTopEnabled`; the official endpoint page does not further describe its accepted shape. | | `days_unapprove_new_users` | integer | No | Minimum value of 1 Maximum value of 99 | | `link_affiliation_enabled` | string | No | Provider parameter `linkAffiliationEnabled`; the official endpoint page does not further describe its accepted shape. | | `ads_position_poll_enabled` | string | No | Provider parameter `adsPositionPollEnabled`; the official endpoint page does not further describe its accepted shape. | | `organic_discovery_enabled` | string | No | Provider parameter `organicDiscoveryEnabled`; the official endpoint page does not further describe its accepted shape. | | `ads_position_bottom_enabled` | string | No | Provider parameter `adsPositionBottomEnabled`; the official endpoint page does not further describe its accepted shape. | | `contextual_ai_polls_enabled` | string | No | Provider parameter `contextualAiPollsEnabled`; the official endpoint page does not further describe its accepted shape. | | `unapprove_new_users_enabled` | string | No | Provider parameter `unapproveNewUsersEnabled`; the official endpoint page does not further describe its accepted shape. | | `disable_third_party_trackers` | string | No | Provider parameter `disableThirdPartyTrackers`; the official endpoint page does not further describe its accepted shape. | | `ads_position_inthread_enabled` | string | No | Provider parameter `adsPositionInthreadEnabled`; the official endpoint page does not further describe its accepted shape. | | `comments_placeholder_text_empty` | string | No | Maximum length of 45 | | `disable_disqus_branding_on_polls` | string | No | Provider parameter `disableDisqusBrandingOnPolls`; the official endpoint page does not further describe its accepted shape. | | `comments_placeholder_text_populated` | string | No | Maximum length of 45 | | `ads_position_recommendations_enabled` | string | No | Provider parameter `adsPositionRecommendationsEnabled`; the official endpoint page does not further describe its accepted shape. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Forum Behind Click Setting **Slug:** `DISQUS_UPDATE_FORUM_BEHIND_CLICK_SETTING` Sets 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. | | `title_css` | string | No | Provider parameter `titleCSS`; the official endpoint page does not further describe its accepted shape. | | `button_css` | string | No | Provider parameter `buttonCSS`; the official endpoint page does not further describe its accepted shape. | | `title_text` | string | No | Provider parameter `titleText`; the official endpoint page does not further describe its accepted shape. | | `button_text` | string | No | Provider parameter `buttonText`; the official endpoint page does not further describe its accepted shape. | | `title_enabled` | string | No | Provider parameter `titleEnabled`; the official endpoint page does not further describe its accepted shape. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Forum Default Avatar **Slug:** `DISQUS_UPDATE_FORUM_DEFAULT_AVATAR` Automatically 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. | | `avatar_file` | object | Yes | Image file to crop and save as the forum default avatar. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Forum Favicon **Slug:** `DISQUS_UPDATE_FORUM_FAVICON` Update 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. | | `favicon_file` | object | Yes | Image file to upload as the forum favicon. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Internal Forum Action History **Slug:** `DISQUS_UPDATE_INTERNAL_FORUM_ACTION_HISTORY` Updates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `ip` | string | No | IP address (defined by RFC 5322) | | `log` | string | Yes | Looks up an action history row by ID | | `post` | string | No | Looks up a post by ID | | `user` | string | No | Optional actor user ID. | | `forum` | string | No | Looks up a forum by ID (aka short name) | | `action` | string ("1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13" | "14" | "15" | "16" | "17") | No | 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 | | `thread` | string | No | Looks up a thread by ID | | `date_added` | string | No | Unix timestamp (or ISO datetime standard) | | `target_user` | string | No | Optional target user ID. | | `user_username` | string | No | Optional actor's Disqus username instead of a user ID. | | `target_user_username` | string | No | Optional target user's Disqus username instead of an ID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Organization Invoice Information **Slug:** `DISQUS_UPDATE_ORGANIZATION_INVOICE_INFORMATION` Update 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `city` | string | No | Provider parameter `city`; the official endpoint page does not further describe its accepted shape. | | `state` | string | No | Provider parameter `state`; the official endpoint page does not further describe its accepted shape. | | `street` | string | No | Provider parameter `street`; the official endpoint page does not further describe its accepted shape. | | `tax_id` | string | No | Provider parameter `taxId`; the official endpoint page does not further describe its accepted shape. | | `country` | string | No | Provider parameter `country`; the official endpoint page does not further describe its accepted shape. | | `zip_code` | string | No | Provider parameter `zipCode`; the official endpoint page does not further describe its accepted shape. | | `company_name` | string | No | Provider parameter `companyName`; the official endpoint page does not further describe its accepted shape. | | `organization` | string | Yes | Looks up an organization by ID You must be an admin on the selected organization. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Organization Payment Information **Slug:** `DISQUS_UPDATE_ORGANIZATION_PAYMENT_INFORMATION` Update 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `token` | string | Yes | Payment token used to update the organization billing information. The official endpoint page does not define the token's type or format. | | `organization` | string | Yes | Looks up an organization by ID You must be an admin on the selected organization. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Post **Slug:** `DISQUS_UPDATE_POST` Updates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `post` | string | Yes | You must be the author of the post or a moderator on the applicable forum. | | `rating` | number | No | Minimum value of 1 Maximum value of 5 | | `message` | string | Yes | Replacement post content. The official endpoint page requires message but does not define its accepted type or format. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Sso User Profile **Slug:** `DISQUS_UPDATE_SSO_USER_PROFILE` Updates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `url` | string | No | URL (defined by RFC 3986) | | `name` | string | No | Provider parameter `name`; the official endpoint page does not further describe its accepted shape. | | `email` | string | No | Email address (defined by RFC 5322) | | `forum` | string | No | Looks up a forum by ID (aka short name) | | `avatar` | string | No | URL (defined by RFC 3986) | | `user_id` | string | No | Provider parameter `user_id`; the official endpoint page does not further describe its accepted shape. | | `profile_url` | string | No | URL (defined by RFC 3986) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Thread **Slug:** `DISQUS_UPDATE_THREAD` Updates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `url` | string | No | URL (defined by RFC 3986) Maximum length of 500 | | `slug` | string | No | Alpha-numeric slug Maximum length of 200 | | `forum` | string | No | Looks up a forum by ID (aka short name) | | `title` | string | No | Maximum length of 200 | | `author` | string | No | User ID for the new thread author; requires moderator access. | | `thread` | string | Yes | You must be the author of the post or a moderator on the applicable forum. | | `message` | string | No | Provider parameter `message`; the official endpoint page does not further describe its accepted shape. | | `category` | string | No | Looks up a category by ID | | `identifier` | string | No | To update a specific identifier, provide 'old_identifier'. If no identifier exists, a new one is created. Maximum length of 300 | | `old_identifier` | string | No | Only valid if 'identifier' is provided. See 'identifier' for more information. Maximum length of 300 | | `author_username` | string | No | Disqus username for the new thread author instead of a user ID; requires moderator access. | | `validate_all_posts` | string | No | Provider parameter `validateAllPosts`; the official endpoint page does not further describe its accepted shape. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Topic **Slug:** `DISQUS_UPDATE_TOPIC` Update 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `can_trend` | string | No | Whether this topic can appear in the list of trending topics | | `topic_name` | string | Yes | Can be either the topic identifier or current display name | | `display_name` | string | No | 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update User Profile **Slug:** `DISQUS_UPDATE_USER_PROFILE` Updates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `url` | string | No | URL (defined by RFC 3986) Maximum length of 200 | | `name` | string | No | Minimum length of 2 Maximum length of 30 | | `about` | string | No | Provider parameter `about`; the official endpoint page does not further describe its accepted shape. | | `location` | string | No | Maximum length of 255 | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Validate Forum Settings **Slug:** `DISQUS_VALIDATE_FORUM_SETTINGS` Validate 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `forum` | string | Yes | Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. | | `ads_position_top_enabled` | string | No | adsPositionTopEnabled flag. Use 1 or 0; boolean true/false are sent as 1/0. Omit to leave unspecified. | | `ads_position_bottom_enabled` | string | No | adsPositionBottomEnabled flag. Use 1 or 0; boolean true/false are sent as 1/0. Omit to leave unspecified. | | `ads_position_inthread_enabled` | string | No | adsPositionInthreadEnabled flag. Use 1 or 0; boolean true/false are sent as 1/0. Omit to leave unspecified. | | `ads_position_recommendations_enabled` | string | No | adsPositionRecommendationsEnabled flag. Use 1 or 0; boolean true/false are sent as 1/0. Omit to leave unspecified. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Validate Organization Coupon **Slug:** `DISQUS_VALIDATE_ORGANIZATION_COUPON` Looks 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `coupon` | string | Yes | Looks up a coupon by its Stripe ID | | `organization` | string | Yes | Looks up an organization by ID You must be an admin on the selected organization. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Vote Post **Slug:** `DISQUS_VOTE_POST` Register a vote on a post. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `post` | string | Yes | Looks up a post by ID | | `vote` | string ("-1" | "0" | "1") | Yes | Choices: -1, 0, 1 | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Vote Thread **Slug:** `DISQUS_VOTE_THREAD` Register a vote on a thread. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `vote` | string ("-1" | "0" | "1") | Yes | Choices: -1, 0, 1 | | `forum` | string | No | Looks up a forum by ID (aka short name) | | `thread` | string | No | Thread ID to vote on. | | `thread_link` | string | No | Thread URL to vote on; requires forum. | | `thread_ident` | string | No | Thread identifier to vote on; requires forum. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Vote Thread Reaction **Slug:** `DISQUS_VOTE_THREAD_REACTION` Used to vote on a reaction. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `thread` | string | Yes | Looks up a thread by ID | | `reaction` | string | Yes | Looks up a reaction by ID | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not |