feat: Application patch and new properties (#810)

* feat: application patch and properties * docs(APIApplication): update tag documentation * fix(RESTPatchCurrentApplicationJSONBody): add `flags` * docs(APIApplication): update `approximate_guild_count`
2026-05-29 23:00:08 +00:00 · 2023-10-03 20:34:06 +02:00
parent 5515e2914a
commit 17f42e0b38
12 changed files with 204 additions and 62 deletions
--- a/deno/payloads/v10/application.ts
+++ b/deno/payloads/v10/application.ts
@@ -41,6 +41,10 @@ export interface APIApplication {
 	 * When `true` the app's bot will only join upon completion of the full oauth2 code grant flow
 	 */
 	bot_require_code_grant: boolean;
+	/**
+	 * Partial user object for the bot user associated with the application
+	 */
+	bot?: APIUser;
 	/**
 	 * The url of the application's terms of service
 	 */
@@ -60,7 +64,7 @@ export interface APIApplication {
 	 *
 	 * @deprecated This field will be removed in v11
 	 */
-	summary: string;
+	summary: '';
 	/**
 	 * The hexadecimal encoded key for verification in interactions and the GameSDK's GetTicket function
 	 *
@@ -77,6 +81,10 @@ export interface APIApplication {
 	 * If this application is a game sold on Discord, this field will be the guild to which it has been linked
 	 */
 	guild_id?: Snowflake;
+	/**
+	 * A partial object of the associated guild
+	 */
+	guild?: APIPartialGuild;
 	/**
 	 * If this application is a game sold on Discord, this field will be the id of the "Game SKU" that is created, if exists
 	 */
@@ -96,7 +104,24 @@ export interface APIApplication {
 	 */
 	flags: ApplicationFlags;
 	/**
-	 * Up to 5 tags describing the content and functionality of the application
+	 * Approximate count of guilds the application has been added to
+	 */
+	approximate_guild_count?: number;
+	/**
+	 * Array of redirect URIs for the application
+	 */
+	redirect_uris?: string[];
+	/**
+	 * The interactions endpoint URL for the application
+	 */
+	interactions_endpoint_url?: string;
+	/**
+	 * The application's role connection verification entry point,
+	 * which when configured will render the app as a verification method in the guild role verification configuration
+	 */
+	role_connections_verification_url?: string;
+	/**
+	 * Up to 5 tags of max 20 characters each describing the content and functionality of the application
 	 */
 	tags?: [string, string?, string?, string?, string?];
 	/**
@@ -107,19 +132,6 @@ export interface APIApplication {
 	 * The application's default custom authorization link, if enabled
 	 */
 	custom_install_url?: string;
-	/**
-	 * The application's role connection verification entry point,
-	 * which when configured will render the app as a verification method in the guild role verification configuration
-	 */
-	role_connections_verification_url?: string;
-	/**
-	 * An approximate count of the app's guild membership
-	 */
-	approximate_guild_count?: number;
-	/**
-	 * A partial object of the associated guild
-	 */
-	guild?: APIPartialGuild;
 }

 export interface APIApplicationInstallParams {
--- a/deno/payloads/v9/application.ts
+++ b/deno/payloads/v9/application.ts
@@ -41,6 +41,10 @@ export interface APIApplication {
 	 * When `true` the app's bot will only join upon completion of the full oauth2 code grant flow
 	 */
 	bot_require_code_grant: boolean;
+	/**
+	 * Partial user object for the bot user associated with the application
+	 */
+	bot?: APIUser;
 	/**
 	 * The url of the application's terms of service
 	 */
@@ -60,7 +64,7 @@ export interface APIApplication {
 	 *
 	 * @deprecated This field will be removed in v11
 	 */
-	summary: string;
+	summary: '';
 	/**
 	 * The hexadecimal encoded key for verification in interactions and the GameSDK's GetTicket function
 	 *
@@ -77,6 +81,10 @@ export interface APIApplication {
 	 * If this application is a game sold on Discord, this field will be the guild to which it has been linked
 	 */
 	guild_id?: Snowflake;
+	/**
+	 * A partial object of the associated guild
+	 */
+	guild?: APIPartialGuild;
 	/**
 	 * If this application is a game sold on Discord, this field will be the id of the "Game SKU" that is created, if exists
 	 */
@@ -96,7 +104,24 @@ export interface APIApplication {
 	 */
 	flags: ApplicationFlags;
 	/**
-	 * Up to 5 tags describing the content and functionality of the application
+	 * Approximate count of guilds the application has been added to
+	 */
+	approximate_guild_count?: number;
+	/**
+	 * Array of redirect URIs for the application
+	 */
+	redirect_uris?: string[];
+	/**
+	 * The interactions endpoint URL for the application
+	 */
+	interactions_endpoint_url?: string;
+	/**
+	 * The application's role connection verification entry point,
+	 * which when configured will render the app as a verification method in the guild role verification configuration
+	 */
+	role_connections_verification_url?: string;
+	/**
+	 * Up to 5 tags of max 20 characters each describing the content and functionality of the application
 	 */
 	tags?: [string, string?, string?, string?, string?];
 	/**
@@ -107,20 +132,6 @@ export interface APIApplication {
 	 * The application's default custom authorization link, if enabled
 	 */
 	custom_install_url?: string;
-	/**
-	 * The application's role connection verification entry point,
-	 * which when configured will render the app as a verification method in the guild role verification configuration
-	 */
-	role_connections_verification_url?: string;
-	/**
-	 * An approximate count of the app's guild membership
-	 * s
-	 */
-	approximate_guild_count?: number;
-	/**
-	 * A partial object of the associated guild
-	 */
-	guild?: APIPartialGuild;
 }

 export interface APIApplicationInstallParams {
--- a/deno/rest/v10/application.ts
+++ b/deno/rest/v10/application.ts
@@ -1,4 +1,5 @@
 import type { APIApplication, APIApplicationRoleConnectionMetadata } from '../../payloads/v10/application.ts';
+import type { Nullable, StrictPartial } from '../../utils/internals.ts';

 /**
 * https://discord.com/developers/docs/resources/application-role-connection-metadata#get-application-role-connection-metadata-records
@@ -19,3 +20,25 @@ export type RESTPutAPIApplicationRoleConnectionMetadataResult = APIApplicationRo
 * https://discord.com/developers/docs/resources/application#get-current-application
 */
 export type RESTGetCurrentApplicationResult = APIApplication;
+
+/**
+ * https://discord.com/developers/docs/resources/application#edit-current-application
+ */
+export type RESTPatchCurrentApplicationJSONBody = StrictPartial<
+	Pick<
+		APIApplication,
+		| 'custom_install_url'
+		| 'description'
+		| 'flags'
+		| 'role_connections_verification_url'
+		| 'install_params'
+		| 'interactions_endpoint_url'
+		| 'tags'
+	> &
+		Nullable<Pick<APIApplication, 'icon' | 'cover_image'>>
+>;
+
+/**
+ * https://discord.com/developers/docs/resources/application#edit-current-application
+ */
+export type RESTPatchCurrentApplicationResult = APIApplication;
--- a/deno/rest/v10/mod.ts
+++ b/deno/rest/v10/mod.ts
@@ -902,6 +902,7 @@ export const Routes = {
 	/**
 	 * Route for:
 	 * - GET `/applications/@me`
+	 * - PATCH `/applications/@me`
 	 */
 	currentApplication() {
 		return '/applications/@me' as const;
--- a/deno/rest/v9/application.ts
+++ b/deno/rest/v9/application.ts
@@ -1,4 +1,5 @@
 import type { APIApplication, APIApplicationRoleConnectionMetadata } from '../../payloads/v9/application.ts';
+import type { StrictPartial, Nullable } from '../../utils/internals.ts';

 /**
 * https://discord.com/developers/docs/resources/application-role-connection-metadata#get-application-role-connection-metadata-records
@@ -19,3 +20,25 @@ export type RESTPutAPIApplicationRoleConnectionMetadataResult = APIApplicationRo
 * https://discord.com/developers/docs/resources/application#get-current-application
 */
 export type RESTGetCurrentApplicationResult = APIApplication;
+
+/**
+ * https://discord.com/developers/docs/resources/application#edit-current-application
+ */
+export type RESTPatchCurrentApplicationJSONBody = StrictPartial<
+	Pick<
+		APIApplication,
+		| 'custom_install_url'
+		| 'description'
+		| 'flags'
+		| 'role_connections_verification_url'
+		| 'install_params'
+		| 'interactions_endpoint_url'
+		| 'tags'
+	> &
+		Nullable<Pick<APIApplication, 'icon' | 'cover_image'>>
+>;
+
+/**
+ * https://discord.com/developers/docs/resources/application#edit-current-application
+ */
+export type RESTPatchCurrentApplicationResult = APIApplication;
--- a/deno/rest/v9/mod.ts
+++ b/deno/rest/v9/mod.ts
@@ -911,6 +911,7 @@ export const Routes = {
 	/**
 	 * Route for:
 	 * - GET `/applications/@me`
+	 * - PATCH `/applications/@me`
 	 */
 	currentApplication() {
 		return '/applications/@me' as const;
--- a/payloads/v10/application.ts
+++ b/payloads/v10/application.ts
@@ -41,6 +41,10 @@ export interface APIApplication {
 	 * When `true` the app's bot will only join upon completion of the full oauth2 code grant flow
 	 */
 	bot_require_code_grant: boolean;
+	/**
+	 * Partial user object for the bot user associated with the application
+	 */
+	bot?: APIUser;
 	/**
 	 * The url of the application's terms of service
 	 */
@@ -60,7 +64,7 @@ export interface APIApplication {
 	 *
 	 * @deprecated This field will be removed in v11
 	 */
-	summary: string;
+	summary: '';
 	/**
 	 * The hexadecimal encoded key for verification in interactions and the GameSDK's GetTicket function
 	 *
@@ -77,6 +81,10 @@ export interface APIApplication {
 	 * If this application is a game sold on Discord, this field will be the guild to which it has been linked
 	 */
 	guild_id?: Snowflake;
+	/**
+	 * A partial object of the associated guild
+	 */
+	guild?: APIPartialGuild;
 	/**
 	 * If this application is a game sold on Discord, this field will be the id of the "Game SKU" that is created, if exists
 	 */
@@ -96,7 +104,24 @@ export interface APIApplication {
 	 */
 	flags: ApplicationFlags;
 	/**
-	 * Up to 5 tags describing the content and functionality of the application
+	 * Approximate count of guilds the application has been added to
+	 */
+	approximate_guild_count?: number;
+	/**
+	 * Array of redirect URIs for the application
+	 */
+	redirect_uris?: string[];
+	/**
+	 * The interactions endpoint URL for the application
+	 */
+	interactions_endpoint_url?: string;
+	/**
+	 * The application's role connection verification entry point,
+	 * which when configured will render the app as a verification method in the guild role verification configuration
+	 */
+	role_connections_verification_url?: string;
+	/**
+	 * Up to 5 tags of max 20 characters each describing the content and functionality of the application
 	 */
 	tags?: [string, string?, string?, string?, string?];
 	/**
@@ -107,19 +132,6 @@ export interface APIApplication {
 	 * The application's default custom authorization link, if enabled
 	 */
 	custom_install_url?: string;
-	/**
-	 * The application's role connection verification entry point,
-	 * which when configured will render the app as a verification method in the guild role verification configuration
-	 */
-	role_connections_verification_url?: string;
-	/**
-	 * An approximate count of the app's guild membership
-	 */
-	approximate_guild_count?: number;
-	/**
-	 * A partial object of the associated guild
-	 */
-	guild?: APIPartialGuild;
 }

 export interface APIApplicationInstallParams {
--- a/payloads/v9/application.ts
+++ b/payloads/v9/application.ts
@@ -41,6 +41,10 @@ export interface APIApplication {
 	 * When `true` the app's bot will only join upon completion of the full oauth2 code grant flow
 	 */
 	bot_require_code_grant: boolean;
+	/**
+	 * Partial user object for the bot user associated with the application
+	 */
+	bot?: APIUser;
 	/**
 	 * The url of the application's terms of service
 	 */
@@ -60,7 +64,7 @@ export interface APIApplication {
 	 *
 	 * @deprecated This field will be removed in v11
 	 */
-	summary: string;
+	summary: '';
 	/**
 	 * The hexadecimal encoded key for verification in interactions and the GameSDK's GetTicket function
 	 *
@@ -77,6 +81,10 @@ export interface APIApplication {
 	 * If this application is a game sold on Discord, this field will be the guild to which it has been linked
 	 */
 	guild_id?: Snowflake;
+	/**
+	 * A partial object of the associated guild
+	 */
+	guild?: APIPartialGuild;
 	/**
 	 * If this application is a game sold on Discord, this field will be the id of the "Game SKU" that is created, if exists
 	 */
@@ -96,7 +104,24 @@ export interface APIApplication {
 	 */
 	flags: ApplicationFlags;
 	/**
-	 * Up to 5 tags describing the content and functionality of the application
+	 * Approximate count of guilds the application has been added to
+	 */
+	approximate_guild_count?: number;
+	/**
+	 * Array of redirect URIs for the application
+	 */
+	redirect_uris?: string[];
+	/**
+	 * The interactions endpoint URL for the application
+	 */
+	interactions_endpoint_url?: string;
+	/**
+	 * The application's role connection verification entry point,
+	 * which when configured will render the app as a verification method in the guild role verification configuration
+	 */
+	role_connections_verification_url?: string;
+	/**
+	 * Up to 5 tags of max 20 characters each describing the content and functionality of the application
 	 */
 	tags?: [string, string?, string?, string?, string?];
 	/**
@@ -107,20 +132,6 @@ export interface APIApplication {
 	 * The application's default custom authorization link, if enabled
 	 */
 	custom_install_url?: string;
-	/**
-	 * The application's role connection verification entry point,
-	 * which when configured will render the app as a verification method in the guild role verification configuration
-	 */
-	role_connections_verification_url?: string;
-	/**
-	 * An approximate count of the app's guild membership
-	 * s
-	 */
-	approximate_guild_count?: number;
-	/**
-	 * A partial object of the associated guild
-	 */
-	guild?: APIPartialGuild;
 }

 export interface APIApplicationInstallParams {
--- a/rest/v10/application.ts
+++ b/rest/v10/application.ts
@@ -1,4 +1,5 @@
 import type { APIApplication, APIApplicationRoleConnectionMetadata } from '../../payloads/v10/application';
+import type { Nullable, StrictPartial } from '../../utils/internals';

 /**
 * https://discord.com/developers/docs/resources/application-role-connection-metadata#get-application-role-connection-metadata-records
@@ -19,3 +20,25 @@ export type RESTPutAPIApplicationRoleConnectionMetadataResult = APIApplicationRo
 * https://discord.com/developers/docs/resources/application#get-current-application
 */
 export type RESTGetCurrentApplicationResult = APIApplication;
+
+/**
+ * https://discord.com/developers/docs/resources/application#edit-current-application
+ */
+export type RESTPatchCurrentApplicationJSONBody = StrictPartial<
+	Pick<
+		APIApplication,
+		| 'custom_install_url'
+		| 'description'
+		| 'flags'
+		| 'role_connections_verification_url'
+		| 'install_params'
+		| 'interactions_endpoint_url'
+		| 'tags'
+	> &
+		Nullable<Pick<APIApplication, 'icon' | 'cover_image'>>
+>;
+
+/**
+ * https://discord.com/developers/docs/resources/application#edit-current-application
+ */
+export type RESTPatchCurrentApplicationResult = APIApplication;
--- a/rest/v10/index.ts
+++ b/rest/v10/index.ts
@@ -902,6 +902,7 @@ export const Routes = {
 	/**
 	 * Route for:
 	 * - GET `/applications/@me`
+	 * - PATCH `/applications/@me`
 	 */
 	currentApplication() {
 		return '/applications/@me' as const;
--- a/rest/v9/application.ts
+++ b/rest/v9/application.ts
@@ -1,4 +1,5 @@
 import type { APIApplication, APIApplicationRoleConnectionMetadata } from '../../payloads/v9/application';
+import type { StrictPartial, Nullable } from '../../utils/internals';

 /**
 * https://discord.com/developers/docs/resources/application-role-connection-metadata#get-application-role-connection-metadata-records
@@ -19,3 +20,25 @@ export type RESTPutAPIApplicationRoleConnectionMetadataResult = APIApplicationRo
 * https://discord.com/developers/docs/resources/application#get-current-application
 */
 export type RESTGetCurrentApplicationResult = APIApplication;
+
+/**
+ * https://discord.com/developers/docs/resources/application#edit-current-application
+ */
+export type RESTPatchCurrentApplicationJSONBody = StrictPartial<
+	Pick<
+		APIApplication,
+		| 'custom_install_url'
+		| 'description'
+		| 'flags'
+		| 'role_connections_verification_url'
+		| 'install_params'
+		| 'interactions_endpoint_url'
+		| 'tags'
+	> &
+		Nullable<Pick<APIApplication, 'icon' | 'cover_image'>>
+>;
+
+/**
+ * https://discord.com/developers/docs/resources/application#edit-current-application
+ */
+export type RESTPatchCurrentApplicationResult = APIApplication;
--- a/rest/v9/index.ts
+++ b/rest/v9/index.ts
@@ -911,6 +911,7 @@ export const Routes = {
 	/**
 	 * Route for:
 	 * - GET `/applications/@me`
+	 * - PATCH `/applications/@me`
 	 */
 	currentApplication() {
 		return '/applications/@me' as const;