chore(release): 0.37.12 🎉 (#598)

Build ran for f62f2506b0

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

CHANGELOG.md

@@ -1,3 +1,12 @@
+## [0.37.12](https://github.com/discordjs/discord-api-types/compare/0.37.11...0.37.12) (2022-10-06)
+
+## [0.37.11](https://github.com/discordjs/discord-api-types/compare/0.37.10...0.37.11) (2022-09-26)
+
+### Features
+
+- **APIGuildForumChannel:** add `default_sort_order` ([#589](https://github.com/discordjs/discord-api-types/issues/589)) ([143b003](https://github.com/discordjs/discord-api-types/commit/143b003fbe5a86eda225e9da1d0914d6e48cddfd))
+- **APIGuildForumChannel:** update and add missing features ([#575](https://github.com/discordjs/discord-api-types/issues/575)) ([0f118d3](https://github.com/discordjs/discord-api-types/commit/0f118d382f94151b1c9be42620520c91b20a05f6))
+
 ## [0.37.10](https://github.com/discordjs/discord-api-types/compare/0.37.9...0.37.10) (2022-09-15)
 
 ### Features

deno/CHANGELOG.md

@@ -1,3 +1,12 @@
+## [0.37.12](https://github.com/discordjs/discord-api-types/compare/0.37.11...0.37.12) (2022-10-06)
+
+## [0.37.11](https://github.com/discordjs/discord-api-types/compare/0.37.10...0.37.11) (2022-09-26)
+
+### Features
+
+- **APIGuildForumChannel:** add `default_sort_order` ([#589](https://github.com/discordjs/discord-api-types/issues/589)) ([143b003](https://github.com/discordjs/discord-api-types/commit/143b003fbe5a86eda225e9da1d0914d6e48cddfd))
+- **APIGuildForumChannel:** update and add missing features ([#575](https://github.com/discordjs/discord-api-types/issues/575)) ([0f118d3](https://github.com/discordjs/discord-api-types/commit/0f118d382f94151b1c9be42620520c91b20a05f6))
+
 ## [0.37.10](https://github.com/discordjs/discord-api-types/compare/0.37.9...0.37.10) (2022-09-15)
 
 ### Features

deno/globals.ts

@@ -51,7 +51,7 @@ export const FormattingPatterns = {
 	 * The `fullName` (possibly including `name`, `subcommandOrGroup` and `subcommand`) and `id` group properties are present on the `exec` result of this expression
 	 */
 	SlashCommand:
-		/<\/(?<fullName>(?<name>[\w-]{1,32})(?: (?<subcommandOrGroup>[\w-]{1,32}))?(?: (?<subcommand>[\w-]{1,32}))?):(?<id>\d{17,20})>/,
+		/<\/(?<fullName>(?<name>[-_\p{Letter}\p{Number}\p{sc=Deva}\p{sc=Thai}]{1,32})(?: (?<subcommandOrGroup>[-_\p{Letter}\p{Number}\p{sc=Deva}\p{sc=Thai}]{1,32}))?(?: (?<subcommand>[-_\p{Letter}\p{Number}\p{sc=Deva}\p{sc=Thai}]{1,32}))?):(?<id>\d{17,20})>/u,
 	/**
 	 * Regular expression for matching a custom emoji, either static or animated
 	 *

deno/payloads/v10/channel.ts

@@ -108,7 +108,7 @@ export interface APIGuildTextChannel<T extends GuildTextChannelType>
 	 */
 	default_auto_archive_duration?: ThreadAutoArchiveDuration;
 	/**
-	 * The channel topic (0-1024 characters)
+	 * The channel topic (0-4096 characters for forum channels, 0-1024 characters for all others)
 	 */
 	topic?: string | null;
 	/**
@@ -230,9 +230,85 @@ export interface APIThreadChannel
 	 * Similar to `message_count` on message creation, but won't decrement when a message is deleted
 	 */
 	total_message_sent?: number;
+	/**
+	 * The IDs of the set of tags that have been applied to a thread in a forum channel
+	 */
+	applied_tags: Snowflake[];
 }
 
-export type APIGuildForumChannel = APIGuildTextChannel<ChannelType.GuildForum>;
+/**
+ * https://discord.com/developers/docs/resources/channel#forum-tag-object-forum-tag-structure
+ */
+export interface APIGuildForumTag {
+	/**
+	 * The id of the tag
+	 */
+	id: Snowflake;
+	/**
+	 * The name of the tag (0-20 characters)
+	 */
+	name: string;
+	/**
+	 * Whether this tag can only be added to or removed from threads by a member with the `MANAGE_THREADS` permission
+	 */
+	moderated: boolean;
+	/**
+	 * The id of a guild's custom emoji
+	 */
+	emoji_id: Snowflake | null;
+	/**
+	 * The unicode character of the emoji
+	 */
+	emoji_name: string | null;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/channel#default-reaction-object-default-reaction-structure
+ */
+export interface APIGuildForumDefaultReactionEmoji {
+	/**
+	 * The id of a guild's custom emoji
+	 */
+	emoji_id: Snowflake | null;
+	/**
+	 * The unicode character of the emoji
+	 */
+	emoji_name: string | null;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/channel/#channel-object-sort-order-types
+ */
+export enum SortOrderType {
+	/**
+	 * Sort forum posts by activity
+	 */
+	LatestActivity,
+	/**
+	 * Sort forum posts by creation time (from most recent to oldest)
+	 */
+	CreationDate,
+}
+
+export interface APIGuildForumChannel extends APIGuildTextChannel<ChannelType.GuildForum> {
+	/**
+	 * The set of tags that can be used in a forum channel
+	 */
+	available_tags: APIGuildForumTag[];
+	/**
+	 * The initial `rate_limit_per_user` to set on newly created threads in a channel.
+	 * This field is copied to the thread at creation time and does not live update
+	 */
+	default_thread_rate_limit_per_user?: number;
+	/**
+	 * The emoji to show in the add reaction button on a thread in a forum channel
+	 */
+	default_reaction_emoji: APIGuildForumDefaultReactionEmoji | null;
+	/**
+	 * The default sort order type used to order posts in forum channels
+	 */
+	default_sort_order: SortOrderType | null;
+}
 
 /**
  * https://discord.com/developers/docs/resources/channel#channel-object-channel-structure
@@ -1429,7 +1505,15 @@ export interface APITextInputComponent extends APIBaseComponent<ComponentType.Te
  * https://discord.com/developers/docs/resources/channel#channel-object-channel-flags
  */
 export enum ChannelFlags {
+	/**
+	 * This thread is pinned to the top of its parent forum channel
+	 */
 	Pinned = 1 << 1,
+	/**
+	 * Whether a tag is required to be specified when creating a thread in a forum channel.
+	 * Tags are specified in the `applied_tags` field
+	 */
+	RequireTag = 1 << 4,
 }
 
 /**

deno/payloads/v9/channel.ts

@@ -230,9 +230,85 @@ export interface APIThreadChannel
 	 * Similar to `message_count` on message creation, but won't decrement when a message is deleted
 	 */
 	total_message_sent?: number;
+	/**
+	 * The IDs of the set of tags that have been applied to a thread in a forum channel
+	 */
+	applied_tags: Snowflake[];
 }
 
-export type APIGuildForumChannel = APIGuildTextChannel<ChannelType.GuildForum>;
+/**
+ * https://discord.com/developers/docs/resources/channel#forum-tag-object-forum-tag-structure
+ */
+export interface APIGuildForumTag {
+	/**
+	 * The id of the tag
+	 */
+	id: Snowflake;
+	/**
+	 * The name of the tag (0-20 characters)
+	 */
+	name: string;
+	/**
+	 * Whether this tag can only be added to or removed from threads by a member with the `MANAGE_THREADS` permission
+	 */
+	moderated: boolean;
+	/**
+	 * The id of a guild's custom emoji
+	 */
+	emoji_id: Snowflake | null;
+	/**
+	 * The unicode character of the emoji
+	 */
+	emoji_name: string | null;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/channel#default-reaction-object-default-reaction-structure
+ */
+export interface APIGuildForumDefaultReactionEmoji {
+	/**
+	 * The id of a guild's custom emoji
+	 */
+	emoji_id: Snowflake | null;
+	/**
+	 * The unicode character of the emoji
+	 */
+	emoji_name: string | null;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/channel/#channel-object-sort-order-types
+ */
+export enum SortOrderType {
+	/**
+	 * Sort forum posts by activity
+	 */
+	LatestActivity,
+	/**
+	 * Sort forum posts by creation time (from most recent to oldest)
+	 */
+	CreationDate,
+}
+
+export interface APIGuildForumChannel extends APIGuildTextChannel<ChannelType.GuildForum> {
+	/**
+	 * The set of tags that can be used in a forum channel
+	 */
+	available_tags: APIGuildForumTag[];
+	/**
+	 * The initial `rate_limit_per_user` to set on newly created threads in a channel.
+	 * This field is copied to the thread at creation time and does not live update
+	 */
+	default_thread_rate_limit_per_user?: number;
+	/**
+	 * The emoji to show in the add reaction button on a thread in a forum channel
+	 */
+	default_reaction_emoji: APIGuildForumDefaultReactionEmoji | null;
+	/**
+	 * The default sort order type used to order posts in forum channels
+	 */
+	default_sort_order: SortOrderType | null;
+}
 
 /**
  * https://discord.com/developers/docs/resources/channel#channel-object-channel-structure
@@ -1428,7 +1504,15 @@ export interface APITextInputComponent extends APIBaseComponent<ComponentType.Te
  * https://discord.com/developers/docs/resources/channel#channel-object-channel-flags
  */
 export enum ChannelFlags {
+	/**
+	 * This thread is pinned to the top of its parent forum channel
+	 */
 	Pinned = 1 << 1,
+	/**
+	 * Whether a tag is required to be specified when creating a thread in a forum channel.
+	 * Tags are specified in the `applied_tags` field
+	 */
+	RequireTag = 1 << 4,
 }
 
 /**

deno/rest/common.ts

@@ -137,9 +137,14 @@ export enum RESTJSONErrorCodes {
 
 	ApplicationInteractionFailedToSend = 40043,
 
+	CannotSendAMessageInAForumChannel = 40058,
+
 	InteractionHasAlreadyBeenAcknowledged = 40060,
 	TagNamesMustBeUnique,
 
+	ThereAreNoTagsAvailableThatCanBeSetByNonModerators = 40066,
+	TagRequiredToCreateAForumPostInThisChannel,
+
 	MissingAccess = 50001,
 	InvalidAccountType,
 	CannotExecuteActionOnDMChannel,
@@ -246,7 +251,10 @@ export enum RESTJSONErrorCodes {
 	MessageWasBlockedByAutomaticModeration = 200000,
 	TitleWasBlockedByAutomaticModeration,
 
-	WebhooksCanOnlyCreateThreadsInForumChannels = 220003,
+	WebhooksPostedToForumChannelsMustHaveAThreadNameOrThreadId = 220001,
+	WebhooksPostedToForumChannelsCannotHaveBothAThreadNameAndThreadId,
+	WebhooksCanOnlyCreateThreadsInForumChannels,
+	WebhookServicesCannotBeUsedInForumChannels,
 
 	MessageBlockedByHarmfulLinksFilter = 240000,
 }

deno/rest/v10/channel.ts

@@ -19,6 +19,9 @@ import type {
 	OverwriteType,
 	ThreadAutoArchiveDuration,
 	VideoQualityMode,
+	APIGuildForumTag,
+	APIGuildForumDefaultReactionEmoji,
+	SortOrderType,
 } from '../../payloads/v10/mod.ts';
 import type { AddUndefinedToPossiblyUndefinedPropertiesOfInterface, StrictPartial } from '../../utils/internals.ts';
 
@@ -56,15 +59,15 @@ export type RESTPatchAPIChannelJSONBody = AddUndefinedToPossiblyUndefinedPropert
 	 */
 	position?: number | null;
 	/**
-	 * 0-1024 character channel topic
+	 * 0-1024 character channel topic (0-4096 characters for forum channels)
 	 *
-	 * Channel types: text, news
+	 * Channel types: text, news, forum
 	 */
 	topic?: string | null;
 	/**
 	 * Whether the channel is nsfw
 	 *
-	 * Channel types: text, voice, news
+	 * Channel types: text, voice, news, forum
 	 */
 	nsfw?: boolean | null;
 	/**
@@ -72,7 +75,7 @@ export type RESTPatchAPIChannelJSONBody = AddUndefinedToPossiblyUndefinedPropert
 	 * bots, as well as users with the permission `MANAGE_MESSAGES` or `MANAGE_CHANNELS`,
 	 * are unaffected
 	 *
-	 * Channel types: text, newsThread, publicThread, privateThread
+	 * Channel types: text, newsThread, publicThread, privateThread, forum
 	 */
 	rate_limit_per_user?: number | null;
 	/**
@@ -141,6 +144,31 @@ export type RESTPatchAPIChannelJSONBody = AddUndefinedToPossiblyUndefinedPropert
 	 * Channel types: privateThread
 	 */
 	invitable?: boolean;
+	/**
+	 * The set of tags that can be used in a forum channel
+	 *
+	 * Channel types: forum
+	 */
+	available_tags?: APIGuildForumTag[];
+	/**
+	 * The emoji to show in the add reaction button on a thread in a forum channel
+	 *
+	 * Channel types: forum
+	 */
+	default_reaction_emoji?: APIGuildForumDefaultReactionEmoji;
+	/**
+	 * The initial `rate_limit_per_user` to set on newly created threads in a channel.
+	 * This field is copied to the thread at creation time and does not live update
+	 *
+	 * Channel types: text, forum
+	 */
+	default_thread_rate_limit_per_user?: number | null;
+	/**
+	 * The default sort order type used to order posts in forum channels
+	 *
+	 * Channel types: forum
+	 */
+	default_sort_order?: SortOrderType | null;
 }>;
 
 /**
@@ -589,6 +617,10 @@ export type RESTPostAPIGuildForumThreadsJSONBody = RESTPostAPIChannelMessagesThr
 	 * First message in the forum thread
 	 */
 	message: RESTPostAPIChannelMessageJSONBody;
+	/**
+	 * The IDs of the set of tags that have been applied to a thread in a forum channel
+	 */
+	applied_tags?: Snowflake[];
 };
 
 /**

deno/rest/v10/guild.ts

@@ -53,6 +53,9 @@ export type APIGuildCreatePartialChannel = StrictPartial<
 		| 'rtc_region'
 		| 'video_quality_mode'
 		| 'flags'
+		| 'default_reaction_emoji'
+		| 'available_tags'
+		| 'default_sort_order'
 	>
 > &
 	AddUndefinedToPossiblyUndefinedPropertiesOfInterface<{

deno/rest/v9/channel.ts

@@ -19,6 +19,9 @@ import type {
 	OverwriteType,
 	ThreadAutoArchiveDuration,
 	VideoQualityMode,
+	APIGuildForumTag,
+	APIGuildForumDefaultReactionEmoji,
+	SortOrderType,
 } from '../../payloads/v9/mod.ts';
 import type { AddUndefinedToPossiblyUndefinedPropertiesOfInterface, StrictPartial } from '../../utils/internals.ts';
 
@@ -56,15 +59,15 @@ export type RESTPatchAPIChannelJSONBody = AddUndefinedToPossiblyUndefinedPropert
 	 */
 	position?: number | null;
 	/**
-	 * 0-1024 character channel topic
+	 * 0-1024 character channel topic (0-4096 characters for forum channels)
 	 *
-	 * Channel types: text, news
+	 * Channel types: text, news, forum
 	 */
 	topic?: string | null;
 	/**
 	 * Whether the channel is nsfw
 	 *
-	 * Channel types: text, voice, news
+	 * Channel types: text, voice, news, forum
 	 */
 	nsfw?: boolean | null;
 	/**
@@ -72,7 +75,7 @@ export type RESTPatchAPIChannelJSONBody = AddUndefinedToPossiblyUndefinedPropert
 	 * bots, as well as users with the permission `MANAGE_MESSAGES` or `MANAGE_CHANNELS`,
 	 * are unaffected
 	 *
-	 * Channel types: text, newsThread, publicThread, privateThread
+	 * Channel types: text, newsThread, publicThread, privateThread, forum
 	 */
 	rate_limit_per_user?: number | null;
 	/**
@@ -141,6 +144,31 @@ export type RESTPatchAPIChannelJSONBody = AddUndefinedToPossiblyUndefinedPropert
 	 * Channel types: privateThread
 	 */
 	invitable?: boolean;
+	/**
+	 * The set of tags that can be used in a forum channel
+	 *
+	 * Channel types: forum
+	 */
+	available_tags?: APIGuildForumTag[];
+	/**
+	 * The emoji to show in the add reaction button on a thread in a forum channel
+	 *
+	 * Channel types: forum
+	 */
+	default_reaction_emoji?: APIGuildForumDefaultReactionEmoji;
+	/**
+	 * The initial `rate_limit_per_user` to set on newly created threads in a channel.
+	 * This field is copied to the thread at creation time and does not live update
+	 *
+	 * Channel types: text, forum
+	 */
+	default_thread_rate_limit_per_user?: number | null;
+	/**
+	 * The default sort order type used to order posts in forum channels
+	 *
+	 * Channel types: forum
+	 */
+	default_sort_order?: SortOrderType | null;
 }>;
 
 /**
@@ -603,6 +631,10 @@ export type RESTPostAPIGuildForumThreadsJSONBody = RESTPostAPIChannelMessagesThr
 	 * First message in the forum thread
 	 */
 	message: RESTPostAPIChannelMessageJSONBody;
+	/**
+	 * The IDs of the set of tags that have been applied to a thread in a forum channel
+	 */
+	applied_tags?: Snowflake[];
 };
 
 /**

deno/rest/v9/guild.ts

@@ -53,6 +53,9 @@ export type APIGuildCreatePartialChannel = StrictPartial<
 		| 'rtc_region'
 		| 'video_quality_mode'
 		| 'flags'
+		| 'default_reaction_emoji'
+		| 'available_tags'
+		| 'default_sort_order'
 	>
 > &
 	AddUndefinedToPossiblyUndefinedPropertiesOfInterface<{

globals.ts

@@ -51,7 +51,7 @@ export const FormattingPatterns = {
 	 * The `fullName` (possibly including `name`, `subcommandOrGroup` and `subcommand`) and `id` group properties are present on the `exec` result of this expression
 	 */
 	SlashCommand:
-		/<\/(?<fullName>(?<name>[\w-]{1,32})(?: (?<subcommandOrGroup>[\w-]{1,32}))?(?: (?<subcommand>[\w-]{1,32}))?):(?<id>\d{17,20})>/,
+		/<\/(?<fullName>(?<name>[-_\p{Letter}\p{Number}\p{sc=Deva}\p{sc=Thai}]{1,32})(?: (?<subcommandOrGroup>[-_\p{Letter}\p{Number}\p{sc=Deva}\p{sc=Thai}]{1,32}))?(?: (?<subcommand>[-_\p{Letter}\p{Number}\p{sc=Deva}\p{sc=Thai}]{1,32}))?):(?<id>\d{17,20})>/u,
 	/**
 	 * Regular expression for matching a custom emoji, either static or animated
 	 *

package-lock.json

@@ -1,12 +1,12 @@
 {
 	"name": "discord-api-types",
-	"version": "0.37.10",
+	"version": "0.37.12",
 	"lockfileVersion": 2,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "discord-api-types",
-			"version": "0.37.10",
+			"version": "0.37.12",
 			"license": "MIT",
 			"devDependencies": {
 				"@babel/runtime-corejs3": "^7.18.0",

package.json

@@ -1,6 +1,6 @@
 {
 	"name": "discord-api-types",
-	"version": "0.37.10",
+	"version": "0.37.12",
 	"description": "Discord API typings that are kept up to date for use in bot library creation.",
 	"homepage": "https://discord-api-types.dev",
 	"exports": {

payloads/v10/channel.ts

@@ -108,7 +108,7 @@ export interface APIGuildTextChannel<T extends GuildTextChannelType>
 	 */
 	default_auto_archive_duration?: ThreadAutoArchiveDuration;
 	/**
-	 * The channel topic (0-1024 characters)
+	 * The channel topic (0-4096 characters for forum channels, 0-1024 characters for all others)
 	 */
 	topic?: string | null;
 	/**
@@ -230,9 +230,85 @@ export interface APIThreadChannel
 	 * Similar to `message_count` on message creation, but won't decrement when a message is deleted
 	 */
 	total_message_sent?: number;
+	/**
+	 * The IDs of the set of tags that have been applied to a thread in a forum channel
+	 */
+	applied_tags: Snowflake[];
 }
 
-export type APIGuildForumChannel = APIGuildTextChannel<ChannelType.GuildForum>;
+/**
+ * https://discord.com/developers/docs/resources/channel#forum-tag-object-forum-tag-structure
+ */
+export interface APIGuildForumTag {
+	/**
+	 * The id of the tag
+	 */
+	id: Snowflake;
+	/**
+	 * The name of the tag (0-20 characters)
+	 */
+	name: string;
+	/**
+	 * Whether this tag can only be added to or removed from threads by a member with the `MANAGE_THREADS` permission
+	 */
+	moderated: boolean;
+	/**
+	 * The id of a guild's custom emoji
+	 */
+	emoji_id: Snowflake | null;
+	/**
+	 * The unicode character of the emoji
+	 */
+	emoji_name: string | null;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/channel#default-reaction-object-default-reaction-structure
+ */
+export interface APIGuildForumDefaultReactionEmoji {
+	/**
+	 * The id of a guild's custom emoji
+	 */
+	emoji_id: Snowflake | null;
+	/**
+	 * The unicode character of the emoji
+	 */
+	emoji_name: string | null;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/channel/#channel-object-sort-order-types
+ */
+export enum SortOrderType {
+	/**
+	 * Sort forum posts by activity
+	 */
+	LatestActivity,
+	/**
+	 * Sort forum posts by creation time (from most recent to oldest)
+	 */
+	CreationDate,
+}
+
+export interface APIGuildForumChannel extends APIGuildTextChannel<ChannelType.GuildForum> {
+	/**
+	 * The set of tags that can be used in a forum channel
+	 */
+	available_tags: APIGuildForumTag[];
+	/**
+	 * The initial `rate_limit_per_user` to set on newly created threads in a channel.
+	 * This field is copied to the thread at creation time and does not live update
+	 */
+	default_thread_rate_limit_per_user?: number;
+	/**
+	 * The emoji to show in the add reaction button on a thread in a forum channel
+	 */
+	default_reaction_emoji: APIGuildForumDefaultReactionEmoji | null;
+	/**
+	 * The default sort order type used to order posts in forum channels
+	 */
+	default_sort_order: SortOrderType | null;
+}
 
 /**
  * https://discord.com/developers/docs/resources/channel#channel-object-channel-structure
@@ -1429,7 +1505,15 @@ export interface APITextInputComponent extends APIBaseComponent<ComponentType.Te
  * https://discord.com/developers/docs/resources/channel#channel-object-channel-flags
  */
 export enum ChannelFlags {
+	/**
+	 * This thread is pinned to the top of its parent forum channel
+	 */
 	Pinned = 1 << 1,
+	/**
+	 * Whether a tag is required to be specified when creating a thread in a forum channel.
+	 * Tags are specified in the `applied_tags` field
+	 */
+	RequireTag = 1 << 4,
 }
 
 /**

payloads/v9/channel.ts

@@ -230,9 +230,85 @@ export interface APIThreadChannel
 	 * Similar to `message_count` on message creation, but won't decrement when a message is deleted
 	 */
 	total_message_sent?: number;
+	/**
+	 * The IDs of the set of tags that have been applied to a thread in a forum channel
+	 */
+	applied_tags: Snowflake[];
 }
 
-export type APIGuildForumChannel = APIGuildTextChannel<ChannelType.GuildForum>;
+/**
+ * https://discord.com/developers/docs/resources/channel#forum-tag-object-forum-tag-structure
+ */
+export interface APIGuildForumTag {
+	/**
+	 * The id of the tag
+	 */
+	id: Snowflake;
+	/**
+	 * The name of the tag (0-20 characters)
+	 */
+	name: string;
+	/**
+	 * Whether this tag can only be added to or removed from threads by a member with the `MANAGE_THREADS` permission
+	 */
+	moderated: boolean;
+	/**
+	 * The id of a guild's custom emoji
+	 */
+	emoji_id: Snowflake | null;
+	/**
+	 * The unicode character of the emoji
+	 */
+	emoji_name: string | null;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/channel#default-reaction-object-default-reaction-structure
+ */
+export interface APIGuildForumDefaultReactionEmoji {
+	/**
+	 * The id of a guild's custom emoji
+	 */
+	emoji_id: Snowflake | null;
+	/**
+	 * The unicode character of the emoji
+	 */
+	emoji_name: string | null;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/channel/#channel-object-sort-order-types
+ */
+export enum SortOrderType {
+	/**
+	 * Sort forum posts by activity
+	 */
+	LatestActivity,
+	/**
+	 * Sort forum posts by creation time (from most recent to oldest)
+	 */
+	CreationDate,
+}
+
+export interface APIGuildForumChannel extends APIGuildTextChannel<ChannelType.GuildForum> {
+	/**
+	 * The set of tags that can be used in a forum channel
+	 */
+	available_tags: APIGuildForumTag[];
+	/**
+	 * The initial `rate_limit_per_user` to set on newly created threads in a channel.
+	 * This field is copied to the thread at creation time and does not live update
+	 */
+	default_thread_rate_limit_per_user?: number;
+	/**
+	 * The emoji to show in the add reaction button on a thread in a forum channel
+	 */
+	default_reaction_emoji: APIGuildForumDefaultReactionEmoji | null;
+	/**
+	 * The default sort order type used to order posts in forum channels
+	 */
+	default_sort_order: SortOrderType | null;
+}
 
 /**
  * https://discord.com/developers/docs/resources/channel#channel-object-channel-structure
@@ -1428,7 +1504,15 @@ export interface APITextInputComponent extends APIBaseComponent<ComponentType.Te
  * https://discord.com/developers/docs/resources/channel#channel-object-channel-flags
  */
 export enum ChannelFlags {
+	/**
+	 * This thread is pinned to the top of its parent forum channel
+	 */
 	Pinned = 1 << 1,
+	/**
+	 * Whether a tag is required to be specified when creating a thread in a forum channel.
+	 * Tags are specified in the `applied_tags` field
+	 */
+	RequireTag = 1 << 4,
 }
 
 /**

rest/common.ts

@@ -137,9 +137,14 @@ export enum RESTJSONErrorCodes {
 
 	ApplicationInteractionFailedToSend = 40043,
 
+	CannotSendAMessageInAForumChannel = 40058,
+
 	InteractionHasAlreadyBeenAcknowledged = 40060,
 	TagNamesMustBeUnique,
 
+	ThereAreNoTagsAvailableThatCanBeSetByNonModerators = 40066,
+	TagRequiredToCreateAForumPostInThisChannel,
+
 	MissingAccess = 50001,
 	InvalidAccountType,
 	CannotExecuteActionOnDMChannel,
@@ -246,7 +251,10 @@ export enum RESTJSONErrorCodes {
 	MessageWasBlockedByAutomaticModeration = 200000,
 	TitleWasBlockedByAutomaticModeration,
 
-	WebhooksCanOnlyCreateThreadsInForumChannels = 220003,
+	WebhooksPostedToForumChannelsMustHaveAThreadNameOrThreadId = 220001,
+	WebhooksPostedToForumChannelsCannotHaveBothAThreadNameAndThreadId,
+	WebhooksCanOnlyCreateThreadsInForumChannels,
+	WebhookServicesCannotBeUsedInForumChannels,
 
 	MessageBlockedByHarmfulLinksFilter = 240000,
 }

rest/v10/channel.ts

@@ -19,6 +19,9 @@ import type {
 	OverwriteType,
 	ThreadAutoArchiveDuration,
 	VideoQualityMode,
+	APIGuildForumTag,
+	APIGuildForumDefaultReactionEmoji,
+	SortOrderType,
 } from '../../payloads/v10/index';
 import type { AddUndefinedToPossiblyUndefinedPropertiesOfInterface, StrictPartial } from '../../utils/internals';
 
@@ -56,15 +59,15 @@ export type RESTPatchAPIChannelJSONBody = AddUndefinedToPossiblyUndefinedPropert
 	 */
 	position?: number | null;
 	/**
-	 * 0-1024 character channel topic
+	 * 0-1024 character channel topic (0-4096 characters for forum channels)
 	 *
-	 * Channel types: text, news
+	 * Channel types: text, news, forum
 	 */
 	topic?: string | null;
 	/**
 	 * Whether the channel is nsfw
 	 *
-	 * Channel types: text, voice, news
+	 * Channel types: text, voice, news, forum
 	 */
 	nsfw?: boolean | null;
 	/**
@@ -72,7 +75,7 @@ export type RESTPatchAPIChannelJSONBody = AddUndefinedToPossiblyUndefinedPropert
 	 * bots, as well as users with the permission `MANAGE_MESSAGES` or `MANAGE_CHANNELS`,
 	 * are unaffected
 	 *
-	 * Channel types: text, newsThread, publicThread, privateThread
+	 * Channel types: text, newsThread, publicThread, privateThread, forum
 	 */
 	rate_limit_per_user?: number | null;
 	/**
@@ -141,6 +144,31 @@ export type RESTPatchAPIChannelJSONBody = AddUndefinedToPossiblyUndefinedPropert
 	 * Channel types: privateThread
 	 */
 	invitable?: boolean;
+	/**
+	 * The set of tags that can be used in a forum channel
+	 *
+	 * Channel types: forum
+	 */
+	available_tags?: APIGuildForumTag[];
+	/**
+	 * The emoji to show in the add reaction button on a thread in a forum channel
+	 *
+	 * Channel types: forum
+	 */
+	default_reaction_emoji?: APIGuildForumDefaultReactionEmoji;
+	/**
+	 * The initial `rate_limit_per_user` to set on newly created threads in a channel.
+	 * This field is copied to the thread at creation time and does not live update
+	 *
+	 * Channel types: text, forum
+	 */
+	default_thread_rate_limit_per_user?: number | null;
+	/**
+	 * The default sort order type used to order posts in forum channels
+	 *
+	 * Channel types: forum
+	 */
+	default_sort_order?: SortOrderType | null;
 }>;
 
 /**
@@ -589,6 +617,10 @@ export type RESTPostAPIGuildForumThreadsJSONBody = RESTPostAPIChannelMessagesThr
 	 * First message in the forum thread
 	 */
 	message: RESTPostAPIChannelMessageJSONBody;
+	/**
+	 * The IDs of the set of tags that have been applied to a thread in a forum channel
+	 */
+	applied_tags?: Snowflake[];
 };
 
 /**

rest/v10/guild.ts

@@ -53,6 +53,9 @@ export type APIGuildCreatePartialChannel = StrictPartial<
 		| 'rtc_region'
 		| 'video_quality_mode'
 		| 'flags'
+		| 'default_reaction_emoji'
+		| 'available_tags'
+		| 'default_sort_order'
 	>
 > &
 	AddUndefinedToPossiblyUndefinedPropertiesOfInterface<{

rest/v9/channel.ts

@@ -19,6 +19,9 @@ import type {
 	OverwriteType,
 	ThreadAutoArchiveDuration,
 	VideoQualityMode,
+	APIGuildForumTag,
+	APIGuildForumDefaultReactionEmoji,
+	SortOrderType,
 } from '../../payloads/v9/index';
 import type { AddUndefinedToPossiblyUndefinedPropertiesOfInterface, StrictPartial } from '../../utils/internals';
 
@@ -56,15 +59,15 @@ export type RESTPatchAPIChannelJSONBody = AddUndefinedToPossiblyUndefinedPropert
 	 */
 	position?: number | null;
 	/**
-	 * 0-1024 character channel topic
+	 * 0-1024 character channel topic (0-4096 characters for forum channels)
 	 *
-	 * Channel types: text, news
+	 * Channel types: text, news, forum
 	 */
 	topic?: string | null;
 	/**
 	 * Whether the channel is nsfw
 	 *
-	 * Channel types: text, voice, news
+	 * Channel types: text, voice, news, forum
 	 */
 	nsfw?: boolean | null;
 	/**
@@ -72,7 +75,7 @@ export type RESTPatchAPIChannelJSONBody = AddUndefinedToPossiblyUndefinedPropert
 	 * bots, as well as users with the permission `MANAGE_MESSAGES` or `MANAGE_CHANNELS`,
 	 * are unaffected
 	 *
-	 * Channel types: text, newsThread, publicThread, privateThread
+	 * Channel types: text, newsThread, publicThread, privateThread, forum
 	 */
 	rate_limit_per_user?: number | null;
 	/**
@@ -141,6 +144,31 @@ export type RESTPatchAPIChannelJSONBody = AddUndefinedToPossiblyUndefinedPropert
 	 * Channel types: privateThread
 	 */
 	invitable?: boolean;
+	/**
+	 * The set of tags that can be used in a forum channel
+	 *
+	 * Channel types: forum
+	 */
+	available_tags?: APIGuildForumTag[];
+	/**
+	 * The emoji to show in the add reaction button on a thread in a forum channel
+	 *
+	 * Channel types: forum
+	 */
+	default_reaction_emoji?: APIGuildForumDefaultReactionEmoji;
+	/**
+	 * The initial `rate_limit_per_user` to set on newly created threads in a channel.
+	 * This field is copied to the thread at creation time and does not live update
+	 *
+	 * Channel types: text, forum
+	 */
+	default_thread_rate_limit_per_user?: number | null;
+	/**
+	 * The default sort order type used to order posts in forum channels
+	 *
+	 * Channel types: forum
+	 */
+	default_sort_order?: SortOrderType | null;
 }>;
 
 /**
@@ -603,6 +631,10 @@ export type RESTPostAPIGuildForumThreadsJSONBody = RESTPostAPIChannelMessagesThr
 	 * First message in the forum thread
 	 */
 	message: RESTPostAPIChannelMessageJSONBody;
+	/**
+	 * The IDs of the set of tags that have been applied to a thread in a forum channel
+	 */
+	applied_tags?: Snowflake[];
 };
 
 /**

rest/v9/guild.ts

@@ -53,6 +53,9 @@ export type APIGuildCreatePartialChannel = StrictPartial<
 		| 'rtc_region'
 		| 'video_quality_mode'
 		| 'flags'
+		| 'default_reaction_emoji'
+		| 'available_tags'
+		| 'default_sort_order'
 	>
 > &
 	AddUndefinedToPossiblyUndefinedPropertiesOfInterface<{

website/versioned_docs/version-0.37.11/api-packages.json

@@ -1 +1 @@
-[{"entryPoints":{"globals":{"path":"globals.ts","label":"Global Types"},"gateway/common":{"path":"gateway/common.ts","label":"Gateway - Common Types"},"payloads/common":{"path":"payloads/common.ts","label":"Payloads - Common Types"},"rest/common":{"path":"rest/common.ts","label":"REST - Common Types"},"rpc/common":{"path":"rpc/common.ts","label":"RPC - Common Types"},"v6":{"path":"v6.ts","label":"API v6 - Deprecated"},"v8":{"path":"v8.ts","label":"API v8 - Deprecated"},"v9":{"path":"v9.ts","label":"API v9"},"v10":{"path":"v10.ts","label":"API v10"},"rpc/v8":{"path":"rpc/v8.ts","label":"RPC v8"},"rpc/v9":{"path":"rpc/v9.ts","label":"RPC v9"},"rpc/v10":{"path":"rpc/v10.ts","label":"RPC v10"},"voice/v4":{"path":"voice/v4.ts","label":"Voice v4"},"utils/v8":{"path":"utils/v8.ts","label":"Utils v8"},"utils/v9":{"path":"utils/v9.ts","label":"Utils v9"},"utils/v10":{"path":"utils/v10.ts","label":"Utils v10"}},"packagePath":"./","packageSlug":"discord-api-types","packageName":"discord-api-types","packageVersion":"0.37.10"}]
+[{"entryPoints":{"globals":{"path":"globals.ts","label":"Global Types"},"gateway/common":{"path":"gateway/common.ts","label":"Gateway - Common Types"},"payloads/common":{"path":"payloads/common.ts","label":"Payloads - Common Types"},"rest/common":{"path":"rest/common.ts","label":"REST - Common Types"},"rpc/common":{"path":"rpc/common.ts","label":"RPC - Common Types"},"v6":{"path":"v6.ts","label":"API v6 - Deprecated"},"v8":{"path":"v8.ts","label":"API v8 - Deprecated"},"v9":{"path":"v9.ts","label":"API v9"},"v10":{"path":"v10.ts","label":"API v10"},"rpc/v8":{"path":"rpc/v8.ts","label":"RPC v8"},"rpc/v9":{"path":"rpc/v9.ts","label":"RPC v9"},"rpc/v10":{"path":"rpc/v10.ts","label":"RPC v10"},"voice/v4":{"path":"voice/v4.ts","label":"Voice v4"},"utils/v8":{"path":"utils/v8.ts","label":"Utils v8"},"utils/v9":{"path":"utils/v9.ts","label":"Utils v9"},"utils/v10":{"path":"utils/v10.ts","label":"Utils v10"}},"packagePath":"./","packageSlug":"discord-api-types","packageName":"discord-api-types","packageVersion":"0.37.11"}]

website/versioned_docs/version-0.37.12/api-packages.json

@@ -1 +1 @@
-[{"entryPoints":{"globals":{"path":"globals.ts","label":"Global Types"},"gateway/common":{"path":"gateway/common.ts","label":"Gateway - Common Types"},"payloads/common":{"path":"payloads/common.ts","label":"Payloads - Common Types"},"rest/common":{"path":"rest/common.ts","label":"REST - Common Types"},"rpc/common":{"path":"rpc/common.ts","label":"RPC - Common Types"},"v6":{"path":"v6.ts","label":"API v6 - Deprecated"},"v8":{"path":"v8.ts","label":"API v8 - Deprecated"},"v9":{"path":"v9.ts","label":"API v9"},"v10":{"path":"v10.ts","label":"API v10"},"rpc/v8":{"path":"rpc/v8.ts","label":"RPC v8"},"rpc/v9":{"path":"rpc/v9.ts","label":"RPC v9"},"rpc/v10":{"path":"rpc/v10.ts","label":"RPC v10"},"voice/v4":{"path":"voice/v4.ts","label":"Voice v4"},"utils/v8":{"path":"utils/v8.ts","label":"Utils v8"},"utils/v9":{"path":"utils/v9.ts","label":"Utils v9"},"utils/v10":{"path":"utils/v10.ts","label":"Utils v10"}},"packagePath":"./","packageSlug":"discord-api-types","packageName":"discord-api-types","packageVersion":"0.37.9"}]
+[{"entryPoints":{"globals":{"path":"globals.ts","label":"Global Types"},"gateway/common":{"path":"gateway/common.ts","label":"Gateway - Common Types"},"payloads/common":{"path":"payloads/common.ts","label":"Payloads - Common Types"},"rest/common":{"path":"rest/common.ts","label":"REST - Common Types"},"rpc/common":{"path":"rpc/common.ts","label":"RPC - Common Types"},"v6":{"path":"v6.ts","label":"API v6 - Deprecated"},"v8":{"path":"v8.ts","label":"API v8 - Deprecated"},"v9":{"path":"v9.ts","label":"API v9"},"v10":{"path":"v10.ts","label":"API v10"},"rpc/v8":{"path":"rpc/v8.ts","label":"RPC v8"},"rpc/v9":{"path":"rpc/v9.ts","label":"RPC v9"},"rpc/v10":{"path":"rpc/v10.ts","label":"RPC v10"},"voice/v4":{"path":"voice/v4.ts","label":"Voice v4"},"utils/v8":{"path":"utils/v8.ts","label":"Utils v8"},"utils/v9":{"path":"utils/v9.ts","label":"Utils v9"},"utils/v10":{"path":"utils/v10.ts","label":"Utils v10"}},"packagePath":"./","packageSlug":"discord-api-types","packageName":"discord-api-types","packageVersion":"0.37.12"}]

website/versions.json

@@ -1,4 +1,4 @@
 [
-  "0.37.10",
-  "0.37.9"
+  "0.37.12",
+  "0.37.11"
 ]