Skip to main content
Discourse
Discourse
67 actions · 1 auth method
Preview

Authentication

API Key

Generate an API key from your Discourse admin panel to authenticate requests. You will also need a username (typically s…Guides: Connector Profile, Link Account
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
Create a new reply in an existing topic, or create a new topic with an initial post.
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
Perform an action on a post such as liking, bookmarking, or flagging.
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).

Getting Started

1

Create or Select a Project

Set up a new project or select an existing one. See the Projects Guide.
2

Configure the Connector

Enable the connector and set up a connector profile in your project. See Managing Connectors.
https://stackone-logos.com/api/discourse/filled/png

Connector Profile

Discourse - API Key
3

Link an Account

Connect an account using StackOne Hub or Auth Link.
https://stackone-logos.com/api/discourse/filled/png

Link Account

Discourse - API Key
4

Use Actions

Invoke actions using one of the methods below: