chore(release): 0.37.97 🎉 (#1068)

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

.eslint-plugin-local/index.ts

@@ -37,6 +37,9 @@ const schema = [
 	},
 ] as const;
 
+const REST_TYPE_NAME_REGEX =
+	/^REST(?:Get|Patch|Post|Put|Delete)[a-zA-Z0-9]+(?:JSONBody|FormDataBody|URLEncodedData|Result|Query)$/;
+
 export = {
 	rules: {
 		'explicitly-optional-undefined-properties': ESLintUtils.RuleCreator.withoutDocs<Options, 'missingOptional'>({
@@ -131,5 +134,54 @@ export = {
 			},
 			defaultOptions: [{ interfaceEndings: [] }],
 		}),
+		'rest-type-naming-convention': ESLintUtils.RuleCreator.withoutDocs<[{ whitelist: string[] }], 'invalidName'>({
+			create: (context) => {
+				const { whitelist } = context.options[0];
+				const whitelistSet = new Set(whitelist);
+
+				return {
+					'TSTypeAliasDeclaration, TSInterfaceDeclaration': (
+						node: TSESTree.TSTypeAliasDeclaration | TSESTree.TSInterfaceDeclaration,
+					) => {
+						if (node.id.type !== AST_NODE_TYPES.Identifier) {
+							return;
+						}
+
+						const { name } = node.id;
+						if (whitelistSet.has(name)) {
+							return;
+						}
+
+						if (!REST_TYPE_NAME_REGEX.test(name)) {
+							context.report({
+								node: node.id,
+								messageId: 'invalidName',
+								data: { name },
+							});
+						}
+					},
+				};
+			},
+			meta: {
+				messages: {
+					invalidName: `{{ name }} does not match REST type naming convention. Must match ${REST_TYPE_NAME_REGEX.source}.`,
+				},
+				type: 'problem',
+				schema: [
+					{
+						type: 'object',
+						properties: {
+							whitelist: {
+								type: 'array',
+								items: {
+									type: 'string',
+								},
+							},
+						},
+					},
+				] as const,
+			},
+			defaultOptions: [{ whitelist: [] }],
+		}),
 	},
 };

.eslintrc.json

@@ -17,5 +17,54 @@
 		"typescript-sort-keys/string-enum": "off",
 		"unicorn/prefer-math-trunc": "off",
 		"jsdoc/no-undefined-types": "off"
-	}
+	},
+	"overrides": [
+		{
+			"files": ["rest/v10/*.ts", "rest/v9/*.ts"],
+			"excludedFiles": ["rest/v10/index.ts", "rest/v9/index.ts"],
+			"rules": {
+				"local/rest-type-naming-convention": [
+					"error",
+					{
+						"whitelist": [
+							"RESTAPIAttachment",
+							"RESTAPIChannelPatchOverwrite",
+							"RESTAPIGuildChannelResolvable",
+							"RESTAPIGuildCreateOverwrite",
+							"RESTAPIGuildCreatePartialChannel",
+							"RESTAPIGuildCreateRole",
+							"RESTAPIGuildOnboardingPrompt",
+							"RESTAPIGuildOnboardingPromptOption",
+							"RESTAPIMessageReference",
+							"RESTAPIPartialCurrentUserGuild",
+							"RESTAPIPoll",
+
+							"RESTOAuth2AdvancedBotAuthorizationQuery",
+							"RESTOAuth2AdvancedBotAuthorizationQueryResult",
+							"RESTOAuth2AuthorizationQuery",
+							"RESTOAuth2BotAuthorizationQuery",
+							"RESTOAuth2ImplicitAuthorizationQuery",
+							"RESTOAuth2ImplicitAuthorizationURLFragmentResult",
+
+							// Deprecated types
+							"APIChannelPatchOverwrite",
+							"APIGuildChannelResolvable",
+							"APIGuildCreateOverwrite",
+							"APIGuildCreatePartialChannel",
+							"APIGuildCreateRole",
+							"APIMessageReferenceSend",
+							"GetAPIVoiceRegionsResult",
+							"RESTAPIModifyGuildOnboardingPromptData",
+							"RESTAPIModifyGuildOnboardingPromptOptionData",
+							"RESTAPIPollCreate",
+							"RESTDeleteAPIChannelMessageOwnReaction",
+							"RESTGetAPIStickerPack",
+							"RESTOAuth2AuthorizationQueryResult",
+							"RESTPostAPIEntitlementBody"
+						]
+					}
+				]
+			}
+		}
+	]
 }

CHANGELOG.md

@@ -1,3 +1,17 @@
+## [0.37.97](https://github.com/discordjs/discord-api-types/compare/0.37.96...0.37.97) (2024-08-22)
+
+
+
+## [0.37.96](https://github.com/discordjs/discord-api-types/compare/0.37.95...0.37.96) (2024-08-20)
+
+
+### Bug Fixes
+
+* nullable `recurrence_rule` on patch ([#1063](https://github.com/discordjs/discord-api-types/issues/1063)) ([19d2aeb](https://github.com/discordjs/discord-api-types/commit/19d2aeb4a82dc781558240a674c36eadce270abf))
+* nullable fields for scheduled event editing ([#1064](https://github.com/discordjs/discord-api-types/issues/1064)) ([f67043b](https://github.com/discordjs/discord-api-types/commit/f67043b3f46eea7286e959d223b78d140deac318))
+
+
+
 ## [0.37.95](https://github.com/discordjs/discord-api-types/compare/0.37.94...0.37.95) (2024-08-19)
 
 

deno/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [0.37.97](https://github.com/discordjs/discord-api-types/compare/0.37.96...0.37.97) (2024-08-22)
+
+
+
+## [0.37.96](https://github.com/discordjs/discord-api-types/compare/0.37.95...0.37.96) (2024-08-20)
+
+
+### Bug Fixes
+
+* nullable `recurrence_rule` on patch ([#1063](https://github.com/discordjs/discord-api-types/issues/1063)) ([19d2aeb](https://github.com/discordjs/discord-api-types/commit/19d2aeb4a82dc781558240a674c36eadce270abf))
+* nullable fields for scheduled event editing ([#1064](https://github.com/discordjs/discord-api-types/issues/1064)) ([f67043b](https://github.com/discordjs/discord-api-types/commit/f67043b3f46eea7286e959d223b78d140deac318))
+
+
+
 ## [0.37.95](https://github.com/discordjs/discord-api-types/compare/0.37.94...0.37.95) (2024-08-19)
 
 

deno/rest/v10/channel.ts

@@ -26,12 +26,17 @@ import type {
 	ChannelFlags,
 } from '../../payloads/v10/mod.ts';
 import type { AddUndefinedToPossiblyUndefinedPropertiesOfInterface, StrictPartial } from '../../utils/internals.ts';
-import type { RESTAPIPollCreate } from './poll.ts';
+import type { RESTAPIPoll } from './poll.ts';
 
-export interface APIChannelPatchOverwrite extends RESTPutAPIChannelPermissionJSONBody {
+export interface RESTAPIChannelPatchOverwrite extends RESTPutAPIChannelPermissionJSONBody {
 	id: Snowflake;
 }
 
+/**
+ * @deprecated Use {@link RESTAPIChannelPatchOverwrite} instead
+ */
+export type APIChannelPatchOverwrite = RESTAPIChannelPatchOverwrite;
+
 /**
  * https://discord.com/developers/docs/resources/channel#get-channel
  */
@@ -98,7 +103,7 @@ export interface RESTPatchAPIChannelJSONBody {
 	 *
 	 * Channel types: all excluding newsThread, publicThread, privateThread
 	 */
-	permission_overwrites?: APIChannelPatchOverwrite[] | null | undefined;
+	permission_overwrites?: RESTAPIChannelPatchOverwrite[] | null | undefined;
 	/**
 	 * ID of the new parent category for a channel
 	 *
@@ -237,7 +242,7 @@ export type RESTGetAPIChannelMessageResult = APIMessage;
 /**
  * https://discord.com/developers/docs/resources/channel#message-reference-object-message-reference-structure
  */
-export type APIMessageReferenceSend = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<
+export type RESTAPIMessageReference = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<
 	Required<Pick<APIMessageReference, 'message_id'>>
 > &
 	StrictPartial<APIMessageReference> & {
@@ -249,6 +254,11 @@ export type APIMessageReferenceSend = AddUndefinedToPossiblyUndefinedPropertiesO
 		fail_if_not_exists?: boolean | undefined;
 	};
 
+/**
+ * @deprecated Use {@link RESTAPIMessageReference} instead
+ */
+export type APIMessageReferenceSend = RESTAPIMessageReference;
+
 /**
  * https://discord.com/developers/docs/resources/channel#attachment-object
  */
@@ -300,7 +310,7 @@ export interface RESTPostAPIChannelMessageJSONBody {
 	 *
 	 * See https://discord.com/developers/docs/resources/channel#message-reference-object-message-reference-structure
 	 */
-	message_reference?: APIMessageReferenceSend | undefined;
+	message_reference?: RESTAPIMessageReference | undefined;
 	/**
 	 * The components to include with the message
 	 *
@@ -329,7 +339,7 @@ export interface RESTPostAPIChannelMessageJSONBody {
 	/**
 	 * A poll!
 	 */
-	poll?: RESTAPIPollCreate | undefined;
+	poll?: RESTAPIPoll | undefined;
 }
 
 /**
@@ -362,7 +372,12 @@ export type RESTPutAPIChannelMessageReactionResult = never;
 /**
  * https://discord.com/developers/docs/resources/channel#delete-own-reaction
  */
-export type RESTDeleteAPIChannelMessageOwnReaction = never;
+export type RESTDeleteAPIChannelMessageOwnReactionResult = never;
+
+/**
+ * @deprecated Use {@link RESTDeleteAPIChannelMessageOwnReactionResult} instead
+ */
+export type RESTDeleteAPIChannelMessageOwnReaction = RESTDeleteAPIChannelMessageOwnReactionResult;
 
 /**
  * https://discord.com/developers/docs/resources/channel#delete-user-reaction

deno/rest/v10/guild.ts

@@ -37,14 +37,25 @@ import type {
 } from '../../utils/internals.ts';
 import type { RESTPutAPIChannelPermissionJSONBody } from './channel.ts';
 
-export interface APIGuildCreateOverwrite extends RESTPutAPIChannelPermissionJSONBody {
+export interface RESTAPIGuildCreateOverwrite extends RESTPutAPIChannelPermissionJSONBody {
 	id: number | string;
 }
 
-export type APIGuildChannelResolvable = Exclude<APIChannel, APIDMChannel | APIGroupDMChannel>;
-export type APIGuildCreatePartialChannel = StrictPartial<
+/**
+ * @deprecated Use {@link RESTAPIGuildCreateOverwrite} instead
+ */
+export type APIGuildCreateOverwrite = RESTAPIGuildCreateOverwrite;
+
+export type RESTAPIGuildChannelResolvable = Exclude<APIChannel, APIDMChannel | APIGroupDMChannel>;
+
+/**
+ * @deprecated Use {@link RESTAPIGuildChannelResolvable} instead
+ */
+export type APIGuildChannelResolvable = RESTAPIGuildChannelResolvable;
+
+export type RESTAPIGuildCreatePartialChannel = StrictPartial<
 	DistributivePick<
-		APIGuildChannelResolvable,
+		RESTAPIGuildChannelResolvable,
 		| 'available_tags'
 		| 'bitrate'
 		| 'default_auto_archive_duration'
@@ -66,13 +77,23 @@ export type APIGuildCreatePartialChannel = StrictPartial<
 	name: string;
 	id?: number | string | undefined;
 	parent_id?: number | string | null | undefined;
-	permission_overwrites?: APIGuildCreateOverwrite[] | undefined;
+	permission_overwrites?: RESTAPIGuildCreateOverwrite[] | undefined;
 };
 
-export interface APIGuildCreateRole extends RESTPostAPIGuildRoleJSONBody {
+/**
+ * @deprecated Use {@link RESTAPIGuildCreatePartialChannel} instead
+ */
+export type APIGuildCreatePartialChannel = RESTAPIGuildCreatePartialChannel;
+
+export interface RESTAPIGuildCreateRole extends RESTPostAPIGuildRoleJSONBody {
 	id: number | string;
 }
 
+/**
+ * @deprecated Use {@link RESTAPIGuildCreateRole} instead
+ */
+export type APIGuildCreateRole = RESTAPIGuildCreateRole;
+
 /**
  * https://discord.com/developers/docs/resources/guild#create-guild
  */
@@ -124,7 +145,7 @@ export interface RESTPostAPIGuildsJSONBody {
 	 *
 	 * See https://discord.com/developers/docs/topics/permissions#role-object
 	 */
-	roles?: APIGuildCreateRole[] | undefined;
+	roles?: RESTAPIGuildCreateRole[] | undefined;
 	/**
 	 * New guild's channels
 	 *
@@ -138,7 +159,7 @@ export interface RESTPostAPIGuildsJSONBody {
 	 *
 	 * See https://discord.com/developers/docs/resources/channel#channel-object
 	 */
-	channels?: APIGuildCreatePartialChannel[] | undefined;
+	channels?: RESTAPIGuildCreatePartialChannel[] | undefined;
 	/**
 	 * ID for afk channel
 	 */
@@ -333,7 +354,7 @@ export type RESTGetAPIGuildChannelsResult = APIChannel[];
 /**
  * https://discord.com/developers/docs/resources/guild#create-guild-channel
  */
-export type RESTPostAPIGuildChannelJSONBody = DistributiveOmit<APIGuildCreatePartialChannel, 'id'>;
+export type RESTPostAPIGuildChannelJSONBody = DistributiveOmit<RESTAPIGuildCreatePartialChannel, 'id'>;
 
 /**
  * https://discord.com/developers/docs/resources/guild#create-guild-channel
@@ -930,20 +951,25 @@ export type RESTPutAPIGuildOnboardingJSONBody = AddUndefinedToPossiblyUndefinedP
 	/**
 	 * Prompts shown during onboarding and in customize community
 	 */
-	prompts?: RESTAPIModifyGuildOnboardingPromptData[] | undefined;
+	prompts?: RESTAPIGuildOnboardingPrompt[] | undefined;
 };
 
-export type RESTAPIModifyGuildOnboardingPromptData = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<
+export type RESTAPIGuildOnboardingPrompt = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<
 	Partial<Omit<APIGuildOnboardingPrompt, 'guild_id' | 'id' | 'options' | 'title'>>
 > &
 	Pick<APIGuildOnboardingPrompt, 'id' | 'title'> & {
 		/**
 		 * Options available within the prompt
 		 */
-		options: RESTAPIModifyGuildOnboardingPromptOptionData[];
+		options: RESTAPIGuildOnboardingPromptOption[];
 	};
 
-export type RESTAPIModifyGuildOnboardingPromptOptionData = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<
+/**
+ * @deprecated Use {@link RESTAPIGuildOnboardingPrompt} instead.
+ */
+export type RESTAPIModifyGuildOnboardingPromptData = RESTAPIGuildOnboardingPrompt;
+
+export type RESTAPIGuildOnboardingPromptOption = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<
 	Partial<Omit<APIGuildOnboardingPromptOption, 'emoji' | 'guild_id' | 'title'>>
 > &
 	Pick<APIGuildOnboardingPromptOption, 'title'> & {
@@ -961,6 +987,11 @@ export type RESTAPIModifyGuildOnboardingPromptOptionData = AddUndefinedToPossibl
 		emoji_animated?: boolean | null | undefined;
 	};
 
+/**
+ * @deprecated Use {@link RESTAPIGuildOnboardingPromptOption} instead.
+ */
+export type RESTAPIModifyGuildOnboardingPromptOptionData = RESTAPIGuildOnboardingPromptOption;
+
 /**
  * https://discord.com/developers/docs/resources/guild#modify-guild-onboarding
  */

deno/rest/v10/guildScheduledEvent.ts

@@ -1,5 +1,5 @@
 import type { Snowflake } from '../../globals.ts';
-import type { StrictPartial } from '../../utils/internals.ts';
+import type { Nullable, StrictPartial } from '../../utils/internals.ts';
 import type {
 	APIGuildScheduledEvent,
 	APIGuildScheduledEventEntityMetadata,
@@ -94,20 +94,17 @@ export type RESTGetAPIGuildScheduledEventResult = APIGuildScheduledEvent;
 /**
  * https://discord.com/developers/docs/resources/guild-scheduled-event#modify-guild-scheduled-event
  */
-export type RESTPatchAPIGuildScheduledEventJSONBody = StrictPartial<RESTPostAPIGuildScheduledEventJSONBody> & {
-	/**
-	 * The status of the scheduled event
-	 */
-	status?: GuildScheduledEventStatus | undefined;
-	/**
-	 * The entity metadata of the scheduled event
-	 */
-	entity_metadata?: APIGuildScheduledEventEntityMetadata | null | undefined;
-	/**
-	 * The description of the guild event
-	 */
-	description?: string | null | undefined;
-};
+export type RESTPatchAPIGuildScheduledEventJSONBody = Nullable<
+	Pick<RESTPostAPIGuildScheduledEventJSONBody, 'description' | 'entity_metadata' | 'recurrence_rule'>
+> &
+	StrictPartial<
+		Omit<RESTPostAPIGuildScheduledEventJSONBody, 'description' | 'entity_metadata' | 'recurrence_rule'>
+	> & {
+		/**
+		 * The status of the scheduled event
+		 */
+		status?: GuildScheduledEventStatus | undefined;
+	};
 
 /**
  * https://discord.com/developers/docs/resources/guild-scheduled-event#modify-guild-scheduled-event

deno/rest/v10/monetization.ts

@@ -46,7 +46,7 @@ export type RESTGetAPIEntitlementsResult = APIEntitlement[];
 /**
  * https://discord.com/developers/docs/monetization/entitlements#create-test-entitlement
  */
-export interface RESTPostAPIEntitlementBody {
+export interface RESTPostAPIEntitlementJSONBody {
 	/**
 	 * ID of the SKU to grant the entitlement to
 	 */
@@ -61,6 +61,11 @@ export interface RESTPostAPIEntitlementBody {
 	owner_type: EntitlementOwnerType;
 }
 
+/**
+ * @deprecated Use {@link RESTPostAPIEntitlementJSONBody} instead
+ */
+export type RESTPostAPIEntitlementBody = RESTPostAPIEntitlementJSONBody;
+
 /**
  * https://discord.com/developers/docs/monetization/entitlements#create-test-entitlement
  */

deno/rest/v10/oauth2.ts

@@ -51,11 +51,16 @@ export interface RESTPostOAuth2TokenRevocationQuery {
 /**
  * https://discord.com/developers/docs/topics/oauth2#authorization-code-grant-redirect-url-example
  */
-export interface RESTOAuth2AuthorizationQueryResult {
+export interface RESTPostOAuth2AuthorizationQueryResult {
 	code: string;
 	state?: string;
 }
 
+/**
+ * @deprecated Use {@link RESTPostOAuth2AuthorizationQueryResult} instead
+ */
+export type RESTOAuth2AuthorizationQueryResult = RESTPostOAuth2AuthorizationQueryResult;
+
 /**
  * https://discord.com/developers/docs/topics/oauth2#authorization-code-grant-redirect-url-example
  */

deno/rest/v10/poll.ts

@@ -20,7 +20,7 @@ export interface RESTGetAPIPollAnswerVotersQuery {
 /**
  * https://discord.com/developers/docs/resources/poll#poll-create-request-object-poll-create-request-object-structure
  */
-export interface RESTAPIPollCreate
+export interface RESTAPIPoll
 	extends Omit<APIPoll, 'allow_multiselect' | 'answers' | 'expiry' | 'layout_type' | 'results'>,
 		Partial<Pick<APIPoll, 'allow_multiselect' | 'layout_type'>> {
 	/**
@@ -35,6 +35,11 @@ export interface RESTAPIPollCreate
 	duration?: number;
 }
 
+/**
+ * @deprecated Use {@link RESTAPIPoll} instead
+ */
+export type RESTAPIPollCreate = RESTAPIPoll;
+
 /**
  * https://discord.com/developers/docs/resources/poll#get-answer-voters
  */

deno/rest/v10/sticker.ts

@@ -15,7 +15,12 @@ export interface RESTGetStickerPacksResult {
 /**
  * https://discord.com/developers/docs/resources/sticker#get-sticker-pack
  */
-export type RESTGetAPIStickerPack = APIStickerPack;
+export type RESTGetAPIStickerPackResult = APIStickerPack;
+
+/**
+ * @deprecated Use {@link RESTGetAPIStickerPackResult} instead
+ */
+export type RESTGetAPIStickerPack = RESTGetAPIStickerPackResult;
 
 /**
  * https://discord.com/developers/docs/resources/sticker#list-sticker-packs

deno/rest/v10/webhook.ts

@@ -10,7 +10,7 @@ import type {
 } from '../../payloads/v10/mod.ts';
 import type { AddUndefinedToPossiblyUndefinedPropertiesOfInterface, Nullable } from '../../utils/internals.ts';
 import type { RESTAPIAttachment } from './channel.ts';
-import type { RESTAPIPollCreate } from './poll.ts';
+import type { RESTAPIPoll } from './poll.ts';
 /**
  * https://discord.com/developers/docs/resources/webhook#create-webhook
  */
@@ -158,7 +158,7 @@ export interface RESTPostAPIWebhookWithTokenJSONBody {
 	/**
 	 * A poll!
 	 */
-	poll?: RESTAPIPollCreate | undefined;
+	poll?: RESTAPIPoll | undefined;
 }
 
 /**

deno/rest/v9/channel.ts

@@ -26,12 +26,17 @@ import type {
 	ChannelFlags,
 } from '../../payloads/v9/mod.ts';
 import type { AddUndefinedToPossiblyUndefinedPropertiesOfInterface, StrictPartial } from '../../utils/internals.ts';
-import type { RESTAPIPollCreate } from './poll.ts';
+import type { RESTAPIPoll } from './poll.ts';
 
-export interface APIChannelPatchOverwrite extends RESTPutAPIChannelPermissionJSONBody {
+export interface RESTAPIChannelPatchOverwrite extends RESTPutAPIChannelPermissionJSONBody {
 	id: Snowflake;
 }
 
+/**
+ * @deprecated Use {@link RESTAPIChannelPatchOverwrite} instead
+ */
+export type APIChannelPatchOverwrite = RESTAPIChannelPatchOverwrite;
+
 /**
  * https://discord.com/developers/docs/resources/channel#get-channel
  */
@@ -237,7 +242,7 @@ export type RESTGetAPIChannelMessageResult = APIMessage;
 /**
  * https://discord.com/developers/docs/resources/channel#message-reference-object-message-reference-structure
  */
-export type APIMessageReferenceSend = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<
+export type RESTAPIMessageReference = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<
 	Required<Pick<APIMessageReference, 'message_id'>>
 > &
 	StrictPartial<APIMessageReference> & {
@@ -249,6 +254,11 @@ export type APIMessageReferenceSend = AddUndefinedToPossiblyUndefinedPropertiesO
 		fail_if_not_exists?: boolean | undefined;
 	};
 
+/**
+ * @deprecated Use {@link RESTAPIMessageReference} instead
+ */
+export type APIMessageReferenceSend = RESTAPIMessageReference;
+
 /**
  * https://discord.com/developers/docs/resources/channel#attachment-object
  */
@@ -308,7 +318,7 @@ export interface RESTPostAPIChannelMessageJSONBody {
 	 *
 	 * See https://discord.com/developers/docs/resources/channel#message-reference-object-message-reference-structure
 	 */
-	message_reference?: APIMessageReferenceSend | undefined;
+	message_reference?: RESTAPIMessageReference | undefined;
 	/**
 	 * The components to include with the message
 	 *
@@ -337,7 +347,7 @@ export interface RESTPostAPIChannelMessageJSONBody {
 	/**
 	 * A poll!
 	 */
-	poll?: RESTAPIPollCreate | undefined;
+	poll?: RESTAPIPoll | undefined;
 }
 
 /**
@@ -370,7 +380,12 @@ export type RESTPutAPIChannelMessageReactionResult = never;
 /**
  * https://discord.com/developers/docs/resources/channel#delete-own-reaction
  */
-export type RESTDeleteAPIChannelMessageOwnReaction = never;
+export type RESTDeleteAPIChannelMessageOwnReactionResult = never;
+
+/**
+ * @deprecated Use {@link RESTDeleteAPIChannelMessageOwnReactionResult} instead
+ */
+export type RESTDeleteAPIChannelMessageOwnReaction = RESTDeleteAPIChannelMessageOwnReactionResult;
 
 /**
  * https://discord.com/developers/docs/resources/channel#delete-user-reaction

deno/rest/v9/guild.ts

@@ -37,14 +37,25 @@ import type {
 } from '../../utils/internals.ts';
 import type { RESTPutAPIChannelPermissionJSONBody } from './channel.ts';
 
-export interface APIGuildCreateOverwrite extends RESTPutAPIChannelPermissionJSONBody {
+export interface RESTAPIGuildCreateOverwrite extends RESTPutAPIChannelPermissionJSONBody {
 	id: number | string;
 }
 
-export type APIGuildChannelResolvable = Exclude<APIChannel, APIDMChannel | APIGroupDMChannel>;
-export type APIGuildCreatePartialChannel = StrictPartial<
+/**
+ * @deprecated Use {@link RESTAPIGuildCreateOverwrite} instead
+ */
+export type APIGuildCreateOverwrite = RESTAPIGuildCreateOverwrite;
+
+export type RESTAPIGuildChannelResolvable = Exclude<APIChannel, APIDMChannel | APIGroupDMChannel>;
+
+/**
+ * @deprecated Use {@link RESTAPIGuildChannelResolvable} instead
+ */
+export type APIGuildChannelResolvable = RESTAPIGuildChannelResolvable;
+
+export type RESTAPIGuildCreatePartialChannel = StrictPartial<
 	DistributivePick<
-		APIGuildChannelResolvable,
+		RESTAPIGuildChannelResolvable,
 		| 'available_tags'
 		| 'bitrate'
 		| 'default_auto_archive_duration'
@@ -66,13 +77,23 @@ export type APIGuildCreatePartialChannel = StrictPartial<
 	name: string;
 	id?: number | string | undefined;
 	parent_id?: number | string | null | undefined;
-	permission_overwrites?: APIGuildCreateOverwrite[] | undefined;
+	permission_overwrites?: RESTAPIGuildCreateOverwrite[] | undefined;
 };
 
-export interface APIGuildCreateRole extends RESTPostAPIGuildRoleJSONBody {
+/**
+ * @deprecated Use {@link RESTAPIGuildCreatePartialChannel} instead
+ */
+export type APIGuildCreatePartialChannel = RESTAPIGuildCreatePartialChannel;
+
+export interface RESTAPIGuildCreateRole extends RESTPostAPIGuildRoleJSONBody {
 	id: number | string;
 }
 
+/**
+ * @deprecated Use {@link RESTAPIGuildCreateRole} instead
+ */
+export type APIGuildCreateRole = RESTAPIGuildCreateRole;
+
 /**
  * https://discord.com/developers/docs/resources/guild#create-guild
  */
@@ -124,7 +145,7 @@ export interface RESTPostAPIGuildsJSONBody {
 	 *
 	 * See https://discord.com/developers/docs/topics/permissions#role-object
 	 */
-	roles?: APIGuildCreateRole[] | undefined;
+	roles?: RESTAPIGuildCreateRole[] | undefined;
 	/**
 	 * New guild's channels
 	 *
@@ -138,7 +159,7 @@ export interface RESTPostAPIGuildsJSONBody {
 	 *
 	 * See https://discord.com/developers/docs/resources/channel#channel-object
 	 */
-	channels?: APIGuildCreatePartialChannel[] | undefined;
+	channels?: RESTAPIGuildCreatePartialChannel[] | undefined;
 	/**
 	 * ID for afk channel
 	 */
@@ -333,7 +354,7 @@ export type RESTGetAPIGuildChannelsResult = APIChannel[];
 /**
  * https://discord.com/developers/docs/resources/guild#create-guild-channel
  */
-export type RESTPostAPIGuildChannelJSONBody = DistributiveOmit<APIGuildCreatePartialChannel, 'id'>;
+export type RESTPostAPIGuildChannelJSONBody = DistributiveOmit<RESTAPIGuildCreatePartialChannel, 'id'>;
 
 /**
  * https://discord.com/developers/docs/resources/guild#create-guild-channel
@@ -936,20 +957,25 @@ export type RESTPutAPIGuildOnboardingJSONBody = AddUndefinedToPossiblyUndefinedP
 	/**
 	 * Prompts shown during onboarding and in customize community
 	 */
-	prompts?: RESTAPIModifyGuildOnboardingPromptData[] | undefined;
+	prompts?: RESTAPIGuildOnboardingPrompt[] | undefined;
 };
 
-export type RESTAPIModifyGuildOnboardingPromptData = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<
+export type RESTAPIGuildOnboardingPrompt = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<
 	Partial<Omit<APIGuildOnboardingPrompt, 'guild_id' | 'id' | 'options' | 'title'>>
 > &
 	Pick<APIGuildOnboardingPrompt, 'id' | 'title'> & {
 		/**
 		 * Options available within the prompt
 		 */
-		options: RESTAPIModifyGuildOnboardingPromptOptionData[];
+		options: RESTAPIGuildOnboardingPromptOption[];
 	};
 
-export type RESTAPIModifyGuildOnboardingPromptOptionData = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<
+/**
+ * @deprecated Use {@link RESTAPIGuildOnboardingPrompt} instead.
+ */
+export type RESTAPIModifyGuildOnboardingPromptData = RESTAPIGuildOnboardingPrompt;
+
+export type RESTAPIGuildOnboardingPromptOption = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<
 	Partial<Omit<APIGuildOnboardingPromptOption, 'emoji' | 'guild_id' | 'title'>>
 > &
 	Pick<APIGuildOnboardingPromptOption, 'title'> & {
@@ -967,6 +993,11 @@ export type RESTAPIModifyGuildOnboardingPromptOptionData = AddUndefinedToPossibl
 		emoji_animated?: boolean | null | undefined;
 	};
 
+/**
+ * @deprecated Use {@link RESTAPIGuildOnboardingPromptOption} instead.
+ */
+export type RESTAPIModifyGuildOnboardingPromptOptionData = RESTAPIGuildOnboardingPromptOption;
+
 /**
  * https://discord.com/developers/docs/resources/guild#modify-guild-onboarding
  */

deno/rest/v9/guildScheduledEvent.ts

@@ -1,5 +1,5 @@
 import type { Snowflake } from '../../globals.ts';
-import type { StrictPartial } from '../../utils/internals.ts';
+import type { Nullable, StrictPartial } from '../../utils/internals.ts';
 import type {
 	APIGuildScheduledEvent,
 	APIGuildScheduledEventEntityMetadata,
@@ -94,20 +94,17 @@ export type RESTGetAPIGuildScheduledEventResult = APIGuildScheduledEvent;
 /**
  * https://discord.com/developers/docs/resources/guild-scheduled-event#modify-guild-scheduled-event
  */
-export type RESTPatchAPIGuildScheduledEventJSONBody = StrictPartial<RESTPostAPIGuildScheduledEventJSONBody> & {
-	/**
-	 * The status of the scheduled event
-	 */
-	status?: GuildScheduledEventStatus | undefined;
-	/**
-	 * The entity metadata of the scheduled event
-	 */
-	entity_metadata?: APIGuildScheduledEventEntityMetadata | null | undefined;
-	/**
-	 * The description of the guild event
-	 */
-	description?: string | null | undefined;
-};
+export type RESTPatchAPIGuildScheduledEventJSONBody = Nullable<
+	Pick<RESTPostAPIGuildScheduledEventJSONBody, 'description' | 'entity_metadata' | 'recurrence_rule'>
+> &
+	StrictPartial<
+		Omit<RESTPostAPIGuildScheduledEventJSONBody, 'description' | 'entity_metadata' | 'recurrence_rule'>
+	> & {
+		/**
+		 * The status of the scheduled event
+		 */
+		status?: GuildScheduledEventStatus | undefined;
+	};
 
 /**
  * https://discord.com/developers/docs/resources/guild-scheduled-event#modify-guild-scheduled-event

deno/rest/v9/monetization.ts

@@ -46,7 +46,7 @@ export type RESTGetAPIEntitlementsResult = APIEntitlement[];
 /**
  * https://discord.com/developers/docs/monetization/entitlements#create-test-entitlement
  */
-export interface RESTPostAPIEntitlementBody {
+export interface RESTPostAPIEntitlementJSONBody {
 	/**
 	 * ID of the SKU to grant the entitlement to
 	 */
@@ -61,6 +61,11 @@ export interface RESTPostAPIEntitlementBody {
 	owner_type: EntitlementOwnerType;
 }
 
+/**
+ * @deprecated Use {@link RESTPostAPIEntitlementJSONBody} instead
+ */
+export type RESTPostAPIEntitlementBody = RESTPostAPIEntitlementJSONBody;
+
 /**
  * https://discord.com/developers/docs/monetization/entitlements#create-test-entitlement
  */

deno/rest/v9/oauth2.ts

@@ -51,11 +51,16 @@ export interface RESTPostOAuth2TokenRevocationQuery {
 /**
  * https://discord.com/developers/docs/topics/oauth2#authorization-code-grant-redirect-url-example
  */
-export interface RESTOAuth2AuthorizationQueryResult {
+export interface RESTPostOAuth2AuthorizationQueryResult {
 	code: string;
 	state?: string;
 }
 
+/**
+ * @deprecated Use {@link RESTPostOAuth2AuthorizationQueryResult} instead
+ */
+export type RESTOAuth2AuthorizationQueryResult = RESTPostOAuth2AuthorizationQueryResult;
+
 /**
  * https://discord.com/developers/docs/topics/oauth2#authorization-code-grant-redirect-url-example
  */

deno/rest/v9/poll.ts

@@ -20,7 +20,7 @@ export interface RESTGetAPIPollAnswerVotersQuery {
 /**
  * https://discord.com/developers/docs/resources/poll#poll-create-request-object-poll-create-request-object-structure
  */
-export interface RESTAPIPollCreate
+export interface RESTAPIPoll
 	extends Omit<APIPoll, 'allow_multiselect' | 'answers' | 'expiry' | 'layout_type' | 'results'>,
 		Partial<Pick<APIPoll, 'allow_multiselect' | 'layout_type'>> {
 	/**
@@ -35,6 +35,11 @@ export interface RESTAPIPollCreate
 	duration?: number;
 }
 
+/**
+ * @deprecated Use {@link RESTAPIPoll} instead
+ */
+export type RESTAPIPollCreate = RESTAPIPoll;
+
 /**
  * https://discord.com/developers/docs/resources/poll#get-answer-voters
  */

deno/rest/v9/sticker.ts

@@ -15,7 +15,12 @@ export interface RESTGetStickerPacksResult {
 /**
  * https://discord.com/developers/docs/resources/sticker#get-sticker-pack
  */
-export type RESTGetAPIStickerPack = APIStickerPack;
+export type RESTGetAPIStickerPackResult = APIStickerPack;
+
+/**
+ * @deprecated Use {@link RESTGetAPIStickerPackResult} instead
+ */
+export type RESTGetAPIStickerPack = RESTGetAPIStickerPackResult;
 
 /**
  * https://discord.com/developers/docs/resources/sticker#list-sticker-packs

deno/rest/v9/webhook.ts

@@ -10,7 +10,7 @@ import type {
 } from '../../payloads/v9/mod.ts';
 import type { AddUndefinedToPossiblyUndefinedPropertiesOfInterface, Nullable } from '../../utils/internals.ts';
 import type { RESTAPIAttachment } from './channel.ts';
-import type { RESTAPIPollCreate } from './poll.ts';
+import type { RESTAPIPoll } from './poll.ts';
 /**
  * https://discord.com/developers/docs/resources/webhook#create-webhook
  */
@@ -158,7 +158,7 @@ export interface RESTPostAPIWebhookWithTokenJSONBody {
 	/**
 	 * A poll!
 	 */
-	poll?: RESTAPIPollCreate | undefined;
+	poll?: RESTAPIPoll | undefined;
 }
 
 /**

package-lock.json

@@ -1,12 +1,12 @@
 {
 	"name": "discord-api-types",
-	"version": "0.37.95",
+	"version": "0.37.97",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "discord-api-types",
-			"version": "0.37.95",
+			"version": "0.37.97",
 			"license": "MIT",
 			"devDependencies": {
 				"@commitlint/cli": "^19.0.3",

package.json

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

rest/v10/channel.ts

@@ -26,12 +26,17 @@ import type {
 	ChannelFlags,
 } from '../../payloads/v10/index';
 import type { AddUndefinedToPossiblyUndefinedPropertiesOfInterface, StrictPartial } from '../../utils/internals';
-import type { RESTAPIPollCreate } from './poll';
+import type { RESTAPIPoll } from './poll';
 
-export interface APIChannelPatchOverwrite extends RESTPutAPIChannelPermissionJSONBody {
+export interface RESTAPIChannelPatchOverwrite extends RESTPutAPIChannelPermissionJSONBody {
 	id: Snowflake;
 }
 
+/**
+ * @deprecated Use {@link RESTAPIChannelPatchOverwrite} instead
+ */
+export type APIChannelPatchOverwrite = RESTAPIChannelPatchOverwrite;
+
 /**
  * https://discord.com/developers/docs/resources/channel#get-channel
  */
@@ -98,7 +103,7 @@ export interface RESTPatchAPIChannelJSONBody {
 	 *
 	 * Channel types: all excluding newsThread, publicThread, privateThread
 	 */
-	permission_overwrites?: APIChannelPatchOverwrite[] | null | undefined;
+	permission_overwrites?: RESTAPIChannelPatchOverwrite[] | null | undefined;
 	/**
 	 * ID of the new parent category for a channel
 	 *
@@ -237,7 +242,7 @@ export type RESTGetAPIChannelMessageResult = APIMessage;
 /**
  * https://discord.com/developers/docs/resources/channel#message-reference-object-message-reference-structure
  */
-export type APIMessageReferenceSend = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<
+export type RESTAPIMessageReference = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<
 	Required<Pick<APIMessageReference, 'message_id'>>
 > &
 	StrictPartial<APIMessageReference> & {
@@ -249,6 +254,11 @@ export type APIMessageReferenceSend = AddUndefinedToPossiblyUndefinedPropertiesO
 		fail_if_not_exists?: boolean | undefined;
 	};
 
+/**
+ * @deprecated Use {@link RESTAPIMessageReference} instead
+ */
+export type APIMessageReferenceSend = RESTAPIMessageReference;
+
 /**
  * https://discord.com/developers/docs/resources/channel#attachment-object
  */
@@ -300,7 +310,7 @@ export interface RESTPostAPIChannelMessageJSONBody {
 	 *
 	 * See https://discord.com/developers/docs/resources/channel#message-reference-object-message-reference-structure
 	 */
-	message_reference?: APIMessageReferenceSend | undefined;
+	message_reference?: RESTAPIMessageReference | undefined;
 	/**
 	 * The components to include with the message
 	 *
@@ -329,7 +339,7 @@ export interface RESTPostAPIChannelMessageJSONBody {
 	/**
 	 * A poll!
 	 */
-	poll?: RESTAPIPollCreate | undefined;
+	poll?: RESTAPIPoll | undefined;
 }
 
 /**
@@ -362,7 +372,12 @@ export type RESTPutAPIChannelMessageReactionResult = never;
 /**
  * https://discord.com/developers/docs/resources/channel#delete-own-reaction
  */
-export type RESTDeleteAPIChannelMessageOwnReaction = never;
+export type RESTDeleteAPIChannelMessageOwnReactionResult = never;
+
+/**
+ * @deprecated Use {@link RESTDeleteAPIChannelMessageOwnReactionResult} instead
+ */
+export type RESTDeleteAPIChannelMessageOwnReaction = RESTDeleteAPIChannelMessageOwnReactionResult;
 
 /**
  * https://discord.com/developers/docs/resources/channel#delete-user-reaction

rest/v10/guild.ts

@@ -37,14 +37,25 @@ import type {
 } from '../../utils/internals';
 import type { RESTPutAPIChannelPermissionJSONBody } from './channel';
 
-export interface APIGuildCreateOverwrite extends RESTPutAPIChannelPermissionJSONBody {
+export interface RESTAPIGuildCreateOverwrite extends RESTPutAPIChannelPermissionJSONBody {
 	id: number | string;
 }
 
-export type APIGuildChannelResolvable = Exclude<APIChannel, APIDMChannel | APIGroupDMChannel>;
-export type APIGuildCreatePartialChannel = StrictPartial<
+/**
+ * @deprecated Use {@link RESTAPIGuildCreateOverwrite} instead
+ */
+export type APIGuildCreateOverwrite = RESTAPIGuildCreateOverwrite;
+
+export type RESTAPIGuildChannelResolvable = Exclude<APIChannel, APIDMChannel | APIGroupDMChannel>;
+
+/**
+ * @deprecated Use {@link RESTAPIGuildChannelResolvable} instead
+ */
+export type APIGuildChannelResolvable = RESTAPIGuildChannelResolvable;
+
+export type RESTAPIGuildCreatePartialChannel = StrictPartial<
 	DistributivePick<
-		APIGuildChannelResolvable,
+		RESTAPIGuildChannelResolvable,
 		| 'available_tags'
 		| 'bitrate'
 		| 'default_auto_archive_duration'
@@ -66,13 +77,23 @@ export type APIGuildCreatePartialChannel = StrictPartial<
 	name: string;
 	id?: number | string | undefined;
 	parent_id?: number | string | null | undefined;
-	permission_overwrites?: APIGuildCreateOverwrite[] | undefined;
+	permission_overwrites?: RESTAPIGuildCreateOverwrite[] | undefined;
 };
 
-export interface APIGuildCreateRole extends RESTPostAPIGuildRoleJSONBody {
+/**
+ * @deprecated Use {@link RESTAPIGuildCreatePartialChannel} instead
+ */
+export type APIGuildCreatePartialChannel = RESTAPIGuildCreatePartialChannel;
+
+export interface RESTAPIGuildCreateRole extends RESTPostAPIGuildRoleJSONBody {
 	id: number | string;
 }
 
+/**
+ * @deprecated Use {@link RESTAPIGuildCreateRole} instead
+ */
+export type APIGuildCreateRole = RESTAPIGuildCreateRole;
+
 /**
  * https://discord.com/developers/docs/resources/guild#create-guild
  */
@@ -124,7 +145,7 @@ export interface RESTPostAPIGuildsJSONBody {
 	 *
 	 * See https://discord.com/developers/docs/topics/permissions#role-object
 	 */
-	roles?: APIGuildCreateRole[] | undefined;
+	roles?: RESTAPIGuildCreateRole[] | undefined;
 	/**
 	 * New guild's channels
 	 *
@@ -138,7 +159,7 @@ export interface RESTPostAPIGuildsJSONBody {
 	 *
 	 * See https://discord.com/developers/docs/resources/channel#channel-object
 	 */
-	channels?: APIGuildCreatePartialChannel[] | undefined;
+	channels?: RESTAPIGuildCreatePartialChannel[] | undefined;
 	/**
 	 * ID for afk channel
 	 */
@@ -333,7 +354,7 @@ export type RESTGetAPIGuildChannelsResult = APIChannel[];
 /**
  * https://discord.com/developers/docs/resources/guild#create-guild-channel
  */
-export type RESTPostAPIGuildChannelJSONBody = DistributiveOmit<APIGuildCreatePartialChannel, 'id'>;
+export type RESTPostAPIGuildChannelJSONBody = DistributiveOmit<RESTAPIGuildCreatePartialChannel, 'id'>;
 
 /**
  * https://discord.com/developers/docs/resources/guild#create-guild-channel
@@ -930,20 +951,25 @@ export type RESTPutAPIGuildOnboardingJSONBody = AddUndefinedToPossiblyUndefinedP
 	/**
 	 * Prompts shown during onboarding and in customize community
 	 */
-	prompts?: RESTAPIModifyGuildOnboardingPromptData[] | undefined;
+	prompts?: RESTAPIGuildOnboardingPrompt[] | undefined;
 };
 
-export type RESTAPIModifyGuildOnboardingPromptData = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<
+export type RESTAPIGuildOnboardingPrompt = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<
 	Partial<Omit<APIGuildOnboardingPrompt, 'guild_id' | 'id' | 'options' | 'title'>>
 > &
 	Pick<APIGuildOnboardingPrompt, 'id' | 'title'> & {
 		/**
 		 * Options available within the prompt
 		 */
-		options: RESTAPIModifyGuildOnboardingPromptOptionData[];
+		options: RESTAPIGuildOnboardingPromptOption[];
 	};
 
-export type RESTAPIModifyGuildOnboardingPromptOptionData = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<
+/**
+ * @deprecated Use {@link RESTAPIGuildOnboardingPrompt} instead.
+ */
+export type RESTAPIModifyGuildOnboardingPromptData = RESTAPIGuildOnboardingPrompt;
+
+export type RESTAPIGuildOnboardingPromptOption = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<
 	Partial<Omit<APIGuildOnboardingPromptOption, 'emoji' | 'guild_id' | 'title'>>
 > &
 	Pick<APIGuildOnboardingPromptOption, 'title'> & {
@@ -961,6 +987,11 @@ export type RESTAPIModifyGuildOnboardingPromptOptionData = AddUndefinedToPossibl
 		emoji_animated?: boolean | null | undefined;
 	};
 
+/**
+ * @deprecated Use {@link RESTAPIGuildOnboardingPromptOption} instead.
+ */
+export type RESTAPIModifyGuildOnboardingPromptOptionData = RESTAPIGuildOnboardingPromptOption;
+
 /**
  * https://discord.com/developers/docs/resources/guild#modify-guild-onboarding
  */

rest/v10/guildScheduledEvent.ts

@@ -1,5 +1,5 @@
 import type { Snowflake } from '../../globals';
-import type { StrictPartial } from '../../utils/internals';
+import type { Nullable, StrictPartial } from '../../utils/internals';
 import type {
 	APIGuildScheduledEvent,
 	APIGuildScheduledEventEntityMetadata,
@@ -94,20 +94,17 @@ export type RESTGetAPIGuildScheduledEventResult = APIGuildScheduledEvent;
 /**
  * https://discord.com/developers/docs/resources/guild-scheduled-event#modify-guild-scheduled-event
  */
-export type RESTPatchAPIGuildScheduledEventJSONBody = StrictPartial<RESTPostAPIGuildScheduledEventJSONBody> & {
-	/**
-	 * The status of the scheduled event
-	 */
-	status?: GuildScheduledEventStatus | undefined;
-	/**
-	 * The entity metadata of the scheduled event
-	 */
-	entity_metadata?: APIGuildScheduledEventEntityMetadata | null | undefined;
-	/**
-	 * The description of the guild event
-	 */
-	description?: string | null | undefined;
-};
+export type RESTPatchAPIGuildScheduledEventJSONBody = Nullable<
+	Pick<RESTPostAPIGuildScheduledEventJSONBody, 'description' | 'entity_metadata' | 'recurrence_rule'>
+> &
+	StrictPartial<
+		Omit<RESTPostAPIGuildScheduledEventJSONBody, 'description' | 'entity_metadata' | 'recurrence_rule'>
+	> & {
+		/**
+		 * The status of the scheduled event
+		 */
+		status?: GuildScheduledEventStatus | undefined;
+	};
 
 /**
  * https://discord.com/developers/docs/resources/guild-scheduled-event#modify-guild-scheduled-event

rest/v10/monetization.ts

@@ -46,7 +46,7 @@ export type RESTGetAPIEntitlementsResult = APIEntitlement[];
 /**
  * https://discord.com/developers/docs/monetization/entitlements#create-test-entitlement
  */
-export interface RESTPostAPIEntitlementBody {
+export interface RESTPostAPIEntitlementJSONBody {
 	/**
 	 * ID of the SKU to grant the entitlement to
 	 */
@@ -61,6 +61,11 @@ export interface RESTPostAPIEntitlementBody {
 	owner_type: EntitlementOwnerType;
 }
 
+/**
+ * @deprecated Use {@link RESTPostAPIEntitlementJSONBody} instead
+ */
+export type RESTPostAPIEntitlementBody = RESTPostAPIEntitlementJSONBody;
+
 /**
  * https://discord.com/developers/docs/monetization/entitlements#create-test-entitlement
  */

rest/v10/oauth2.ts

@@ -51,11 +51,16 @@ export interface RESTPostOAuth2TokenRevocationQuery {
 /**
  * https://discord.com/developers/docs/topics/oauth2#authorization-code-grant-redirect-url-example
  */
-export interface RESTOAuth2AuthorizationQueryResult {
+export interface RESTPostOAuth2AuthorizationQueryResult {
 	code: string;
 	state?: string;
 }
 
+/**
+ * @deprecated Use {@link RESTPostOAuth2AuthorizationQueryResult} instead
+ */
+export type RESTOAuth2AuthorizationQueryResult = RESTPostOAuth2AuthorizationQueryResult;
+
 /**
  * https://discord.com/developers/docs/topics/oauth2#authorization-code-grant-redirect-url-example
  */

rest/v10/poll.ts

@@ -20,7 +20,7 @@ export interface RESTGetAPIPollAnswerVotersQuery {
 /**
  * https://discord.com/developers/docs/resources/poll#poll-create-request-object-poll-create-request-object-structure
  */
-export interface RESTAPIPollCreate
+export interface RESTAPIPoll
 	extends Omit<APIPoll, 'allow_multiselect' | 'answers' | 'expiry' | 'layout_type' | 'results'>,
 		Partial<Pick<APIPoll, 'allow_multiselect' | 'layout_type'>> {
 	/**
@@ -35,6 +35,11 @@ export interface RESTAPIPollCreate
 	duration?: number;
 }
 
+/**
+ * @deprecated Use {@link RESTAPIPoll} instead
+ */
+export type RESTAPIPollCreate = RESTAPIPoll;
+
 /**
  * https://discord.com/developers/docs/resources/poll#get-answer-voters
  */

rest/v10/sticker.ts

@@ -15,7 +15,12 @@ export interface RESTGetStickerPacksResult {
 /**
  * https://discord.com/developers/docs/resources/sticker#get-sticker-pack
  */
-export type RESTGetAPIStickerPack = APIStickerPack;
+export type RESTGetAPIStickerPackResult = APIStickerPack;
+
+/**
+ * @deprecated Use {@link RESTGetAPIStickerPackResult} instead
+ */
+export type RESTGetAPIStickerPack = RESTGetAPIStickerPackResult;
 
 /**
  * https://discord.com/developers/docs/resources/sticker#list-sticker-packs

rest/v10/webhook.ts

@@ -10,7 +10,7 @@ import type {
 } from '../../payloads/v10/index';
 import type { AddUndefinedToPossiblyUndefinedPropertiesOfInterface, Nullable } from '../../utils/internals';
 import type { RESTAPIAttachment } from './channel';
-import type { RESTAPIPollCreate } from './poll';
+import type { RESTAPIPoll } from './poll';
 /**
  * https://discord.com/developers/docs/resources/webhook#create-webhook
  */
@@ -158,7 +158,7 @@ export interface RESTPostAPIWebhookWithTokenJSONBody {
 	/**
 	 * A poll!
 	 */
-	poll?: RESTAPIPollCreate | undefined;
+	poll?: RESTAPIPoll | undefined;
 }
 
 /**

rest/v9/channel.ts

@@ -26,12 +26,17 @@ import type {
 	ChannelFlags,
 } from '../../payloads/v9/index';
 import type { AddUndefinedToPossiblyUndefinedPropertiesOfInterface, StrictPartial } from '../../utils/internals';
-import type { RESTAPIPollCreate } from './poll';
+import type { RESTAPIPoll } from './poll';
 
-export interface APIChannelPatchOverwrite extends RESTPutAPIChannelPermissionJSONBody {
+export interface RESTAPIChannelPatchOverwrite extends RESTPutAPIChannelPermissionJSONBody {
 	id: Snowflake;
 }
 
+/**
+ * @deprecated Use {@link RESTAPIChannelPatchOverwrite} instead
+ */
+export type APIChannelPatchOverwrite = RESTAPIChannelPatchOverwrite;
+
 /**
  * https://discord.com/developers/docs/resources/channel#get-channel
  */
@@ -237,7 +242,7 @@ export type RESTGetAPIChannelMessageResult = APIMessage;
 /**
  * https://discord.com/developers/docs/resources/channel#message-reference-object-message-reference-structure
  */
-export type APIMessageReferenceSend = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<
+export type RESTAPIMessageReference = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<
 	Required<Pick<APIMessageReference, 'message_id'>>
 > &
 	StrictPartial<APIMessageReference> & {
@@ -249,6 +254,11 @@ export type APIMessageReferenceSend = AddUndefinedToPossiblyUndefinedPropertiesO
 		fail_if_not_exists?: boolean | undefined;
 	};
 
+/**
+ * @deprecated Use {@link RESTAPIMessageReference} instead
+ */
+export type APIMessageReferenceSend = RESTAPIMessageReference;
+
 /**
  * https://discord.com/developers/docs/resources/channel#attachment-object
  */
@@ -308,7 +318,7 @@ export interface RESTPostAPIChannelMessageJSONBody {
 	 *
 	 * See https://discord.com/developers/docs/resources/channel#message-reference-object-message-reference-structure
 	 */
-	message_reference?: APIMessageReferenceSend | undefined;
+	message_reference?: RESTAPIMessageReference | undefined;
 	/**
 	 * The components to include with the message
 	 *
@@ -337,7 +347,7 @@ export interface RESTPostAPIChannelMessageJSONBody {
 	/**
 	 * A poll!
 	 */
-	poll?: RESTAPIPollCreate | undefined;
+	poll?: RESTAPIPoll | undefined;
 }
 
 /**
@@ -370,7 +380,12 @@ export type RESTPutAPIChannelMessageReactionResult = never;
 /**
  * https://discord.com/developers/docs/resources/channel#delete-own-reaction
  */
-export type RESTDeleteAPIChannelMessageOwnReaction = never;
+export type RESTDeleteAPIChannelMessageOwnReactionResult = never;
+
+/**
+ * @deprecated Use {@link RESTDeleteAPIChannelMessageOwnReactionResult} instead
+ */
+export type RESTDeleteAPIChannelMessageOwnReaction = RESTDeleteAPIChannelMessageOwnReactionResult;
 
 /**
  * https://discord.com/developers/docs/resources/channel#delete-user-reaction

rest/v9/guild.ts

@@ -37,14 +37,25 @@ import type {
 } from '../../utils/internals';
 import type { RESTPutAPIChannelPermissionJSONBody } from './channel';
 
-export interface APIGuildCreateOverwrite extends RESTPutAPIChannelPermissionJSONBody {
+export interface RESTAPIGuildCreateOverwrite extends RESTPutAPIChannelPermissionJSONBody {
 	id: number | string;
 }
 
-export type APIGuildChannelResolvable = Exclude<APIChannel, APIDMChannel | APIGroupDMChannel>;
-export type APIGuildCreatePartialChannel = StrictPartial<
+/**
+ * @deprecated Use {@link RESTAPIGuildCreateOverwrite} instead
+ */
+export type APIGuildCreateOverwrite = RESTAPIGuildCreateOverwrite;
+
+export type RESTAPIGuildChannelResolvable = Exclude<APIChannel, APIDMChannel | APIGroupDMChannel>;
+
+/**
+ * @deprecated Use {@link RESTAPIGuildChannelResolvable} instead
+ */
+export type APIGuildChannelResolvable = RESTAPIGuildChannelResolvable;
+
+export type RESTAPIGuildCreatePartialChannel = StrictPartial<
 	DistributivePick<
-		APIGuildChannelResolvable,
+		RESTAPIGuildChannelResolvable,
 		| 'available_tags'
 		| 'bitrate'
 		| 'default_auto_archive_duration'
@@ -66,13 +77,23 @@ export type APIGuildCreatePartialChannel = StrictPartial<
 	name: string;
 	id?: number | string | undefined;
 	parent_id?: number | string | null | undefined;
-	permission_overwrites?: APIGuildCreateOverwrite[] | undefined;
+	permission_overwrites?: RESTAPIGuildCreateOverwrite[] | undefined;
 };
 
-export interface APIGuildCreateRole extends RESTPostAPIGuildRoleJSONBody {
+/**
+ * @deprecated Use {@link RESTAPIGuildCreatePartialChannel} instead
+ */
+export type APIGuildCreatePartialChannel = RESTAPIGuildCreatePartialChannel;
+
+export interface RESTAPIGuildCreateRole extends RESTPostAPIGuildRoleJSONBody {
 	id: number | string;
 }
 
+/**
+ * @deprecated Use {@link RESTAPIGuildCreateRole} instead
+ */
+export type APIGuildCreateRole = RESTAPIGuildCreateRole;
+
 /**
  * https://discord.com/developers/docs/resources/guild#create-guild
  */
@@ -124,7 +145,7 @@ export interface RESTPostAPIGuildsJSONBody {
 	 *
 	 * See https://discord.com/developers/docs/topics/permissions#role-object
 	 */
-	roles?: APIGuildCreateRole[] | undefined;
+	roles?: RESTAPIGuildCreateRole[] | undefined;
 	/**
 	 * New guild's channels
 	 *
@@ -138,7 +159,7 @@ export interface RESTPostAPIGuildsJSONBody {
 	 *
 	 * See https://discord.com/developers/docs/resources/channel#channel-object
 	 */
-	channels?: APIGuildCreatePartialChannel[] | undefined;
+	channels?: RESTAPIGuildCreatePartialChannel[] | undefined;
 	/**
 	 * ID for afk channel
 	 */
@@ -333,7 +354,7 @@ export type RESTGetAPIGuildChannelsResult = APIChannel[];
 /**
  * https://discord.com/developers/docs/resources/guild#create-guild-channel
  */
-export type RESTPostAPIGuildChannelJSONBody = DistributiveOmit<APIGuildCreatePartialChannel, 'id'>;
+export type RESTPostAPIGuildChannelJSONBody = DistributiveOmit<RESTAPIGuildCreatePartialChannel, 'id'>;
 
 /**
  * https://discord.com/developers/docs/resources/guild#create-guild-channel
@@ -936,20 +957,25 @@ export type RESTPutAPIGuildOnboardingJSONBody = AddUndefinedToPossiblyUndefinedP
 	/**
 	 * Prompts shown during onboarding and in customize community
 	 */
-	prompts?: RESTAPIModifyGuildOnboardingPromptData[] | undefined;
+	prompts?: RESTAPIGuildOnboardingPrompt[] | undefined;
 };
 
-export type RESTAPIModifyGuildOnboardingPromptData = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<
+export type RESTAPIGuildOnboardingPrompt = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<
 	Partial<Omit<APIGuildOnboardingPrompt, 'guild_id' | 'id' | 'options' | 'title'>>
 > &
 	Pick<APIGuildOnboardingPrompt, 'id' | 'title'> & {
 		/**
 		 * Options available within the prompt
 		 */
-		options: RESTAPIModifyGuildOnboardingPromptOptionData[];
+		options: RESTAPIGuildOnboardingPromptOption[];
 	};
 
-export type RESTAPIModifyGuildOnboardingPromptOptionData = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<
+/**
+ * @deprecated Use {@link RESTAPIGuildOnboardingPrompt} instead.
+ */
+export type RESTAPIModifyGuildOnboardingPromptData = RESTAPIGuildOnboardingPrompt;
+
+export type RESTAPIGuildOnboardingPromptOption = AddUndefinedToPossiblyUndefinedPropertiesOfInterface<
 	Partial<Omit<APIGuildOnboardingPromptOption, 'emoji' | 'guild_id' | 'title'>>
 > &
 	Pick<APIGuildOnboardingPromptOption, 'title'> & {
@@ -967,6 +993,11 @@ export type RESTAPIModifyGuildOnboardingPromptOptionData = AddUndefinedToPossibl
 		emoji_animated?: boolean | null | undefined;
 	};
 
+/**
+ * @deprecated Use {@link RESTAPIGuildOnboardingPromptOption} instead.
+ */
+export type RESTAPIModifyGuildOnboardingPromptOptionData = RESTAPIGuildOnboardingPromptOption;
+
 /**
  * https://discord.com/developers/docs/resources/guild#modify-guild-onboarding
  */

rest/v9/guildScheduledEvent.ts

@@ -1,5 +1,5 @@
 import type { Snowflake } from '../../globals';
-import type { StrictPartial } from '../../utils/internals';
+import type { Nullable, StrictPartial } from '../../utils/internals';
 import type {
 	APIGuildScheduledEvent,
 	APIGuildScheduledEventEntityMetadata,
@@ -94,20 +94,17 @@ export type RESTGetAPIGuildScheduledEventResult = APIGuildScheduledEvent;
 /**
  * https://discord.com/developers/docs/resources/guild-scheduled-event#modify-guild-scheduled-event
  */
-export type RESTPatchAPIGuildScheduledEventJSONBody = StrictPartial<RESTPostAPIGuildScheduledEventJSONBody> & {
-	/**
-	 * The status of the scheduled event
-	 */
-	status?: GuildScheduledEventStatus | undefined;
-	/**
-	 * The entity metadata of the scheduled event
-	 */
-	entity_metadata?: APIGuildScheduledEventEntityMetadata | null | undefined;
-	/**
-	 * The description of the guild event
-	 */
-	description?: string | null | undefined;
-};
+export type RESTPatchAPIGuildScheduledEventJSONBody = Nullable<
+	Pick<RESTPostAPIGuildScheduledEventJSONBody, 'description' | 'entity_metadata' | 'recurrence_rule'>
+> &
+	StrictPartial<
+		Omit<RESTPostAPIGuildScheduledEventJSONBody, 'description' | 'entity_metadata' | 'recurrence_rule'>
+	> & {
+		/**
+		 * The status of the scheduled event
+		 */
+		status?: GuildScheduledEventStatus | undefined;
+	};
 
 /**
  * https://discord.com/developers/docs/resources/guild-scheduled-event#modify-guild-scheduled-event

rest/v9/monetization.ts

@@ -46,7 +46,7 @@ export type RESTGetAPIEntitlementsResult = APIEntitlement[];
 /**
  * https://discord.com/developers/docs/monetization/entitlements#create-test-entitlement
  */
-export interface RESTPostAPIEntitlementBody {
+export interface RESTPostAPIEntitlementJSONBody {
 	/**
 	 * ID of the SKU to grant the entitlement to
 	 */
@@ -61,6 +61,11 @@ export interface RESTPostAPIEntitlementBody {
 	owner_type: EntitlementOwnerType;
 }
 
+/**
+ * @deprecated Use {@link RESTPostAPIEntitlementJSONBody} instead
+ */
+export type RESTPostAPIEntitlementBody = RESTPostAPIEntitlementJSONBody;
+
 /**
  * https://discord.com/developers/docs/monetization/entitlements#create-test-entitlement
  */

rest/v9/oauth2.ts

@@ -51,11 +51,16 @@ export interface RESTPostOAuth2TokenRevocationQuery {
 /**
  * https://discord.com/developers/docs/topics/oauth2#authorization-code-grant-redirect-url-example
  */
-export interface RESTOAuth2AuthorizationQueryResult {
+export interface RESTPostOAuth2AuthorizationQueryResult {
 	code: string;
 	state?: string;
 }
 
+/**
+ * @deprecated Use {@link RESTPostOAuth2AuthorizationQueryResult} instead
+ */
+export type RESTOAuth2AuthorizationQueryResult = RESTPostOAuth2AuthorizationQueryResult;
+
 /**
  * https://discord.com/developers/docs/topics/oauth2#authorization-code-grant-redirect-url-example
  */

rest/v9/poll.ts

@@ -20,7 +20,7 @@ export interface RESTGetAPIPollAnswerVotersQuery {
 /**
  * https://discord.com/developers/docs/resources/poll#poll-create-request-object-poll-create-request-object-structure
  */
-export interface RESTAPIPollCreate
+export interface RESTAPIPoll
 	extends Omit<APIPoll, 'allow_multiselect' | 'answers' | 'expiry' | 'layout_type' | 'results'>,
 		Partial<Pick<APIPoll, 'allow_multiselect' | 'layout_type'>> {
 	/**
@@ -35,6 +35,11 @@ export interface RESTAPIPollCreate
 	duration?: number;
 }
 
+/**
+ * @deprecated Use {@link RESTAPIPoll} instead
+ */
+export type RESTAPIPollCreate = RESTAPIPoll;
+
 /**
  * https://discord.com/developers/docs/resources/poll#get-answer-voters
  */

rest/v9/sticker.ts

@@ -15,7 +15,12 @@ export interface RESTGetStickerPacksResult {
 /**
  * https://discord.com/developers/docs/resources/sticker#get-sticker-pack
  */
-export type RESTGetAPIStickerPack = APIStickerPack;
+export type RESTGetAPIStickerPackResult = APIStickerPack;
+
+/**
+ * @deprecated Use {@link RESTGetAPIStickerPackResult} instead
+ */
+export type RESTGetAPIStickerPack = RESTGetAPIStickerPackResult;
 
 /**
  * https://discord.com/developers/docs/resources/sticker#list-sticker-packs

rest/v9/webhook.ts

@@ -10,7 +10,7 @@ import type {
 } from '../../payloads/v9/index';
 import type { AddUndefinedToPossiblyUndefinedPropertiesOfInterface, Nullable } from '../../utils/internals';
 import type { RESTAPIAttachment } from './channel';
-import type { RESTAPIPollCreate } from './poll';
+import type { RESTAPIPoll } from './poll';
 /**
  * https://discord.com/developers/docs/resources/webhook#create-webhook
  */
@@ -158,7 +158,7 @@ export interface RESTPostAPIWebhookWithTokenJSONBody {
 	/**
 	 * A poll!
 	 */
-	poll?: RESTAPIPollCreate | undefined;
+	poll?: RESTAPIPoll | undefined;
 }
 
 /**

website/versioned_docs/version-0.37.96/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.94"}]
+[{"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.96"}]

website/versioned_docs/version-0.37.97/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.95"}]
+[{"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.97"}]

website/versions.json

@@ -1,4 +1,4 @@
 [
-  "0.37.95",
-  "0.37.94"
+  "0.37.97",
+  "0.37.96"
 ]