Threads
Actions in the category "Threads".
Create thread
Creates a new thread in a text channel.
Required permissions: Create public threads.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Channel | Text channel | Yes | Channel to create the thread in. |
| Name | Text | Yes | Name of the thread. Length: 1 to 100 characters. |
| Auto-archive duration | Duration | Yes | When the thread auto-archives after inactivity. Allowed values: 3600000, 86400000, 259200000, 604800000. Default: 86400000. |
| Private thread | Yes/No | Yes | Make the thread private (invite only). Default: No. |
| Starter message | Message content | No | Send this message as the first message of the thread. |
Outputs
| Name | Type | Details |
|---|---|---|
| Thread | Thread | The newly created thread. |
Start thread from message
Creates a new thread that branches off an existing message.
Required permissions: Create public threads.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Source Message | Message | Yes | The message the thread will be attached to. |
| Thread Name | Text | Yes | Name of the new thread (1-100 characters). Length: 1 to 100 characters. |
| Auto-archive Duration | Whole number | No | Minutes of inactivity after which the thread auto-archives. Allowed values: 60, 1440, 4320, 10080. Default: 1440. |
| Slowmode | Whole number | No | Per-user message cooldown in seconds (0-21600). Value: 0 to 21600. |
| Audit Log Reason | Text | No | Optional reason recorded in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Thread | Thread | The newly created thread. |
Create public thread
Creates a new public thread inside a text channel without anchoring it to a message.
Required permissions: Create public threads.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Parent Channel | Text channel | Yes | The text channel that will host the thread. |
| Thread Name | Text | Yes | Name of the new thread (1-100 characters). Length: 1 to 100 characters. |
| Auto-archive Duration | Whole number | No | Minutes of inactivity after which the thread auto-archives. Allowed values: 60, 1440, 4320, 10080. Default: 1440. |
| Slowmode | Whole number | No | Per-user message cooldown in seconds (0-21600). Value: 0 to 21600. |
| Audit Log Reason | Text | No | Optional reason recorded in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Thread | Thread | The newly created public thread. |
Create private thread
Creates a new private thread inside a text channel.
Required permissions: Create private threads.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Parent Channel | Text channel | Yes | The text channel that will host the thread. |
| Thread Name | Text | Yes | Name of the new thread (1-100 characters). Length: 1 to 100 characters. |
| Auto-archive Duration | Whole number | No | Minutes of inactivity after which the thread auto-archives. Allowed values: 60, 1440, 4320, 10080. Default: 1440. |
| Invitable | Yes/No | No | Whether non-moderators may invite others to the thread. Default: Yes. |
| Slowmode | Whole number | No | Per-user message cooldown in seconds (0-21600). Value: 0 to 21600. |
| Audit Log Reason | Text | No | Optional reason recorded in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Thread | Thread | The newly created private thread. |
Create forum post
Creates a new post (thread) inside a forum or media channel with a starter message.
Required permissions: Send messages, Create public threads.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Forum Channel | Forum channel | Yes | The forum or media channel that will host the post. |
| Post Title | Text | Yes | Title of the forum post (1-100 characters). Length: 1 to 100 characters. |
| Applied Tags | List of Forum tag | No | Forum tags to apply to the post (max 5). Maximum items: 5. |
| Starter Message | Message content | Yes | Content for the post's first message. |
| Auto-archive Duration | Whole number | No | Minutes of inactivity after which the post auto-archives. Allowed values: 60, 1440, 4320, 10080. Default: 1440. |
| Slowmode | Whole number | No | Per-user message cooldown in seconds (0-21600). Value: 0 to 21600. |
| Audit Log Reason | Text | No | Optional reason recorded in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Forum Post | Thread | The newly created forum post thread. |
| Starter Message | Message | The first message of the forum post. |
Archive thread
Archives a thread, hiding it from the active threads list.
Required permissions: Manage threads.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Thread | Thread | Yes | The thread to archive. |
| Audit Log Reason | Text | No | Optional reason recorded in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Thread | Thread | The archived thread. |
Unarchive thread
Reopens a previously archived thread so it appears in the active list again.
Required permissions: Manage threads.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Thread | Thread | Yes | The archived thread to reopen. |
| Audit Log Reason | Text | No | Optional reason recorded in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Thread | Thread | The reopened thread. |
Lock thread
Locks a thread so only moderators can send messages or unarchive it.
Required permissions: Manage threads.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Thread | Thread | Yes | The thread to lock. |
| Audit Log Reason | Text | No | Optional reason recorded in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Thread | Thread | The locked thread. |
Unlock thread
Removes the lock from a thread so members can send messages again.
Required permissions: Manage threads.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Thread | Thread | Yes | The thread to unlock. |
| Audit Log Reason | Text | No | Optional reason recorded in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Thread | Thread | The unlocked thread. |
Update thread name
Renames a thread.
Required permissions: Manage threads.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Thread | Thread | Yes | The thread to rename. |
| New Name | Text | Yes | New thread name (1-100 characters). Length: 1 to 100 characters. |
| Audit Log Reason | Text | No | Optional reason recorded in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Thread | Thread | The renamed thread. |
Update thread auto-archive duration
Changes how long a thread can stay inactive before auto-archiving.
Required permissions: Manage threads.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Thread | Thread | Yes | The thread to update. |
| Auto-archive Duration | Whole number | Yes | Minutes of inactivity before auto-archive (60, 1440, 4320, 10080). Allowed values: 60, 1440, 4320, 10080. |
| Audit Log Reason | Text | No | Optional reason recorded in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Thread | Thread | The updated thread. |
Update thread slowmode
Sets a thread's per-user message cooldown.
Required permissions: Manage threads.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Thread | Thread | Yes | The thread to update. |
| Slowmode | Whole number | Yes | Per-user message cooldown in seconds (0-21600). Value: 0 to 21600. |
| Audit Log Reason | Text | No | Optional reason recorded in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Thread | Thread | The updated thread. |
Update forum post tags
Replaces the applied tags on a forum or media channel post.
Required permissions: Manage threads.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Forum Post | Thread | Yes | The forum post to update. |
| Applied Tags | List of Forum tag | Yes | New set of tags to apply (max 5). Maximum items: 5. |
| Audit Log Reason | Text | No | Optional reason recorded in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Forum Post | Thread | The updated forum post. |
Update private thread invitable
Toggles whether non-moderators can invite others to a private thread.
Required permissions: Manage threads.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Thread | Thread | Yes | The private thread to update. |
| Invitable | Yes/No | Yes | If true, non-moderators may invite others. |
| Audit Log Reason | Text | No | Optional reason recorded in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Thread | Thread | The updated private thread. |
Update thread flags
Sets the raw thread flags bitfield on a thread (advanced).
Required permissions: Manage threads.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Thread | Thread | Yes | The thread to update. |
| Flags | Whole number | Yes | Bitfield of thread flags. Minimum: 0. |
| Audit Log Reason | Text | No | Optional reason recorded in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Thread | Thread | The updated thread. |
Delete thread
Permanently deletes a thread and all of its messages.
Required permissions: Manage threads.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Thread | Thread | Yes | The thread to delete. |
| Audit Log Reason | Text | No | Optional reason recorded in the audit log. Maximum length: 512 characters. |
Add member to thread
Adds a user to a thread so they receive its messages.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Thread | Thread | Yes | The thread to add the user to. |
| User | User | Yes | The user to add. |
Remove member from thread
Removes a user from a thread.
Required permissions: Manage threads.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Thread | Thread | Yes | The thread to remove the user from. |
| User | User | Yes | The user to remove. |
Join thread
Has the bot join a thread.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Thread | Thread | Yes | The thread the bot should join. |
Leave thread
Has the bot leave a thread.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Thread | Thread | Yes | The thread the bot should leave. |
Fetch thread members
Returns every member currently part of a thread.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Thread | Thread | Yes | The thread whose members should be fetched. |
Outputs
| Name | Type | Details |
|---|---|---|
| Members | List of Server member | Members of the thread. |
Fetch active threads
Returns every active (non-archived) thread the bot can see in a server.
Outputs
| Name | Type | Details |
|---|---|---|
| Threads | List of Thread | Active threads in the server. |
Pin forum post
Pins a thread inside a forum or media channel so it appears at the top of the post list.
Required permissions: Manage threads.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Forum Post | Thread | Yes | The forum post to pin. |
| Audit Log Reason | Text | No | Optional reason recorded in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Forum Post | Thread | The pinned forum post. |
Unpin forum post
Unpins a previously pinned thread inside a forum or media channel.
Required permissions: Manage threads.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Forum Post | Thread | Yes | The forum post to unpin. |
| Audit Log Reason | Text | No | Optional reason recorded in the audit log. Maximum length: 512 characters. |
Outputs
| Name | Type | Details |
|---|---|---|
| Forum Post | Thread | The unpinned forum post. |
Build forum tag
Build a forum tag value to be applied to a forum or media channel.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Name | Text | Yes | Tag display name. Maximum length: 20 characters. |
| Emoji | Text | No | Optional emoji shown alongside the tag. |
| Moderated | Yes/No | Yes | If true, only members with the Manage Threads permission may apply this tag. Default: No. |
Outputs
| Name | Type | Details |
|---|---|---|
| Tag | Forum tag | The constructed forum tag. |
Add forum tag
Appends a forum tag to a tag list and returns the updated list (max 20 tags). Use the result in a forum/media channel's available tags, or a forum post's applied tags.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Tags | List of Forum tag | No | The tag list to extend (leave empty to start a new list). Maximum items: 20. |
| Tag | Forum tag | Yes | The forum tag to append (from Create forum tag). |
Outputs
| Name | Type | Details |
|---|---|---|
| Tags | List of Forum tag | The updated tag list. |
Fetch thread by ID
Fetches a thread by its Discord ID. Returns an empty value if not found or if the channel is not a thread.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Thread ID | Discord ID | Yes | Discord ID of the thread. |
Outputs
| Name | Type | Details |
|---|---|---|
| Thread | Thread | The fetched thread, or empty. May be empty. |
Fetch archived threads
Returns archived threads in the current server, either public or private.
Inputs
| Name | Type | Required | Details |
|---|---|---|---|
| Privacy | Thread privacy | Yes | Fetch public or private archived threads. Default: Public. |
| Limit | Whole number | No | Maximum number of threads to return (1-100). Value: 1 to 100. Default: 50. |
Outputs
| Name | Type | Details |
|---|---|---|
| Threads | List of Thread | The archived threads. |