Skip to main content
Discourse
67 actions · 50 events · 1 auth method

Getting Started

1

Create or Select a Project

Set up a new project or select an existing one. See Organizations & Projects.
2

Configure the Connector

Enable the connector and set up a Connector Profile in your project. See Setup Connector Profile.

Connector Profile · API Key

Generate an API key from your Discourse admin panel to authenticate requests. You will also need a username (typically s…
Optionally, configure receiving Events for Discourse into StackOne.

Webhooks setup

3

Link an Account

Link an account from the dashboard (or via StackOne Hub).See the guide for the authentication type chosen in the Connector Profile:

Link Account · API Key

4

Use Actions

Connect an AI platform to the linked account’s actions. See AI Platforms.Other ways to call actions are listed in Protocols & SDKs.

Actions

67 actions
Action
Description
List Badges
List all badges available in the Discourse instance (admin only).
Create Badge
Create a new custom badge (admin only).
Update Badge
Update the settings of an existing badge (admin only).
Delete Badge
Permanently delete a badge (admin only).
List User Badges
Get all badges earned by a specific user.
List Categories
List all topic categories in the Discourse instance.
Get Category
Retrieve a single category by its ID.
List Category Topics
Get all topics in a specific category.
Create Category
Create a new topic category (admin only).
Update Category
Update the settings or metadata of an existing category (admin only).
List Groups
List all groups in the Discourse instance.
Get Group
Retrieve details about a specific group by its name.
Get Group By ID
Retrieve details about a specific group by its numeric ID.
List Group Members
Get all members of a specific group.
Create Group
Create a new user group in Discourse (admin only).
Update Group
Update the settings or metadata of an existing group.
Add Group Members
Add one or more users to a group.
Remove Group Members
Remove one or more users from a group.
Delete Group
Permanently delete a group (admin only).
List Notifications
List notifications for the currently authenticated user.
Mark Notifications Read
Mark one or all notifications as read for the authenticated user.
List Latest Posts
Get the latest posts from across all topics in the forum.
Create Post
Reply to an existing topic (use create_topic to start a new topic).
Get Post
Retrieve a single post by its ID.
Update Post
Edit the Markdown content of an existing post.
Delete Post
Delete a post from a topic.
List Post Replies
Get all direct replies to a specific post.
Lock Post
Lock or unlock a post to prevent or allow editing.
Create Post Action
Like a post or flag it for moderator attention.
List Private Messages
Get private messages received by a specific user.
List Sent Private Messages
Get private messages sent by a specific user.
Create Private Message
Send a private message to one or more users or groups.
Search
Search for topics, posts, users, and categories across the Discourse forum.
Get Site Info
Retrieve full site configuration and metadata for the Discourse instance.
Get Site Basic Info
Retrieve basic public information about the Discourse instance.
Get About
Retrieve public site statistics and staff information.
List Tags
List all tags used in the Discourse forum.
Get Tag
Retrieve details and topics for a specific tag.
List Tag Groups
List all tag groups defined in the Discourse instance.
Get Tag Group
Retrieve a specific tag group by its ID.
Create Tag Group
Create a new tag group to organize related tags (admin only).
Update Tag Group
Update the name or tags of an existing tag group (admin only).
List Latest Topics
Get the latest topics from the Discourse forum, sorted by recent activity.
List Top Topics
Get the top-ranked topics filtered by time period from the Discourse forum.
Get Topic
Retrieve a single topic and its posts by topic ID.
Update Topic
Update the title, category, or tags of an existing topic.
Delete Topic
Delete a topic and all its posts (admin or moderator only).
Update Topic Status
Enable or disable a status flag on a topic (close, pin, archive, hide, etc.).
Create Topic Timer
Schedule an automatic action on a topic at a future date and time.
Get Topic Posts
Retrieve specific posts from a topic by their post IDs.
Create Topic
Create a new topic in the Discourse forum.
List Users
List all users in the Discourse instance (admin only).
List Users By Flag
List users filtered by account status flag (admin only).
Get User
Retrieve a user’s public profile by their username.
Get User By ID
Retrieve a user’s full details by their numeric ID (admin only).
Create User
Create a new user account in the Discourse instance.
Update User
Update a user’s profile information.
Activate User
Activate a pending user account (admin only).
Deactivate User
Deactivate a user account to prevent them from logging in (admin only).
Suspend User
Suspend a user account until a specified date (admin only).
Delete User
Permanently delete a user account (admin only).
List User Actions
Get a list of actions performed by a specific user.
Get User Emails
Retrieve the email addresses associated with a user account (admin only).
Log Out User
Force-log out a user’s current session (admin only).
Silence User
Silence a user to prevent them from posting without fully suspending their account (admin only).
Anonymize User
Permanently anonymize a user by replacing all identifying information with random values (admin only).
Get User By External ID
Retrieve a Discourse user by their external system ID (SSO/Discourse Connect lookup).

Events

|
50 events
Event
Description
Tags
Ping
Responds with 200 OK to Discourse ping deliveries and any request without an X-Discourse-Event header.
Health Checks
Topic Created
Fired when a topic is created in Discourse, including private message topics.
Topics
Topic Edited
Fired when a topic is edited or its status changes (closed, archived, visible, pinned, pinned globally, or auto-closed).
Topics
Topic Deleted
Fired when a topic is deleted in Discourse.
Topics
Topic Recovered
Fired when a deleted topic is recovered in Discourse.
Topics
Post Created
Fired when a post or reply is created in Discourse, including the first post of a new topic and private message posts.
Posts
Post Edited
Fired when a post is edited in Discourse.
Posts
Post Deleted
Fired when a post is deleted in Discourse.
Posts
Post Recovered
Fired when a deleted post is recovered in Discourse.
Posts
User Logged In
Fired when a user logs in to Discourse.
Users
User Logged Out
Fired when a user logs out of Discourse.
Users
User Confirmed Email
Fired when a user confirms their email address in Discourse.
Users
User Created
Fired when a user account is created in Discourse.
Users
User Approved
Fired when a staff member approves a pending user in Discourse.
Users
User Updated
Fired when a user profile is updated in Discourse.
Users
User Deleted
Fired when a user is deleted from Discourse.
Users
User Suspended
Fired when a user is suspended in Discourse.
Users
User Unsuspended
Fired when a user suspension is lifted in Discourse.
Users
User Anonymized
Fired when a user is anonymized in Discourse.
Users
Group Created
Fired when a group is created in Discourse.
Groups
Group Updated
Fired when a group is updated in Discourse.
Groups
Group Deleted
Fired when a group is deleted from Discourse.
Groups
Category Created
Fired when a category is created in Discourse.
Categories
Category Updated
Fired when a category is updated in Discourse.
Categories
Category Deleted
Fired when a category is deleted from Discourse.
Categories
Tag Created
Fired when a tag is created in Discourse.
Tags
Tag Updated
Fired when a tag is renamed or updated in Discourse.
Tags
Tag Deleted
Fired when a tag is deleted from Discourse.
Tags
Reviewable Created
Fired when an item enters the Discourse review queue, such as a flagged post, a queued post, or a user awaiting approval…
Review Queue
Reviewable Updated
Fired when a review queue item gets a new score or changes status (approved, rejected, ignored, or deleted).
Review Queue
Notification Created
Fired when Discourse creates a notification for any user on the forum.
Notifications
Solution Accepted
Fired when a post is marked as the accepted solution of a topic in Discourse.
Solutions
Solution Unaccepted
Fired when an accepted solution is removed from a topic in Discourse.
Solutions
Topic Assigned
Fired when a topic or post is assigned to a user or group in Discourse.
Assignments
Topic Unassigned
Fired when an assignment is removed from a topic or post in Discourse.
Assignments
User Badge Granted
Fired when a badge is granted to a user in Discourse.
Badges
User Badge Revoked
Fired when a badge is revoked from a user in Discourse.
Badges
User Added to Group
Fired when a user is added to a group in Discourse.
Groups
User Removed from Group
Fired when a user is removed from a group in Discourse.
Groups
Post Liked
Fired when a user likes a post in Discourse.
Posts
User Promoted
Fired when a user is promoted to a higher trust level in Discourse.
Users
Topic Upvoted
Fired when a user votes for a topic in Discourse.
Topic Voting
Topic Vote Removed
Fired when a user removes their vote from a topic in Discourse.
Topic Voting
Chat Message Created
Fired when a chat message is sent in a Discourse chat channel or direct message.
Chat
Chat Message Edited
Fired when a chat message is edited in Discourse.
Chat
Chat Message Deleted
Fired when a chat message is deleted in Discourse.
Chat
Chat Message Restored
Fired when a deleted chat message is restored in Discourse.
Chat
Calendar Event Created
Fired when a calendar event is created on a post in Discourse.
Calendar Events
Calendar Event Updated
Fired when a calendar event is updated in Discourse.
Calendar Events
Calendar Event Deleted
Fired when a calendar event is deleted in Discourse.
Calendar Events